What does it do:
================
This contrib adds a country check to automatically choose a currency based on the customer's ip address.
It uses a complete list of country-to-currency code matchups to show any supported currencies to the customer.
When the customer first visists your site, it will grab his IP address and lookup his country.
It will then match the country to the associated currency that is local to that country.
If that currency is one that your store supports and has enabled in the system, then it will switch to that currency automatically.
If the currency is not supported in your store, then it will default to your store default currency.


Requirements:
================
You must have the latest vQmod Engine installed from Home · vqmod/vqmod Wiki · GitHub



Main features:
==============
* Uses IP lookup to get the customer's country
* Checks that the currency exists in opencart and sets it or defaults to you the store default currency.
* Country/Currency mapping can be easily changed at anytime
* Has multiple fallback lookup systems in place. If the first fails, it tries the second.
* Sets cookie to avoid lookup on each page reload. Cookie lasts until browser close. Actual lookup only done one time.
* Shows the country code quietly in the footer (shows * if using the cookie value)
* Still Allows customer to change their currency to something else.
* Sets the session shipping/payment addresses location to the detected country to ensure proper taxing is shown.

Notes:
==============
* If you are using a cache mod, you will need to ask the author of that mod how to allow bypassing the footer.php controller for this to properly be able to set a cookie. Otherwise you could end up with an endless loop
* If you want to test it using a proxy or vpn, be sure you delete your browser cookies each time you reload the page with a new location. It only detects the country if you don't already have a cookie with the value set.
* You must have the currency installed for it to switch.
- Example, if you do not have GBP installed, but come from UK, then it will not automatically switch
* IP Lookup sometimes fails on 3rd world countries.
- If country cannot be found by lookup it returns 'XX'. In this case it will just load the default currency.

Supported OpenCart Versions:
================
1.5.x
2.x