GrantsLocalization.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Permissions;
 
use HtmlArmor;
use MediaWiki\Html\Html;
use MediaWiki\Language\Language;
use MediaWiki\Languages\LanguageFactory;
use MediaWiki\Linker\LinkRenderer;
use MediaWiki\SpecialPage\SpecialPage;
 
class GrantsLocalization {
    private GrantsInfo $grantsInfo;
    private LinkRenderer $linkRenderer;
    private LanguageFactory $languageFactory;
    private Language $contentLanguage;
 
    public function __construct(
        GrantsInfo $grantsInfo,
        LinkRenderer $linkRenderer,
        LanguageFactory $languageFactory,
        Language $contentLanguage
    ) {
        $this->grantsInfo = $grantsInfo;
        $this->linkRenderer = $linkRenderer;
        $this->languageFactory = $languageFactory;
        $this->contentLanguage = $contentLanguage;
    }
 
    public function getGrantDescription( string $grant, $lang = null ): string {
        // Give grep a chance to find the usages:
        // grant-blockusers, grant-createeditmovepage, grant-delete,
        // grant-editinterface, grant-editmycssjs, grant-editmywatchlist,
        // grant-editsiteconfig, grant-editpage, grant-editprotected,
        // grant-highvolume, grant-oversight, grant-patrol, grant-protect,
        // grant-rollback, grant-sendemail, grant-uploadeditmovefile,
        // grant-uploadfile, grant-basic, grant-viewdeleted,
        // grant-viewmywatchlist, grant-createaccount, grant-mergehistory,
        // grant-import
 
        // TODO: replace wfMessage with something that can be injected like TextFormatter
        $msg = wfMessage( "grant-$grant" );
 
        if ( $lang ) {
            $msg->inLanguage( $lang );
        }
 
        if ( !$msg->exists() ) {
            $msg = $lang
                ? wfMessage( 'grant-generic', $grant )->inLanguage( $lang )
                : wfMessage( 'grant-generic', $grant );
        }
 
        return $msg->text();
    }
 
    public function getGrantDescriptions( array $grants, $lang = null ): array {
        $ret = [];
 
        foreach ( $grants as $grant ) {
            $ret[$grant] = $this->getGrantDescription( $grant, $lang );
        }
        return $ret;
    }
 
    public function getGrantDescriptionsWithClasses( array $grants, $lang = null ): array {
        $riskGroupsByGrant = $this->grantsInfo->getRiskGroupsByGrant( 'unknown' );
        $grantDescriptions = $this->getGrantDescriptions( $grants, $lang );
        $results = [];
        foreach ( $grantDescriptions as $grant => $description ) {
            $riskGroup = $riskGroupsByGrant[$grant] ?? 'unknown';
            // Messages used here: grantriskgroup-vandalism, grantriskgroup-security,
            // grantriskgroup-internal
            $riskGroupMsg = wfMessage( "grantriskgroup-$riskGroup" );
            if ( $lang ) {
                $riskGroupMsg->inLanguage( $lang );
            }
            if ( $riskGroupMsg->exists() ) {
                $riskDescription = $riskGroupMsg->text();
                $riskDescriptionHTML = ' ' .
                    Html::element( 'span', [ 'class' => "mw-grant mw-grantriskgroup-$riskGroup" ], $riskDescription );
            } else {
                $riskDescription = '';
                $riskDescriptionHTML = '';
            }
            $results[] = htmlspecialchars( $description ) . $riskDescriptionHTML;
        }
        return $results;
    }
 
    public function getGrantsLink( string $grant, $lang = null ): string {
        $riskGroupsByGrant = $this->grantsInfo->getRiskGroupsByGrant( 'unknown' );
        $riskGroup = $riskGroupsByGrant[$grant] ?? 'unknown';
        return $this->linkRenderer->makeKnownLink(
            SpecialPage::getTitleFor( 'Listgrants', false, $grant ),
            new HtmlArmor( $this->getGrantDescriptionsWithClasses( [ $grant ], $lang )[ 0 ] )
        );
    }
 
    public function getGrantsWikiText( $grantsFilter, $lang = null ): string {
        if ( is_string( $lang ) ) {
            $lang = $this->languageFactory->getLanguage( $lang );
        } elseif ( $lang === null ) {
            $lang = $this->contentLanguage;
        }
 
        $s = '';
        foreach ( $this->grantsInfo->getGrantGroups( $grantsFilter ) as $group => $grants ) {
            if ( $group === 'hidden' ) {
                continue; // implicitly granted
            }
            $grantDescriptionsWithClasses = $this->getGrantDescriptionsWithClasses( $grants, $lang );
            // Give grep a chance to find the usages:
            // grant-group-page-interaction, grant-group-file-interaction
            // grant-group-watchlist-interaction, grant-group-email,
            // grant-group-high-volume, grant-group-customization,
            // grant-group-administration, grant-group-private-information,
            // grant-group-other
            $s .= "*<span class=\"mw-grantgroup\">" .
                // TODO: replace wfMessage with something that can be injected like TextFormatter
                wfMessage( "grant-group-$group" )->inLanguage( $lang )->text() . "</span>\n";
            $s .= ":" . $lang->semicolonList( $grantDescriptionsWithClasses ) . "\n";
        }
        return "$s\n";
    }
}