WooCommerce All in One Currency Converter documentation#

WooCommerce All in One Currency Converter is available exclusively on CodeCanyon.

Basic information#

If you are reading this, it means that you probably already know what this plugin is supposed to do. But just to make sure - WooCommerce All in One Currency Converter is a WordPress-WooCommerce extension plugin that allows your webstore visitors to see your product prices in various currencies.

Depending on plugin configuration, the conversion can happen only for user's reference (while the payment is still happening in your store's base currency) or have the currency converted not only for user's reference, but also for payment (you will receive payment in alternative currency).

Plugin offers many features which make it the most complete currency conversion solution for any online shopping system on the market.

Now that we know what we are dealing with here, let's see how to get this beast up and running!

Quick start#

Installation#

  • Standard WordPress method

Download plugin from your CodeCanyon account (Installable WordPress file only) and upload this zip file using Plugins > Add new > Upload Plugin uploader in your WordPress Admin dashboard. After plugin is successfully installed, go to Plugins section in WordPress Admin dashboard, find WooCommerce All in One Currency Converter on the list and click Activate next to it.

  • FTP method

Upload the woocommerce-all-in-one-currency-converter folder to wp-content/plugins on your server. Go to Plugins section in WordPress Admin dashboard, find WooCommerce All in One Currency Converter on the list and click Activate next to it.

Plugin activation#

In order to be able to receive automatic updates with new plugin features and security fixes, you also need to activate the plugin using your Envato Purchase Code. To do so, please go to WooCommerce > Settings > Currency Converter > Plugin activation in your WordPress Admin Dashboard. In Your purchase code field please paste your Envato Purchase Code, which you can find in Downloads section of your Envato account and in the e-mail you received right after purchasing this item. After clicking Save changes, your plugin will be activated.

Can't find your Purchase Code? Here is an article on Envato explaining where to find it - Where Can I Find my Purchase Code?

Plugin setup#

Default settings make the plugin work right out of the box. You only need to insert a currency switcher on your site. The easiest way is to use widget. Go to Appearance > Widgets section of your WordPress Admin Dashboard. In the Available Widgets area you should see Currency Converter. Drag it, for example, to one of the sidebars.

That's it! Your WooCommerce All in One Currency Converter is ready to go!

Please explore plugin settings to adjust the plugin to your needs. In this documentation you can find detailed description of all plugin features.

Troubleshooting#

Although the plugin was written with quality in mind, sometimes the unexpected can happen.

In the very unlikely event of experiencing any problems with the plugin, the first thing you need to do is to check your software versions.

WooCommerce All in One Currency Converter has the following requirements:

  • PHP: 5.6 minimum
  • WordPress: 5.0.3 minimum
  • WooCommerce: 3.5.3 minimum

Please keep in mind that WooCommerce must by activated for this plugin to work.

While WordPress and WooCommerce are relatively easy to update, you may not be used to updating your PHP. However, it is very important to keep your PHP version up to date. PHP 5.3.x and 5.4.x are still very popular even though they have been discontinued for a very long time. PHP 5.3 and 5.4 is a very old software now and if you have it on your server, you need to update it to at least PHP 5.6.x. New PHP versions are more secure, more reliable and significantly faster than the old ones.

Updating PHP#

PHP can usually be updated in your server panel - cPanel and DirectAdmin are the most popular ones. If you don't know how to do it, just contact your hosting provider and they will do it for you within minutes - tell them you need at least 5.6.x version of PHP.

Still experiencing problems?#

If updating your environment didn't help, please go to plugin Settings > Advanced tab and click Restore default settings. This will remove all plugin settings and restore them to default ones.

If you still have problems with the plugin, please contact me! I provide support through CodeCanyon messages. Please contact me using the Envato account that was used to purchase the plugin. Contact me using the contact form on the right - https://codecanyon.net/user/dev49net

Changelog#

Version 2.12.1 (2019.01.21)

  • WordPress 5.0.x and WooCommerce 3.5.x full compatibility
  • Updated exchange rates APIs
  • DEV: Make frontend and admin classes public properties of Main plugin class
  • DEV: Remove wc_version from frontend variables

Version 2.12.0 (2018.06.06)

  • Added WooCommerce 3.4.x compatibility
  • Added Docs entry on the Plugins list
  • Fixed issue with occasional currency switch betweeen backend and frontend
  • Fixed issue with order preview in admin dashboard taking currency from the frontend
  • Fixed occasional issue with invalidating variations prices cache
  • Removed Google Finance API, as it no logner works
  • Removed WooCommerce 3.1/3.2 support entirely
  • DEV: Added wcaiocc_custom_reference_price_final filter

Version 2.11.0 (2018.03.22)

  • Added WooCommerce 3.3.x compatibility
  • Fixed occasional issue where item was displayed as being on sale, even though it wasn't
  • Improved exchange rates update reliability
  • Fixed issue with invalidating cached variation prices, causing the plugin to perform multiple unnecessary database updates

Version 2.10.0 (2017.11.12)

  • Added WooCommerce 3.2.x compatibility
  • Fixed issues with exchange rates updates (added new APIs, removed not working ones)
  • Removed WooCommerce 2.6 compatbility - only 3.x is supported from now on
  • Minor fixes and improvements
  • DEV: Add filter for final custom product price

Version 2.9.1 (2017.06.01)

  • Fixed crossed price issue on certain WooCommerce setups
  • Fixed called to undefined function error when activating without WooCommerce activated
  • Fixed modal window when specifying geolocation country-currency relation
  • Fixed storing base currency price values when creating order from backend
  • Allow to convert prices when creating order from backend in new currency
  • Check if GeoIP database exists when activating Geolocation
  • Minor compatibility fix for PDF Invoices plugin
  • DEV: Add filter to specify max number of currencies

