FormSpecialPage.php

Go to the documentation of this file.

<?php
abstract class FormSpecialPage extends SpecialPage {
    protected $par = null;

    abstract protected function getFormFields();

    protected function preText() {
        return '';
    }

    protected function postText() {
        return '';
    }

    protected function alterForm( HTMLForm $form ) {
    }

    protected function getMessagePrefix() {
        return strtolower( $this->getName() );
    }

    protected function getForm() {
        $this->fields = $this->getFormFields();

        $form = new HTMLForm( $this->fields, $this->getContext(), $this->getMessagePrefix() );
        $form->setSubmitCallback( array( $this, 'onSubmit' ) );
        // If the form is a compact vertical form, then don't output this ugly
        // fieldset surrounding it.
        // XXX Special pages can setDisplayFormat to 'vform' in alterForm(), but that
        // is called after this.
        if ( !$form->isVForm() ) {
            $form->setWrapperLegendMsg( $this->getMessagePrefix() . '-legend' );
        }

        $headerMsg = $this->msg( $this->getMessagePrefix() . '-text' );
        if ( !$headerMsg->isDisabled() ) {
            $form->addHeaderText( $headerMsg->parseAsBlock() );
        }

        // Retain query parameters (uselang etc)
        $params = array_diff_key(
            $this->getRequest()->getQueryValues(), array( 'title' => null ) );
        $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
        wfRunHooks( 'SpecialPageBeforeFormDisplay', array( $this->getName(), &$form ) );

        return $form;
    }

    abstract public function onSubmit( array $data /* $form = null */ );

    public function onSuccess() {
    }

    public function execute( $par ) {
        $this->setParameter( $par );
        $this->setHeaders();

        // This will throw exceptions if there's a problem
        $this->checkExecutePermissions( $this->getUser() );

        $form = $this->getForm();
        if ( $form->show() ) {
            $this->onSuccess();
        }
    }

    protected function setParameter( $par ) {
        $this->par = $par;
    }

    protected function checkExecutePermissions( User $user ) {
        $this->checkPermissions();

        if ( $this->requiresUnblock() && $user->isBlocked() ) {
            $block = $user->getBlock();
            throw new UserBlockedError( $block );
        }

        if ( $this->requiresWrite() ) {
            $this->checkReadOnly();
        }

        return true;
    }

    public function requiresWrite() {
        return true;
    }

    public function requiresUnblock() {
        return true;
    }
}