AllMessagesTablePager.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
use Wikimedia\Rdbms\FakeResultWrapper;
 
class AllMessagesTablePager extends TablePager {
 
    protected $filter, $prefix, $langcode, $displayPrefix;
 
    public $mLimitsShown;
 
    public $lang;
 
    public $custom;
 
    function __construct( $page, $conds, Language $langObj = null ) {
        parent::__construct( $page->getContext() );
        $this->mIndexField = 'am_title';
        $this->mPage = $page;
        $this->mConds = $conds;
        // FIXME: Why does this need to be set to DIR_DESCENDING to produce ascending ordering?
        $this->mDefaultDirection = IndexPager::DIR_DESCENDING;
        $this->mLimitsShown = [ 20, 50, 100, 250, 500, 5000 ];
 
        $this->talk = $this->msg( 'talkpagelinktext' )->escaped();
 
        $contLang = MediaWikiServices::getInstance()->getContentLanguage();
        $this->lang = $langObj ?? $contLang;
        $this->langcode = $this->lang->getCode();
        $this->foreign = !$this->lang->equals( $contLang );
 
        $request = $this->getRequest();
 
        $this->filter = $request->getVal( 'filter', 'all' );
        if ( $this->filter === 'all' ) {
            $this->custom = null; // So won't match in either case
        } else {
            $this->custom = ( $this->filter === 'unmodified' );
        }
 
        $prefix = $this->getLanguage()->ucfirst( $request->getVal( 'prefix', '' ) );
        $prefix = $prefix !== '' ?
            Title::makeTitleSafe( NS_MEDIAWIKI, $request->getVal( 'prefix', null ) ) :
            null;
 
        if ( $prefix !== null ) {
            $this->displayPrefix = $prefix->getDBkey();
            $this->prefix = '/^' . preg_quote( $this->displayPrefix, '/' ) . '/i';
        } else {
            $this->displayPrefix = false;
            $this->prefix = false;
        }
 
        // The suffix that may be needed for message names if we're in a
        // different language (eg [[MediaWiki:Foo/fr]]: $suffix = '/fr'
        if ( $this->foreign ) {
            $this->suffix = '/' . $this->langcode;
        } else {
            $this->suffix = '';
        }
    }
 
    function buildForm() {
        $attrs = [ 'id' => 'mw-allmessages-form-lang', 'name' => 'lang' ];
        $msg = wfMessage( 'allmessages-language' );
        $langSelect = Xml::languageSelector( $this->langcode, false, null, $attrs, $msg );
 
        $out = Xml::openElement( 'form', [
                'method' => 'get',
                'action' => $this->getConfig()->get( 'Script' ),
                'id' => 'mw-allmessages-form'
            ] ) .
            Xml::fieldset( $this->msg( 'allmessages-filter-legend' )->text() ) .
            Html::hidden( 'title', $this->getTitle()->getPrefixedText() ) .
            Xml::openElement( 'table', [ 'class' => 'mw-allmessages-table' ] ) . "\n" .
            '<tr>
                <td class="mw-label">' .
            Xml::label( $this->msg( 'allmessages-prefix' )->text(), 'mw-allmessages-form-prefix' ) .
            "</td>\n
            <td class=\"mw-input\">" .
            Xml::input(
                'prefix',
                20,
                str_replace( '_', ' ', $this->displayPrefix ),
                [ 'id' => 'mw-allmessages-form-prefix' ]
            ) .
            "</td>\n
            </tr>
            <tr>\n
            <td class='mw-label'>" .
            $this->msg( 'allmessages-filter' )->escaped() .
            "</td>\n
                <td class='mw-input'>" .
            Xml::radioLabel( $this->msg( 'allmessages-filter-unmodified' )->text(),
                'filter',
                'unmodified',
                'mw-allmessages-form-filter-unmodified',
                ( $this->filter === 'unmodified' )
            ) .
            Xml::radioLabel( $this->msg( 'allmessages-filter-all' )->text(),
                'filter',
                'all',
                'mw-allmessages-form-filter-all',
                ( $this->filter === 'all' )
            ) .
            Xml::radioLabel( $this->msg( 'allmessages-filter-modified' )->text(),
                'filter',
                'modified',
                'mw-allmessages-form-filter-modified',
                ( $this->filter === 'modified' )
            ) .
            "</td>\n
            </tr>
            <tr>\n
                <td class=\"mw-label\">" . $langSelect[0] . "</td>\n
                <td class=\"mw-input\">" . $langSelect[1] . "</td>\n
            </tr>" .
 
            '<tr>
                <td class="mw-label">' .
            Xml::label( $this->msg( 'table_pager_limit_label' )->text(), 'mw-table_pager_limit_label' ) .
            '</td>
            <td class="mw-input">' .
            $this->getLimitSelect( [ 'id' => 'mw-table_pager_limit_label' ] ) .
            '</td>
            <tr>
                <td></td>
                <td>' .
            Xml::submitButton( $this->msg( 'allmessages-filter-submit' )->text() ) .
            "</td>\n
            </tr>" .
 
            Xml::closeElement( 'table' ) .
            $this->getHiddenFields( [ 'title', 'prefix', 'filter', 'lang', 'limit' ] ) .
            Xml::closeElement( 'fieldset' ) .
            Xml::closeElement( 'form' );
 
        return $out;
    }
 
