WikitextContentHandler.php

Go to the documentation of this file.

<?php
use MediaWiki\Content\Renderer\ContentParseParams;
use MediaWiki\Content\Transform\PreloadTransformParams;
use MediaWiki\Content\Transform\PreSaveTransformParams;
use MediaWiki\Languages\LanguageNameUtils;
use MediaWiki\Parser\MagicWordFactory;
use MediaWiki\Parser\ParserOutputFlags;
use MediaWiki\Parser\Parsoid\ParsoidParserFactory;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\Title\Title;
use MediaWiki\Title\TitleFactory;
use Wikimedia\UUID\GlobalIdGenerator;
 
class WikitextContentHandler extends TextContentHandler {
 
    private $titleFactory;
 
    private $parserFactory;
 
    private $globalIdGenerator;
 
    private $languageNameUtils;
 
    private $magicWordFactory;
 
    private $parsoidParserFactory;
 
    public function __construct(
        string $modelId,
        TitleFactory $titleFactory,
        ParserFactory $parserFactory,
        GlobalIdGenerator $globalIdGenerator,
        LanguageNameUtils $languageNameUtils,
        MagicWordFactory $magicWordFactory,
        ParsoidParserFactory $parsoidParserFactory
    ) {
        // $modelId should always be CONTENT_MODEL_WIKITEXT
        parent::__construct( $modelId, [ CONTENT_FORMAT_WIKITEXT ] );
        $this->titleFactory = $titleFactory;
        $this->parserFactory = $parserFactory;
        $this->globalIdGenerator = $globalIdGenerator;
        $this->languageNameUtils = $languageNameUtils;
        $this->magicWordFactory = $magicWordFactory;
        $this->parsoidParserFactory = $parsoidParserFactory;
    }
 
    protected function getContentClass() {
        return WikitextContent::class;
    }
 
    public function makeRedirectContent( Title $destination, $text = '' ) {
        $optionalColon = '';
 
        if ( $destination->getNamespace() === NS_CATEGORY ) {
            $optionalColon = ':';
        } else {
            $iw = $destination->getInterwiki();
            if ( $iw && $this->languageNameUtils->getLanguageName( $iw,
                        LanguageNameUtils::AUTONYMS,
                        LanguageNameUtils::DEFINED )
            ) {
                $optionalColon = ':';
            }
        }
 
        $mwRedir = $this->magicWordFactory->get( 'redirect' );
        $redirectText = $mwRedir->getSynonym( 0 ) .
            ' [[' . $optionalColon . $destination->getFullText() . ']]';
 
        if ( $text != '' ) {
            $redirectText .= "\n" . $text;
        }
 
        $class = $this->getContentClass();
        return new $class( $redirectText );
    }
 
    public function supportsRedirects() {
        return true;
    }
 
    public function supportsSections() {
        return true;
    }
 
    public function isParserCacheSupported() {
        return true;
    }
 
    public function supportsPreloadContent(): bool {
        return true;
    }
 
    protected function getFileHandler() {
        return new FileContentHandler(
            $this->getModelID(),
            $this->titleFactory,
            $this->parserFactory,
            $this->globalIdGenerator,
            $this->languageNameUtils,
            $this->magicWordFactory,
            $this->parsoidParserFactory
        );
    }
 
    public function getFieldsForSearchIndex( SearchEngine $engine ) {
        $fields = parent::getFieldsForSearchIndex( $engine );
 
        $fields['heading'] =
            $engine->makeSearchFieldMapping( 'heading', SearchIndexField::INDEX_TYPE_TEXT );
        $fields['heading']->setFlag( SearchIndexField::FLAG_SCORING );
 
        $fields['auxiliary_text'] =
            $engine->makeSearchFieldMapping( 'auxiliary_text', SearchIndexField::INDEX_TYPE_TEXT );
 
        $fields['opening_text'] =
            $engine->makeSearchFieldMapping( 'opening_text', SearchIndexField::INDEX_TYPE_TEXT );
        $fields['opening_text']->setFlag(
            SearchIndexField::FLAG_SCORING | SearchIndexField::FLAG_NO_HIGHLIGHT
        );
        // Until we have full first-class content handler for files, we invoke it explicitly here
        $fields = array_merge( $fields, $this->getFileHandler()->getFieldsForSearchIndex( $engine ) );
 
        return $fields;
    }
 
