SpecialRedirectWithAction.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\SpecialPage;
 
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\Search\SearchEngineFactory;
use MediaWiki\Title\Title;
 
abstract class SpecialRedirectWithAction extends RedirectSpecialPage {
    protected $action;
 
    protected $msgPrefix;
 
    public function __construct(
        $name,
        $action,
        $msgPrefix,
        private readonly SearchEngineFactory $searchEngineFactory,
    ) {
        parent::__construct( $name );
        $this->action = $action;
        $this->msgPrefix = $msgPrefix;
    }
 
    public function getRedirect( $subpage ) {
        if ( $subpage === null || $subpage === '' ) {
            return false;
        }
        $this->mAddedRedirectParams['title'] = $subpage;
        $this->mAddedRedirectParams['action'] = $this->action;
        return true;
    }
 
    protected function showNoRedirectPage() {
        $this->setHeaders();
        $this->outputHeader();
        $this->showForm();
    }
 
    private function showForm() {
        // Dynamic messages used:
        // 'special' . $this->msgPrefix . '-page'
        // 'special' . $this->msgPrefix . '-submit'
        // Each special page that extends this should include those as comments for grep
        $form = HTMLForm::factory( 'ooui', [
            'page' => [
                'type' => 'title',
                'name' => 'page',
                'label-message' => 'special' . $this->msgPrefix . '-page',
                'required' => true,
                'creatable' => true,
            ],
        ], $this->getContext(), $this->msgPrefix );
        $form->setSubmitTextMsg( 'special' . $this->msgPrefix . '-submit' );
        $form->setSubmitCallback( $this->onFormSubmit( ... ) );
        $form->show();
    }
 
    public function onFormSubmit( $formData ) {
        $title = $formData['page'];
        $page = Title::newFromText( $title );
        $query = [ 'action' => $this->action ];
        $url = $page->getFullUrlForRedirect( $query );
        $this->getOutput()->redirect( $url );
    }
 
    public function isListed() {
        return true;
    }
 
    public function prefixSearchSubpages( $search, $limit, $offset ) {
        return $this->prefixSearchString( $search, $limit, $offset, $this->searchEngineFactory );
    }
 
    protected function getGroupName() {
        return 'redirects';
    }
}
 
// @codeCoverageIgnoreStart
class_alias( SpecialRedirectWithAction::class, 'SpecialRedirectWithAction' );
// @codeCoverageIgnoreEnd