44141e3a72
Support for OOUI is added to FormAction, and subclasses can enable it as required. PurgeAction, RevertAction, WatchAction and UnwatchAction are converted to OOUI, with minor changes to the forms to give them a neater appearance. Bug: T160236 Change-Id: I5294e5d886e8641e9b63eabc9d7fa8ea93e0df96
146 lines
4 KiB
PHP
146 lines
4 KiB
PHP
<?php
|
|
/**
|
|
* Base classes for actions done on pages.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|
|
*
|
|
* @file
|
|
* @ingroup Actions
|
|
*/
|
|
|
|
/**
|
|
* An action which shows a form and does something based on the input from the form
|
|
*
|
|
* @ingroup Actions
|
|
*/
|
|
abstract class FormAction extends Action {
|
|
|
|
/**
|
|
* Get an HTMLForm descriptor array
|
|
* @return array
|
|
*/
|
|
protected function getFormFields() {
|
|
// Default to an empty form with just a submit button
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Add pre- or post-text to the form
|
|
* @return string HTML which will be sent to $form->addPreText()
|
|
*/
|
|
protected function preText() {
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
protected function postText() {
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Play with the HTMLForm if you need to more substantially
|
|
* @param HTMLForm $form
|
|
*/
|
|
protected function alterForm( HTMLForm $form ) {
|
|
}
|
|
|
|
/**
|
|
* Whether the form should use OOUI
|
|
* @return bool
|
|
*/
|
|
protected function usesOOUI() {
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Get the HTMLForm to control behavior
|
|
* @return HTMLForm|null
|
|
*/
|
|
protected function getForm() {
|
|
$this->fields = $this->getFormFields();
|
|
|
|
// Give hooks a chance to alter the form, adding extra fields or text etc
|
|
Hooks::run( 'ActionModifyFormFields', [ $this->getName(), &$this->fields, $this->page ] );
|
|
|
|
if ( $this->usesOOUI() ) {
|
|
$form = HTMLForm::factory( 'ooui', $this->fields, $this->getContext(), $this->getName() );
|
|
} else {
|
|
$form = new HTMLForm( $this->fields, $this->getContext(), $this->getName() );
|
|
}
|
|
$form->setSubmitCallback( [ $this, 'onSubmit' ] );
|
|
|
|
$title = $this->getTitle();
|
|
$form->setAction( $title->getLocalURL( [ 'action' => $this->getName() ] ) );
|
|
// Retain query parameters (uselang etc)
|
|
$params = array_diff_key(
|
|
$this->getRequest()->getQueryValues(),
|
|
[ 'action' => null, 'title' => null ]
|
|
);
|
|
if ( $params ) {
|
|
$form->addHiddenField( 'redirectparams', wfArrayToCgi( $params ) );
|
|
}
|
|
|
|
$form->addPreText( $this->preText() );
|
|
$form->addPostText( $this->postText() );
|
|
$this->alterForm( $form );
|
|
|
|
// Give hooks a chance to alter the form, adding extra fields or text etc
|
|
Hooks::run( 'ActionBeforeFormDisplay', [ $this->getName(), &$form, $this->page ] );
|
|
|
|
return $form;
|
|
}
|
|
|
|
/**
|
|
* Process the form on POST submission.
|
|
*
|
|
* If you don't want to do anything with the form, just return false here.
|
|
*
|
|
* @param array $data
|
|
* @return bool|array True for success, false for didn't-try, array of errors on failure
|
|
*/
|
|
abstract public function onSubmit( $data );
|
|
|
|
/**
|
|
* 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).
|
|
*/
|
|
abstract public function onSuccess();
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
public function show() {
|
|
$this->setHeaders();
|
|
|
|
// This will throw exceptions if there's a problem
|
|
$this->checkCanExecute( $this->getUser() );
|
|
|
|
$form = $this->getForm();
|
|
if ( $form->show() ) {
|
|
$this->onSuccess();
|
|
}
|
|
}
|
|
|
|
public function doesWrites() {
|
|
return true;
|
|
}
|
|
}
|