CoreMagicVariables.php

Go to the documentation of this file.

<?php
use MediaWiki\Config\ServiceOptions;
use MediaWiki\MainConfigNames;
use Psr\Log\LoggerInterface;
use Wikimedia\Timestamp\ConvertibleTimestamp;
 
class CoreMagicVariables {
 
    public static function expand(
        // Fundamental options
        Parser $parser,
        string $id,
        // Context passed over from the parser
        ConvertibleTimestamp $ts,
        ServiceOptions $svcOptions,
        LoggerInterface $logger
    ): ?string {
        $pageLang = $parser->getTargetLanguage();
        $title = $parser->getTitle();
 
        switch ( $id ) {
            case '!':
                return '|';
            case '=':
                return '=';
            case 'currentmonth':
                return $pageLang->formatNumNoSeparators( $ts->format( 'm' ) );
            case 'currentmonth1':
                return $pageLang->formatNumNoSeparators( $ts->format( 'n' ) );
            case 'currentmonthname':
                return $pageLang->getMonthName( (int)$ts->format( 'n' ) );
            case 'currentmonthnamegen':
                return $pageLang->getMonthNameGen( (int)$ts->format( 'n' ) );
            case 'currentmonthabbrev':
                return $pageLang->getMonthAbbreviation( (int)$ts->format( 'n' ) );
            case 'currentday':
                return $pageLang->formatNumNoSeparators( $ts->format( 'j' ) );
            case 'currentday2':
                return $pageLang->formatNumNoSeparators( $ts->format( 'd' ) );
            case 'localmonth':
                return $pageLang->formatNumNoSeparators( self::makeTsLocal( $svcOptions, $ts )->format( 'm' ) );
            case 'localmonth1':
                return $pageLang->formatNumNoSeparators( self::makeTsLocal( $svcOptions, $ts )->format( 'n' ) );
            case 'localmonthname':
                return $pageLang->getMonthName( (int)self::makeTsLocal( $svcOptions, $ts )->format( 'n' ) );
            case 'localmonthnamegen':
                return $pageLang->getMonthNameGen( (int)self::makeTsLocal( $svcOptions, $ts )->format( 'n' ) );
            case 'localmonthabbrev':
                return $pageLang->getMonthAbbreviation( (int)self::makeTsLocal( $svcOptions, $ts )->format( 'n' ) );
            case 'localday':
                return $pageLang->formatNumNoSeparators( self::makeTsLocal( $svcOptions, $ts )->format( 'j' ) );
            case 'localday2':
                return $pageLang->formatNumNoSeparators( self::makeTsLocal( $svcOptions, $ts )->format( 'd' ) );
            case 'pagename':
            case 'pagenamee':
            case 'fullpagename':
            case 'fullpagenamee':
            case 'subpagename':
            case 'subpagenamee':
            case 'rootpagename':
            case 'rootpagenamee':
            case 'basepagename':
            case 'basepagenamee':
            case 'talkpagename':
            case 'talkpagenamee':
            case 'subjectpagename':
            case 'subjectpagenamee':
            case 'pageid':
            case 'revisionid':
            case 'revisionuser':
            case 'revisionday':
            case 'revisionday2':
            case 'revisionmonth':
            case 'revisionmonth1':
            case 'revisionyear':
            case 'revisiontimestamp':
            case 'namespace':
            case 'namespacee':
            case 'namespacenumber':
            case 'talkspace':
            case 'talkspacee':
            case 'subjectspace':
            case 'subjectspacee':
            case 'cascadingsources':
                # First argument of the corresponding parser function
                # (second argument of the PHP implementation) is
                # "title".
 
                # Note that for many of these {{FOO}} is subtly different
                # from {{FOO:{{PAGENAME}}}}, so we can't pass $title here
                # we have to explicitly use the "no arguments" form of the
                # parser function by passing `null` to indicate a missing
                # argument (which then defaults to the current page title).
                return CoreParserFunctions::$id( $parser, null );
            case 'revisionsize':
                return (string)$parser->getRevisionSize();
            case 'currentdayname':
                return $pageLang->getWeekdayName( (int)$ts->format( 'w' ) + 1 );
            case 'currentyear':
                return $pageLang->formatNumNoSeparators( $ts->format( 'Y' ) );
            case 'currenttime':
                return $pageLang->time( $ts->getTimestamp( TS_MW ), false, false );
            case 'currenthour':
                return $pageLang->formatNumNoSeparators( $ts->format( 'H' ) );
            case 'currentweek':
                // @bug T6594 PHP5 has it zero padded, PHP4 does not, cast to
                // int to remove the padding
                return $pageLang->formatNum( (int)$ts->format( 'W' ) );
            case 'currentdow':
                return $pageLang->formatNum( $ts->format( 'w' ) );
            case 'localdayname':
                return $pageLang->getWeekdayName(
                    (int)self::makeTsLocal( $svcOptions, $ts )->format( 'w' ) + 1
                );
            case 'localyear':
                return $pageLang->formatNumNoSeparators( self::makeTsLocal( $svcOptions, $ts )->format( 'Y' ) );
            case 'localtime':
                return $pageLang->time(
                    self::makeTsLocal( $svcOptions, $ts )->format( 'YmdHis' ),
                    false,
                    false
                );
            case 'localhour':
                return $pageLang->formatNumNoSeparators( self::makeTsLocal( $svcOptions, $ts )->format( 'H' ) );
            case 'localweek':
                // @bug T6594 PHP5 has it zero padded, PHP4 does not, cast to
                // int to remove the padding
                return $pageLang->formatNum( (int)self::makeTsLocal( $svcOptions, $ts )->format( 'W' ) );
            case 'localdow':
                return $pageLang->formatNum( self::makeTsLocal( $svcOptions, $ts )->format( 'w' ) );
            case 'numberofarticles':
            case 'numberoffiles':
            case 'numberofusers':
            case 'numberofactiveusers':
            case 'numberofpages':
            case 'numberofadmins':
            case 'numberofedits':
                # second argument is 'raw'; magic variables are "not raw"
                return CoreParserFunctions::$id( $parser, null );
            case 'currenttimestamp':
                return $ts->getTimestamp( TS_MW );
            case 'localtimestamp':
                return self::makeTsLocal( $svcOptions, $ts )->format( 'YmdHis' );
            case 'currentversion':
                return SpecialVersion::getVersion();
            case 'articlepath':
                return (string)$svcOptions->get( MainConfigNames::ArticlePath );
            case 'sitename':
                return (string)$svcOptions->get( MainConfigNames::Sitename );
            case 'server':
                return (string)$svcOptions->get( MainConfigNames::Server );
            case 'servername':
                return (string)$svcOptions->get( MainConfigNames::ServerName );
            case 'scriptpath':
                return (string)$svcOptions->get( MainConfigNames::ScriptPath );
            case 'stylepath':
                return (string)$svcOptions->get( MainConfigNames::StylePath );
            case 'directionmark':
                return $pageLang->getDirMark();
            case 'contentlanguage':
                return $parser->getContentLanguage()->getCode();
            case 'pagelanguage':
                return $pageLang->getCode();
            default:
                // This is not one of the core magic variables
                return null;
        }
    }
 
    private static function makeTsLocal( $svcOptions, $ts ) {
        $localtimezone = $svcOptions->get( MainConfigNames::Localtimezone );
        $ts->setTimezone( $localtimezone );
        return $ts;
    }
}