MediaWiki  1.23.2
Action Class Reference

Actions are things which can be done to pages (edit, delete, rollback, etc). More...

Inheritance diagram for Action:
Collaboration diagram for Action:

Public Member Functions

 __construct (Page $page, IContextSource $context=null)
 Constructor. More...
 
 execute ()
 Execute the action in a silent fashion: do not display anything or release any errors. More...
 
 getContext ()
 Get the IContextSource in use here. More...
 
 getLang ()
 Shortcut to get the user Language being used for this instance. More...
 
 getLanguage ()
 Shortcut to get the user Language being used for this instance. More...
 
 getName ()
 Return the name of the action this object responds to. More...
 
 getOutput ()
 Get the OutputPage being used for this instance. More...
 
 getRequest ()
 Get the WebRequest being used for this instance. More...
 
 getRestriction ()
 Get the permission required to perform this action. More...
 
 getSkin ()
 Shortcut to get the Skin being used for this instance. More...
 
 getTitle ()
 Shortcut to get the Title object from the page. More...
 
 getUser ()
 Shortcut to get the User being used for this instance. More...
 
 msg ()
 Get a Message object with context set Parameters are the same as wfMessage() More...
 
 requiresUnblock ()
 Whether this action can still be executed by a blocked user. More...
 
 requiresWrite ()
 Whether this action requires the wiki not to be locked. More...
 
 show ()
 The main action entry point. More...
 

Static Public Member Functions

static exists ( $name)
 Check if a given action is recognised, even if it's disabled. More...
 
static factory ( $action, Page $page, IContextSource $context=null)
 Get an appropriate Action subclass for the given action. More...
 
static getActionName (IContextSource $context)
 Get the action that will be executed, not necessarily the one passed passed through the "action" request parameter. More...
 

Protected Member Functions

 checkCanExecute (User $user)
 Checks if the given user (identified by an object) can perform this action. More...
 
 getDescription ()
 Returns the description that goes below the <h1> tag. More...
 
 getPageTitle ()
 Returns the name that goes in the <h1> page title. More...
 
 setHeaders ()
 Set output headers for noindexing etc. More...
 

Protected Attributes

IContextSource $context
 IContextSource if specified; otherwise we'll use the Context from the Page $context. More...
 
array $fields
 The fields used to create the HTMLForm $fields. More...
 
WikiPage Article ImagePage CategoryPage Page $page
 Page on which we're performing the action $page. More...
 

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. More...
 

Detailed Description

Actions are things which can be done to pages (edit, delete, rollback, etc).

They are distinct from Special Pages because an action must apply to exactly one page.

To add an action in an extension, create a subclass of Action, and add the key to $wgActions. There is also the deprecated UnknownAction hook

Actions generally fall into two groups: the show-a-form-then-do-something-with-the-input format (protect, delete, move, etc), and the just-do-something format (watch, rollback, patrol, etc). The FormAction and FormlessAction classes represent these two groups.

Definition at line 37 of file Action.php.

Constructor & Destructor Documentation

◆ __construct()

Action::__construct ( Page  $page,
IContextSource  $context = null 
)

Constructor.

Only public since 1.21

Parameters
Page$page
IContextSource$context

Definition at line 260 of file Action.php.

References $context, $page, page, and wfWarn().

Member Function Documentation

◆ checkCanExecute()

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
User$userThe user to check, or null to use the context user
Exceptions
UserBlockedError|ReadOnlyError|PermissionsError
Returns
bool True on success

Reimplemented in WatchAction, and RevertFileAction.

Definition at line 295 of file Action.php.

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

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

◆ execute()

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.

◆ exists()

static Action::exists (   $name)
staticfinal

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

Parameters
string$nameName of an action
Returns
bool

Definition at line 156 of file Action.php.

References $name, array(), and getClass().

Referenced by HistoryAction\fetchRevisions().

◆ factory()

static Action::factory (   $action,
Page  $page,
IContextSource  $context = null 
)
staticfinal

Get an appropriate Action subclass for the given action.

Parameters
string$action
Page$page
IContextSource$context
Returns
Action|bool|null False if the action is disabled, null if it is not recognised

Definition at line 88 of file Action.php.

References $context, $page, array(), WikiPage\getActionOverrides(), and getClass().

Referenced by getActionName(), Article\info(), MediaWiki\performAction(), SkinTemplate\prepareQuickTemplate(), Article\purge(), Article\revert(), and Article\rollback().

◆ getActionName()

static Action::getActionName ( IContextSource  $context)
staticfinal

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
IContextSource$context
Returns
string Action name

Definition at line 112 of file Action.php.

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

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

◆ getClass()

static Action::getClass (   $action,
array  $overrides 
)
staticfinalprivate

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
string$action
array$overrides
Returns
bool|null|string|callable

Definition at line 61 of file Action.php.

References global.

Referenced by exists(), and factory().

◆ getContext()

◆ getDescription()

Action::getDescription ( )
protected

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

Returns
string

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

Definition at line 360 of file Action.php.

References getName(), and msg().

Referenced by setHeaders().

◆ getLang()

Action::getLang ( )
final

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

Deprecated:
since 1.19 Use getLanguage instead
Returns
Language

Definition at line 228 of file Action.php.

References getLanguage(), and wfDeprecated().

◆ getLanguage()

Action::getLanguage ( )
final

◆ getName()

◆ getOutput()

◆ getPageTitle()

Action::getPageTitle ( )
protected

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

Returns
string

Reimplemented in InfoAction, RevertFileAction, and HistoryAction.

Definition at line 351 of file Action.php.

References getTitle().

Referenced by WatchAction\checkCanExecute(), and setHeaders().

◆ getRequest()

◆ getRestriction()

Action::getRestriction ( )

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 282 of file Action.php.

Referenced by checkCanExecute().

◆ getSkin()

Action::getSkin ( )
final

Shortcut to get the Skin being used for this instance.

Returns
Skin

Definition at line 209 of file Action.php.

References getContext().

◆ getTitle()

◆ getUser()

◆ msg()

◆ requiresUnblock()

Action::requiresUnblock ( )

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

Returns
bool

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

Definition at line 330 of file Action.php.

Referenced by checkCanExecute().

◆ requiresWrite()

Action::requiresWrite ( )

Whether this action requires the wiki not to be locked.

Returns
bool

Reimplemented in InfoAction, HistoryAction, and RawAction.

Definition at line 322 of file Action.php.

Referenced by checkCanExecute().

◆ setHeaders()

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 338 of file Action.php.

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

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

◆ show()

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 FormAction, SubmitAction, PurgeAction, UnprotectAction, FormlessAction, WatchAction, RevisiondeleteAction, EditAction, DeleteAction, ProtectAction, RenderAction, ViewAction, and RevertAction.

Member Data Documentation

◆ $context

IContextSource Action::$context
protected

IContextSource if specified; otherwise we'll use the Context from the Page $context.

Definition at line 47 of file Action.php.

Referenced by __construct(), RawPage\__construct(), factory(), getActionName(), and getContext().

◆ $fields

array Action::$fields
protected

The fields used to create the HTMLForm $fields.

Definition at line 52 of file Action.php.

Referenced by FormAction\execute().

◆ $page


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