TranslationPage.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\PageTranslation;
 
use Content;
use ContentHandler;
use Language;
use MediaWiki\Extension\Translate\MessageLoading\Message;
use MediaWiki\Extension\Translate\MessageLoading\MessageCollection;
use Parser;
use Title;
use WikiPageMessageGroup;
 
class TranslationPage {
    private $output;
    private $group;
    private $targetLanguage;
    private $sourceLanguage;
    private $showOutdated;
    private $wrapUntranslated;
    private $sourcePageTitle;
 
    public function __construct(
        ParserOutput $output,
        WikiPageMessageGroup $group,
        Language $targetLanguage,
        Language $sourceLanguage,
        bool $showOutdated,
        bool $wrapUntranslated,
        Title $sourcePageTitle
    ) {
        $this->output = $output;
        $this->group = $group;
        $this->targetLanguage = $targetLanguage;
        $this->sourceLanguage = $sourceLanguage;
        $this->showOutdated = $showOutdated;
        $this->wrapUntranslated = $wrapUntranslated;
        $this->sourcePageTitle = $sourcePageTitle;
    }
 
    public function getPageContent( Parser $parser ): Content {
        $text = $this->generateSource( $parser );
        $model = $this->sourcePageTitle->getContentModel();
        return ContentHandler::makeContent( $text, null, $model );
    }
 
    public function getMessageCollection(): MessageCollection {
        return $this->group->initCollection( $this->targetLanguage->getCode() );
    }
 
    public function filterMessageCollection( MessageCollection $collection ): void {
        $collection->loadTranslations();
        if ( $this->showOutdated ) {
            $collection->filter( 'hastranslation', false );
        } else {
            $collection->filter( 'translated', false );
        }
    }
 
    private function extractMessages( MessageCollection $collection ): array {
        $messages = [];
        $prefix = $this->sourcePageTitle->getPrefixedDBkey() . '/';
        foreach ( $this->output->units() as $unit ) {
            // Even if a unit id has spaces, the message collection will have the
            // key as spaces replaced with underscore. See: T326516
            $normalizedUnitId = str_replace( ' ', '_', $unit->id );
            $messages[$unit->id] = $collection[$prefix . $normalizedUnitId] ?? null;
        }
 
        return $messages;
    }
 
    public function generateSourceFromTranslations( Parser $parser, array $messages ): string {
        $replacements = [];
        foreach ( $this->output->units() as $placeholder => $unit ) {
            $msg = $messages[$unit->id] ?? null;
            $replacements[$placeholder] = $unit->getTextForRendering(
                $msg,
                $this->sourceLanguage,
                $this->targetLanguage,
                $this->wrapUntranslated,
                $parser
            );
        }
 
        $template = $this->output->translationPageTemplate();
        return strtr( $template, $replacements );
    }
 
    public function generateSourceFromMessageCollection(
        Parser $parser,
        MessageCollection $collection
    ): string {
        $messages = $this->extractMessages( $collection );
        return $this->generateSourceFromTranslations( $parser, $messages );
    }
 
    private function generateSource( Parser $parser ): string {
        $collection = $this->getMessageCollection();
        $this->filterMessageCollection( $collection );
        $messages = $this->extractMessages( $collection );
        return $this->generateSourceFromTranslations( $parser, $messages );
    }
}