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.
Features
- Inline converter using Currencyr for jQuery
- Various exchange rates providers – Yahoo!, Google, Open Exchange Rates, European Central Bank and FoxRates
- Support database cache driven for fast response
- WP Cron task scheduler enabled
- Shortcode quick conversion support
- Currency table and converter widget
- Function for theme developer
- Auto-determinate local currency via IP detection using IP2C
- Support integration with various ecommerce plugins – WooCommerce, WP-eCommerce, Shopp and Easy Digital Downloads
- Translation support
Shortcode
To enable the shortcode simply use [currencyr] and use the following syntax:
[currencyr amount=$amount <from=$code> to=$code<|$code>]
- amount – The number that you wish to convert.
- to – The currency code. Use “|” as separator for multiple conversion.
- from (optional) – The currency code. If omitted the Base Currency from setting will be use.
Examples:
[currencyr amount=99.99 to=gbp]
[currencyr amount=99.99 from=aud to=gbp]
[currencyr amount=99.99 to=gbp|eur|cad]
Function Call
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:
- amount – The number that you wish to convert.
- to – The currency code.
-
from (optional) – The currency code. If omitted the Base Currency from setting will be use.
The code above is similar to:
<?php echo currencyr_exchange( array( 'amount' => 99.99, 'to' => 'cad' ) ); ?>
Also similar to:
<?php echo currencyr_exchange( 99.99, 'cad' ); ?>
Roadmap
- Add exchange rates table page
- Add custom currency support
Feedback
If you have any feedback, tweet @firmanw for fast response, or head over to the support forum.
Download & install the zip archive
The plugin package installer can be downloaded from the WP2E project tab called “code”.
1 – Select the version to download if this option is available otherwise the “latest” version of the main plugin will be used.
2 – After downloading the zip archive install the plugin package installer in you local environment and activate the script from the plugin list.
3 – Under the section “Plugins” of the admin dashboard you should see a new “Dependencies & Licenses” link. Follow the instructions from this panel to finalize the installation of the missing dependencies.
-
- Give a name to your project
-
- Download the Installer Package
-
- Install & activate the plugin locally
-
- Install the suggested dependencies
Tips: Use the WP2E panel to add/suggest new dependencies to the local installation. Press F5 in the list of dependencies if the changes are not displayed right away.