WordPress.org

Ready to get started?Download WordPress

Plugin Directory

LocalCurrency

Show currency values to readers in their local currency (in brackets after the original value).

The LocalCurrency WordPress plugin allows visitors to see currency values in their local currency (in brackets after the original value). For example: If the site's currency is Chinese yuan and the post contains 10 yuan, a user from Australia will see 10 yuan (AUD$1.53), while a user from US will see 10 yuan (USD$1.39).

Why Use It?

I've seen many bloggers write something like: 10 yuan (about $1.50) - because many of their readers don't know how much the yuan (or whatever currency they are using) is worth. LocalCurrency automatically does this for you and tells readers exactly how much it's worth, in their own currency, wherever they are from.

Features:

  • Determines the reader's country via IP address, using IP2C
  • Obtains exchange rates from Yahoo! Finance
  • Uses 'AJAX' techniques so that converting currency values doesn't delay page load times
  • Caches exchange rates locally to minimise calls to Yahoo! Finance
  • Only does something if there is a currency value in the post
  • Allows visitors to change their currency via a selection box
  • Allows the conversion of a currency range (eg $50-100)
  • Gives site owner the ability to hide the original value if desired
  • Gives site owner the choice of using current or historic rates (ie at time of post).

How To Use (once plugin is installed)

Enter any currency values you want converted within <!--LCSTART--> and <!--LCEND--> tags. This can be done through the Code view. Simply select the number to be converted and click the LocalCurrency Quicktag. This should enter the tags for you. For example: <!--LCSTART-->$10<!--LCEND-->

For a currency range, use a hyphen between values (without spaces), eg: <!--LCSTART-->$50-100<!--LCEND-->

Note: If you disable the plugin, the tags will remain in your post but will not be shown, because they are in a HTML comment.

Warning

The plugin strips non numeric characters (such as $) from between the tags, before converting the value. However, some currency symbols may include numeric characters. For example, 10元 may be stored as 10&amp;#20803;. The 20803 will remain after the non numeric characters are stripped and will be considered as part of the value to convert, resulting in an incorrect value.

If you experience this problem, simply leave the currency sign outside the tags (ie: <!--LCSTART-->10<!--LCEND-->元).

Compatibility:

  • This plugin requires WordPress 2.8 or above.
  • I am not currently aware of any compatibility issues with any other WordPress plugins.

Support:

This plugin is officially not supported (due to my time constraints), but if you post problems to the support forum, I'll try to help.

Disclaimer

This plugin is released under the GPL licence. I do not accept any responsibility for any damages or losses, direct or indirect, that may arise from using the plugin or these instructions. This software is provided as is, with absolutely no warranty. Please refer to the full version of the GPL license for more information.

Requires: 2.8.0 or higher
Compatible up to: 3.6.1
Last Updated: 2013-10-25
Downloads: 4,169

Ratings

4 stars
4 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
1 person says it's broken.

100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
0,1,0