Dinero - WooCommerce Currency Converter

“Dinero - WooCommerce Currency Converter” Documentation by “WP Plugin Experts”

Introduction

Dinero - WooCommerce Currency Converter extension allow your customers to convert product prices to a currency of their choice easily.

Dinero - WooCommerce Currency Converter uses Open Exchange Rates for converting your product prices to a currency of your customers choice! It features currency detection and responsive design. Orders are still completed using the base currency set in WooCommerce settings, converted prices are just for reference.

Features:

  • Automatically detect customers currency based on their location, so your customers can spend more time looking at your products.
  • Responsive Design, so it will work on all screen sizes and devices!
  • Shortcode for displaying the customers saved currency in the menu label.
  • Choose if converted prices replace base currency price or if they are displayed next to base currency price in brackets (when a currency is selected that isn't the base currency).
  • Choose if currency code is appended to product prices.
  • Full localization support.
  • A clean & user friendly admin UI to manage everything.

Installing the Plugin

  1. The installation of the plugin is just like any other plugin installation for WordPress. Login to your WordPress site and go to Plugins > Add New.
  2. At the Install Plugins Page click on Upload from the top navigation and then click on browse.
  3. Go to the location on your computer where you saved the downloaded plugin zip file and upload this zipped file. You need to unzip the file first to get the plugin zip file.
  4. Now click on Install Now.
  5. Wait until WordPress has uploaded the file. If it's done click on Activate Plugin.
  6. Now you should see a message 'Plugin activated' at the top of the window.

After installing the extension, a Currency Converter section will be added to the WooCommerce Currency Converter Extensions tab.

Plugin Settings

The Plugin Settings

General Settings

Exchange Rates Method
Choose exchange rates method. If you choose "both" rates then it will take custom rates, if custom rate is empty then it will consider open exchange rates. If both are empty it won't convert currency on front side.

Select Currency Page
This is the page, which will act as your Select Currency page, containing a list of all currencies. This page is being automatically created as soon as you activate the plugin and it contains the following shortcode:

[woo_select_currency]

This shortcode is required in order for the Select Currency process to work.

Replace Currency Symbol
Replace the currency symbol with currency code.

Append Currency Code
Appends currency code to prices.

Currency Code Position
Choose the location of the currency code, when append currency code is enabled.

Replace Base Currency
Replaces base prices with converted prices (alternatively the converted price will be shown beside the base price).

Display Cart Notification
If the customer saved a currency that is different from the base WooCommerce currency, notify the customer on the cart page that all orders are processed in the base WooCommerce currency.

Base Currency
Choose base currency. if you set base currency different then the one set in general settings then it would show by default price in both currencies.

Open Exchange Rates Options

Plugin Settings

App ID
Enter open exchange rate APP ID, changing the APP ID will clear the cache.

Cache Length
Length of time in minutes to cache retrieved exchange rates.

Detection Options

Plugin Settings

Enable Currency Detection
Check this box, if you want to allow to automatic detect currency and replace it based on customer IP address.

Prompt User
Check this box, if you want to prompt the customer if they want to save their detected currency. If unchecked, the detected currency will be automatically saved for the customer.

New customers to your website will be greeted with a popup asking if they want to save their detected currency as shown below image:

Detected Currency Popup

You can check if currency detection is working by clearing your cookies or opening your browser in private mode. How ever, it is possible no preferable currency can be detected for your location. Currency detection will not work on localhost.


Manage Currencies

Currencies can be managed by the admin by going to WooCommerce > Currency converter. This is list of currencies you will allow your users to select on the front-end.

You can also manage the order of Currencies by drag and drop interface as shown below image:

Currency List

Also custom currency can be added from WooCommerce > Currency converter > Add New as shown below image:

Add Custom Currency

Open Exchange Rate API

WooCommerce Currency Converter uses Open Exchange Rates for retrieving the latest currency rates, you can easily create an account for free here. The only limitation for free accounts is that you can only access the currency rates 1000 times a month, this however is not a problem because WooCommerce Currency Converter will cache the retreived rates for an hour which is exactly how often Open Exchange Rates updates their currency rates.

The rates retrieved from Open Exchange Rates are not 100% accurate, all converted prices are for reference only. All your WooCommerce Currency Converter orders will still be processed in the shop currency.

Once you have created your account, you will need to find your App ID.

Open Exchange Rate API


Frontend Behavior

On the frontend, users can choose a currency as shown below image:

Currency Popup

Once chosen, all prices (which are formatted using the get_woocommerce_currencies core function) will change. This includes, by default:

  1. Product Price
  2. Cart/Checkout Totals
  3. Purchase History Prices
  4. Discount Prices
  5. Taxes Prices

Also, All orders are processed in base currency. Prices in selected currency are for reference only.



Need Support
 
Created: June 03, 2020
By: wppluginexperts
Email: [email protected]
If you have any question which you couldn't get answered within our documentation then feel free to email us on [email protected]. If you have valid license key then please raise a ticket through our support system https://support.wppluginexperts.com. We would also love to hear if you have any new Ideas for making our plugin even more rich with new features, Do visit our Ideas forum. Thank you.