SpecialExpandTemplates.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;

class SpecialExpandTemplates extends SpecialPage {

    protected $generateXML;

    protected $generateRawHtml;

    protected $removeComments;

    protected $removeNowiki;

    const MAX_INCLUDE_SIZE = 50000000;

    function __construct() {
        parent::__construct( 'ExpandTemplates' );
    }

    function execute( $subpage ) {
        $this->setHeaders();
        $this->addHelpLink( 'Help:ExpandTemplates' );

        $request = $this->getRequest();
        $titleStr = $request->getText( 'wpContextTitle' );
        $title = Title::newFromText( $titleStr );

        if ( !$title ) {
            $title = $this->getPageTitle();
        }
        $input = $request->getText( 'wpInput' );
        $this->generateXML = $request->getBool( 'wpGenerateXml' );
        $this->generateRawHtml = $request->getBool( 'wpGenerateRawHtml' );

        if ( strlen( $input ) ) {
            $this->removeComments = $request->getBool( 'wpRemoveComments', false );
            $this->removeNowiki = $request->getBool( 'wpRemoveNowiki', false );
            $options = ParserOptions::newFromContext( $this->getContext() );
            $options->setRemoveComments( $this->removeComments );
            $options->setTidy( true );
            $options->setMaxIncludeSize( self::MAX_INCLUDE_SIZE );

            $parser = MediaWikiServices::getInstance()->getParser();
            if ( $this->generateXML ) {
                $parser->startExternalParse( $title, $options, Parser::OT_PREPROCESS );
                $dom = $parser->preprocessToDom( $input );

                if ( method_exists( $dom, 'saveXML' ) ) {
                    // @phan-suppress-next-line PhanUndeclaredMethod
                    $xml = $dom->saveXML();
                } else {
                    // @phan-suppress-next-line PhanUndeclaredMethod
                    $xml = $dom->__toString();
                }
            }

            $output = $parser->preprocess( $input, $title, $options );
        } else {
            $this->removeComments = $request->getBool( 'wpRemoveComments', true );
            $this->removeNowiki = $request->getBool( 'wpRemoveNowiki', false );
            $output = false;
        }

        $out = $this->getOutput();

        $this->makeForm( $titleStr, $input );

        if ( $output !== false ) {
            if ( $this->generateXML && strlen( $output ) > 0 ) {
                $out->addHTML( $this->makeOutput( $xml, 'expand_templates_xml_output' ) );
            }

            $tmp = $this->makeOutput( $output );

            if ( $this->removeNowiki ) {
                $tmp = preg_replace(
                    [ '_&lt;nowiki&gt;_', '_&lt;/nowiki&gt;_', '_&lt;nowiki */&gt;_' ],
                    '',
                    $tmp
                );
            }

            $config = $this->getConfig();
            if ( MWTidy::isEnabled() && $options->getTidy() ) {
                $tmp = MWTidy::tidy( $tmp );
            } else {
                wfDeprecated( 'disabling tidy', '1.33' );
            }

            $out->addHTML( $tmp );

            $pout = $this->generateHtml( $title, $output );
            $rawhtml = $pout->getText();
            if ( $this->generateRawHtml && strlen( $rawhtml ) > 0 ) {
                $out->addHTML( $this->makeOutput( $rawhtml, 'expand_templates_html_output' ) );
            }

            $this->showHtmlPreview( $title, $pout, $out );
        }
    }

    public function onSubmitInput( array $values ) {
        $status = Status::newGood();
        if ( !strlen( $values['input'] ) ) {
            $status = Status::newFatal( 'expand_templates_input_missing' );
        }
        return $status;
    }