    public function getDataForSearchIndex(
        WikiPage $page,
        ParserOutput $parserOutput,
        SearchEngine $engine,
        ?RevisionRecord $revision = null
    ) {
        $fields = parent::getDataForSearchIndex( $page, $parserOutput, $engine, $revision );
 
        $structure = new WikiTextStructure( $parserOutput );
        $fields['heading'] = $structure->headings();
        // text fields
        $fields['opening_text'] = $structure->getOpeningText();
        $fields['text'] = $structure->getMainText(); // overwrites one from ContentHandler
        $fields['auxiliary_text'] = $structure->getAuxiliaryText();
        $fields['defaultsort'] = $structure->getDefaultSort();
        $fields['file_text'] = null;
 
        // Until we have full first-class content handler for files, we invoke it explicitly here
        if ( $page->getTitle()->getNamespace() === NS_FILE ) {
            $fields = array_merge( $fields,
                    $this->getFileHandler()->getDataForSearchIndex( $page, $parserOutput, $engine, $revision ) );
        }
        return $fields;
    }
 
    public function serializeContent( Content $content, $format = null ) {
        $this->checkFormat( $format );
 
        // NOTE: MessageContent also uses CONTENT_MODEL_WIKITEXT, but it's not a TextContent!
        // Perhaps MessageContent should use a separate ContentHandler instead.
        if ( $content instanceof MessageContent ) {
            return $content->getMessage()->plain();
        }
 
        return parent::serializeContent( $content, $format );
    }
 
    public function preSaveTransform(
        Content $content,
        PreSaveTransformParams $pstParams
    ): Content {
        $shouldCallDeprecatedMethod = $this->shouldCallDeprecatedContentTransformMethod(
            $content,
            $pstParams
        );
 
        if ( $shouldCallDeprecatedMethod ) {
            return $this->callDeprecatedContentPST(
                $content,
                $pstParams
            );
        }
 
        '@phan-var WikitextContent $content';
        $text = $content->getText();
 
        $parser = $this->parserFactory->getInstance();
        $pst = $parser->preSaveTransform(
            $text,
            $pstParams->getPage(),
            $pstParams->getUser(),
            $pstParams->getParserOptions()
        );
 
        if ( $text === $pst ) {
            return $content;
        }
 
        $contentClass = $this->getContentClass();
        $ret = new $contentClass( $pst );
        $ret->setPreSaveTransformFlags( $parser->getOutput()->getAllFlags() );
        return $ret;
    }
 
    public function preloadTransform(
        Content $content,
        PreloadTransformParams $pltParams
    ): Content {
        $shouldCallDeprecatedMethod = $this->shouldCallDeprecatedContentTransformMethod(
            $content,
            $pltParams
        );
 
        if ( $shouldCallDeprecatedMethod ) {
            return $this->callDeprecatedContentPLT(
                $content,
                $pltParams
            );
        }
 
        '@phan-var WikitextContent $content';
        $text = $content->getText();
 
        $plt = $this->parserFactory->getInstance()
            ->getPreloadText(
                $text,
                $pltParams->getPage(),
                $pltParams->getParserOptions(),
                $pltParams->getParams()
            );
 
        $contentClass = $this->getContentClass();
        return new $contentClass( $plt );
    }
 
    protected function fillParserOutput(
        Content $content,
        ContentParseParams $cpoParams,
        ParserOutput &$parserOutput
    ) {
        '@phan-var WikitextContent $content';
        $title = $this->titleFactory->newFromPageReference( $cpoParams->getPage() );
        $parserOptions = $cpoParams->getParserOptions();
        $revId = $cpoParams->getRevId();
 
        [ $redir, $text ] = $content->getRedirectTargetAndText();
        if ( $parserOptions->getUseParsoid() && !$redir ) {
            $parser = $this->parsoidParserFactory->create();
        } else {
            $parser = $this->parserFactory->getInstance();
        }
        $parserOutput = $parser
            ->parse( $text, $title, $parserOptions, true, true, $revId );
 
        // T330667: Record the fact that we used the value of
        // 'useParsoid' to influence this parse.  Note that
        // ::getUseParsoid() has a side-effect on $parserOutput here
        // which didn't occur when we called ::getUseParsoid() earlier
        // because $parserOutput didn't exist at that time.
        $parserOptions->getUseParsoid();
 
        // Add redirect indicator at the top
        if ( $redir ) {
            // Make sure to include the redirect link in pagelinks
            $parserOutput->addLink( $redir );
            if ( $cpoParams->getGenerateHtml() ) {
                $redirTarget = $content->getRedirectTarget();
                $parserOutput->setText(
                    Article::getRedirectHeaderHtml( $title->getPageLanguage(), $redirTarget, false ) .
                    $parserOutput->getRawText()
                );
                $parserOutput->addModuleStyles( [ 'mediawiki.action.view.redirectPage' ] );
            } else {
                $parserOutput->setText( null );
            }
        }
 
        // Pass along user-signature flag
        if ( in_array( 'user-signature', $content->getPreSaveTransformFlags() ) ) {
            $parserOutput->setOutputFlag( ParserOutputFlags::USER_SIGNATURE );
        }
    }
}