MediaWiki
1.23.2
|
An action which shows a form and does something based on the input from the form. More...
Public Member Functions | |
execute (array $data=null, $captureErrors=true) | |
onSubmit ( $data) | |
Process the form on POST submission. More... | |
onSuccess () | |
Do something exciting on successful processing of the form. More... | |
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. More... | |
Public Member Functions inherited from Action | |
__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... | |
Protected Member Functions | |
alterForm (HTMLForm $form) | |
Play with the HTMLForm if you need to more substantially. More... | |
getForm () | |
Get the HTMLForm to control behavior. More... | |
getFormFields () | |
Get an HTMLForm descriptor array. More... | |
postText () | |
preText () | |
Add pre- or post-text to the form. More... | |
Protected Member Functions inherited from Action | |
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... | |
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. 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 Attributes inherited from Action | |
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... | |
An action which shows a form and does something based on the input from the form.
Definition at line 29 of file FormAction.php.
|
protected |
Play with the HTMLForm if you need to more substantially.
HTMLForm | $form |
Reimplemented in UnwatchAction, WatchAction, PurgeAction, and RevertFileAction.
Definition at line 56 of file FormAction.php.
Referenced by getForm().
array | null | $data | |
bool | $captureErrors |
ErrorPageError|Exception |
Definition at line 133 of file FormAction.php.
References $e, Action\$fields, $params, array(), as, Action\checkCanExecute(), Action\getContext(), Action\getUser(), onSubmit(), and onSuccess().
|
protected |
Get the HTMLForm to control behavior.
Definition at line 63 of file FormAction.php.
References $form, $params, alterForm(), array(), Action\getContext(), getFormFields(), Action\getName(), Action\getRequest(), page, postText(), preText(), wfArrayToCgi(), and wfRunHooks().
Referenced by WatchAction\show(), PurgeAction\show(), and show().
|
abstractprotected |
Get an HTMLForm descriptor array.
Reimplemented in RevertFileAction, PurgeAction, and WatchAction.
Referenced by getForm().
|
abstract |
Process the form on POST submission.
If you return false from getFormFields(), this will obviously never be reached. If you don't want to do anything with the form, just return false here
array | $data |
Reimplemented in UnwatchAction, RevertFileAction, PurgeAction, and WatchAction.
Referenced by execute().
|
abstract |
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 in UnwatchAction, WatchAction, RevertFileAction, and PurgeAction.
|
protected |
Reimplemented in PurgeAction.
Definition at line 48 of file FormAction.php.
Referenced by getForm().
|
protected |
Add pre- or post-text to the form.
Reimplemented in UnwatchAction, WatchAction, and PurgeAction.
Definition at line 41 of file FormAction.php.
Referenced by getForm().
FormAction::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 Action.
Reimplemented in PurgeAction, and WatchAction.
Definition at line 113 of file FormAction.php.
References $form, Action\checkCanExecute(), getForm(), Action\getUser(), onSuccess(), and Action\setHeaders().