Description
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:
- Names for countries (and ISO 3166 country codes).
- Names for regions (and UN M.49 region codes, plus countries included in each region).
- Names for languages (and ISO 639 language codes).
- Names and symbols for currencies (and ISO 4317 currency codes).
- Names for time zone example cities (and IANA time zone IDs).
- Calendar information including the first day of the week in different countries.
- Country information including telephone codes, most spoken languages, currency, 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.
Follow along with or contribute to the development of this plugin at https://github.com/Automattic/wp-cldr.
Screenshots
Examples of data available for the locale es_MX, Spanish (Mexico)
Examples of data available for the locale pt_BR, Portuguese (Brazil)
Examples of data available for the locale zh_CN, Chinese (China)
Examples of data available for the locale hi_IN, Hindi
Installation
- Upload the folder to the
/wp-content/plugins/directory. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- See the plugin in action via its settings page.
- Build CLDR data into your site by using methods in the API documentation
FAQ
What locales are included?
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.
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 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.
Where can I report issues?
Open up a new issue on GitHub at https://github.com/Automattic/wp-cldr/issues. We love pull requests!
Reviews
There are no reviews for this plugin.
Contributors & Developers
“WP CLDR” is open source software. The following people have contributed to this plugin.
Contributors
“WP CLDR” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “WP CLDR” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0 (Mar 21, 2016)
- Documentation & localization cleanup
0.9 (Mar 17, 2016)
- initial versioned release (for plugin review)