Firman Wandayandi

Instead of traditional “calculator” looks converter, Currencyr take the advance of “tooltip” and sit right at the amount to allow user convert it. Support various exchange rates provider API running as WP Cron task and able to auto-determinate local currency of visitor. Currencyr also offers currency converter widget, shortcode and function.
See it in action at http://demo.firmanw.com/wp/currencyr.
Note: This plugin requires PHP 5.3.0 or later, do not ever try to install if you running the older version.
<h4>Features</h4>
<ul>
<li>Inline converter using <a href="http://firmanw.github.com/jquery-currencyr" rel="nofollow ugc">Currencyr for jQuery</a></li>
<li>Various exchange rates providers – Yahoo!, Google, Open Exchange Rates, European Central Bank and FoxRates</li>
<li>Support database cache driven for fast response</li>
<li>WP Cron task scheduler enabled</li>
<li>Shortcode quick conversion support</li>
<li>Currency table and converter widget</li>
<li>Function for theme developer</li>
<li>Auto-determinate local currency via IP detection using <a href="http://firestats.cc/wiki/ip2c" rel="nofollow ugc">IP2C</a></li>
<li>Support integration with various ecommerce plugins – WooCommerce, WP-eCommerce, Shopp and Easy Digital Downloads</li>
<li>Translation support</li>
</ul>
<h4>Shortcode</h4>
To enable the shortcode simply use [currencyr] and use the following syntax:
<pre><code>[currencyr amount=$amount <from=$code> to=$code<|$code>]
</code></pre>
<ul>
<li>amount – The number that you wish to convert.</li>
<li>to – The currency code. Use “|” as separator for multiple conversion.</li>
<li>from (optional) – The currency code. If omitted the Base Currency from setting will be use.</li>
</ul>
Examples: 
 [currencyr amount=99.99 to=gbp]
<pre><code>[currencyr amount=99.99 from=aud to=gbp]

[currencyr amount=99.99 to=gbp|eur|cad]
</code></pre>
<h4>Function Call</h4>
The conversion feature is available to call within templates or codes using either currencyr_exchange() or the_currencyr_exchange(). Both functions share the same arguments, the diferrent is the_currencyr_exchange() is only echoes the result automatically. You can call the functions as WordPress style or PHP with the following arguments:
<ul>
<li>amount – The number that you wish to convert.</li>
<li>to – The currency code.</li>
<li>
from (optional) – The currency code. If omitted the Base Currency from setting will be use.
</li>
</ul>
The code above is similar to:
<pre><code><?php echo currencyr_exchange( array( 'amount' => 99.99, 'to' => 'cad' ) ); ?>
</code></pre>
Also similar to:
<pre><code><?php echo currencyr_exchange( 99.99, 'cad' ); ?>
</code></pre>
<h4>Roadmap</h4>
<ul>
<li>Add exchange rates table page</li>
<li>Add custom currency support</li>
</ul>
<h4>Feedback</h4>
If you have any feedback, tweet <a href="http://twitter.com/firmanw" rel="nofollow ugc">@firmanw</a> for fast response, or head over to the <a href="https://wordpress.org/support/plugin/currencyr" rel="ugc">support forum</a>.

Currencyr

A simple yet advanced, intuitive, easy-to-use and complete currency converter plugin with a beautiful unique converter tooltip.

David Artiss

