Multicurrencyalizer

Description

This version of the Multicurrencyalizer has been superseded by Multicurrencyalizer 3. There is a free version and a subscription version. You can read more here.

The Multicurrencyalizer lets your users see your prices in their own currency. It works on any website that allows you to upload JavaScript. It includes specific code to handle Squarespace and Shopify prices, but simply send us a URL for your own store before purchase and we’ll add the correct configuration to the code for your store.

How it works

The Multicurrencyalizer adds a currency selector bar to the top-right of your website. This can be customised, but by default it looks like this:

The first currency in your list is always the currency of your store, then the others are additional currencies for your target economies that you choose. For example, if you show prices in USD but you also serve the UK, conversions will increase as trust increases when users see that you have specific options for their currency.

If a user of your website is visiting your website for the first time, the Multicurrencyalizer will attempt to figure out which currency it should show them. It uses the browser country + language preferences to guess this. If you have the currency for that country configured, this will be the default currency for that user and they will immediately see prices in their own currency. If you do not have their currency configured, it will default to your store currency.

If a user clicks the currency widget, this choice will be remembered in the browsers local storage. It does not use a cookie, and it is GDPR compliant.

When a user returns to your site, it will remember their previous currency choice, provided local storage has not been cleared and provided they are using the same device+browser.

All currencies are available, and we use the open exchange rates to update exchange rates every day.

There is an additional option to allow you to place an ‘inline’ currency selector on your website, right next to all of your prices. If you choose this option, it will look like this:

If the user changes this option, it will also update your currency selector at the top right hand of your page. Similarly, if your users change the currency in the widget, all of these inline currency selectors will also update.

Choosing your currencies

Customisation is simple – choose your default currency and your additional currency options you’d like to display, then copy/paste the code to your website builder.

Once you have made your purchase, you will receive a download file include a readme.txt file. Inside that file is a customisation guide to configuring your currencies – so make the changes inside that readme file and then copy/paste the edited file to your website builder.

The main customisations are:

• currencies – your store currency + the other currency options you’d like to display
• position – where to display the currency selector
• showInLine – whether to show the inline currency selector or not

var mcuserconfig = {
currencies: ['GBP','EUR','USD'],
position: 'top',
showInLine: true
}

Full info for the various options is included in the readme file once you have made your purchase.

You can find a complete list of currency codes we support here:

https://docs.openexchangerates.org/docs/supported-currencies

Customising the appearance

With CSS, it’s possible to change the style of the currency widget or the inline currency selectors however you wish. The default styling is very attractive, but if you’d like to alter it, we have guidance below.

In order to make these changes, you should know how to add custom CSS to your website builder. In Squarespace, for example, click Design then click Custom CSS.

In the image above, you can see that when the user hovers over CAD, the button changes background colour to dark grey. Similarly, you can see the active currency has a background colour of red. You can also see the default widget colour of light grey. These are all configurable.

Note: For colours, CSS uses hex codes, e.g. #eeffee. If you don’t know how to grab these from your favourite paint program, you can google ‘html hex colour picker’ and you’ll find dozens of tools online to help you get the hex codes for all the colours in the world.

Change default currency widget background colour

.ml-currency-widget-button {
background-color:#eeffee;
}

Change active currency widget background colour

It defaults to red. To change it use:

.ml-currency-widget-button.active {
background-color:#8888ff;
border-color:#8888aa;
}

Change currency hover widget background colour

It defaults to dark grey. To change it use:

.ml-currency-widget-button:hover {
background-color:#eeffee;
}

Move the currency widget around

The currency widget has something called a ‘fixed’ position on your screen. This makes it not scroll with the rest of your content. If the position is not good for your site, you can adjust it with the following CSS:

.ml-currency-widget {
top:20px;
right:20px;
}

Change the top or right values according to how many pixels from the top and the right you would like your currency widget to be.

Lifetime support & updates

With all of our products we offer lifetime support & updates. We want you to be talking to us, and charging a yearly fee makes that less likely. We’re against profiteering too, and the fact is that once you have this set up there’s practically zero extra cost for us every year, so there’s no need for us to charge a yearly fee.

The price you see is the only price you’ll ever pay.

Is there a free trial?

We don’t offer a free-trial. Instead we offer a 60-day money-back guarantee. All we ask is that you give us 7 days to try and solve your issue. If we cannot, or you are still unhappy, we will issue your full refund.

Notes & Limitations

• Exchange rate prices are only updated daily
• Exchange rate calculations do not include any additional currency conversion charges that Stripe or PayPal may charge your users
• The Multicurrencyalizer uses a ‘floating’ currency selector for simplicity. If needed, it’s possible to add this directly into your menu. Get in touch if you need this.

Troubleshooting

If you find currencies are not being translated or are being translated incorrectly, please check the order of your currencies in your configuration.

• You *must* enter your store currency first in the list. After that, it doesn’t matter the order.
• You *must* use the correct currency codes from this openexchange rates currency list.

Installation Instructions

Please follow the instructions in the file you receive to configure your currencies.

For the Multicurrencyalizer to work, your site must have jQuery – if you are uncertain if you already have jQuery, visit a page on your site, press CTRL+U or CMD+U to view source, then search for jquery.

To add jQuery, paste the following code above your Multicurrencyalizer script:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>

After the above code, paste your customised Multicurrencyalizer script. It’s recommended to customise your Multicurrencyalizer directly inside your web builder since many text editors will turn straight single-quotes into ‘smart quotes’.

We have a full screencast covering installation below: