SupportAid.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\TranslatorInterface\Aid;
 
use MediaWiki\Extension\Translate\TranslatorInterface\TranslationHelperException;
use MediaWiki\Extension\Translate\Utilities\Utilities;
use MessageHandle;
use Title;
 
class SupportAid extends TranslationAid {
    public function getData(): array {
        return [
            'url' => self::getSupportUrl( $this->handle ),
        ];
    }
 
    public static function getSupportUrl( MessageHandle $handle ): string {
        $title = $handle->getTitle();
        $config = self::getConfig( $handle );
 
        $placeholders = [
            '%MESSAGE%' => $title->getPrefixedText(),
            '%MESSAGE_URL%' => Utilities::getEditorUrl( $handle )
        ];
 
        // Preprocess params
        $params = [];
        if ( isset( $config['params'] ) ) {
            foreach ( $config['params'] as $key => $value ) {
                $params[$key] = strtr( $value, $placeholders );
            }
        }
 
        // Return the URL or make one from the page
        if ( isset( $config['url'] ) ) {
            return wfAppendQuery( $config['url'], $params );
        } elseif ( isset( $config['page'] ) ) {
            $page = Title::newFromText( $config['page'] );
            if ( $page ) {
                return $page->getFullURL( $params );
            }
        }
 
        throw new TranslationHelperException( 'Support page not configured properly' );
    }
 
    private static function getConfig( MessageHandle $handle ): array {
        global $wgTranslateSupportUrl, $wgTranslateSupportUrlNamespace;
 
        if ( !$handle->isValid() ) {
            throw new TranslationHelperException( 'Invalid MessageHandle' );
        }
 
        // Fetch group level configuration if possible, fallback to namespace based, or default
        $group = $handle->getGroup();
        $namespace = $handle->getTitle()->getNamespace();
        $config = $group->getSupportConfig()
            ?? $wgTranslateSupportUrlNamespace[$namespace]
            ?? $wgTranslateSupportUrl;
 
        if ( !$config ) {
            throw new TranslationHelperException( 'Support page not configured' );
        }
 
        return $config;
    }
}