wp-cldr

Gives WordPress developers easy access to localized country, region, language, currency, and calendar info.

== Description ==

This plugin provides WordPress developers with easy access to localized country, language, currency, region, 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:

• Names for countries (and ISO 3166 country codes).
• Names for regions (and UN M.49 region codes, plus countries included in each region).
• Names and symbols for currencies (and ISO 4317 currency codes).
• Names for languages (and ISO 639 language codes).
• Calendar information including the first day of the week in different countries.
• Country information including most spoken language, currency, telephone codes, and population.

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.

== Installation ==

1. Upload the folder to the /wp-content/plugins/ directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. See the plugin in action via its settings page.
4. Build CLDR data into your site by using functions in the API documentation

== Frequently Asked Questions ==

= What locales are included? =

The plugin ships with JSON files for over 100 WordPress locales including ary, ar, az, bg_BG, bn_BD, bs_BA, ca, cy, da_DK, de_CH, de_DE, de_DE_formal, el, en_NZ, en_ZA, en_AU, en_GB, en_CA, eo, es_MX, es_VE, es_CL, es_ES, es_AR, es_PE, es_CO, et, eu, fa_IR, fi, fr_CA, fr_BE, fr_FR, gd, gl_ES, he_IL, hi_IN, hr, hu_HU, hy, id_ID, is_IS, it_IT, ja, ko_KR, lt_LT, ms_MY, my_MM, nl_NL, nn_NO, pl_PL, ps, pt_PT, pt_BR, ro_RO, ru_RU, sk_SK, sl_SI, sq, sr_RS, sv_SE, th, tl, tr_TR, ug_CN, uk, vi, zh_TW, zh_CN.

= Is there testing? =

Yes! The class includes a suite of PHPUnit tests. To run them, call phpunit from the plugin directory.

= Can the plugin handle high volume? =

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.

= Where do the JSON files come from? =

The scripts used to collect the JSON files are included in the repo. A bash script 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 prune-cldr-files.php removes unneeded locales and locale files from that download.

= Where can I report issues? =

Open up a new issue on Github at https://github.com/Automattic/wp-cldr/issues. We love pull requests!

Examples:

The default locale is English

$cldr = new WP_CLDR();
$territories_in_english = $cldr->get_territories();

You can override the default locale per-call by passing in a language slug in the second parameter

$germany_in_arabic = $cldr->get_territory_name( 'DE' , 'ar' );

Use a convenience parameter during instantiation to change the default locale

$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' );

Switch locales after the object has been created

$cldr->set_locale( 'en' );
$us_dollar_in_english = $cldr->get_currency_name( 'USD' );

Get CLDR's supplemental data

$telephone_code_in_france = $cldr->get_telephone_code( 'FR' );

Tags: i18n, internationalization, L10n, localization, unicode, CLDR