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

Inheritance diagram for Action:

[legend]

Collaboration diagram for Action:

[legend]

Public Member Functions
	__construct (Page $page, IContextSource $context=null)
	Only public since 1.21. More...

	addHelpLink ( $to, $overrideBaseUrl=false)
	Adds help link with an icon via page indicators. More...

	doesWrites ()
	Indicates whether this action may perform database writes. More...

	getArticle ()
	Get a Article object. More...

	getContext ()
	Get the IContextSource in use here. 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...

	getWikiPage ()
	Get a WikiPage object. More...

	msg ( $key,... $params)
	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 (string $name)
	Check if a given action is recognised, even if it's disabled. More...

static	factory (string $action, Article $article, 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...

	getHookContainer ()

	getHookRunner ()

	getPageTitle ()
	Returns the name that goes in the \<h1\> page title. More...

	setHeaders ()
	Set output headers for noindexing etc. More...

	useTransactionalTimeLimit ()
	Call wfTransactionalTimeLimit() if this request was POSTed. More...

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

array	$fields
	The fields used to create the HTMLForm. More...

WikiPage Article ImagePage CategoryPage Page	$page
	Page on which we're performing the action. More...

Static Private Member Functions
static	convertPageToArticle (Page $page, ?IContextSource $context, string $method)

Private Attributes
Article	$article

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.

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.

Stability: stable: to extend

Definition at line 43 of file Action.php.

Constructor & Destructor Documentation

◆ __construct()

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

Only public since 1.21.

Stability: stable: to call

Parameters

Article \| WikiPage \| Page	$page	Calling with anything other then Article is deprecated since 1.35
IContextSource \| null	$context

Reimplemented in MediaWiki\Actions\FileDeleteAction, and DeleteAction.

Definition at line 260 of file Action.php.

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

Member Function Documentation

◆ addHelpLink()

Action::addHelpLink	(	$to,
		$overrideBaseUrl = `false`
	)

Adds help link with an icon via page indicators.

Link target can be overridden by a local message containing a wikilink: the message key is: lowercase action name + '-helppage'.

Parameters

string	$to	Target MediaWiki.org page title or encoded URL.
bool	$overrideBaseUrl	Whether $url is a full URL, to avoid MW.o.

Since: 1.25

Definition at line 431 of file Action.php.

References $lang, $title, getName(), getOutput(), msg(), and Title\newFromText().

Referenced by HistoryAction\onView(), InfoAction\onView(), and DeleteAction\show().

◆ 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

Since: 1.17

Stability: stable: to override

Parameters

User $user

Exceptions

UserBlockedError|ReadOnlyError|PermissionsError

Reimplemented in WatchAction, RevertAction, and McrUndoAction.

Definition at line 329 of file Action.php.

References User\getBlock(), getLanguage(), getName(), getRequest(), getRestriction(), getTitle(), User\isBlockedFrom(), requiresUnblock(), requiresWrite(), and wfReadOnly().

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

◆ convertPageToArticle()

static Action::convertPageToArticle	(	Page	$page,
		?IContextSource	$context,
		string	$method
	)

staticprivate

Definition at line 273 of file Action.php.

References $context, $page, RequestContext\getMain(), Article\newFromWikiPage(), and wfDeprecated().

Referenced by __construct().

◆ doesWrites()

Action::doesWrites ( )

Indicates whether this action may perform database writes.

Returns: bool

Since: 1.27

Stability: stable: to override

Reimplemented in WatchAction, UnwatchAction, UnprotectAction, SpecialPageAction, RollbackAction, RevertAction, PurgeAction, ProtectAction, MarkpatrolledAction, FormAction, EditAction, and DeleteAction.

Definition at line 472 of file Action.php.

◆ exists()

static Action::exists ( string $name )

staticfinal

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

Since: 1.17

Parameters

string $name Name of an action

Returns: bool

Definition at line 121 of file Action.php.

Referenced by MediaWiki\Permissions\PermissionManager\checkUserBlock(), HistoryAction\fetchRevisions(), HistoryAction\onView(), and InfoAction\pageInfo().

◆ factory()

static Action::factory	(	string	$action,
		Article	$article,
		IContextSource	$context = `null`
	)

staticfinal

Get an appropriate Action subclass for the given action.

Since: 1.17

Parameters

string	$action
Article	$article
IContextSource \| null	$context	Falls back to article's context

Returns: Action|bool|null False if the action is disabled, null if it is not recognised

Definition at line 85 of file Action.php.

References $article, $context, and Article\getContext().

Referenced by MediaWiki\Permissions\PermissionManager\checkUserBlock(), RebuildFileCache\execute(), Skin\getFooterLinks(), and MediaWiki\performAction().

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

References $context.

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

◆ getArticle()

Action::getArticle ( )

Get a Article object.

Since: 1.35 Overriding this method is deprecated since 1.35

Returns: Article|ImagePage|CategoryPage

Definition at line 206 of file Action.php.

References $article.

Referenced by MediaWiki\Actions\FileDeleteAction\__construct(), getContext(), DeleteAction\getDefaultReason(), FormAction\getForm(), getWikiPage(), HistoryAction\onView(), InfoAction\onView(), InfoAction\pageInfo(), EditAction\show(), ProtectAction\show(), RenderAction\show(), UnprotectAction\show(), ViewAction\show(), DeleteAction\tempConfirmDelete(), and DeleteAction\tempDelete().

◆ getContext()

Action::getContext ( )

final

Get the IContextSource in use here.

Since: 1.17

Returns: IContextSource

Definition at line 132 of file Action.php.

References $context, getArticle(), and wfDebug().

Referenced by WatchAction\__construct(), HistoryAction\getDescription(), FormAction\getForm(), WatchAction\getFormFields(), getLanguage(), getOutput(), RawAction\getRawText(), getRequest(), getSkin(), getUser(), RollbackAction\handleRollbackRequest(), msg(), McrUndoAction\onSubmit(), UnwatchAction\onSubmit(), WatchAction\onSubmit(), WatchAction\onSuccess(), HistoryAction\onView(), InfoAction\onView(), RawAction\onView(), InfoAction\pageInfo(), MediaWiki\Actions\FileDeleteAction\prepareMessage(), DeleteAction\runExecuteChecks(), MediaWiki\Actions\FileDeleteAction\runExecuteChecks(), EditAction\show(), McrUndoAction\show(), ProtectAction\show(), SpecialPageAction\show(), MediaWiki\Actions\FileDeleteAction\showForm(), DeleteAction\showHistoryWarnings(), DeleteAction\showLogEntries(), DeleteAction\tempConfirmDelete(), DeleteAction\tempDelete(), and MediaWiki\Actions\FileDeleteAction\tempExecute().

◆ getDescription()

Action::getDescription ( )

protected

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

Since: 1.17

Stability: stable: to override

Returns: string HTML

Reimplemented in WatchAction, SpecialPageAction, RollbackAction, RevertAction, PurgeAction, McrUndoAction, McrRestoreAction, MarkpatrolledAction, InfoAction, HistoryAction, and CreditsAction.

Definition at line 419 of file Action.php.

References getName(), and msg().

Referenced by setHeaders().

◆ getHookContainer()

Action::getHookContainer ( )

protected

Since: 1.35

Access: internal: since 1.37

Returns: HookContainer

Definition at line 237 of file Action.php.

Referenced by getHookRunner().

◆ getHookRunner()

Action::getHookRunner ( )

protected

Since: 1.35

Access: internal: This is for use by core only. Hook interfaces may be removed without notice.

Returns: HookRunner

Definition at line 247 of file Action.php.

References getHookContainer().

Referenced by HistoryAction\getDescription(), FormAction\getForm(), HistoryAction\onView(), EditAction\show(), DeleteAction\tempConfirmDelete(), and DeleteAction\tempDelete().

◆ getLanguage()

Action::getLanguage ( )

final

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

Returns: Language

Definition at line 185 of file Action.php.

References getContext().

Referenced by checkCanExecute(), CreditsAction\getAuthor(), CreditsAction\getContributors(), HistoryAction\getDescription(), RevertAction\getFormFields(), InfoAction\getNamespaceProtectionMessage(), RevertAction\onSuccess(), and InfoAction\pageInfo().

◆ getName()

Action::getName ( )

abstract

Return the name of the action this object responds to.

Since: 1.17

Returns: string Lowercase name

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

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

◆ getOutput()

Action::getOutput ( )

final

Get the OutputPage being used for this instance.

Since: 1.17

Returns: OutputPage

Definition at line 156 of file Action.php.

References getContext().

Referenced by addHelpLink(), HistoryAction\feed(), RollbackAction\handleRollbackRequest(), MarkpatrolledAction\onSubmit(), McrUndoAction\onSuccess(), PurgeAction\onSuccess(), RevertAction\onSuccess(), UnwatchAction\onSuccess(), WatchAction\onSuccess(), CreditsAction\onView(), HistoryAction\onView(), InfoAction\onView(), RawAction\onView(), DeleteAction\prepareOutput(), DeleteAction\prepareOutputForForm(), setHeaders(), EditAction\show(), FormlessAction\show(), McrUndoAction\show(), ProtectAction\show(), ViewAction\show(), DeleteAction\showFormWarnings(), MediaWiki\Actions\FileDeleteAction\showFormWarnings(), and McrUndoAction\showPreview().

◆ getPageTitle()

Action::getPageTitle ( )

protected

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

Stability: stable: to override

Returns: string

Reimplemented in RevertAction, InfoAction, and HistoryAction.

Definition at line 408 of file Action.php.

References getTitle().

Referenced by setHeaders().

◆ getRequest()

Action::getRequest ( )

final

Get the WebRequest being used for this instance.

Since: 1.17

Returns: WebRequest

Definition at line 146 of file Action.php.

References getContext().

Referenced by MediaWiki\Actions\FileDeleteAction\__construct(), MarkpatrolledAction\alterForm(), RevertAction\alterForm(), RollbackAction\alterForm(), checkCanExecute(), RevertAction\checkCanExecute(), RollbackAction\enableTransactionalTimelimit(), HistoryAction\feed(), McrUndoAction\generateDiffOrPreview(), RawAction\getContentType(), DeleteAction\getDefaultReason(), MediaWiki\Actions\FileDeleteAction\getDefaultReason(), DeleteAction\getDeleteReason(), FormAction\getForm(), McrUndoAction\getFormFields(), RevertAction\getFormFields(), RawAction\getOldId(), RawAction\getRawText(), MarkpatrolledAction\getRecentChange(), RollbackAction\handleRollbackRequest(), McrRestoreAction\initFromParameters(), McrUndoAction\initFromParameters(), McrUndoAction\onSubmit(), RevertAction\onSubmit(), WatchAction\onSubmit(), RevertAction\onSuccess(), HistoryAction\onView(), RawAction\onView(), McrUndoAction\show(), PurgeAction\show(), and useTransactionalTimeLimit().

◆ getRestriction()

Action::getRestriction ( )

Get the permission required to perform this action.

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

Since: 1.17

Stability: stable: to override

Returns: string|null

Reimplemented in RollbackAction, RevertAction, and MarkpatrolledAction.

Definition at line 315 of file Action.php.

Referenced by checkCanExecute().

◆ getSkin()

Action::getSkin ( )

final

Shortcut to get the Skin being used for this instance.

Since: 1.17

Returns: Skin

Definition at line 176 of file Action.php.

References getContext().

◆ getTitle()

Action::getTitle ( )

final

Shortcut to get the Title object from the page.

Since: 1.17

Returns: Title

Definition at line 216 of file Action.php.

References getWikiPage().

Referenced by WatchAction\__construct(), McrUndoAction\alterForm(), RevertAction\alterForm(), checkCanExecute(), RevertAction\checkCanExecute(), HistoryAction\feed(), HistoryAction\feedEmpty(), HistoryAction\feedItem(), HistoryAction\fetchRevisions(), HistoryAction\getDescription(), RevertAction\getDescription(), FormAction\getForm(), DeleteAction\getFormAction(), RevertAction\getFormFields(), getPageTitle(), HistoryAction\getPageTitle(), InfoAction\getPageTitle(), RevertAction\getPageTitle(), RawAction\getRawText(), RollbackAction\handleRollbackRequest(), McrUndoAction\onSubmit(), RevertAction\onSubmit(), UnwatchAction\onSubmit(), WatchAction\onSubmit(), McrUndoAction\onSuccess(), PurgeAction\onSuccess(), RevertAction\onSuccess(), UnwatchAction\onSuccess(), WatchAction\onSuccess(), HistoryAction\onView(), RawAction\onView(), CreditsAction\othersLink(), InfoAction\pageInfo(), EditAction\show(), McrUndoAction\show(), MediaWiki\Actions\FileDeleteAction\showForm(), DeleteAction\showFormWarnings(), DeleteAction\showHistoryWarnings(), McrUndoAction\showPreview(), DeleteAction\tempConfirmDelete(), and DeleteAction\tempDelete().

◆ getUser()

Action::getUser ( )

final

Shortcut to get the User being used for this instance.

Since: 1.17

Returns: User

Definition at line 166 of file Action.php.

References getContext().

Referenced by WatchAction\__construct(), RevertAction\getFormFields(), RollbackAction\handleRollbackRequest(), MarkpatrolledAction\onSubmit(), RevertAction\onSubmit(), RevertAction\onSuccess(), HistoryAction\onView(), RawAction\onView(), InfoAction\pageInfo(), EditAction\show(), FormAction\show(), FormlessAction\show(), and PurgeAction\show().

◆ getWikiPage()

Action::getWikiPage ( )

final

Get a WikiPage object.

Since: 1.35

Returns: WikiPage

Definition at line 195 of file Action.php.

References getArticle().

Referenced by HistoryAction\fetchRevisions(), CreditsAction\getAuthor(), CreditsAction\getContributors(), RevertAction\getFile(), RawAction\getOldId(), getTitle(), RollbackAction\handleRollbackRequest(), McrRestoreAction\initFromParameters(), McrUndoAction\initFromParameters(), McrUndoAction\onSubmit(), PurgeAction\onSubmit(), CreditsAction\onView(), HistoryAction\onView(), RawAction\onView(), InfoAction\pageCounts(), InfoAction\pageInfo(), ViewAction\show(), McrUndoAction\showPreview(), and DeleteAction\tempDelete().

◆ msg()

Action::msg	(	$key,
		$params
	)

final

Get a Message object with context set Parameters are the same as wfMessage()

Parameters

string \| string[] \| MessageSpecifier	$key
	mixed	...$params

Returns: Message

Implements MessageLocalizer.

Definition at line 228 of file Action.php.

References getContext().

Referenced by addHelpLink(), RevertAction\checkCanExecute(), HistoryAction\feed(), HistoryAction\feedEmpty(), HistoryAction\feedItem(), CreditsAction\getAuthor(), CreditsAction\getContributors(), DeleteAction\getDeleteReason(), getDescription(), CreditsAction\getDescription(), HistoryAction\getDescription(), PurgeAction\getFormFields(), RevertAction\getFormFields(), RollbackAction\getFormFields(), UnwatchAction\getFormFields(), WatchAction\getFormFields(), DeleteAction\getFormMsg(), InfoAction\getNamespaceProtectionMessage(), HistoryAction\getPageTitle(), InfoAction\getPageTitle(), RevertAction\getPageTitle(), RollbackAction\handleRollbackRequest(), MarkpatrolledAction\onSubmit(), CreditsAction\onView(), HistoryAction\onView(), InfoAction\onView(), CreditsAction\othersLink(), InfoAction\pageInfo(), PurgeAction\postText(), HistoryAction\preCacheMessages(), MarkpatrolledAction\preText(), SpecialPageAction\show(), DeleteAction\tempDelete(), and CreditsAction\userLink().

◆ requiresUnblock()

Action::requiresUnblock ( )

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

Since: 1.17

Stability: stable: to override

Returns: bool

Reimplemented in WatchAction, SpecialPageAction, RawAction, InfoAction, and HistoryAction.

Definition at line 384 of file Action.php.

Referenced by checkCanExecute().

◆ requiresWrite()

Action::requiresWrite ( )

Whether this action requires the wiki not to be locked.

Since: 1.17

Stability: stable: to override

Returns: bool

Reimplemented in RawAction, InfoAction, and HistoryAction.

Definition at line 373 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.

Stability: stable: to override

Since: 1.17

Definition at line 394 of file Action.php.

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

Referenced by FormAction\show(), FormlessAction\show(), and PurgeAction\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.

Since: 1.17

Exceptions

ErrorPageError

Reimplemented in ViewAction, UnprotectAction, SubmitAction, SpecialPageAction, RollbackAction, RenderAction, PurgeAction, ProtectAction, McrUndoAction, FormlessAction, FormAction, EditAction, and DeleteAction.

◆ useTransactionalTimeLimit()

Action::useTransactionalTimeLimit ( )

protected

Call wfTransactionalTimeLimit() if this request was POSTed.

Since: 1.26

Definition at line 460 of file Action.php.

References getRequest(), and wfTransactionalTimeLimit().

Referenced by RevertAction\onSubmit(), DeleteAction\show(), EditAction\show(), and McrUndoAction\show().

Member Data Documentation

◆ $article

Article Action::$article

private

Since: 1.35

Definition at line 59 of file Action.php.

Referenced by factory(), getArticle(), EditAction\show(), and DeleteAction\tempDelete().

◆ $context

IContextSource Action::$context

protected

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

Since: 1.17

Definition at line 66 of file Action.php.

Referenced by RollbackAction\__construct(), RawAction\__construct(), InfoAction\__construct(), RevertAction\__construct(), MarkpatrolledAction\__construct(), CreditsAction\__construct(), McrUndoAction\__construct(), SpecialPageAction\__construct(), UnwatchAction\__construct(), WatchAction\__construct(), __construct(), DeleteAction\__construct(), MediaWiki\Actions\FileDeleteAction\__construct(), convertPageToArticle(), factory(), getActionName(), getContext(), DeleteAction\showHistoryWarnings(), DeleteAction\tempDelete(), and MediaWiki\Actions\FileDeleteAction\tempExecute().

◆ $fields

array Action::$fields

protected

The fields used to create the HTMLForm.

Since: 1.17

Definition at line 73 of file Action.php.

Referenced by HistoryAction\onView(), MediaWiki\Actions\FileDeleteAction\showForm(), and DeleteAction\tempConfirmDelete().

◆ $page

WikiPage Article ImagePage CategoryPage Page Action::$page

protected

Page on which we're performing the action.

Since: 1.17

Deprecated:: since 1.35, use getArticle() ?? getWikiPage(). Must be removed.

Access: internal

Definition at line 53 of file Action.php.

Referenced by RollbackAction\__construct(), RawAction\__construct(), InfoAction\__construct(), RevertAction\__construct(), MarkpatrolledAction\__construct(), CreditsAction\__construct(), McrUndoAction\__construct(), SpecialPageAction\__construct(), UnwatchAction\__construct(), WatchAction\__construct(), __construct(), DeleteAction\__construct(), MediaWiki\Actions\FileDeleteAction\__construct(), convertPageToArticle(), CreditsAction\getAuthor(), InfoAction\getCacheKey(), InfoAction\invalidateCache(), and InfoAction\pageCounts().

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

includes/actions/Action.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addHelpLink()

◆ checkCanExecute()

◆ convertPageToArticle()

◆ doesWrites()

◆ exists()

◆ factory()

◆ getActionName()

◆ getArticle()

◆ getContext()

◆ getDescription()

◆ getHookContainer()

◆ getHookRunner()

◆ getLanguage()

◆ getName()

◆ getOutput()

◆ getPageTitle()

◆ getRequest()

◆ getRestriction()

◆ getSkin()

◆ getTitle()

◆ getUser()

◆ getWikiPage()

◆ msg()

◆ requiresUnblock()

◆ requiresWrite()

◆ setHeaders()

◆ show()

◆ useTransactionalTimeLimit()

Member Data Documentation

◆ $article

◆ $context

◆ $fields

◆ $page