Search moodle.org's
Developer Documentation
Developer Documentation
- Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
- Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
- PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
/lib/classes/ -> string_manager_standard.php (source)
Differences Between: [Versions 311 and 400] [Versions 311 and 401] [Versions 311 and 402] [Versions 311 and 403]
1 <?php 2 // This file is part of Moodle - http://moodle.org/ 3 // 4 // Moodle is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // Moodle is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU General Public License for more details. 13 // 14 // You should have received a copy of the GNU General Public License 15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>. 16 17 /** 18 * Standard string manager. 19 * 20 * @package core 21 * @copyright 2010 Petr Skoda {@link http://skodak.org} 22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later 23 */ 24 25 defined('MOODLE_INTERNAL') || die(); 26 27 28 /** 29 * Standard string_manager implementation 30 * 31 * Implements string_manager with getting and printing localised strings 32 * 33 * @package core 34 * @copyright 2010 Petr Skoda {@link http://skodak.org} 35 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later 36 */ 37 class core_string_manager_standard implements core_string_manager { 38 /** @var string location of all packs except 'en' */ 39 protected $otherroot; 40 /** @var string location of all lang pack local modifications */ 41 protected $localroot; 42 /** @var cache lang string cache - it will be optimised more later */ 43 protected $cache; 44 /** @var int get_string() counter */ 45 protected $countgetstring = 0; 46 /** @var bool use disk cache */ 47 protected $translist; 48 /** @var array language aliases to use in the language selector */ 49 protected $transaliases = []; 50 /** @var cache stores list of available translations */ 51 protected $menucache; 52 /** @var array list of cached deprecated strings */ 53 protected $cacheddeprecated; 54 55 /** 56 * Create new instance of string manager 57 * 58 * @param string $otherroot location of downloaded lang packs - usually $CFG->dataroot/lang 59 * @param string $localroot usually the same as $otherroot 60 * @param array $translist limit list of visible translations 61 * @param array $transaliases aliases to use for the languages in the language selector 62 */ 63 public function __construct($otherroot, $localroot, $translist, $transaliases = []) { 64 $this->otherroot = $otherroot; 65 $this->localroot = $localroot; 66 if ($translist) { 67 $this->translist = array_combine($translist, $translist); 68 $this->transaliases = $transaliases; 69 } else { 70 $this->translist = array(); 71 } 72 73 if ($this->get_revision() > 0) { 74 // We can use a proper cache, establish the cache using the 'String cache' definition. 75 $this->cache = cache::make('core', 'string'); 76 $this->menucache = cache::make('core', 'langmenu'); 77 } else { 78 // We only want a cache for the length of the request, create a static cache. 79 $options = array( 80 'simplekeys' => true, 81 'simpledata' => true 82 ); 83 $this->cache = cache::make_from_params(cache_store::MODE_REQUEST, 'core', 'string', array(), $options); 84 $this->menucache = cache::make_from_params(cache_store::MODE_REQUEST, 'core', 'langmenu', array(), $options); 85 } 86 } 87 88 /** 89 * Returns list of all explicit parent languages for the given language. 90 * 91 * English (en) is considered as the top implicit parent of all language packs 92 * and is not included in the returned list. The language itself is appended to the 93 * end of the list. The method is aware of circular dependency risk. 94 * 95 * @see self::populate_parent_languages() 96 * @param string $lang the code of the language 97 * @return array all explicit parent languages with the lang itself appended 98 */ 99 public function get_language_dependencies($lang) { 100 return $this->populate_parent_languages($lang); 101 } 102 103 /** 104 * Load all strings for one component 105 * 106 * @param string $component The module the string is associated with 107 * @param string $lang 108 * @param bool $disablecache Do not use caches, force fetching the strings from sources 109 * @param bool $disablelocal Do not use customized strings in xx_local language packs 110 * @return array of all string for given component and lang 111 */ 112 public function load_component_strings($component, $lang, $disablecache = false, $disablelocal = false) { 113 global $CFG; 114 115 list($plugintype, $pluginname) = core_component::normalize_component($component); 116 if ($plugintype === 'core' and is_null($pluginname)) { 117 $component = 'core'; 118 } else { 119 $component = $plugintype . '_' . $pluginname; 120 } 121 122 $cachekey = $lang.'_'.$component.'_'.$this->get_key_suffix(); 123 124 $cachedstring = $this->cache->get($cachekey); 125 if (!$disablecache and !$disablelocal) { 126 if ($cachedstring !== false) { 127 return $cachedstring; 128 } 129 } 130 131 // No cache found - let us merge all possible sources of the strings. 132 if ($plugintype === 'core') { 133 $file = $pluginname; 134 if ($file === null) { 135 $file = 'moodle'; 136 } 137 $string = array(); 138 // First load english pack. 139 if (!file_exists("$CFG->dirroot/lang/en/$file.php")) { 140 return array(); 141 } 142 include("$CFG->dirroot/lang/en/$file.php"); 143 $enstring = $string; 144 145 // And then corresponding local if present and allowed. 146 if (!$disablelocal and file_exists("$this->localroot/en_local/$file.php")) { 147 include("$this->localroot/en_local/$file.php"); 148 } 149 // Now loop through all langs in correct order. 150 $deps = $this->get_language_dependencies($lang); 151 foreach ($deps as $dep) { 152 // The main lang string location. 153 if (file_exists("$this->otherroot/$dep/$file.php")) { 154 include("$this->otherroot/$dep/$file.php"); 155 } 156 if (!$disablelocal and file_exists("$this->localroot/{$dep}_local/$file.php")) { 157 include("$this->localroot/{$dep}_local/$file.php"); 158 } 159 } 160 161 } else { 162 if (!$location = core_component::get_plugin_directory($plugintype, $pluginname) or !is_dir($location)) { 163 return array(); 164 } 165 if ($plugintype === 'mod') { 166 // Bloody mod hack. 167 $file = $pluginname; 168 } else { 169 $file = $plugintype . '_' . $pluginname; 170 } 171 $string = array(); 172 // First load English pack. 173 if (!file_exists("$location/lang/en/$file.php")) { 174 // English pack does not exist, so do not try to load anything else. 175 return array(); 176 } 177 include("$location/lang/en/$file.php"); 178 $enstring = $string; 179 // And then corresponding local english if present. 180 if (!$disablelocal and file_exists("$this->localroot/en_local/$file.php")) { 181 include("$this->localroot/en_local/$file.php"); 182 } 183 184 // Now loop through all langs in correct order. 185 $deps = $this->get_language_dependencies($lang); 186 foreach ($deps as $dep) { 187 // Legacy location - used by contrib only. 188 if (file_exists("$location/lang/$dep/$file.php")) { 189 include("$location/lang/$dep/$file.php"); 190 } 191 // The main lang string location. 192 if (file_exists("$this->otherroot/$dep/$file.php")) { 193 include("$this->otherroot/$dep/$file.php"); 194 } 195 // Local customisations. 196 if (!$disablelocal and file_exists("$this->localroot/{$dep}_local/$file.php")) { 197 include("$this->localroot/{$dep}_local/$file.php"); 198 } 199 } 200 } 201 202 // We do not want any extra strings from other languages - everything must be in en lang pack. 203 $string = array_intersect_key($string, $enstring); 204 205 if (!$disablelocal) { 206 // Now we have a list of strings from all possible sources, 207 // cache it in MUC cache if not already there. 208 if ($cachedstring === false) { 209 $this->cache->set($cachekey, $string); 210 } 211 } 212 return $string; 213 } 214 215 /** 216 * Parses all deprecated.txt in all plugins lang locations and returns the list of deprecated strings. 217 * 218 * Static variable is used for caching, this function is only called in dev environment. 219 * 220 * @return array of deprecated strings in the same format they appear in deprecated.txt files: "identifier,component" 221 * where component is a normalised component (i.e. "core_moodle", "mod_assign", etc.) 222 */ 223 protected function load_deprecated_strings() { 224 global $CFG; 225 226 if ($this->cacheddeprecated !== null) { 227 return $this->cacheddeprecated; 228 } 229 230 $this->cacheddeprecated = array(); 231 $content = ''; 232 $filename = $CFG->dirroot . '/lang/en/deprecated.txt'; 233 if (file_exists($filename)) { 234 $content .= file_get_contents($filename); 235 } 236 foreach (core_component::get_plugin_types() as $plugintype => $plugintypedir) { 237 foreach (core_component::get_plugin_list($plugintype) as $pluginname => $plugindir) { 238 $filename = $plugindir.'/lang/en/deprecated.txt'; 239 if (file_exists($filename)) { 240 $content .= "\n". file_get_contents($filename); 241 } 242 } 243 } 244 245 $strings = preg_split('/\s*\n\s*/', $content, -1, PREG_SPLIT_NO_EMPTY); 246 $this->cacheddeprecated = array_flip($strings); 247 248 return $this->cacheddeprecated; 249 } 250 251 /** 252 * Has string been deprecated? 253 * 254 * Usually checked only inside get_string() to display debug warnings. 255 * 256 * @param string $identifier The identifier of the string to search for 257 * @param string $component The module the string is associated with 258 * @return bool true if deprecated 259 */ 260 public function string_deprecated($identifier, $component) { 261 $deprecated = $this->load_deprecated_strings(); 262 list($plugintype, $pluginname) = core_component::normalize_component($component); 263 $normcomponent = $pluginname ? ($plugintype . '_' . $pluginname) : $plugintype; 264 return isset($deprecated[$identifier . ',' . $normcomponent]); 265 } 266 267 /** 268 * Does the string actually exist? 269 * 270 * get_string() is throwing debug warnings, sometimes we do not want them 271 * or we want to display better explanation of the problem. 272 * Note: Use with care! 273 * 274 * @param string $identifier The identifier of the string to search for 275 * @param string $component The module the string is associated with 276 * @return boot true if exists 277 */ 278 public function string_exists($identifier, $component) { 279 $lang = current_language(); 280 $string = $this->load_component_strings($component, $lang); 281 return isset($string[$identifier]); 282 } 283 284 /** 285 * Get String returns a requested string 286 * 287 * @param string $identifier The identifier of the string to search for 288 * @param string $component The module the string is associated with 289 * @param string|object|array $a An object, string or number that can be used 290 * within translation strings 291 * @param string $lang moodle translation language, null means use current 292 * @return string The String ! 293 */ 294 public function get_string($identifier, $component = '', $a = null, $lang = null) { 295 global $CFG; 296 297 $this->countgetstring++; 298 // There are very many uses of these time formatting strings without the 'langconfig' component, 299 // it would not be reasonable to expect that all of them would be converted during 2.0 migration. 300 static $langconfigstrs = array( 301 'strftimedate' => 1, 302 'strftimedatefullshort' => 1, 303 'strftimedateshort' => 1, 304 'strftimedatetime' => 1, 305 'strftimedatetimeshort' => 1, 306 'strftimedaydate' => 1, 307 'strftimedaydatetime' => 1, 308 'strftimedayshort' => 1, 309 'strftimedaytime' => 1, 310 'strftimemonthyear' => 1, 311 'strftimerecent' => 1, 312 'strftimerecentfull' => 1, 313 'strftimetime' => 1); 314 315 if (empty($component)) { 316 if (isset($langconfigstrs[$identifier])) { 317 $component = 'langconfig'; 318 } else { 319 $component = 'moodle'; 320 } 321 } 322 323 if ($lang === null) { 324 $lang = current_language(); 325 } 326 327 $string = $this->load_component_strings($component, $lang); 328 329 if (!isset($string[$identifier])) { 330 if ($component === 'pix' or $component === 'core_pix') { 331 // This component contains only alt tags for emoticons, not all of them are supposed to be defined. 332 return ''; 333 } 334 if ($identifier === 'parentlanguage' and ($component === 'langconfig' or $component === 'core_langconfig')) { 335 // Identifier parentlanguage is a special string, undefined means use English if not defined. 336 return 'en'; 337 } 338 // Do not rebuild caches here! 339 // Devs need to learn to purge all caches after any change or disable $CFG->langstringcache. 340 if (!isset($string[$identifier])) { 341 // The string is still missing - should be fixed by developer. 342 if ($CFG->debugdeveloper) { 343 list($plugintype, $pluginname) = core_component::normalize_component($component); 344 if ($plugintype === 'core') { 345 $file = "lang/en/{$component}.php"; 346 } else if ($plugintype == 'mod') { 347 $file = "mod/{$pluginname}/lang/en/{$pluginname}.php"; 348 } else { 349 $path = core_component::get_plugin_directory($plugintype, $pluginname); 350 $file = "{$path}/lang/en/{$plugintype}_{$pluginname}.php"; 351 } 352 debugging("Invalid get_string() identifier: '{$identifier}' or component '{$component}'. " . 353 "Perhaps you are missing \$string['{$identifier}'] = ''; in {$file}?", DEBUG_DEVELOPER); 354 } 355 return "[[$identifier]]"; 356 } 357 } 358 359 $string = $string[$identifier]; 360 361 if ($a !== null) { 362 // Process array's and objects (except lang_strings). 363 if (is_array($a) or (is_object($a) && !($a instanceof lang_string))) { 364 $a = (array)$a; 365 $search = array(); 366 $replace = array(); 367 foreach ($a as $key => $value) { 368 if (is_int($key)) { 369 // We do not support numeric keys - sorry! 370 continue; 371 } 372 if (is_array($value) or (is_object($value) && !($value instanceof lang_string))) { 373 // We support just string or lang_string as value. 374 continue; 375 } 376 $search[] = '{$a->'.$key.'}'; 377 $replace[] = (string)$value; 378 } 379 if ($search) { 380 $string = str_replace($search, $replace, $string); 381 } 382 } else { 383 $string = str_replace('{$a}', (string)$a, $string); 384 } 385 } 386 387 if ($CFG->debugdeveloper) { 388 // Display a debugging message if sting exists but was deprecated. 389 if ($this->string_deprecated($identifier, $component)) { 390 list($plugintype, $pluginname) = core_component::normalize_component($component); 391 $normcomponent = $pluginname ? ($plugintype . '_' . $pluginname) : $plugintype; 392 debugging("String [{$identifier},{$normcomponent}] is deprecated. ". 393 'Either you should no longer be using that string, or the string has been incorrectly deprecated, in which case you should report this as a bug. '. 394 'Please refer to https://docs.moodle.org/dev/String_deprecation', DEBUG_DEVELOPER); 395 } 396 } 397 398 return $string; 399 } 400 401 /** 402 * Returns information about the core_string_manager performance. 403 * 404 * @return array 405 */ 406 public function get_performance_summary() { 407 return array(array( 408 'langcountgetstring' => $this->countgetstring, 409 ), array( 410 'langcountgetstring' => 'get_string calls', 411 )); 412 } 413 414 /** 415 * Returns a localised list of all country names, sorted by localised name. 416 * 417 * @param bool $returnall return all or just enabled 418 * @param string $lang moodle translation language, null means use current 419 * @return array two-letter country code => translated name. 420 */ 421 public function get_list_of_countries($returnall = false, $lang = null) { 422 global $CFG; 423 424 if ($lang === null) { 425 $lang = current_language(); 426 } 427 428 $countries = $this->load_component_strings('core_countries', $lang); 429 core_collator::asort($countries); 430 431 if (!$returnall and !empty($CFG->allcountrycodes)) { 432 $enabled = explode(',', $CFG->allcountrycodes); 433 $return = array(); 434 foreach ($enabled as $c) { 435 if (isset($countries[$c])) { 436 $return[$c] = $countries[$c]; 437 } 438 } 439 440 if (!empty($return)) { 441 return $return; 442 } 443 } 444 445 return $countries; 446 } 447 448 /** 449 * Returns a localised list of languages, sorted by code keys. 450 * 451 * @param string $lang moodle translation language, null means use current 452 * @param string $standard language list standard 453 * - iso6392: three-letter language code (ISO 639-2/T) => translated name 454 * - iso6391: two-letter language code (ISO 639-1) => translated name 455 * @return array language code => translated name 456 */ 457 public function get_list_of_languages($lang = null, $standard = 'iso6391') { 458 if ($lang === null) { 459 $lang = current_language(); 460 } 461 462 if ($standard === 'iso6392') { 463 $langs = $this->load_component_strings('core_iso6392', $lang); 464 ksort($langs); 465 return $langs; 466 467 } else if ($standard === 'iso6391') { 468 $langs2 = $this->load_component_strings('core_iso6392', $lang); 469 static $mapping = array('aar' => 'aa', 'abk' => 'ab', 'afr' => 'af', 'aka' => 'ak', 'sqi' => 'sq', 'amh' => 'am', 'ara' => 'ar', 'arg' => 'an', 'hye' => 'hy', 470 'asm' => 'as', 'ava' => 'av', 'ave' => 'ae', 'aym' => 'ay', 'aze' => 'az', 'bak' => 'ba', 'bam' => 'bm', 'eus' => 'eu', 'bel' => 'be', 'ben' => 'bn', 'bih' => 'bh', 471 'bis' => 'bi', 'bos' => 'bs', 'bre' => 'br', 'bul' => 'bg', 'mya' => 'my', 'cat' => 'ca', 'cha' => 'ch', 'che' => 'ce', 'zho' => 'zh', 'chu' => 'cu', 'chv' => 'cv', 472 'cor' => 'kw', 'cos' => 'co', 'cre' => 'cr', 'ces' => 'cs', 'dan' => 'da', 'div' => 'dv', 'nld' => 'nl', 'dzo' => 'dz', 'eng' => 'en', 'epo' => 'eo', 'est' => 'et', 473 'ewe' => 'ee', 'fao' => 'fo', 'fij' => 'fj', 'fin' => 'fi', 'fra' => 'fr', 'fry' => 'fy', 'ful' => 'ff', 'kat' => 'ka', 'deu' => 'de', 'gla' => 'gd', 'gle' => 'ga', 474 'glg' => 'gl', 'glv' => 'gv', 'ell' => 'el', 'grn' => 'gn', 'guj' => 'gu', 'hat' => 'ht', 'hau' => 'ha', 'heb' => 'he', 'her' => 'hz', 'hin' => 'hi', 'hmo' => 'ho', 475 'hrv' => 'hr', 'hun' => 'hu', 'ibo' => 'ig', 'isl' => 'is', 'ido' => 'io', 'iii' => 'ii', 'iku' => 'iu', 'ile' => 'ie', 'ina' => 'ia', 'ind' => 'id', 'ipk' => 'ik', 476 'ita' => 'it', 'jav' => 'jv', 'jpn' => 'ja', 'kal' => 'kl', 'kan' => 'kn', 'kas' => 'ks', 'kau' => 'kr', 'kaz' => 'kk', 'khm' => 'km', 'kik' => 'ki', 'kin' => 'rw', 477 'kir' => 'ky', 'kom' => 'kv', 'kon' => 'kg', 'kor' => 'ko', 'kua' => 'kj', 'kur' => 'ku', 'lao' => 'lo', 'lat' => 'la', 'lav' => 'lv', 'lim' => 'li', 'lin' => 'ln', 478 'lit' => 'lt', 'ltz' => 'lb', 'lub' => 'lu', 'lug' => 'lg', 'mkd' => 'mk', 'mah' => 'mh', 'mal' => 'ml', 'mri' => 'mi', 'mar' => 'mr', 'msa' => 'ms', 'mlg' => 'mg', 479 'mlt' => 'mt', 'mon' => 'mn', 'nau' => 'na', 'nav' => 'nv', 'nbl' => 'nr', 'nde' => 'nd', 'ndo' => 'ng', 'nep' => 'ne', 'nno' => 'nn', 'nob' => 'nb', 'nor' => 'no', 480 'nya' => 'ny', 'oci' => 'oc', 'oji' => 'oj', 'ori' => 'or', 'orm' => 'om', 'oss' => 'os', 'pan' => 'pa', 'fas' => 'fa', 'pli' => 'pi', 'pol' => 'pl', 'por' => 'pt', 481 'pus' => 'ps', 'que' => 'qu', 'roh' => 'rm', 'ron' => 'ro', 'run' => 'rn', 'rus' => 'ru', 'sag' => 'sg', 'san' => 'sa', 'sin' => 'si', 'slk' => 'sk', 'slv' => 'sl', 482 'sme' => 'se', 'smo' => 'sm', 'sna' => 'sn', 'snd' => 'sd', 'som' => 'so', 'sot' => 'st', 'spa' => 'es', 'srd' => 'sc', 'srp' => 'sr', 'ssw' => 'ss', 'sun' => 'su', 483 'swa' => 'sw', 'swe' => 'sv', 'tah' => 'ty', 'tam' => 'ta', 'tat' => 'tt', 'tel' => 'te', 'tgk' => 'tg', 'tgl' => 'tl', 'tha' => 'th', 'bod' => 'bo', 'tir' => 'ti', 484 'ton' => 'to', 'tsn' => 'tn', 'tso' => 'ts', 'tuk' => 'tk', 'tur' => 'tr', 'twi' => 'tw', 'uig' => 'ug', 'ukr' => 'uk', 'urd' => 'ur', 'uzb' => 'uz', 'ven' => 've', 485 'vie' => 'vi', 'vol' => 'vo', 'cym' => 'cy', 'wln' => 'wa', 'wol' => 'wo', 'xho' => 'xh', 'yid' => 'yi', 'yor' => 'yo', 'zha' => 'za', 'zul' => 'zu'); 486 $langs1 = array(); 487 foreach ($mapping as $c2 => $c1) { 488 $langs1[$c1] = $langs2[$c2]; 489 } 490 ksort($langs1); 491 return $langs1; 492 493 } else { 494 debugging('Unsupported $standard parameter in get_list_of_languages() method: '.$standard); 495 } 496 497 return array(); 498 } 499 500 /** 501 * Checks if the translation exists for the language 502 * 503 * @param string $lang moodle translation language code 504 * @param bool $includeall include also disabled translations 505 * @return bool true if exists 506 */ 507 public function translation_exists($lang, $includeall = true) { 508 $translations = $this->get_list_of_translations($includeall); 509 return isset($translations[$lang]); 510 } 511 512 /** 513 * Returns localised list of installed translations 514 * 515 * @param bool $returnall return all or just enabled 516 * @return array moodle translation code => localised translation name 517 */ 518 public function get_list_of_translations($returnall = false) { 519 global $CFG; 520 521 $languages = array(); 522 523 $cachekey = 'list_'.$this->get_key_suffix(); 524 $cachedlist = $this->menucache->get($cachekey); 525 if ($cachedlist !== false) { 526 // The cache content is invalid. 527 if ($returnall or empty($this->translist)) { 528 return $cachedlist; 529 } 530 // Return only enabled translations. 531 foreach ($cachedlist as $langcode => $langname) { 532 if (array_key_exists($langcode, $this->translist)) { 533 $languages[$langcode] = !empty($this->transaliases[$langcode]) ? $this->transaliases[$langcode] : $langname; 534 } 535 } 536 537 // If there are no valid enabled translations, then return all languages. 538 if (!empty($languages)) { 539 return $languages; 540 } else { 541 return $cachedlist; 542 } 543 } 544 545 // Get all languages available in system. 546 $langdirs = get_list_of_plugins('', 'en', $this->otherroot); 547 $langdirs["$CFG->dirroot/lang/en"] = 'en'; 548 549 // We use left to right mark to demark the shortcodes contained in LTR brackets, but we need to do 550 // this hacky thing to have the utf8 char until we go php7 minimum and can simply put \u200E in 551 // a double quoted string. 552 $lrm = json_decode('"\u200E"'); 553 554 // Loop through all langs and get info. 555 foreach ($langdirs as $lang) { 556 if (strrpos($lang, '_local') !== false) { 557 // Just a local tweak of some other lang pack. 558 continue; 559 } 560 if (strrpos($lang, '_utf8') !== false) { 561 // Legacy 1.x lang pack. 562 continue; 563 } 564 if ($lang !== clean_param($lang, PARAM_SAFEDIR)) { 565 // Invalid lang pack name! 566 continue; 567 } 568 $string = $this->load_component_strings('langconfig', $lang); 569 if (!empty($string['thislanguage'])) { 570 $languages[$lang] = $string['thislanguage'].' '.$lrm.'('. $lang .')'.$lrm; 571 } 572 } 573 574 core_collator::asort($languages); 575 576 // Cache the list so that it can be used next time. 577 $this->menucache->set($cachekey, $languages); 578 579 if ($returnall or empty($this->translist)) { 580 return $languages; 581 } 582 583 $cachedlist = $languages; 584 585 // Return only enabled translations. 586 $languages = array(); 587 foreach ($cachedlist as $langcode => $langname) { 588 if (isset($this->translist[$langcode])) { 589 $languages[$langcode] = !empty($this->transaliases[$langcode]) ? $this->transaliases[$langcode] : $langname; 590 } 591 } 592 593 // If there are no valid enabled translations, then return all languages. 594 if (!empty($languages)) { 595 return $languages; 596 } else { 597 return $cachedlist; 598 } 599 } 600 601 /** 602 * Returns localised list of currencies. 603 * 604 * @param string $lang moodle translation language, null means use current 605 * @return array currency code => localised currency name 606 */ 607 public function get_list_of_currencies($lang = null) { 608 if ($lang === null) { 609 $lang = current_language(); 610 } 611 612 $currencies = $this->load_component_strings('core_currencies', $lang); 613 asort($currencies); 614 615 return $currencies; 616 } 617 618 /** 619 * Clears both in-memory and on-disk caches 620 * @param bool $phpunitreset true means called from our PHPUnit integration test reset 621 */ 622 public function reset_caches($phpunitreset = false) { 623 // Clear the on-disk disk with aggregated string files. 624 $this->cache->purge(); 625 $this->menucache->purge(); 626 627 if (!$phpunitreset) { 628 // Increment the revision counter. 629 $langrev = get_config('core', 'langrev'); 630 $next = time(); 631 if ($langrev !== false and $next <= $langrev and $langrev - $next < 60*60) { 632 // This resolves problems when reset is requested repeatedly within 1s, 633 // the < 1h condition prevents accidental switching to future dates 634 // because we might not recover from it. 635 $next = $langrev+1; 636 } 637 set_config('langrev', $next); 638 } 639 640 // Lang packs use PHP files in dataroot, it is better to invalidate opcode caches. 641 if (function_exists('opcache_reset')) { 642 opcache_reset(); 643 } 644 } 645 646 /** 647 * Returns cache key suffix, this enables us to store string + lang menu 648 * caches in local caches on cluster nodes. We can not use prefix because 649 * it would cause problems when creating subdirs in cache file store. 650 * @return string 651 */ 652 protected function get_key_suffix() { 653 $rev = $this->get_revision(); 654 if ($rev < 0) { 655 // Simple keys do not like minus char. 656 $rev = 0; 657 } 658 659 return $rev; 660 } 661 662 /** 663 * Returns string revision counter, this is incremented after any string cache reset. 664 * @return int lang string revision counter, -1 if unknown 665 */ 666 public function get_revision() { 667 global $CFG; 668 if (empty($CFG->langstringcache)) { 669 return -1; 670 } 671 if (isset($CFG->langrev)) { 672 return (int)$CFG->langrev; 673 } else { 674 return -1; 675 } 676 } 677 678 /** 679 * Helper method that recursively loads all parents of the given language. 680 * 681 * @see self::get_language_dependencies() 682 * @param string $lang language code 683 * @param array $stack list of parent languages already populated in previous recursive calls 684 * @return array list of all parents of the given language with the $lang itself added as the last element 685 */ 686 protected function populate_parent_languages($lang, array $stack = array()) { 687 688 // English does not have a parent language. 689 if ($lang === 'en') { 690 return $stack; 691 } 692 693 // Prevent circular dependency (and thence the infinitive recursion loop). 694 if (in_array($lang, $stack)) { 695 return $stack; 696 } 697 698 // Load language configuration and look for the explicit parent language. 699 if (!file_exists("$this->otherroot/$lang/langconfig.php")) { 700 return $stack; 701 } 702 $string = array(); 703 include("$this->otherroot/$lang/langconfig.php"); 704 705 if (empty($string['parentlanguage']) or $string['parentlanguage'] === 'en') { 706 return array_merge(array($lang), $stack); 707 708 } 709 710 $parentlang = $string['parentlanguage']; 711 return $this->populate_parent_languages($parentlang, array_merge(array($lang), $stack)); 712 } 713 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
