WP Currencies

Description

WP Currencies uses openexchangerates.org to pull currency data and currency exchange rates in WordPress.

The currencies and their exchange rates will be periodically updated at intervals set from the WordPress dashboard by an administrator.

The plugin is intended for developers that want to access currencies data and currency exchange rates from within WordPress and perform basic currency rates conversions. WP Currencies comes with a functions library to retrieve currency data and exchange rates as PHP arrays or json objects in ajax calls.

Furthermore, it extends JSON REST WP API with new routes, and, if you use Advanced Custom Fields (ACF), WP Currencies will also add a new “Currency” field for use in ACF.

If you use WPML and have both WooCommerce and WooCommerce MultiLingual installed, you can use this plugin to filter WCML currency rate using one of their hooks and update rates on the fly.

Important – You will need an API key from http://www.openexchangerates.org/ to pull currency data and make this plugin work properly (either choose the forever free plan or one of their premium subscriptions).

Documentation

A more complete documentation for this plugin is found in the Github wiki.

Contributing

To contribute with bug reports or submit pull requests, please refer to WP Currencies repository on Github, thank you.

Functions

For the full documentation, please refer to the WP Currencies wiki on Github.

Screenshots

  • The plugin settings page
  • An example of a json object with currency rates with US Dollar as base currency

FAQ

I’ve installed the plugin but I don’t see anything!

Please read again the plugin description and read the documentation.
WP Currencies by this time doesn’t offer any WYSIWYG functionality, but it’s intended for developers who want to build solutions using currency data and exchange rates – which this plugin provides with an API for using those in WordPress.

Is this plugin created or endorsed by Open Exchange Rates?

No it is not. It just makes use of their public API within their Terms and Conditions policy: https://openexchangerates.org/terms.

Can you guarantee that the currency exchange rates provided will be accurate?

No. As Open Exchange Rates itself says: “Exchange rates are provided for informational purposes only, and do not constitute financial advice of any kind. Although every attempt is made to ensure quality, NO guarantees are given whatsoever of accuracy, validity, availability, or fitness for any purpose – please use at your own risk.”
It is not recommended to use this plugin in critical business scenarios. The plugin author(s) nor the currency exchange rates provider(s) will not be responsible for financial loss or damage caused by data inaccuracies. Please refer to the GPL license and Open Exchange Rates terms and conditions for further information.

What if I exceed my Open Exchange Rates API request quota?

This plugin will be unable to update the database and older, may throw a warning when it tries to do so (as if it would with an invalid API key) and less accurate currency rates will be used (those recorded in the database at the time of the last update).
You can monitor your quota usage according to your subscription plan by logging into your Open Exchange Rates account at https://openexchangerates.org/.
From the plugin settings, you can specify a less frequent interval of database updates to make less API requests. Please note that if you make use of the API elsewhere and perform more requests, they will be counted by Open Exchange Rates and summed up with the ones triggered by this plugin.

WP Currencies runs but the currencies aren’t refreshed at the intervals I’ve set – why?

This could be related to cron not working properly in your host. Please refer to the Troubleshooting section of WP Currencies documentation.

Reviews

COMPATIBILITY

lucialu

Hello does your plugin work with multi-currency setup (provided by WPML+WCML) when currently selected currency is not the default one?

Read all 4 reviews

Changelog

1.4.6

  • Further improvements in handling wp cron and scheduled events hooks
  • Introduced wp_currencies_update() function

1.4.4

  • Removed deprecated code in ACF 5.x support that was triggering an error

1.4.3

  • ‘DOING_CRON’ wrapper check added to wp cron callback action to prevent firing too many updates
  • Added new action hooks (see documentation)

1.4.1

  • Fixes a critical bug from 1.4.0 where too many currency update requests were fired – please update

1.4.0

  • Better OOP rewrite of the whole plugin
  • PHP 5.4 is the minimum requirement now
  • Improved security and performance
  • Introduced new hooks (see documentation)

1.3.0

  • Removed support for WCML (use the new WCML hooks instead)

1.2.5

  • Supports WordPress 4.2

1.2.4

  • Fixes “The plugin generated … characters of unexpected output” upon activation

1.2.2

  • Fixes missing database table creation on plugin activation (you may want to deactivate and reactivate plugin after upgrade if were experiencing issues)

1.2.1

  • Fixes broken link to plugin settings page

1.2.0

  • Added support to WooCommerce MultiLanguage
  • Updated Settings Page
  • The plugin now uses wp_cron for periodical updates
  • Introduced currency_exists() function
  • Bugfixes

1.1.3

  • Added field support for Advanced Custom Fields 5.x
  • More currency data

1.1.1

  • Bugfix (accidentally deactivated admin class in 1.1.0)

1.1.0

  • Introduced format_currency() function
  • Added endpoints for JSON REST API (WP API)
  • Added a “Currency field” for Advanced Custom Fields 4.x

1.0.0

  • First release

Contributors & Developers

WP Currencies is open source software. The following people have contributed to this plugin.

Contributors

Translate WP Currencies into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.