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. | |
| 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. | |
Protected Member Functions | |
| alterForm (HTMLForm $form) | |
| Play with the HTMLForm if you need to more substantially. | |
| getForm () | |
| Get the HTMLForm to control behavior. | |
| getFormFields () | |
| Get an HTMLForm descriptor array. | |
| postText () | |
| preText () | |
| Add pre- or post-text to the form. | |
Detailed Description
An action which shows a form and does something based on the input from the form.
Definition at line 382 of file Action.php.
Member Function Documentation
| FormAction::alterForm | ( | HTMLForm $ | form | ) | [protected] |
Play with the HTMLForm if you need to more substantially.
- Parameters:
-
$form HTMLForm
Reimplemented in UnwatchAction, WatchAction, PurgeAction, and RevertFileAction.
Definition at line 409 of file Action.php.
| FormAction::execute | ( | array $ | data = null, |
| $ | captureErrors = true |
||
| ) |
- See also:
- Action::execute()
- Parameters:
-
$data array|null $captureErrors bool
- Exceptions:
-
ErrorPageError|Exception
- Returns:
- bool
Definition at line 486 of file Action.php.
| FormAction::getForm | ( | ) | [protected] |
Get the HTMLForm to control behavior.
- Returns:
- HTMLForm|null
Definition at line 416 of file Action.php.
Referenced by WatchAction\show(), and PurgeAction\show().
| FormAction::getFormFields | ( | ) | [abstract, protected] |
Get an HTMLForm descriptor array.
- Returns:
- Array
Reimplemented in RevertFileAction, PurgeAction, and WatchAction.
| FormAction::onSubmit | ( | $ | data | ) | [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
- Parameters:
-
$data Array
- Returns:
- Bool|Array true for success, false for didn't-try, array of errors on failure
Reimplemented in UnwatchAction, RevertFileAction, PurgeAction, and WatchAction.
| FormAction::onSuccess | ( | ) | [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.
| FormAction::postText | ( | ) | [protected] |
| FormAction::preText | ( | ) | [protected] |
Add pre- or post-text to the form.
- Returns:
- String HTML which will be sent to $form->addPreText()
Reimplemented in UnwatchAction, WatchAction, and PurgeAction.
Definition at line 394 of file Action.php.
| 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 466 of file Action.php.
The documentation for this class was generated from the following file:
- includes/Action.php
