SpecialTalkPage.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials\Redirects;
 
use MediaWiki\Config\Config;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\MainConfigNames;
use MediaWiki\SpecialPage\FormSpecialPage;
use MediaWiki\Status\Status;
use MediaWiki\Title\MalformedTitleException;
use MediaWiki\Title\Title;
use MediaWiki\Title\TitleParser;
 
class SpecialTalkPage extends FormSpecialPage {
 
    private Config $config;
    private TitleParser $titleParser;
 
    public function __construct( Config $config, TitleParser $titleParser ) {
        parent::__construct( 'TalkPage' );
        $this->config = $config;
        $this->titleParser = $titleParser;
    }
 
    protected function getFormFields() {
        return [
            'target' => [
                'type' => 'title',
                'name' => 'target',
                'label-message' => 'special-talkpage-target',
                'default' => $this->par,
            ],
        ];
    }
 
    protected function alterForm( HTMLForm $form ) {
        if ( $this->par ) { // immediately submit with subpage value
            $form->setMethod( 'get' );
        }
        $form->setSubmitTextMsg( 'special-talkpage-submit' );
    }
 
    public function onSubmit( array $formData ) {
        $target = $formData['target'];
        try {
            $title = $this->titleParser->parseTitle( $target );
        } catch ( MalformedTitleException $e ) {
            return Status::newFatal( $e->getMessageObject() );
        }
        $title = Title::newFromLinkTarget( $title );
        $talk = $title->getTalkPageIfDefined();
        if ( $talk === null ) {
            return Status::newFatal( 'title-invalid-talk-namespace' );
        }
 
        // HTTP 302: Found; cache for the Parser Cache length, as an appropriate long time
        $this->getOutput()->redirect( $talk->getFullUrlForRedirect(), '302' );
        $this->getOutput()->enableClientCache();
        $this->getOutput()->setCdnMaxage(
            $this->config->get( MainConfigNames::ParserCacheExpireTime )
        );
        return true;
    }
 
    protected function getDisplayFormat() {
        return 'ooui';
    }
 
    public function requiresWrite() {
        return false;
    }
 
    public function requiresUnblock() {
        return false;
    }
 
    public function isListed() {
        return false;
    }
 
    protected function getMessagePrefix() {
        return 'special-talkpage';
    }
 
    public function getDescription() {
        // "talkpage" is already taken by CologneBlue
        return $this->msg( 'special-talkpage' );
    }
 
}