WikiPageMessageGroup.php

Go to the documentation of this file.

<?php
use MediaWiki\Extension\Translate\PageTranslation\Hooks;
use MediaWiki\Extension\Translate\PageTranslation\TranslatablePageInsertablesSuggester;
use MediaWiki\Extension\Translate\PageTranslation\TranslationUnit;
use MediaWiki\Extension\Translate\Utilities\Utilities;
use MediaWiki\Extension\Translate\Validation\ValidationRunner;
use MediaWiki\MediaWikiServices;
use MediaWiki\Revision\SlotRecord;
 
class WikiPageMessageGroup extends MessageGroupOld implements IDBAccessObject {
    protected $title;
    protected $namespace = NS_TRANSLATIONS;
 
    public function __construct( $id, $title ) {
        $this->id = $id;
        $this->title = $title;
    }
 
    public function getSourceLanguage() {
        return $this->getTitle()->getPageLanguage()->getCode();
    }
 
    public function getTitle() {
        if ( is_string( $this->title ) ) {
            $this->title = Title::newFromText( $this->title );
        }
 
        return $this->title;
    }
 
    protected $definitions;
 
    public function getDefinitions() {
        if ( is_array( $this->definitions ) ) {
            return $this->definitions;
        }
 
        $title = $this->getTitle();
 
        $dbr = Utilities::getSafeReadDB();
        $tables = [ 'page', 'translate_sections' ];
        $vars = [ 'trs_key', 'trs_text' ];
        $conds = [
            'page_namespace' => $title->getNamespace(),
            'page_title' => $title->getDBkey(),
            // The join condition
            'page_id = trs_page',
        ];
        $options = [ 'ORDER BY' => 'trs_order' ];
        $res = $dbr->select( $tables, $vars, $conds, __METHOD__, $options );
 
        $defs = [];
 
        foreach ( $res as $r ) {
            $section = new TranslationUnit( $r->trs_text );
            $defs[$r->trs_key] = $section->getTextWithVariables();
        }
 
        $groupKeys = $this->makeGroupKeys( array_keys( $defs ) );
        $this->definitions = array_combine( $groupKeys, array_values( $defs ) );
 
        return $this->definitions;
    }
 
    public function makeGroupKeys( array $keys ): array {
        $prefix = $this->getTitle()->getPrefixedDBkey() . '/';
        return array_map( static function ( string $key ) use ( $prefix ): string {
            return $prefix . str_replace( ' ', '_', $key );
        }, $keys );
    }
 
    public function getLabel( IContextSource $context = null ) {
        return $this->getTitle()->getPrefixedText();
    }
 
    public function clearCaches() {
        $this->definitions = null;
    }
 
    public function load( $code ) {
        if ( $this->isSourceLanguage( $code ) ) {
            return $this->getDefinitions();
        }
 
        return [];
    }
 
    public function getMessage( $key, $code, $flags = self::READ_LATEST ) {
        if ( $this->isSourceLanguage( $code ) ) {
            $stuff = $this->load( $code );
 
            $title = Title::newFromText( $key );
            if ( $title ) {
                $key = $title->getPrefixedDBkey();
            }
 
            return $stuff[$key] ?? null;
        }
 
        $title = Title::makeTitleSafe( $this->getNamespace(), "$key/$code" );
        if ( Hooks::$renderingContext ) {
            $revFlags = IDBAccessObject::READ_NORMAL; // bug T95753
        } else {
            $revFlags = ( $flags & self::READ_LATEST ) == self::READ_LATEST
                ? IDBAccessObject::READ_LATEST
                : IDBAccessObject::READ_NORMAL;
        }
        $rev = MediaWikiServices::getInstance()
            ->getRevisionLookup()
            ->getRevisionByTitle( $title, 0, $revFlags );
 
        if ( !$rev ) {
            return null;
        }
 
        $content = $rev->getContent( SlotRecord::MAIN );
        return ( $content instanceof TextContent ) ? $content->getText() : null;
    }
 
    public function getValidator() {
        $validator = new ValidationRunner( $this->getId() );
        $validator->setValidators( [
            [ 'id' => 'MediaWikiPlural' ],
            [ 'id' => 'BraceBalance' ]
        ] );
 
        return $validator;
    }
 
    public function getInsertablesSuggester() {
        return new TranslatablePageInsertablesSuggester();
    }
 
    public function getDescription( IContextSource $context = null ) {
        $title = $this->getTitle()->getPrefixedText();
        $target = ":$title";
        $pageLanguageCode = $this->getSourceLanguage();
        $inLanguageCode = $context ? $context->getLanguage()->getCode() : null;
        $languageName = MediaWikiServices::getInstance()->getLanguageNameUtils()
            ->getLanguageName( $pageLanguageCode, $inLanguageCode );
 
        // Allow for adding a custom group description by using
        // "MediaWiki:Tp-custom-<group ID>".
        $customText = '';
        $msg = wfMessage( 'tp-custom-' . $this->id );
        self::addContext( $msg, $context );
        if ( $msg->exists() ) {
            $customText = $msg->plain();
        }
 
        $msg = wfMessage( 'translate-tag-page-desc', $title, $target, $languageName, $pageLanguageCode );
        self::addContext( $msg, $context );
 
        return $msg->plain() . $customText;
    }
}