MediaWiki REL1_28
PurgeAction Class Reference

User-requested page cache purging. More...

Inheritance diagram for PurgeAction:
Collaboration diagram for PurgeAction:

Public Member Functions

 doesWrites ()
 Indicates whether this action may perform database writes.
 
 getDescription ()
 Returns the description that goes below the \<h1\> tag.
 
 getName ()
 Return the name of the action this object responds to.
 
 onSubmit ( $data)
 Process the form on POST submission.
 
 onSuccess ()
 Do something exciting on successful processing of the form.
 
 requiresUnblock ()
 Whether this action can still be executed by a blocked user.
 
 show ()
 The basic pattern for actions is to display some sort of HTMLForm UI, maybe with some stuff underneath (history etc); to do some processing on submission of that form (delete, protect, etc) and to do something exciting on 'success', be that display something new or redirect to somewhere.
 
- Public Member Functions inherited from Action
 __construct (Page $page, IContextSource $context=null)
 Constructor.
 
 addHelpLink ( $to, $overrideBaseUrl=false)
 Adds help link with an icon via page indicators.
 
 getContext ()
 Get the IContextSource in use here.
 
 getLanguage ()
 Shortcut to get the user Language being used for this instance.
 
 getOutput ()
 Get the OutputPage being used for this instance.
 
 getRequest ()
 Get the WebRequest being used for this instance.
 
 getRestriction ()
 Get the permission required to perform this action.
 
 getSkin ()
 Shortcut to get the Skin being used for this instance.
 
 getTitle ()
 Shortcut to get the Title object from the page.
 
 getUser ()
 Shortcut to get the User being used for this instance.
 
 msg ()
 Get a Message object with context set Parameters are the same as wfMessage()
 
 requiresWrite ()
 Whether this action requires the wiki not to be locked.
 

Protected Member Functions

 alterForm (HTMLForm $form)
 Play with the HTMLForm if you need to more substantially.
 
 postText ()
 
 preText ()
 Add pre- or post-text to the form.
 
- Protected Member Functions inherited from FormAction
 getForm ()
 Get the HTMLForm to control behavior.
 
 getFormFields ()
 Get an HTMLForm descriptor array.
 
- Protected Member Functions inherited from Action
 checkCanExecute (User $user)
 Checks if the given user (identified by an object) can perform this action.
 
 getPageTitle ()
 Returns the name that goes in the \<h1\> page title.
 
 setHeaders ()
 Set output headers for noindexing etc.
 
 useTransactionalTimeLimit ()
 Call wfTransactionalTimeLimit() if this request was POSTed.
 

Private Attributes

 $redirectParams
 

Additional Inherited Members

- Static Public Member Functions inherited from Action
static exists ( $name)
 Check if a given action is recognised, even if it's disabled.
 
static factory ( $action, Page $page, IContextSource $context=null)
 Get an appropriate Action subclass for the given action.
 
static getActionName (IContextSource $context)
 Get the action that will be executed, not necessarily the one passed passed through the "action" request parameter.
 
- Protected Attributes inherited from Action
 $context
 IContextSource if specified; otherwise we'll use the Context from the Page.
 
 $fields
 The fields used to create the HTMLForm.
 
 $page
 Page on which we're performing the action.
 

Detailed Description

User-requested page cache purging.

Definition at line 28 of file PurgeAction.php.

Member Function Documentation

◆ alterForm()

PurgeAction::alterForm ( HTMLForm  $form)
protected

Play with the HTMLForm if you need to more substantially.

Parameters
HTMLForm$form

Reimplemented from FormAction.

Definition at line 78 of file PurgeAction.php.

References HTMLForm\setSubmitTextMsg().

◆ doesWrites()

PurgeAction::doesWrites ( )

Indicates whether this action may perform database writes.

Returns
bool
Since
1.27

Reimplemented from FormAction.

Definition at line 94 of file PurgeAction.php.

◆ getDescription()

PurgeAction::getDescription ( )

Returns the description that goes below the \<h1\> tag.

Since
1.17
Returns
string HTML

Reimplemented from Action.

Definition at line 40 of file PurgeAction.php.

◆ getName()

PurgeAction::getName ( )

Return the name of the action this object responds to.

Since
1.17
Returns
string Lowercase name

Reimplemented from Action.

Definition at line 32 of file PurgeAction.php.

◆ onSubmit()

PurgeAction::onSubmit (   $data)

Process the form on POST submission.

If you don't want to do anything with the form, just return false here.

Parameters
array$data
Returns
bool|array True for success, false for didn't-try, array of errors on failure

Reimplemented from FormAction.

Definition at line 44 of file PurgeAction.php.

References page, and WikiPage\PURGE_ALL.

Referenced by show().

◆ onSuccess()

PurgeAction::onSuccess ( )

Do something exciting on successful processing of the form.

This might be to show a confirmation message (watch, rollback, etc) or to redirect somewhere else (edit, protect, etc).

Reimplemented from FormAction.

Definition at line 90 of file PurgeAction.php.

References Action\getOutput(), and Action\getTitle().

Referenced by show().

◆ postText()

PurgeAction::postText ( )
protected
Returns
string

Reimplemented from FormAction.

Definition at line 86 of file PurgeAction.php.

References Action\msg().

◆ preText()

PurgeAction::preText ( )
protected

Add pre- or post-text to the form.

Returns
string HTML which will be sent to $form->addPreText()

Reimplemented from FormAction.

Definition at line 82 of file PurgeAction.php.

References Action\msg().

◆ requiresUnblock()

PurgeAction::requiresUnblock ( )

Whether this action can still be executed by a blocked user.

Since
1.17
Returns
bool

Reimplemented from Action.

Definition at line 36 of file PurgeAction.php.

◆ show()

PurgeAction::show ( )

The basic pattern for actions is to display some sort of HTMLForm UI, maybe with some stuff underneath (history etc); to do some processing on submission of that form (delete, protect, etc) and to do something exciting on 'success', be that display something new or redirect to somewhere.

Some actions have more exotic behavior, but that's what subclassing is for :D

Reimplemented from FormAction.

Definition at line 48 of file PurgeAction.php.

References $user, Action\checkCanExecute(), FormAction\getForm(), Action\getRequest(), Action\getUser(), onSubmit(), onSuccess(), Action\setHeaders(), and wfArrayToCgi().

Member Data Documentation

◆ $redirectParams

PurgeAction::$redirectParams
private

Definition at line 30 of file PurgeAction.php.


The documentation for this class was generated from the following file: