MediaWiki  REL1_19
Action Class Reference
Inheritance diagram for Action:

List of all members.

Public Member Functions

 execute ()
 Execute the action in a silent fashion: do not display anything or release any errors.
 getContext ()
 Get the IContextSource in use here.
 getLang ()
 Shortcut to get the user Language being used for this instance.
 getLanguage ()
 Shortcut to get the user Language being used for this instance.
 getName ()
 Return the name of the action this object responds to.
 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()
 requiresUnblock ()
 Whether this action can still be executed by a blocked user.
 requiresWrite ()
 Whether this action requires the wiki not to be locked.
 show ()
 The main action entry point.

Static Public Member Functions

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 Member Functions

 __construct (Page $page, IContextSource $context=null)
 Protected constructor: use Action::factory( $action, $page ) to actually build these things in the real world.
 checkCanExecute (User $user)
 Checks if the given user (identified by an object) can perform this action.
 getDescription ()
 Returns the description that goes below the <h1> tag.
 getPageTitle ()
 Returns the name that goes in the <h1> page title.
 setHeaders ()
 Set output headers for noindexing etc.

Protected Attributes

 $context
 $fields
 $page

Static Private Member Functions

static getClass ($action, array $overrides)
 Get the Action subclass which should be used to handle this action, false if the action is disabled, or null if it's not recognised.

Detailed Description

Definition at line 30 of file Action.php.


Constructor & Destructor Documentation

Action::__construct ( Page page,
IContextSource context = null 
) [protected]

Protected constructor: use Action::factory( $action, $page ) to actually build these things in the real world.

Parameters:
$pagePage
$contextIContextSource

Definition at line 242 of file Action.php.

References $context, and $page.


Member Function Documentation

Action::checkCanExecute ( User user) [protected]

Checks if the given user (identified by an object) can perform this action.

Can be overridden by sub-classes with more complicated permissions schemes. Failures here must throw subclasses of ErrorPageError

Parameters:
$userUser: the user to check, or null to use the context user
Exceptions:
ErrorPageError

Reimplemented in WatchAction, and RevertFileAction.

Definition at line 270 of file Action.php.

References getRestriction(), getTitle(), User\isBlocked(), requiresUnblock(), requiresWrite(), and wfReadOnly().

Referenced by FormAction\execute(), FormlessAction\execute(), PurgeAction\show(), FormAction\show(), and FormlessAction\show().

Here is the call graph for this function:

Here is the caller graph for this function:

Action::execute ( ) [abstract]

Execute the action in a silent fashion: do not display anything or release any errors.

Returns:
Bool whether execution was successful

Reimplemented in RevertAction.

static Action::exists ( name) [static, final]

Check if a given action is recognised, even if it's disabled.

Parameters:
$nameString: name of an action
Returns:
Bool

Definition at line 146 of file Action.php.

References getClass().

Here is the call graph for this function:

static Action::factory ( action,
Page page,
IContextSource context = null 
) [static, final]

Get an appropriate Action subclass for the given action.

Parameters:
$actionString
$pagePage
$contextIContextSource
Returns:
Action|false|null false if the action is disabled, null if it is not recognised

Definition at line 84 of file Action.php.

References $context, and getClass().

Referenced by WatchAction\doUnwatch(), WatchAction\doWatch(), getActionName(), Article\info(), Article\markpatrolled(), SkinTemplate\outputPage(), MediaWiki\performAction(), Article\purge(), Article\revert(), Article\rollback(), Article\unwatch(), and Article\watch().

Here is the call graph for this function:

Here is the caller graph for this function:

static Action::getActionName ( IContextSource context) [static, final]

Get the action that will be executed, not necessarily the one passed passed through the "action" request parameter.

Actions disabled in $wgActions will be replaced by "nosuchaction".

Since:
1.19
Parameters:
$contextIContextSource
Returns:
string: action name

Definition at line 102 of file Action.php.

References $wgActions, IContextSource\canUseWikiPage(), factory(), IContextSource\getRequest(), and IContextSource\getWikiPage().

Referenced by MediaWiki\getAction(), OutputPage\getJSVars(), and OutputPage\headElement().

Here is the call graph for this function:

Here is the caller graph for this function:

static Action::getClass ( action,
array $  overrides 
) [static, final, private]

Get the Action subclass which should be used to handle this action, false if the action is disabled, or null if it's not recognised.

Parameters:
$actionString
$overridesArray
Returns:
bool|null|string

Definition at line 57 of file Action.php.

References $wgActions.

Referenced by exists(), and factory().

Here is the caller graph for this function:

Action::getDescription ( ) [protected]

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

Returns:
String

Reimplemented in UnwatchAction, RevertFileAction, RollbackAction, HistoryAction, PurgeAction, RevisiondeleteAction, WatchAction, CreditsAction, InfoAction, and MarkpatrolledAction.

Definition at line 334 of file Action.php.

References getName(), and wfMsgHtml().

Referenced by setHeaders().

Here is the call graph for this function:

Here is the caller graph for this function:

Action::getLang ( ) [final]

Shortcut to get the user Language being used for this instance.

Deprecated:
1.19 Use getLanguage instead
Returns:
Language

Definition at line 212 of file Action.php.

References getLanguage(), and wfDeprecated().

Here is the call graph for this function:

Action::getLanguage ( ) [final]

Shortcut to get the user Language being used for this instance.

Returns:
Language

Definition at line 202 of file Action.php.

References getContext().

Referenced by CreditsAction\getAuthor(), CreditsAction\getContributors(), RevertFileAction\getFormFields(), getLang(), RevertFileAction\onSuccess(), and InfoAction\onView().

Here is the call graph for this function:

Here is the caller graph for this function:

Action::getName ( ) [abstract]

Return the name of the action this object responds to.

Returns:
String lowercase

Reimplemented in UnwatchAction, SubmitAction, RevertFileAction, UnprotectAction, RevertAction, PurgeAction, RollbackAction, CreditsAction, DeleteAction, EditAction, InfoAction, ProtectAction, RenderAction, RevisiondeleteAction, ViewAction, MarkpatrolledAction, WatchAction, RawAction, and HistoryAction.

Referenced by getDescription(), and FormAction\getForm().

Here is the caller graph for this function:

Action::getPageTitle ( ) [protected]

Returns the name that goes in the <h1> page title.

Returns:
String

Reimplemented in RevertFileAction, InfoAction, and HistoryAction.

Definition at line 325 of file Action.php.

References getTitle().

Referenced by setHeaders().

Here is the call graph for this function:

Here is the caller graph for this function:

Get the permission required to perform this action.

Often, but not always, the same as the action name

Returns:
String|null

Reimplemented in RevertFileAction, and RollbackAction.

Definition at line 258 of file Action.php.

Referenced by checkCanExecute().

Here is the caller graph for this function:

Action::getSkin ( ) [final]

Shortcut to get the Skin being used for this instance.

Returns:
Skin

Definition at line 193 of file Action.php.

References getContext().

Here is the call graph for this function:

Action::getUser ( ) [final]

Shortcut to get the User being used for this instance.

Returns:
User

Definition at line 184 of file Action.php.

References getContext().

Referenced by FormAction\execute(), FormlessAction\execute(), WatchAction\onSubmit(), UnwatchAction\onSubmit(), RawAction\onView(), MarkpatrolledAction\onView(), RollbackAction\onView(), InfoAction\onView(), EditAction\show(), WatchAction\show(), PurgeAction\show(), FormAction\show(), and FormlessAction\show().

Here is the call graph for this function:

Here is the caller graph for this function:

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

Returns:
Bool

Reimplemented in InfoAction, PurgeAction, RevisiondeleteAction, RawAction, HistoryAction, and WatchAction.

Definition at line 304 of file Action.php.

Referenced by checkCanExecute().

Here is the caller graph for this function:

Whether this action requires the wiki not to be locked.

Returns:
Bool

Reimplemented in InfoAction, RawAction, and HistoryAction.

Definition at line 296 of file Action.php.

Referenced by checkCanExecute().

Here is the caller graph for this function:

Action::setHeaders ( ) [protected]

Set output headers for noindexing etc.

This function will not be called through the execute() entry point, so only put UI-related stuff in here.

Definition at line 312 of file Action.php.

References $out, getDescription(), getOutput(), and getPageTitle().

Referenced by WatchAction\show(), PurgeAction\show(), FormAction\show(), and FormlessAction\show().

Here is the call graph for this function:

Here is the caller graph for this function:

Action::show ( ) [abstract]

The main action entry point.

Do all output for display and send it to the context output. Do not use globals $wgOut, $wgRequest, etc, in implementations; use $this->getOutput(), etc.

Exceptions:
ErrorPageError

Reimplemented in FormlessAction, FormAction, SubmitAction, PurgeAction, WatchAction, UnprotectAction, RevisiondeleteAction, RevertAction, DeleteAction, EditAction, ProtectAction, RenderAction, and ViewAction.


Member Data Documentation

Action::$context [protected]

Definition at line 42 of file Action.php.

Referenced by RawPage\__construct(), __construct(), factory(), and EditAction\show().

Action::$fields [protected]

Definition at line 48 of file Action.php.

Referenced by FormAction\execute().

Action::$page [protected]

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