35bbceb384
I specified one year as the desirable value on the bug, but one month is probably saner since we're still hammering out the details of how to deliver this data. Bug: 56509 Change-Id: I4e3664f953e25b2c01b9c1f75d3aa27ef7e3af4f
113 lines
3.0 KiB
PHP
113 lines
3.0 KiB
PHP
<?php
|
|
/**
|
|
* Localization API 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
|
|
* @licence GNU General Public Licence 2.0 or later
|
|
* @licence MIT License
|
|
*/
|
|
|
|
/**
|
|
* @ingroup API
|
|
*/
|
|
class ApiULSLocalization extends ApiBase {
|
|
|
|
public function execute() {
|
|
$this->getMain()->setCacheMode( 'public' );
|
|
$this->getMain()->setCacheMaxAge( 2419200 );
|
|
|
|
$params = $this->extractRequestParams();
|
|
$language = $params['language'];
|
|
if ( !Language::isValidCode( $language ) ) {
|
|
$this->dieUsage( 'Invalid language', 'invalidlanguage' );
|
|
}
|
|
|
|
$contents = array();
|
|
// jQuery.uls localization
|
|
$contents += $this->loadI18nFile( __DIR__ . '/../lib/jquery.uls/i18n', $language );
|
|
// mediaWiki.uls localization
|
|
$contents += $this->loadI18nFile( __DIR__ . '/../i18n', $language );
|
|
|
|
// Output the file's contents raw
|
|
$this->getResult()->addValue( null, 'text', json_encode( $contents ) );
|
|
$this->getResult()->addValue( null, 'mime', 'application/json' );
|
|
}
|
|
|
|
/**
|
|
* Load messages from the jquery.i18n json file and from
|
|
* fallback languages.
|
|
* @param string $dir Directory of the json file.
|
|
* @param string $language Language code.
|
|
* @return array
|
|
*/
|
|
protected function loadI18nFile( $dir, $language ) {
|
|
$languages = Language::getFallbacksFor( $language );
|
|
// Prepend the requested language code
|
|
// to load them all in one loop
|
|
array_unshift( $languages, $language );
|
|
$messages = array();
|
|
|
|
foreach ( $languages as $language ) {
|
|
$filename = "$dir/$language.json";
|
|
|
|
if ( !file_exists( $filename ) ) {
|
|
continue;
|
|
}
|
|
|
|
$contents = file_get_contents( $filename );
|
|
$messagesForLanguage = json_decode( $contents, true );
|
|
$messages = array_merge( $messagesForLanguage, $messages );
|
|
}
|
|
|
|
return $messages;
|
|
}
|
|
|
|
public function getCustomPrinter() {
|
|
return new ApiFormatRaw(
|
|
$this->getMain(),
|
|
$this->getMain()->createPrinterByName( 'json' )
|
|
);
|
|
}
|
|
|
|
public function getAllowedParams() {
|
|
return array(
|
|
'language' => array(
|
|
ApiBase::PARAM_REQUIRED => true,
|
|
ApiBase::PARAM_TYPE => 'string',
|
|
),
|
|
);
|
|
}
|
|
|
|
public function getParamDescription() {
|
|
return array(
|
|
'language' => 'Language string',
|
|
);
|
|
}
|
|
|
|
public function getDescription() {
|
|
return 'Get the localization of ULS in given language';
|
|
}
|
|
|
|
public function getExamples() {
|
|
return array(
|
|
'api.php?action=ulslocalization&language=ta',
|
|
'api.php?action=ulslocalization&language=hi',
|
|
);
|
|
}
|
|
|
|
public function getVersion() {
|
|
return __CLASS__ . ': ' . ULS_VERSION;
|
|
}
|
|
}
|