    function getAllMessages( $descending ) {
        $messageNames = Language::getLocalisationCache()->getSubitemList( 'en', 'messages' );
 
        // Normalise message names so they look like page titles and sort correctly - T86139
        $messageNames = array_map( [ $this->lang, 'ucfirst' ], $messageNames );
 
        if ( $descending ) {
            rsort( $messageNames );
        } else {
            asort( $messageNames );
        }
 
        return $messageNames;
    }
 
    public static function getCustomisedStatuses( $messageNames, $langcode = 'en', $foreign = false ) {
        // FIXME: This function should be moved to Language:: or something.
 
        $dbr = wfGetDB( DB_REPLICA );
        $res = $dbr->select( 'page',
            [ 'page_namespace', 'page_title' ],
            [ 'page_namespace' => [ NS_MEDIAWIKI, NS_MEDIAWIKI_TALK ] ],
            __METHOD__,
            [ 'USE INDEX' => 'name_title' ]
        );
        $xNames = array_flip( $messageNames );
 
        $pageFlags = $talkFlags = [];
 
        foreach ( $res as $s ) {
            $exists = false;
 
            if ( $foreign ) {
                $titleParts = explode( '/', $s->page_title );
                if ( count( $titleParts ) === 2 &&
                    $langcode === $titleParts[1] &&
                    isset( $xNames[$titleParts[0]] )
                ) {
                    $exists = $titleParts[0];
                }
            } elseif ( isset( $xNames[$s->page_title] ) ) {
                $exists = $s->page_title;
            }
 
            $title = Title::newFromRow( $s );
            if ( $exists && $title->inNamespace( NS_MEDIAWIKI ) ) {
                $pageFlags[$exists] = true;
            } elseif ( $exists && $title->inNamespace( NS_MEDIAWIKI_TALK ) ) {
                $talkFlags[$exists] = true;
            }
        }
 
        return [ 'pages' => $pageFlags, 'talks' => $talkFlags ];
    }
 
    function reallyDoQuery( $offset, $limit, $descending ) {
        $result = new FakeResultWrapper( [] );
 
        $messageNames = $this->getAllMessages( $descending );
        $statuses = self::getCustomisedStatuses( $messageNames, $this->langcode, $this->foreign );
 
        $count = 0;
        foreach ( $messageNames as $key ) {
            $customised = isset( $statuses['pages'][$key] );
            if ( $customised !== $this->custom &&
                ( $descending && ( $key < $offset || !$offset ) || !$descending && $key > $offset ) &&
                ( ( $this->prefix && preg_match( $this->prefix, $key ) ) || $this->prefix === false )
            ) {
                $actual = wfMessage( $key )->inLanguage( $this->langcode )->plain();
                $default = wfMessage( $key )->inLanguage( $this->langcode )->useDatabase( false )->plain();
                $result->result[] = [
                    'am_title' => $key,
                    'am_actual' => $actual,
                    'am_default' => $default,
                    'am_customised' => $customised,
                    'am_talk_exists' => isset( $statuses['talks'][$key] )
                ];
                $count++;
            }
 
            if ( $count === $limit ) {
                break;
            }
        }
 
        return $result;
    }
 
