Temporary action for MCR undos. More...

Inheritance diagram for McrUndoAction:

[legend]

Collaboration diagram for McrUndoAction:

[legend]

Public Member Functions
	getDescription ()
	Returns the description that goes below the \<h1\> tag.

	getName ()
	Return the name of the action this object responds to.

	getRestriction ()
	Get the permission required to perform this action.

	onSubmit ( $data)
	Process the form on POST submission.

	onSuccess ()
	Do something exciting on successful processing of the form.

	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 FormAction
	doesWrites ()
	Stable to override.

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

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

	getArticle ()
	Get a Article object.

	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.

	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.

	getWikiPage ()
	Get a WikiPage object.

	msg ( $key,... $params)
	Get a Message object with context set Parameters are the same as wfMessage()

	needsReadRights ()
	Indicates whether this action requires read rights.

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

	requiresWrite ()
	Whether this action requires the wiki not to be locked.

Protected Member Functions
	addStatePropagationFields (HTMLForm $form)

	alterForm (HTMLForm $form)
	Play with the HTMLForm if you need to more substantially Stable to override.

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

	getFormFields ()
	Get an HTMLForm descriptor array Stable to override.

	initFromParameters ()

	preText ()
	Add pre- or post-text to the form Stable to override.

	usesOOUI ()
	Whether the form should use OOUI Stable to override.

Protected Member Functions inherited from FormAction
	getForm ()
	Get the HTMLForm to control behavior Stable to override.

	postText ()
	Stable to override.

Protected Member Functions inherited from Action
	getHookContainer ()

	getHookRunner ()

	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.

Protected Attributes
	$cur = 0

RevisionRecord null	$curRev = null

	$undo = 0

	$undoafter = 0

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

array	$fields
	The fields used to create the HTMLForm.

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

Private Member Functions
	generateDiffOrPreview ()

	getNewRevision ()

	showPreview (RevisionRecord $rev)

Additional Inherited Members
Static Public Member Functions inherited from Action
static	exists (string $name)
	Check if a given action is recognised, even if it's disabled.

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

Detailed Description

Temporary action for MCR undos.

This is intended to go away when real MCR support is added to EditPage and the standard undo-with-edit behavior can be implemented there instead.

If this were going to be kept, we'd probably want to figure out a good way to reuse the same code for generating the headers, summary box, and buttons on EditPage and here, and to better share the diffing and preview logic between the two. But doing that now would require much of the rewriting of EditPage that we're trying to put off by doing this instead.

Since: 1.32

Deprecated:: since 1.32

Definition at line 30 of file McrUndoAction.php.

Member Function Documentation

◆ addStatePropagationFields()

McrUndoAction::addStatePropagationFields ( HTMLForm $form )

protected

Reimplemented in McrRestoreAction.

Definition at line 496 of file McrUndoAction.php.

References HTMLForm\addHiddenField().

Referenced by alterForm().

◆ alterForm()

McrUndoAction::alterForm ( HTMLForm $form )

protected

Play with the HTMLForm if you need to more substantially Stable to override.

Parameters

HTMLForm $form

Reimplemented from FormAction.

Reimplemented in McrRestoreAction.

Definition at line 469 of file McrUndoAction.php.

References HTMLForm\addButton(), addStatePropagationFields(), Action\getTitle(), HTMLForm\setCancelTarget(), HTMLForm\setId(), HTMLForm\setSubmitName(), HTMLForm\setSubmitTextMsg(), HTMLForm\setSubmitTooltip(), HTMLForm\setWrapperLegendMsg(), HTMLForm\showCancel(), and Linker\tooltipAndAccesskeyAttribs().

◆ checkCanExecute()

McrUndoAction::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 Stable to override

Parameters

User $user

Exceptions

UserBlockedError|ReadOnlyError|PermissionsError

Reimplemented from Action.

Definition at line 115 of file McrUndoAction.php.

References $title, Action\getTitle(), and initFromParameters().

◆ generateDiffOrPreview()

McrUndoAction::generateDiffOrPreview ( )

private

Definition at line 234 of file McrUndoAction.php.

References getNewRevision(), Action\getRequest(), and showPreview().

Referenced by getFormFields().

◆ getDescription()

McrUndoAction::getDescription ( )

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

Since: 1.17 Stable to override

Returns: string HTML

Reimplemented from Action.

Reimplemented in McrRestoreAction.

Definition at line 41 of file McrUndoAction.php.

◆ getFormFields()

McrUndoAction::getFormFields ( )

protected

Get an HTMLForm descriptor array Stable to override.

Returns: array

Reimplemented from FormAction.

Definition at line 429 of file McrUndoAction.php.

References Linker\commentBlock(), generateDiffOrPreview(), and Action\getRequest().