    private function makeForm( $title, $input ) {
        $fields = [
            'contexttitle' => [
                'type' => 'text',
                'label' => $this->msg( 'expand_templates_title' )->plain(),
                'name' => 'wpContextTitle',
                'id' => 'contexttitle',
                'size' => 60,
                'default' => $title,
                'autofocus' => true,
            ],
            'input' => [
                'type' => 'textarea',
                'name' => 'wpInput',
                'label' => $this->msg( 'expand_templates_input' )->text(),
                'rows' => 10,
                'default' => $input,
                'id' => 'input',
                'useeditfont' => true,
            ],
            'removecomments' => [
                'type' => 'check',
                'label' => $this->msg( 'expand_templates_remove_comments' )->text(),
                'name' => 'wpRemoveComments',
                'id' => 'removecomments',
                'default' => $this->removeComments,
            ],
            'removenowiki' => [
                'type' => 'check',
                'label' => $this->msg( 'expand_templates_remove_nowiki' )->text(),
                'name' => 'wpRemoveNowiki',
                'id' => 'removenowiki',
                'default' => $this->removeNowiki,
            ],
            'generate_xml' => [
                'type' => 'check',
                'label' => $this->msg( 'expand_templates_generate_xml' )->text(),
                'name' => 'wpGenerateXml',
                'id' => 'generate_xml',
                'default' => $this->generateXML,
            ],
            'generate_rawhtml' => [
                'type' => 'check',
                'label' => $this->msg( 'expand_templates_generate_rawhtml' )->text(),
                'name' => 'wpGenerateRawHtml',
                'id' => 'generate_rawhtml',
                'default' => $this->generateRawHtml,
            ],
        ];

        $form = HTMLForm::factory( 'ooui', $fields, $this->getContext() );
        $form
            ->setSubmitTextMsg( 'expand_templates_ok' )
            ->setWrapperLegendMsg( 'expandtemplates' )
            ->setHeaderText( $this->msg( 'expand_templates_intro' )->parse() )
            ->setSubmitCallback( [ $this, 'onSubmitInput' ] )
            ->showAlways();
    }

    private function makeOutput( $output, $heading = 'expand_templates_output' ) {
        $out = "<h2>" . $this->msg( $heading )->escaped() . "</h2>\n";
        $out .= Xml::textarea(
            'output',
            $output,
            10,
            10,
            [
                'id' => 'output',
                'readonly' => 'readonly',
                'class' => 'mw-editfont-' . $this->getUser()->getOption( 'editfont' )
            ]
        );

        return $out;
    }

    private function generateHtml( Title $title, $text ) {
        $popts = ParserOptions::newFromContext( $this->getContext() );
        $popts->setTargetLanguage( $title->getPageLanguage() );
        return MediaWikiServices::getInstance()->getParser()->parse( $text, $title, $popts );
    }

    private function showHtmlPreview( Title $title, ParserOutput $pout, OutputPage $out ) {
        $lang = $title->getPageViewLanguage();
        $out->addHTML( "<h2>" . $this->msg( 'expand_templates_preview' )->escaped() . "</h2>\n" );

        if ( $this->getConfig()->get( 'RawHtml' ) ) {
            $request = $this->getRequest();
            $user = $this->getUser();

            // To prevent cross-site scripting attacks, don't show the preview if raw HTML is
            // allowed and a valid edit token is not provided (T73111). However, MediaWiki
            // does not currently provide logged-out users with CSRF protection; in that case,
            // do not show the preview unless anonymous editing is allowed.
            if ( $user->isAnon() && !MediaWikiServices::getInstance()
                    ->getPermissionManager()
                    ->userHasRight( $user, 'edit' )
            ) {
                $error = [ 'expand_templates_preview_fail_html_anon' ];
            } elseif ( !$user->matchEditToken( $request->getVal( 'wpEditToken' ), '', $request ) ) {
                $error = [ 'expand_templates_preview_fail_html' ];
            } else {
                $error = false;
            }

            if ( $error ) {
                $out->wrapWikiMsg( "<div class='previewnote errorbox'>\n$1\n</div>", $error );
                return;
            }
        }

        $out->addHTML( Html::openElement( 'div', [
            'class' => 'mw-content-' . $lang->getDir(),
            'dir' => $lang->getDir(),
            'lang' => $lang->getHtmlCode(),
        ] ) );
        $out->addParserOutputContent( $pout );
        $out->addHTML( Html::closeElement( 'div' ) );
        $out->setCategoryLinks( $pout->getCategories() );
    }

    protected function getGroupName() {
        return 'wiki';
    }
}