ConfigHelper.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\Utilities;
 
use MediaWiki\Extension\Translate\MessageGroups\MessageGroup;
use MediaWiki\Permissions\Authority;
 
class ConfigHelper {
    public function getValidationExclusionFile() {
        global $wgTranslateValidationExclusionFile;
        return $wgTranslateValidationExclusionFile;
    }
 
    public function getTranslateAuthorExclusionList(): array {
        global $wgTranslateAuthorExclusionList;
        return $wgTranslateAuthorExclusionList;
    }
 
    public function getDisabledTargetLanguages(): array {
        global $wgTranslateDisabledTargetLanguages;
        return $wgTranslateDisabledTargetLanguages;
    }
 
    public function isTargetLanguageDisabled(
        MessageGroup $group,
        string $languageCode,
        ?string &$reason = null
    ): bool {
        $globalDisabledReason = null;
        $groupId = $group->getId();
        $checks = [
            $groupId,
            strtok( $groupId, '-' ),
            '*'
        ];
 
        $disabledLanguages = $this->getDisabledTargetLanguages();
        foreach ( $checks as $check ) {
            if ( isset( $disabledLanguages[$check][$languageCode] ) ) {
                $globalDisabledReason = $disabledLanguages[$check][$languageCode];
                break;
            }
        }
 
        $groupLanguages = $group->getTranslatableLanguages();
 
        $isLanguageDisabled = $groupLanguages === MessageGroup::DEFAULT_LANGUAGES
            ? $globalDisabledReason !== null
            : !array_key_exists( $languageCode, $groupLanguages );
 
        // Only set the reason if the language is actually disabled
        if ( $isLanguageDisabled ) {
            $reason = $globalDisabledReason;
        }
 
        return $isLanguageDisabled;
    }
 
    public function canSeeExcludedLanguageStats(
        Authority $authority,
        int $translated,
        int $fuzzy
    ): bool {
        if ( $translated === 0 && $fuzzy === 0 ) {
            return false;
        }
        return $authority->isAllowed( 'pagetranslation' );
    }
 
    public function isAuthorExcluded( MessageGroup|string $group, string $languageCode, string $username ): bool {
        $groupId = $group instanceof MessageGroup ? $group->getId() : $group;
        $hash = "$groupId;$languageCode;$username";
        $authorExclusionList = $this->getTranslateAuthorExclusionList();
        $excluded = false;
 
        foreach ( $authorExclusionList as [ $type, $regex ] ) {
            if ( preg_match( $regex, $hash ) ) {
                if ( $type === 'include' ) {
                    return false;
                } else {
                    $excluded = true;
                }
            }
        }
 
        return $excluded;
    }
}