wikimedia/mediawiki-extensions-Translate

<?php
declare( strict_types = 1 );

namespace MediaWiki\Extension\Translate\MessageGroupProcessing;

use MediaWiki\Extension\Translate\MessageBundleTranslation\MessageBundleMessageGroup;
use MediaWiki\Title\Title;
use MediaWiki\Title\TitleFactory;
use MessageGroup;
use RuntimeException;
use WikiPageMessageGroup;

/**
 * Contains logic to store, validate, fetch aggregate groups created via Special:AggregateGroups.
 * @author Abijeet Patro
 * @license GPL-2.0-or-later
 * @since 2024.06
 */
class AggregateGroupManager {
    private TitleFactory $titleFactory;

    public function __construct( TitleFactory $titleFactory ) {
        $this->titleFactory = $titleFactory;
    }

    public function supportsAggregation( MessageGroup $group ): bool {
        return $group instanceof WikiPageMessageGroup || $group instanceof MessageBundleMessageGroup;
    }

    public function getTargetTitleByGroupId( string $groupId ): Title {
        $group = MessageGroups::getGroup( $groupId );
        if ( $group ) {
            return $this->getTargetTitleByGroup( $group );
        } else {
            /* To allow removing no longer existing groups from aggregate message groups,
             * the message group object $group might not always be available.
             * In this case we need to fake some title. */
            return $this->titleFactory->newFromText( "Special:Translate/$groupId" );
        }
    }

    /** @throws RuntimeException If MessageGroup::getRelatedPage returns null */
    public function getTargetTitleByGroup( MessageGroup $group ): Title {
        $relatedGroupPage = $group->getRelatedPage();
        if ( !$relatedGroupPage ) {
            throw new RuntimeException( "No related page found for group " . $group->getId() );
        }

        return $this->titleFactory->newFromLinkTarget( $relatedGroupPage );
    }
}