MLEB/cldr/README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

This extension contains local language names for different languages extracted
from CLDR data.

== Installation ==
Include it in LocalSettings.php:
 wfLoadExtension( 'cldr' );

== Updating data ==

Download newest data from CLDR site:
 https://www.unicode.org/cldr/repository_access.html

Example:
 wget https://www.unicode.org/Public/cldr/28/core.zip
 unzip core.zip -d core
 php rebuild.php

== Usage ==
<source lang=php>
	if ( is_callable( [ LanguageNames::class, 'getNames' ] ) ) {
		$languages = LanguageNames::getNames( 'en' ,
			LanguageNames::FALLBACK_NORMAL,
			LanguageNames::LIST_MW_AND_CLDR
		);
	} else {
		// If need to display something, use this as fallback
		$languages = Language::getLanguageNames( false );
	}
</source>

=== Parameters ===

For fallback:
* '''FALLBACK_NATIVE''': Go straight to MediaWiki's name entries
* '''FALLBACK_NORMAL''': Go through the fallback chain

For which languages to return:
* '''LIST_MW_SUPPORTED''': Only languages that has localisation in MediaWiki
* '''LIST_MW''': All languages that are in Names.php
* '''LIST_MW_AND_CLDR''': All languages that are either in MediaWiki or in cldr