WordPress.org

Author: StephenCronin

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
• 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 and 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: $10

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: 10?).

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 leave a comment on the plugin's home page or contact me, I should be able 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.