1.34.0/php/CoreTagHooks_8php_source.html

<?php

class CoreTagHooks {

    public static function register( $parser ) {

        global $wgRawHtml;

        $parser->setHook( 'pre', [ __CLASS__, 'pre' ] );

        $parser->setHook( 'nowiki', [ __CLASS__, 'nowiki' ] );

        $parser->setHook( 'gallery', [ __CLASS__, 'gallery' ] );

        $parser->setHook( 'indicator', [ __CLASS__, 'indicator' ] );

        if ( $wgRawHtml ) {

            $parser->setHook( 'html', [ __CLASS__, 'html' ] );

        }

    }


    public static function pre( $text, $attribs, $parser ) {

        // Backwards-compatibility hack

        $content = StringUtils::delimiterReplace( '<nowiki>', '</nowiki>', '$1', $text, 'i' );


        $attribs = Sanitizer::validateTagAttributes( $attribs, 'pre' );

        // We need to let both '"' and '&' through,

        // for strip markers and entities respectively.

        $content = str_replace(

            [ '>', '<' ],

            [ '&gt;', '&lt;' ],

            $content

        );

        return Html::rawElement( 'pre', $attribs, $content );

    }


    public static function html( $content, $attributes, $parser ) {

        global $wgRawHtml;

        if ( $wgRawHtml ) {

            if ( $parser->getOptions()->getAllowUnsafeRawHtml() ) {

                return [ $content, 'markerType' => 'nowiki' ];

            } else {

                // In a system message where raw html is

                // not allowed (but it is allowed in other

                // contexts).

                return Html::rawElement(

                    'span',

                    [ 'class' => 'error' ],

                    // Using ->text() not ->parse() as

                    // a paranoia measure against a loop.

                    wfMessage( 'rawhtml-notallowed' )->escaped()

                );

            }

        } else {

            throw new MWException( '<html> extension tag encountered unexpectedly' );

        }

    }


    public static function nowiki( $content, $attributes, $parser ) {

        $content = strtr( $content, [

            // lang converter

            '-{' => '-&#123;',

            '}-' => '&#125;-',

            // html tags

            '<' => '&lt;',

            '>' => '&gt;'

            // Note: Both '"' and '&' are not converted.

            // This allows strip markers and entities through.

        ] );

        return [ $content, 'markerType' => 'nowiki' ];

    }


    public static function gallery( $content, $attributes, $parser ) {

        return $parser->renderImageGallery( $content, $attributes );

    }


    public static function indicator( $content, array $attributes, Parser $parser, PPFrame $frame ) {

        if ( !isset( $attributes['name'] ) || trim( $attributes['name'] ) === '' ) {

            return '<span class="error">' .

                wfMessage( 'invalid-indicator-name' )->inContentLanguage()->parse() .

                '</span>';

        }


        $parser->getOutput()->setIndicator(

            trim( $attributes['name'] ),

            Parser::stripOuterParagraph( $parser->recursiveTagParseFully( $content, $frame ) )

        );


        return '';

    }

}