◆ getName()

McrUndoAction::getName ( )

Return the name of the action this object responds to.

Since: 1.17

Returns: string Lowercase name

Reimplemented from Action.

Reimplemented in McrRestoreAction.

Definition at line 37 of file McrUndoAction.php.

◆ getNewRevision()

McrUndoAction::getNewRevision ( )

private

Returns: MutableRevisionRecord

Definition at line 140 of file McrUndoAction.php.

References $curRev, MediaWiki\Revision\RevisionRecord\getId(), MediaWiki\Revision\RevisionRecord\getSlot(), MediaWiki\Revision\RevisionRecord\getSlotRoles(), MediaWiki\Revision\RevisionRecord\getSlots(), and MediaWiki\Revision\RevisionRecord\hasSlot().

Referenced by generateDiffOrPreview(), and onSubmit().

◆ getRestriction()

McrUndoAction::getRestriction ( )

Get the permission required to perform this action.

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

Since: 1.17 Stable to override

Returns: string|null

Reimplemented from Action.

Definition at line 45 of file McrUndoAction.php.

◆ initFromParameters()

McrUndoAction::initFromParameters ( )

protected

Reimplemented in McrRestoreAction.

Definition at line 99 of file McrUndoAction.php.

References $curRev, Action\getRequest(), and Action\getWikiPage().

Referenced by checkCanExecute().

◆ onSubmit()

McrUndoAction::onSubmit ( $data )

Process the form on POST submission.

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

This method will be passed to the HTMLForm as a submit callback (see HTMLForm::setSubmitCallback) and must return as documented for HTMLForm::trySubmit.

See also: HTMLForm::setSubmitCallback(); HTMLForm::trySubmit()

Parameters

array $data

Returns: bool|string|array|Status Must return as documented for HTMLForm::trySubmit

Reimplemented from FormAction.

Definition at line 313 of file McrUndoAction.php.

References $curRev, $wgUseRCPatrol, EDIT_AUTOSUMMARY, EDIT_UPDATE, Action\getContext(), MediaWiki\Revision\RevisionRecord\getId(), getNewRevision(), Action\getRequest(), MediaWiki\Revision\RevisionRecord\getSlotRoles(), Action\getUser(), and Action\getWikiPage().

◆ onSuccess()

McrUndoAction::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 502 of file McrUndoAction.php.

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

◆ preText()

McrUndoAction::preText ( )

protected

Add pre- or post-text to the form Stable to override.

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

Reimplemented from FormAction.

Definition at line 506 of file McrUndoAction.php.

◆ show()

McrUndoAction::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 Stable to override

Reimplemented from FormAction.

Definition at line 50 of file McrUndoAction.php.

References Action\getContext(), Action\getOutput(), Action\getRequest(), Action\getTitle(), SpecialPage\getTitleFor(), Action\useTransactionalTimeLimit(), wfReadOnly(), and wfReadOnlyReason().

◆ showPreview()

McrUndoAction::showPreview ( RevisionRecord $rev )

private

Definition at line 256 of file McrUndoAction.php.

References Action\getOutput(), Action\getTitle(), MediaWiki\Revision\RevisionRecord\getUser(), and Action\getWikiPage().

Referenced by generateDiffOrPreview().

◆ usesOOUI()

McrUndoAction::usesOOUI ( )

protected

Whether the form should use OOUI Stable to override.

Returns: bool

Reimplemented from FormAction.

Definition at line 425 of file McrUndoAction.php.

Member Data Documentation

◆ $cur

McrUndoAction::$cur = 0

protected

Definition at line 32 of file McrUndoAction.php.

Referenced by McrRestoreAction\initFromParameters().

◆ $curRev

RevisionRecord null McrUndoAction::$curRev = null

protected

Definition at line 35 of file McrUndoAction.php.

Referenced by getNewRevision(), McrRestoreAction\initFromParameters(), initFromParameters(), and onSubmit().

◆ $undo

McrUndoAction::$undo = 0

protected

Definition at line 32 of file McrUndoAction.php.

◆ $undoafter

McrUndoAction::$undoafter = 0

protected

Definition at line 32 of file McrUndoAction.php.

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

includes/actions/McrUndoAction.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addStatePropagationFields()

◆ alterForm()

◆ checkCanExecute()

◆ generateDiffOrPreview()

◆ getDescription()

◆ getFormFields()

◆ getName()

◆ getNewRevision()

◆ getRestriction()

◆ initFromParameters()

◆ onSubmit()

◆ onSuccess()

◆ preText()

◆ show()

◆ showPreview()

◆ usesOOUI()

Member Data Documentation

◆ $cur

◆ $curRev

◆ $undo

◆ $undoafter