WorldCurrency plugin for wordpress recognises users by IP address and shows them converted values in their local currency, you can write post/pages in multiple currencies.
- Current version: 1.15
- Last release date: 13 June 2012
- Last checkup: 6 october 2012
- Tested down to: WordPress 3.2.1 (should work on 2.8)
- Tested up to: WordPress 3.4.2
- Download: from WordPress Plugin Directory
Show currency values to readers in their local currency, you can use multipe currencies per post. [ worldcurrency curr="THB" value="120"] will became (~3.5$ USD) in United States and (~3€ EUR) from Europe
Why Use It?
It is really usefull (expecially for travel and commerce blogs) to show prices in the currency of the reader, so they’ll find themself at home
With this plugin you can obtain somethig like this: The price of the green curry was of 120 bath (~3€ EUR)
- Determines the reader’s country via IP address, using IP2C
- Obtains exchange rates from Yahoo! Finance
- Uses AJAX so that converting currency values doesn’t delay page load times
- Caches exchange rates locally to minimize calls to Yahoo! Finance
- Only does something if there is a currency value in the post
- Allows to specify different currencies per post/page
- It is possible to totally personalize the output format, for example: EUR 2 | 2€ | (~2 EUR)
- Gives site owner the choice of using current or historic (at publishing time) rates (globally or also per single conversion/post).
- Allows visitors to change their currency via a selection box
- Currency selection box shorttag available
- Currency selection box widget available
- The currency selection box may be putted everywhere via html placeholder
- Is possible to choose to hide conversion if target and origin currency are the same
- Is possible to choose to make ajax calls over SSL
- Is possible to choose the decimal and thousands separator for the output format
- Is possible to force the target currency per each conversion
Enter any currency values you want converted with the [ worldcurrency] shorttag.
The price of a green curry soup is 120 bath [ worldcurrency curr="THB" value="120"]
will be shown as:
And at the bottom of the page or in the sidebar there will be this currency selector box:
- curr=”***” :: the name of the value currency
- value=”***” :: the value used for exchange
- target=”***” :: the name of the target currency (if you want to force it)
- historic=”true|false” :: (optional) override main plugin setting
This plugin is officially not supported, but if you leave a comment on the bottom of this page, I may help
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.
- Download the plugin file and unzip it.
- Upload the `worldcurrency` folder to the `wp-content/plugins/` folder.
- Activate the WorldCurrency plugin within WordPress.
Alternatively you can install the plugin automatically through the WordPress Admin interface by going to Plugins -> Add New and searching for WorldCurrency.
- Download the plugin file and unzip it.
- Upload the `worldcurrency` folder to the `wp-content/plugins/` folder, overwriting the existing files.
- Go to the plugin settings and Update or Reset them to be sure that new settings are saved.
Alternatively you can update this plugin through the WordPress Admin interface.
If the update includes a new currency that you need, il will appear only after a day because currency rates are cached.
If you are using historic rates than you have to delete “wc_rates” custom field from the post to have it refreshed with the new currency (but keep in mind that this will refresh also the other exchange rates)
Frequently Asked Questions
Will the plugin have extra features in the future
Extra features may be implemented if I find them usefull/interesting and if I have time to develop them.
Feel free to propose them.
I use the shortcode in another plugin (like wp-table-reloaded) and the conversions are not working
This is because in this cases the WorldCurrency plugin is not aware of the presence of these conversions and the necessary code is not loaded. You can add a wc_force = 1 custom field to posts or pages to force the loading of the necessary code in this cases.
Look in the WordPress Plugin Directory page
- Built on ideas and small code portions from LocalCurrency by Stephen Cronin
- This plugin uses IP2C to determine which country the visitor is from.
- This plugin uses Yahoo! Finance to determine the exchange rates.
This post is also available in: Italian