About Multiple Currencies

Multiple Currencies displays prices simultaneously in multiple currencies with this extension, which will automatically update the exchange rates for you, or let you set manual rates, and allow customers to choose what they would like to pay with.

Installation

 

To install your plugin:

  1. Navigate to Plugins Add New.
  2. At the top of the Add Plugins page, click the Upload Plugins button.
  3. Click Choose File.
  4. In the File Upload pop-up, choose the plugin’s .zip file from the hard drive and then click Open.
  5. Click Install Now.
  6. After installation, you have to click the Activate Plugin button.
  7. You will be transferred to the Plugin page; Multiple Currencies should now be visible.

Activation

 

To activate the plugin:

  1. Navigate to Jigoshop Manage Licenses.
  2. Fill the boxes with appropriate information (license key and activation email).
  3. Click the Save button.
  4. Your plugin should now be active.

Configuration

 

  1. Navigate to  Jigoshop → Settings and choose Multi Currencies tab.
  2. Set Available Currencies by toggling the desired currencies.
  3. Toggle Product in one currency mode – If you enable this option you can define for each product one currency from the available, in which product will be sold. If the cart has products in another currency then it is cleared first.
  4. Set Currencies Settings 
    • Set Currency Display – default ‘$0.00
    • Set Thousand Separator – default ‘,
    • Set Decimal Separator – default ‘.
    • Set Number of Decimals – default ‘2
  5. Toggle Auto exchange rates – if enabled, automatically get exchange rates from Oanda.com, synchronize it and send an email with current exchange rates.
  6. Toggle Force using country currency? – Force currency based either upon Customer’s Shipping and Billing Country.
  7. Save
  8. Go to Jigoshop → Currency Exchange menu page and define exchange rates
  9. For widgets, navigate to Appearance → Widgets.
    • Drag Jigoshop: Change Currency to the desired sidebar (optional) – allows you to use dropdown or radio toggle to select the currency.
    • Drag Jigoshop: Currency Exchange Table to the desired sidebar (optional) – table will display all available currencies along with exchange rate.

All Prices on frontend will be displayed depending on user chosen currency. All orders are taken in chosen user currency.

Usage

Information for developers

Exchanges are applied to and were tested with Jigoshop

  • products and taxes
  • shipping amounts (flat rate) and the minimal amount for the order
  • coupons fixed amounts (cart, product) + min/max order values

For payment gateway developers

If you want your payment gateway to interact with multiple currencies plugin to get know if gateway should be enabled or disabled you can use two filter hooks

  • jigoshop_multi_currencies_available gives all currencies defined in the multi-currency plugin
  • jigoshop_multi_currencies_currency give current user currency

If you want to check if one of you gateway available currencies are supported

$multi_currencies = apply_filters( 'jigoshop_multi_currencies_available', array() );
if (count($multi_currencies) > 0 && count(array_intersect($multi_currencies, self::$available_currencies)) > 0 ) {
  return true;
}

If you want to check if gateway should appear in checkout you can use in gateway constructor something like this

$current_currency = apply_filters( 'jigoshop_multi_currencies_currency', Jigoshop_Base::get_options()->get_option('jigoshop_currency') );
if (!in_array($current_currency, self::$available_currencies)) {
  $this->enabled = false;
}
 
Jigoshop