Gives WordPress developers easy access to localized country, region, language, currency, time zone, and calendar info.
This plugin gives WordPress developers easy access to localized country, region, language, currency, time zone, and calendar info from the Unicode Common Locale Data Repository.
With the plugin active, WordPress developers can access the following for over 100 WordPress locales:
More information in the detailed API documentation.
CLDR is a library of localization data coordinated by Unicode. It emphasizes common, everyday usage and is available in over 700 language-region locales. It is updated every six months and used by all major software systems. CLDR data is licensed under Unicode's data files and software license which is on the list of approved GPLv2 compatible licenses.
/wp-content/plugins/
directory.The plugin ships with JSON files for over 100 WordPress locales including ar
, ary
, az
, bg_BG
, bn_BD
, bs_BA
, ca
, cy
, da_DK
, de_CH
, de_DE
, de_DE_formal
, el
, en_US
, en_AU
, en_CA
, en_GB
, en_NZ
, en_ZA
, eo
, es_AR
, es_CL
, es_CO
, es_ES
, es_GT
, es_MX
, es_PE
, es_VE
, et
, eu
, fa_IR
, fi
, fr_BE
, fr_CA
, fr_FR
, gd
, gl_ES
, he_IL
, hi_IN
, hr
, hu_HU
, hy
, id_ID
, is_IS
, it_IT
, ja
, ka_GE
, ko_KR
, lt_LT
, ms_MY
, my_MM
, nb_NO
, nl_NL
, nl_NL_formal
, nn_NO
, pl_PL
, ps
, pt_BR
, pt_PT
, ro_RO
, ru_RU
, sk_SK
, sl_SI
, sq
, sr_RS
, sv_SE
, th
, tl
, tr_TR
, ug_CN
, uk
, vi
, zh_CN
, zh_TW
.
Yes! The class includes a suite of PHPUnit tests. To run them, call phpunit
from the plugin directory.
The plugin includes two layers of caching (in-memory arrays and the WordPress object cache) and is designed for high volume use. It is currently used on WordPress.com.
The scripts used to collect the JSON files are included in the repo. A bash script bash get-cldr-files.sh
uses wget to collect the files from Unicode's reference distribution of CLDR JSON on GitHub; a command-line PHP script php prune-cldr-files.php
removes unneeded locales and locale files from that download. Both should be run from within the wp-cldr
directory.
Open up a new issue on GitHub at https://github.com/Automattic/wp-cldr/issues. We love pull requests!
$cldr = new WP_CLDR();
$territories_in_english = $cldr->get_territories();
$germany_in_arabic = $cldr->get_territory_name( 'DE' , 'ar' );
$cldr = new WP_CLDR( 'fr' );
$germany_in_french = $cldr->get_territory_name( 'DE' );
$us_dollar_in_french = $cldr->get_currency_name( 'USD' );
$canadian_french_in_french = $cldr->get_language_name( 'fr-ca' );
$canadian_french_in_english = $cldr->get_language_name( 'fr-ca' , 'en' );
$german_in_german = $cldr->get_language_name( 'de_DE' , 'de-DE' );
$bengali_in_japanese = $cldr->get_language_name( 'bn_BD' , 'ja_JP' );
$us_dollar_symbol_in_simplified_chinese = $cldr->get_currency_symbol( 'USD', 'zh' );
$africa_in_french = $cldr->get_territory_name( '002' );
$cldr->set_locale( 'en' );
$us_dollar_in_english = $cldr->get_currency_name( 'USD' );
$languages_spoken_in_south_africa = $cldr->get_languages_spoken( 'ZA' );
Tags: i18n, internationalization, L10n, localization, unicode, CLDR