    function getStartBody() {
        $tableClass = $this->getTableClass();
        return Xml::openElement( 'table', [
            'class' => "mw-datatable $tableClass",
            'id' => 'mw-allmessagestable'
        ] ) .
        "\n" .
        "<thead><tr>
                <th rowspan=\"2\">" .
        $this->msg( 'allmessagesname' )->escaped() . "
                </th>
                <th>" .
        $this->msg( 'allmessagesdefault' )->escaped() .
        "</th>
            </tr>\n
            <tr>
                <th>" .
        $this->msg( 'allmessagescurrent' )->escaped() .
        "</th>
            </tr></thead><tbody>\n";
    }
 
    function formatValue( $field, $value ) {
        $linkRenderer = MediaWikiServices::getInstance()->getLinkRenderer();
        switch ( $field ) {
            case 'am_title' :
                $title = Title::makeTitle( NS_MEDIAWIKI, $value . $this->suffix );
                $talk = Title::makeTitle( NS_MEDIAWIKI_TALK, $value . $this->suffix );
                $translation = Linker::makeExternalLink(
                    'https://translatewiki.net/w/i.php?' . wfArrayToCgi( [
                        'title' => 'Special:SearchTranslations',
                        'group' => 'mediawiki',
                        'grouppath' => 'mediawiki',
                        'language' => $this->getLanguage()->getCode(),
                        'query' => $value . ' ' . $this->msg( $value )->plain()
                    ] ),
                    $this->msg( 'allmessages-filter-translate' )->text()
                );
 
                if ( $this->mCurrentRow->am_customised ) {
                    $title = $linkRenderer->makeKnownLink( $title, $this->getLanguage()->lcfirst( $value ) );
                } else {
                    $title = $linkRenderer->makeBrokenLink(
                        $title,
                        $this->getLanguage()->lcfirst( $value )
                    );
                }
                if ( $this->mCurrentRow->am_talk_exists ) {
                    $talk = $linkRenderer->makeKnownLink( $talk, $this->talk );
                } else {
                    $talk = $linkRenderer->makeBrokenLink(
                        $talk,
                        $this->talk
                    );
                }
 
                return $title . ' ' .
                $this->msg( 'parentheses' )->rawParams( $talk )->escaped() .
                ' ' .
                $this->msg( 'parentheses' )->rawParams( $translation )->escaped();
 
            case 'am_default' :
            case 'am_actual' :
                return Sanitizer::escapeHtmlAllowEntities( $value );
        }
 
        return '';
    }
 
    function formatRow( $row ) {
        // Do all the normal stuff
        $s = parent::formatRow( $row );
 
        // But if there's a customised message, add that too.
        if ( $row->am_customised ) {
            $s .= Xml::openElement( 'tr', $this->getRowAttrs( $row, true ) );
            $formatted = strval( $this->formatValue( 'am_actual', $row->am_actual ) );
 
            if ( $formatted === '' ) {
                $formatted = "\u{00A0}";
            }
 
            $s .= Xml::tags( 'td', $this->getCellAttrs( 'am_actual', $row->am_actual ), $formatted )
                . "</tr>\n";
        }
 
        return $s;
    }
 
    function getRowAttrs( $row, $isSecond = false ) {
        $arr = [];
 
        if ( $row->am_customised ) {
            $arr['class'] = 'allmessages-customised';
        }
 
        if ( !$isSecond ) {
            $arr['id'] = Sanitizer::escapeIdForAttribute(
                'msg_' . $this->getLanguage()->lcfirst( $row->am_title )
            );
        }
 
        return $arr;
    }
 
    function getCellAttrs( $field, $value ) {
        if ( $this->mCurrentRow->am_customised && $field === 'am_title' ) {
            return [ 'rowspan' => '2', 'class' => $field ];
        } elseif ( $field === 'am_title' ) {
            return [ 'class' => $field ];
        } else {
            return [
                'lang' => $this->lang->getHtmlCode(),
                'dir' => $this->lang->getDir(),
                'class' => $field
            ];
        }
    }
 
    // This is not actually used, as getStartBody is overridden above
    function getFieldNames() {
        return [
            'am_title' => $this->msg( 'allmessagesname' )->text(),
            'am_default' => $this->msg( 'allmessagesdefault' )->text()
        ];
    }
 
    function getTitle() {
        return SpecialPage::getTitleFor( 'Allmessages', false );
    }
 
    function isFieldSortable( $x ) {
        return false;
    }
 
    function getDefaultSort() {
        return '';
    }
 
    function getQueryInfo() {
        return '';
    }
 
}