wikimedia/mediawiki-extensions-UniversalLanguageSelector

View on GitHub
includes/ULSJsonMessageLoader.php

Summary

Maintainability
A
0 mins
Test Coverage
<?php
/**
 * Json formatted MessageLoader for ULS
 *
 * Copyright (C) 2013 Alolita Sharma, Amir Aharoni, Arun Ganesh, Brandon Harris,
 * Niklas Laxström, Pau Giner, Santhosh Thottingal, Siebrand Mazeland and other
 * contributors. See CREDITS for a list.
 *
 * UniversalLanguageSelector is dual licensed GPLv2 or later and MIT. You don't
 * have to do anything special to choose one license or the other and you don't
 * have to notify anyone which license you are using. You are free to use
 * UniversalLanguageSelector in commercial projects as long as the copyright
 * header is left intact. See files GPL-LICENSE and MIT-LICENSE for details.
 *
 * @file
 * @ingroup Extensions
 * @license GPL-2.0-or-later
 * @license MIT
 * @since 2013.11
 */

namespace UniversalLanguageSelector;

use MediaWiki\MediaWikiServices;

class ULSJsonMessageLoader {
    /**
     * Returns all message files that are used to load messages for the given
     * language.
     * @param string $language Language code.
     * @return string[]
     */
    public static function getFilenames( string $language ) {
        $filenames = [];

        $languages = MediaWikiServices::getInstance()->getLanguageFallback()->getAll( $language );
        // Prepend the requested language code
        // to load them all in one loop
        array_unshift( $languages, $language );

        // jQuery.uls localization
        foreach ( $languages as $language ) {
            $filenames[] = __DIR__ . "/../lib/jquery.uls/i18n/$language.json";
        }

        // mediaWiki.uls localization
        foreach ( $languages as $language ) {
            $filenames[] = __DIR__ . "/../i18n/$language.json";
        }

        $filenames = array_filter( $filenames, 'file_exists' );

        return $filenames;
    }

    /**
     * Get messages for the given language.
     * @param string $language Language code.
     * @return array
     */
    public static function getMessages( string $language ) {
        $contents = [];

        foreach ( self::getFilenames( $language ) as $filename ) {
            $contents += self::loadI18nFile( $filename );
        }

        return $contents;
    }

    /**
     * Load messages from a json file.
     * @param string $filename Directory of the json file.
     * @return array
     */
    protected static function loadI18nFile( $filename ) {
        $contents = file_get_contents( $filename );

        return json_decode( $contents, true );
    }
}