Description
A cache-compatible WordPress plugin which converts all prices of the currency of
your choice in a post or page in the viewer’s local currency. LocalMoney relies
on the WP-cron system to fetch and cache the rates from
Open Exchange Rates
on an hourly basis and then uses javascript to lookup the visitor’s location and
fetch the appropriate rate data. This means that, unlike some plugins I could mention,
LocalMoney is compatible with caching plugins.
LocalMoney, once configured, immediately (or as soon as your cache updates) acts
on all your posts and pages without you having to mark up the prices in your text.
Features
- Determines the reader’s country via IP address, using IP2C
- Resolves proxies with the ‘forwarded-for’ header so AOL-compatible
- If IP2C fails uses the language settings and timezone offset to guess location
- Obtains exchange rates from openexchangerates.org
- Uses AJAX so that converting currency values doesn’t delay page load times
- Caches exchange rates locally to minimize calls to openexchangerates.org
- Output prices matched to format of input prices (i.e. with or without cents)
How to Use
Once LocalMoney is installed it will take any page on which US dollar prices are
displayed and convert them to the visitors local currency. If your posts are written
with another currency you can change the base currency in the Settings > LocalMoney
page.
Internationalization (i18n)
Currently LocalMoney has not been translated to any languages other than English.
If you wish, feel free to create a translation. Here are the basic steps:
- Copy “localmoney-en.po” to “localmoney-LANG_COUNTRY.po” – fill in LANG and COUNTRY with whatever you use for WPLANG in wp-config.php.
- Grab a transalation editor. POedit works for us.
- Translate each line.
- Send your new localmoney-LANG_COUNTRY.po file to steve@machinesthatgobing.com.
- Your translation will be incorporated in the next release.