💵 Convert currencies within the text of a post or page.
🚀 If you have a wish to convert currencies “on the fly” within the text of a post or page then this is the plugin for you! It’s free to download, free to use and advert free – if you think you have to pay for something you’re doing it wrong!
So, let’s say you run a UK based site and will refer to currencies in GBP. However, the majority of visitors are from the US, so you may have a wish to also show the dollar equivalent. Using this plugin you can do this without having to work out the conversion and then re-visit it in future to take into account conversion changes.
Key features include…
👉 Please visit the Github page for the latest code development, planned enhancements and known issues 👈
🔑 Getting Your App Key
Open Currency Converter gets its data from the Open Exchange Rates website (which is not associated with this plugin nor the developer). This site requires an App Key to be specified for it to work. This is to prevent over-use of the exchange system and to provide premium features for users who wish to pay for them. Having a premium plan does not add any extra features to this plugin and is not a requirement.
To get your App Key…
Using the Shortcode
To add to your site simply use the [convert]
shortcode. For example…
[convert number=49.99 from="gbp" to="usd"]
This would convert 49.99 GBP to USD.
⚠️ Disclaimer
The exchange rate data is provided for free via the Open Source Exchange Rates project. Its accuracy and availability are never guaranteed, and there’s no warranty provided.
Once the plugin is activated two new administration screens will be present.
Before using this plugin it is highly recommended that you review the Options screen and change any values, as appropriate. You will also need to sign up for and enter an App Key before conversions will work.
The shortcode of ‘[convert]’ has the following parameters that you may specify…
Example of use are…
[convert number=49.99 from="gbp" to="usd"]
This would convert 49.99 from UK pounds to US dollars and output the result to 2 decimal places.
[convert number=50 from="usd" to="gbp"]
This would convert 50 from US dollars to UK pounds and output the result without any decimal places.
If the conversion can’t be done then an appropriate error message will be output instead. If you wish to suppress these messages then you need to use a template (see the later section on this) – in this case no output will be generated in the case of an error.
The template option allows you to specify other information to be output along with the conversion result. None of the template will be output if any error occurs, including any error messages, allowing you to suppress any conversion text in the case of a problem.
The template text must include %result%
where you wish the output to appear.
Here’s an example…
The retail price is $49.99[convert number=50 from=“use” to=“gap” template=" (approx.%result%) GBP”].
Normally, this would print a result such as…
The retail price is $49.99 (approx. 79.11 GBP).
However, if an error occurs then it will print as…
The retail price is $49.99.
You may also include the template between opening and closing shortcode tags. For example…
The retail price is $49.99[convert number=50 from=“use” to=“gap”] (approx. %result% GBP)[/convert].<h3>Using the Function Call</h3>
If you wish to perform a currency conversion within your theme, rather than within a post or page, then you can use a PHP function call. The function name is get_conversion
and will return the result back.
For example…
<?php echo get_conversion( 'number=49.99&from=gbp&to=usd' ); ?><h3>🌍 Global conversion variables</h3>
For the use of developers, 2 global variables have been added which, if assigned within your site code, will override the conversion codes.
The variables are global_convert_from
and global_convert_to
.
This is useful if, say, you have multiple versions of the site in different languages – you can then assign these global variables depending on which site is being viewed and all currency will be converted based upon these settings.
These will only override the options screen and not specific parameters specified with a shortcode or function call.
Open Currency Converter can be found and installed via the Plugin menu within WordPress administration (Plugins -> Add New). Alternatively, it can be downloaded from WordPress.org and installed manually…
artiss-currency-converter
folder to your wp-content/plugins/
directory.Voila! It’s ready to go.
I use semantic versioning, with the first release being 1.0.
Use of undefined constant global_convert_from
PHP warning