🚀 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…
<ul>
<li>No need to update exchange rates yourself – data is fetched from an Open Source API</li>
<li>Over 170 currencies supported</li>
<li>An easy to use shortcode for embedding directly into your posts and pages</li>
<li>A PHP function for those people who wish to add features in their theme</li>
<li>Results can be cached, reducing resources and improving response</li>
<li>Template to allow you to control how results are output</li>
<li>Administration screen allowing you to define defaults and to view current exchange rates</li>
<li>And much, much more!</li>
</ul>
👉 Please visit the <a href="https://github.com/morehawes/open-currency-converter" title="Github" rel="nofollow ugc">Github page</a> for the latest code development, planned enhancements and known issues 👈
<h3>Getting Started</h3>
🔑 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…
<ol>
<li><a href="https://openexchangerates.org/signup/free" rel="nofollow ugc">Sign up on the Open Exchange Rates site</a> – this link will take you to the free option but the site does require personal information.</li>
<li>You should now be at <a href="https://openexchangerates.org/account" rel="nofollow ugc">your account screen</a>.</li>
<li>Click on the “App IDs” option in the side menu.</li>
<li>An App ID should be listed on the right hand side – copy this ID.</li>
<li>Head back to the admin of your website and select the Settings -> Open Currency menu.</li>
<li>Paste the App ID into the equivalent field at the top of the settings screen.</li>
<li>Click the “Save Changes” button.</li>
</ol>
Using the Shortcode
To add to your site simply use the <code>[convert]</code> shortcode. For example…
<pre><code>[convert number="100" from="gbp" to="cad"]
</code></pre>
This would convert 100 GBP to CAD.
⚠️ Disclaimer
The exchange rate data is provided for free via the <a href="http://openexchangerates.org/" title="Open Source Exchange Rates" rel="nofollow ugc">Open Source Exchange Rates</a> project. Its accuracy and availability are never guaranteed, and there’s no warranty provided.
<h3>🖥 The Options Screen</h3>
Once the plugin is activated two new administration screens will be present.
<ul>
<li>Open Currency – This appears under “Settings” and allows you to specify default settings for any currency conversion</li>
<li>Exchange Rates – Shown under the “Tools” menu, this displays the current exchange rates along with a list of all the valid exchange codes</li>
</ul>
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.
<h3>🗜 Using the Shortcode</h3>
The shortcode of ‘[convert]’ has the following parameters that you may specify…
<ul>
<li>number – The number that you wish to convert from one currency to another. This is required</li>
<li>from – The currency code that you wish to convert from (see the admin options for a list of valid codes). If you do not specify this value then the default from the options screen will be used</li>
<li>to – The currency code that you wish to convert to (see the admin options for a list of valid codes). If you do not specify this value then the default from the options screen will be used.</li>
<li>dp – How many decimal places the output should be. This should be numeric or the word “match”. The latter is the default and will mean that the output will match the number of decimal places that the number was.</li>
<li>template – See the later section, “Using Templates”, for further information</li>
<li>thousands_separator – The character that should be used to separate thousands in the output. This is a single character, such as a comma or period. If not specified then the default from the options screen will be used.</li>
</ul>
Example of use are…
<pre><code>[convert number=49.99 from="gbp" to="usd"]
</code></pre>
This would convert 49.99 from UK pounds to US dollars and output the result to 2 decimal places.
<pre><code>[convert number=50 from="usd" to="gbp"]
</code></pre>
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.
You can specify the thousands separator either through the options screen or by using the <code>thousands_separator</code> parameter (default is a comma). This will be used to format the output of the conversion result:
<pre><code>[convert number=50 from="usd" to="gbp" thousands_separator="."]<h3>🧩 Using Templates</h3>
</code></pre>
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 <code>%result%</code> where you wish the output to appear.
Here’s an example…
<pre><code>The retail price is $49.99[convert number=50 from=“use” to=“gap” template=" (approx.%result%) GBP”].
</code></pre>
Normally, this would print a result such as…
<pre><code>The retail price is $49.99 (approx. 79.11 GBP).
</code></pre>
However, if an error occurs then it will print as…
<pre><code>The retail price is $49.99.
</code></pre>
You may also include the template between opening and closing shortcode tags. For example…
<pre><code>The retail price is $49.99[convert number=50 from=“use” to=“gap”] (approx. %result% GBP)[/convert].<h3>Using the Function Call</h3>
</code></pre>
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 <code>get_conversion</code> and will return the result back.
<ul>
<li>All of the shortcode parameters are valid, except for the template which isn’t required</li>
<li>The parameters are specified in any order and are separated with an ampersand</li>
<li>You should not add quotes around each parameter value, as you do with the shortcode</li>
</ul>
For example…
<pre><code><?php echo get_conversion( 'number=49.99&from=gbp&to=usd' ); ?><h3>🌍 Global conversion variables</h3>
</code></pre>
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 <code>global_convert_from</code> and <code>global_convert_to</code>.
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

Not bloated and to the point. A developers dream!

Thanks for your contribution to the Wordpress ecosystem.

Perfect

💵 Convert currencies within the text of a post or page.

Currencyr vs Open Currency Converter