SpecialSpecialpages.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;

class SpecialSpecialpages extends UnlistedSpecialPage {

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

    function execute( $par ) {
        $out = $this->getOutput();
        $this->setHeaders();
        $this->outputHeader();
        $out->allowClickjacking();
        $out->addModuleStyles( 'mediawiki.special' );

        $groups = $this->getPageGroups();

        if ( $groups === false ) {
            return;
        }

        $this->addHelpLink( 'Help:Special pages' );
        $this->outputPageList( $groups );
    }

    private function getPageGroups() {
        $pages = MediaWikiServices::getInstance()->getSpecialPageFactory()->
            getUsablePages( $this->getUser() );

        if ( $pages === [] ) {
            # Yeah, that was pointless. Thanks for coming.
            return false;
        }

        $groups = [];
        foreach ( $pages as $page ) {
            if ( $page->isListed() ) {
                $group = $page->getFinalGroupName();
                if ( !isset( $groups[$group] ) ) {
                    $groups[$group] = [];
                }
                $groups[$group][$page->getDescription()] = [
                    $page->getPageTitle(),
                    $page->isRestricted(),
                    $page->isCached()
                ];
            }
        }

        foreach ( $groups as $group => $sortedPages ) {
            ksort( $groups[$group] );
        }

        if ( array_key_exists( 'other', $groups ) ) {
            $other = $groups['other'];
            unset( $groups['other'] );
            $groups['other'] = $other;
        }

        return $groups;
    }

    private function outputPageList( $groups ) {
        $out = $this->getOutput();

        $includesRestrictedPages = false;
        $includesCachedPages = false;

        foreach ( $groups as $group => $sortedPages ) {
            $out->wrapWikiMsg(
                "<h2 class=\"mw-specialpagesgroup\" id=\"mw-specialpagesgroup-$group\">$1</h2>\n",
                "specialpages-group-$group"
            );
            $out->addHTML(
                Html::openElement( 'div', [ 'class' => 'mw-specialpages-list' ] )
                . '<ul>'
            );
            foreach ( $sortedPages as $desc => $specialpage ) {
                list( $title, $restricted, $cached ) = $specialpage;

                $pageClasses = [];
                if ( $cached ) {
                    $includesCachedPages = true;
                    $pageClasses[] = 'mw-specialpagecached';
                }
                if ( $restricted ) {
                    $includesRestrictedPages = true;
                    $pageClasses[] = 'mw-specialpagerestricted';
                }

                $link = $this->getLinkRenderer()->makeKnownLink( $title, $desc );
                $out->addHTML( Html::rawElement(
                        'li',
                        [ 'class' => implode( ' ', $pageClasses ) ],
                        $link
                    ) . "\n" );
            }
            $out->addHTML(
                Html::closeElement( 'ul' ) .
                Html::closeElement( 'div' )
            );
        }

        // add legend
        $notes = [];
        if ( $includesRestrictedPages ) {
            $restricedMsg = $this->msg( 'specialpages-note-restricted' );
            if ( !$restricedMsg->isDisabled() ) {
                $notes[] = $restricedMsg->plain();
            }
        }
        if ( $includesCachedPages ) {
            $cachedMsg = $this->msg( 'specialpages-note-cached' );
            if ( !$cachedMsg->isDisabled() ) {
                $notes[] = $cachedMsg->plain();
            }
        }
        if ( $notes !== [] ) {
            $out->wrapWikiMsg(
                "<h2 class=\"mw-specialpages-note-top\">$1</h2>", 'specialpages-note-top'
            );
            $out->wrapWikiTextAsInterface(
                'mw-specialpages-notes',
                implode( "\n", $notes )
            );
        }
    }
}