TranslatableBundle.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\MessageGroupProcessing;
 
use MediaWiki\MediaWikiServices;
use MediaWiki\Page\PageReference;
use MessageHandle;
use Title;
 
abstract class TranslatableBundle {
    abstract public function getTitle(): Title;
 
    abstract public function getMessageGroupId(): string;
 
    abstract public function getTranslationPages(): array;
 
    abstract public function getTranslationUnitPages( ?string $code = null ): array;
 
    abstract public function isMoveable(): bool;
 
    abstract public function isDeletable(): bool;
 
    protected function getTranslationUnitPagesByTitle( PageReference $title, ?string $code = null ): array {
        $dbw = wfGetDB( DB_PRIMARY );
 
        $base = MediaWikiServices::getInstance()->getTitleFormatter()->getPrefixedDBkey( $title );
        // Including the / used as separator
        $baseLength = strlen( $base ) + 1;
 
        if ( $code === null ) {
            $like = $dbw->buildLike( "$base/", $dbw->anyString() );
        } else {
            $like = $dbw->buildLike( "$base/", $dbw->anyString(), "/$code" );
        }
 
        $res = $dbw->newSelectQueryBuilder()
            ->select( [ 'page_namespace', 'page_title' ] )
            ->from( 'page' )
            ->where( [
                'page_namespace' => NS_TRANSLATIONS,
                'page_title ' . $like
            ] )
            ->caller( __METHOD__ )
            ->fetchResultSet();
 
        // Only include pages which belong to this translatable page.
        // Problematic cases are when pages Foo and Foo/bar are both
        // translatable. Then when querying for Foo, we also get units
        // belonging to Foo/bar.
        $units = [];
        foreach ( $res as $row ) {
            $title = Title::newFromRow( $row );
 
            // Strip the language code and the name of the
            // translatable to get plain translation unit id
            $handle = new MessageHandle( $title );
            $key = substr( $handle->getKey(), $baseLength );
            if ( str_contains( $key, '/' ) ) {
                // Probably belongs to translatable subpage
                continue;
            }
 
            // We have a match :)
            $units[] = $title;
        }
 
        return $units;
    }
}