WikitextContent.php

Go to the documentation of this file.

<?php
class WikitextContent extends TextContent {
    private $redirectTargetAndText = null;

    public function __construct( $text ) {
        parent::__construct( $text, CONTENT_MODEL_WIKITEXT );
    }

    public function getSection( $sectionId ) {
        global $wgParser;

        $text = $this->getNativeData();
        $sect = $wgParser->getSection( $text, $sectionId, false );

        if ( $sect === false ) {
            return false;
        } else {
            return new static( $sect );
        }
    }

    public function replaceSection( $sectionId, Content $with, $sectionTitle = '' ) {

        $myModelId = $this->getModel();
        $sectionModelId = $with->getModel();

        if ( $sectionModelId != $myModelId ) {
            throw new MWException( "Incompatible content model for section: " .
                "document uses $myModelId but " .
                "section uses $sectionModelId." );
        }

        $oldtext = $this->getNativeData();
        $text = $with->getNativeData();

        if ( strval( $sectionId ) === '' ) {
            return $with; # XXX: copy first?
        }

        if ( $sectionId === 'new' ) {
            # Inserting a new section
            $subject = $sectionTitle ? wfMessage( 'newsectionheaderdefaultlevel' )
                    ->rawParams( $sectionTitle )->inContentLanguage()->text() . "\n\n" : '';
            if ( Hooks::run( 'PlaceNewSection', [ $this, $oldtext, $subject, &$text ] ) ) {
                $text = strlen( trim( $oldtext ) ) > 0
                    ? "{$oldtext}\n\n{$subject}{$text}"
                    : "{$subject}{$text}";
            }
        } else {
            # Replacing an existing section; roll out the big guns
            global $wgParser;

            $text = $wgParser->replaceSection( $oldtext, $sectionId, $text );
        }

        $newContent = new static( $text );

        return $newContent;
    }

    public function addSectionHeader( $header ) {
        $text = wfMessage( 'newsectionheaderdefaultlevel' )
            ->rawParams( $header )->inContentLanguage()->text();
        $text .= "\n\n";
        $text .= $this->getNativeData();

        return new static( $text );
    }

    public function preSaveTransform( Title $title, User $user, ParserOptions $popts ) {
        global $wgParser;

        $text = $this->getNativeData();
        $pst = $wgParser->preSaveTransform( $text, $title, $user, $popts );

        return ( $text === $pst ) ? $this : new static( $pst );
    }

    public function preloadTransform( Title $title, ParserOptions $popts, $params = [] ) {
        global $wgParser;

        $text = $this->getNativeData();
        $plt = $wgParser->getPreloadText( $text, $title, $popts, $params );

        return new static( $plt );
    }

    protected function getRedirectTargetAndText() {
        global $wgMaxRedirects;

        if ( $this->redirectTargetAndText !== null ) {
            return $this->redirectTargetAndText;
        }

        if ( $wgMaxRedirects < 1 ) {
            // redirects are disabled, so quit early
            $this->redirectTargetAndText = [ null, $this->getNativeData() ];
            return $this->redirectTargetAndText;
        }

        $redir = MagicWord::get( 'redirect' );
        $text = ltrim( $this->getNativeData() );
        if ( $redir->matchStartAndRemove( $text ) ) {
            // Extract the first link and see if it's usable
            // Ensure that it really does come directly after #REDIRECT
            // Some older redirects included a colon, so don't freak about that!
            $m = [];
            if ( preg_match( '!^\s*:?\s*\[{2}(.*?)(?:\|.*?)?\]{2}\s*!', $text, $m ) ) {
                // Strip preceding colon used to "escape" categories, etc.
                // and URL-decode links
                if ( strpos( $m[1], '%' ) !== false ) {
                    // Match behavior of inline link parsing here;
                    $m[1] = rawurldecode( ltrim( $m[1], ':' ) );
                }
                $title = Title::newFromText( $m[1] );
                // If the title is a redirect to bad special pages or is invalid, return null
                if ( !$title instanceof Title || !$title->isValidRedirectTarget() ) {
                    $this->redirectTargetAndText = [ null, $this->getNativeData() ];
                    return $this->redirectTargetAndText;
                }

                $this->redirectTargetAndText = [ $title, substr( $text, strlen( $m[0] ) ) ];
                return $this->redirectTargetAndText;
            }
        }

        $this->redirectTargetAndText = [ null, $this->getNativeData() ];
        return $this->redirectTargetAndText;
    }

    public function getRedirectTarget() {
        list( $title, ) = $this->getRedirectTargetAndText();

        return $title;
    }

    public function updateRedirect( Title $target ) {
        if ( !$this->isRedirect() ) {
            return $this;
        }

        # Fix the text
        # Remember that redirect pages can have categories, templates, etc.,
        # so the regex has to be fairly general
        $newText = preg_replace( '/ \[ \[  [^\]]*  \] \] /x',
            '[[' . $target->getFullText() . ']]',
            $this->getNativeData(), 1 );

        return new static( $newText );
    }

    public function isCountable( $hasLinks = null, Title $title = null ) {
        global $wgArticleCountMethod;

        if ( $this->isRedirect() ) {
            return false;
        }

        switch ( $wgArticleCountMethod ) {
            case 'any':
                return true;
            case 'comma':
                $text = $this->getNativeData();
                return strpos( $text, ',' ) !== false;
            case 'link':
                if ( $hasLinks === null ) { # not known, find out
                    if ( !$title ) {
                        $context = RequestContext::getMain();
                        $title = $context->getTitle();
                    }

                    $po = $this->getParserOutput( $title, null, null, false );
                    $links = $po->getLinks();
                    $hasLinks = !empty( $links );
                }

                return $hasLinks;
        }

        return false;
    }

    public function getTextForSummary( $maxlength = 250 ) {
        $truncatedtext = parent::getTextForSummary( $maxlength );

        # clean up unfinished links
        # XXX: make this optional? wasn't there in autosummary, but required for
        # deletion summary.
        $truncatedtext = preg_replace( '/\[\[([^\]]*)\]?$/', '$1', $truncatedtext );

        return $truncatedtext;
    }

    protected function fillParserOutput( Title $title, $revId,
            ParserOptions $options, $generateHtml, ParserOutput &$output
    ) {
        global $wgParser;

        list( $redir, $text ) = $this->getRedirectTargetAndText();
        $output = $wgParser->parse( $text, $title, $options, true, true, $revId );

        // Add redirect indicator at the top
        if ( $redir ) {
            // Make sure to include the redirect link in pagelinks
            $output->addLink( $redir );
            if ( $generateHtml ) {
                $chain = $this->getRedirectChain();
                $output->setText(
                    Article::getRedirectHeaderHtml( $title->getPageLanguage(), $chain, false ) .
                    $output->getRawText()
                );
                $output->addModuleStyles( 'mediawiki.action.view.redirectPage' );
            }
        }
    }

    protected function getHtml() {
        throw new MWException(
            "getHtml() not implemented for wikitext. "
                . "Use getParserOutput()->getText()."
        );
    }

    public function matchMagicWord( MagicWord $word ) {
        return $word->match( $this->getNativeData() );
    }

}