Version 2.9 (2017.04.19)

  • WooCommerce 3.0.x compatbility
  • Fixed error in price conversions when creating order from the backend
  • Improved mechanism checking if WooCommerce is active

Version 2.8 (2017.01.17)

  • WordPress 4.7.x ready
  • Added support for WooCommerce Reports
  • Fixed potential JavaScript errors
  • Improved WooCommerce activation checking
  • Improved price slider compatibility
  • Improved geolocation mechanism
  • Improved wcaiocc_convert shortcode
  • Fixed fees converting
  • Fixed automatic exchanges rates updates occasional failure
  • Fixed price formatting in certain cases
  • Completely dropped WooCommerce 2.5 compatibility
  • DEV: Added wcaiocc_currency_switcher_output_html filter
  • DEV: Deprecated wcaiocc_currency_switcher_html filter

Version 2.7 (2016.07.13)

  • Full WooCommerce 2.6.x compatibility
  • Shipping taxation fix
  • JavaScript syntax fixes
  • Alternative currencies custom orders fix
  • New wcaiocc_{currency_code}_exchange_rate_update_value filter
  • WooCommerce Composite Products Widget issue fix
  • Only one plugin instance allowed
  • Fixed displayed price taxation issue on variable products
  • Fixed currency symbol issue on orders placed in alternative currencies
  • Added [wcaiocc_convert] shortocde
  • Ability to add switchers via filters - wcaiocc_currency_switcher_themes and wcaiocc_currency_switcher_theme_{name}
  • Added feature to configure payment gateways for each currency
  • Fixed currency switching issue on AJAX-loaded content
  • Fixed conversion problem on very specific use case
  • Added startup currency feature
  • Added feature to change currency via GET parameter
  • Fixed price filter issues
  • Dropped WooCommerce 2.4.x support
  • Fixed possible currency conflicts with the new WooCommerce REST API
  • Minimum required WordPress changed to 4.5
  • Fixed free shipping minimum required amount conversion

Version 2.6.1 (2016.02.06)

  • Fixed WooCommerce Composite Products compatibility problem
  • Fixed currency conversion when placing order in reference conversion mode with cheque payment method
  • Improved restore default settings functionality
  • Couple of minor fixes

Version 2.6 (2016.01.24)

  • Full WooCommerce 2.5 compatibility
  • Added Mangohour Table Rate Shipping compatibility
  • Added option to change order currency on order edit page
  • Improved automatic exchange rates update mechanism
  • Many fixes and improvements

Version 2.5 (2015.11.28)

  • Added compatibility with page caching plugins
  • Currency switcher text (and all other strings) can now be easily translated with WPML
  • Fixed possible WP-Admin error with WooCommerce disabled
  • Fixed price calculation for grouped products
  • Fixed possible minor problems with certain payment gateways
  • Fixed plugin settings UI in Firefox
  • Fixed possible currency conflict when creating custom order in WooCommerce admin dashboard
  • Improved currency exchange rate autoupdate mechanism
  • 3 new currency exchange rates APIs (6 now in total)
  • Improved security of admin AJAX requests
  • WordPress 4.4 ready

Version 2.4 (2015.08.29)

  • Fixed possible PHP error on AJAX calls

Version 2.3 (2015.08.16)

  • WordPress 4.3.x and WooCommerce 2.4.x ready
  • Improved AJAX cart behaviour after switching currency
  • Fixed possible error when auto-updating exchange rates
  • Improved translations
  • Improved uninstallation process and Restore default settings feature
  • Switched from using cURL to WordPress HTTP API to maintain compatibility with hosting providers
  • Fixed exchange rates formatting - no more trailing decimal zeros in the exchange rates table
  • Fixed possible error in confirmation email after PayPal payment
  • Added new filter for supplying alternative country code when using geolocation (only for developers)

Version 2.2 (2015.08.03)

  • Base prices for Composite Products plugin are now converted to alternative currencies
  • Added support for price filter widget
  • Added support for "free shipping for orders over..." rule
  • Added support for minimum and maximum order amount for coupons

Version 2.1 (2015.07.23)

  • Fixed AJAX cart update issue on some themes
  • Improved performance on some servers by using transient cookies instead of sessions
  • Increased number of currencies limit
  • Improved plugin settings

Version 2.0 (2015.07.01)

  • Completely redesigned geolocation currencies - everything can now be quickly and easily configured in Advanced settings section
  • Fixed conversion error occurring on rare server configuration
  • Fixed couple of minor possible incompatibilities
  • Removed one of the exchange rates APIs - service no longer available (European Central Bank, Yahoo Finance and Fixer.io are still available)

Version 1.2 (2015.06.25)

  • Added automatic updates system
  • Confirmed compatibility with latest WooCommerce
  • Increased plugin speed (especially with geolocation feature)
  • Added Custom JavaScript code field
  • Improved currency exchange rate auto-update
  • WooCommerce base currency can now be removed from the currencies list
  • Fixed problem with changing WooCommerce base currency
  • After changing WooCommerce base currency, all exchange rates are automatically updated
  • Improved currency conversion algorithm

Version 1.1 (2015.06.02)

  • Improved cache data storing and removed Clear cache function
  • Confirmed compatibility with latest WooCommerce
  • Improved geolocation functionality
  • Added option to change "Total payment" text in checkout (without the need to change translation files)
  • Added new WordPress filter (see documentation for more info)
  • Increased number of currencies limit
  • Fixed couple of issues

Version 1.0 (2015.05)

  • Initial release