Title: WP CLDR
Author: Stu West
Published: <strong>March 21, 2016</strong>
Last modified: March 22, 2016

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/wp-cldr.svg)

# WP CLDR

 By [Stu West](https://profiles.wordpress.org/stuwest/)

[Download](https://downloads.wordpress.org/plugin/wp-cldr.1.0.zip)

 * [Details](https://en-au.wordpress.org/plugins/wp-cldr/#description)
 * [Reviews](https://en-au.wordpress.org/plugins/wp-cldr/#reviews)
 *  [Installation](https://en-au.wordpress.org/plugins/wp-cldr/#installation)
 * [Development](https://en-au.wordpress.org/plugins/wp-cldr/#developers)

 [Support](https://wordpress.org/support/plugin/wp-cldr/)

## 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](http://cldr.unicode.org/).

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](https://automattic.github.io/wp-cldr/class-WP_CLDR.html).

CLDR is a library of localization data coordinated by Unicode. It emphasizes [common, everyday usage](http://cldr.unicode.org/translation/country-names)
and is available in over 700 language-region locales. It is [updated every six months](http://cldr.unicode.org/index/downloads)
and used by [all major software systems](http://cldr.unicode.org/#TOC-Who-uses-CLDR-).
CLDR data is licensed under [Unicode’s data files and software license](http://unicode.org/copyright.html#Exhibit1)
which is on [the list of approved GPLv2 compatible licenses](https://www.gnu.org/philosophy/license-list.html#Unicode).

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

 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 [methods in the API documentation](https://automattic.github.io/wp-cldr/class-WP_CLDR.html)

## 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](http://cldr.unicode.org/index/cldr-spec/json);
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

 *   [ Stu West ](https://profiles.wordpress.org/stuwest/)

“WP CLDR” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-cldr/contributors)
for their contributions.

[Translate “WP CLDR” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-cldr)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-cldr/), check out
the [SVN repository](https://plugins.svn.wordpress.org/wp-cldr/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/wp-cldr/) by [RSS](https://plugins.trac.wordpress.org/log/wp-cldr/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0 (Mar 21, 2016)

 * Documentation & localization cleanup

#### 0.9 (Mar 17, 2016)

 * initial versioned release (for plugin review)

## Meta

 *  Version **1.0**
 *  Last updated **10 years ago**
 *  Active installations **Fewer than 10**
 *  WordPress Version ** 4.4 or higher **
 *  Tested up to **4.4.34**
 *  Languages
 * [English (US)](https://wordpress.org/plugins/wp-cldr/) and [Japanese](https://ja.wordpress.org/plugins/wp-cldr/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-cldr)
 * Tags
 * [i18n](https://en-au.wordpress.org/plugins/tags/i18n/)[internationalization](https://en-au.wordpress.org/plugins/tags/internationalization/)
   [l10n](https://en-au.wordpress.org/plugins/tags/l10n/)[localization](https://en-au.wordpress.org/plugins/tags/localization/)
   [unicode](https://en-au.wordpress.org/plugins/tags/unicode/)
 *  [Advanced View](https://en-au.wordpress.org/plugins/wp-cldr/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/wp-cldr/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-cldr/reviews/)

## Contributors

 *   [ Stu West ](https://profiles.wordpress.org/stuwest/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-cldr/)