fme extensions - magento · currency switcher extension for magento 2. a step by step instruction...

FME EXTENSIONS

EXTENSION FOR MAGENTO 2

USER GUIDE

FME EXTENSIONS GEOIP DEFAULT LANGUAGE CURRENCY SWITCHER

2 USER GUIDE

INTENDED AUDIENCE

The content of this document is designed to facilitate the users -

managers, supervisors, and others of GeoIP Default Language

Currency Switcher Extension for Magento 2. A step by step

instruction has been added to this document to help users to install

the extension on Magento 2.

This extension will only work on Magento 2. As a safe practice always

backup your files and database before installing any extension on

Magento. If you are looking for someone to install the extension, we

can do it for you as well. Just go to the following link and let support

know the order id to expedite the installation process.

Once you have installed please see the User Guide to help you

understand how to use the extension to its full capacity. If you still

have questions, feel free to contact us on our website.


3 USER GUIDE

TABLE OF CONTENTS

INTENDED AUDIENCE ............................................................................................................................. 2

USER GUIDE ........................................................................................................................................... 4

HOW TO CONFIGURE THE EXTENSION ................................................................................................... 4

HOW TO UPDATE GEOIP DATABASE...................................................................................................... 8

HOW TO SETUP THE CURRENCY ............................................................................................................ 9

DISCLIAMER ........................................................................................................................................... 15


4 USER GUIDE

USER GUIDE

After installation of the extension, make sure the setup is upgraded and static-contents are

deployed. Login to the admin panel and flush your Magento cache storage.

HOW TO CONFIGURE THE EXTENSION At the back end, go to FME EXTENSIONS > Geo-IP Default Language Currency

Configuration. Here you can find the following settings:

GENERAL CONFIGURATION

• Enable Store Switcher: Select ‘Yes’ or ‘No’ to Enable or Disable the store switcher

module

• Enable Round Prices: Select ‘Yes’ or ‘No’ to Enable or Disable the round prices

• Round Algorithm: Select any one algorithm for rounding off the pricing figure in

local currency to display a precise product value.


5 USER GUIDE

COUNTRY SPECIFIC SETTINGS

• Switch Currency For Specific Country: Create multiple rules to form a country-

currency relationship and display product prices by permitting currency only to

those specific countries; automatically switches store currency as per the geo-

location so that users can continue shopping in their local currency.

• Switch Store For Specific Country: Create multiple rules to form a country-store

relationship and display product prices only to those specific countries. The manual

switching can also be enabled to allow customers to switch between different store

views and pay in a currency they are comfortable with.

• Switch Language For Specific Country: Create multiple rules to form a country-

language relationship and display product prices only to those specific countries.

The language of the store is also switched to native or easily understandable

language depending on the visitors’ location (Note: Please install the language pack

to switch the language)

• Redirect to Custom URL For Specific Country: The geolocation of the users is

automatically detected from their IP addresses so that they could be redirected to a

suitable store view.


6 USER GUIDE


7 USER GUIDE

EXTENSION RESTRICTION

• User Agent: You can disable store switcher for specific search engine agents e.g.

Google, Yahoo, etc.

• Ip to Ignore: Enter specific IP addresses to ignore automatic rule switching

• Ip to Block: Enter specific IP addresses to block automatic rule switching

• Redirect URL: Enter a URL for the restricted customer to redirect it to a specific page

• First Visit Redirect Only: Select ‘Yes’ or ‘No’ to Enable or Disable the redirect feature

for the customers who visited your store for the very first time.


8 USER GUIDE

HOW TO UPDATE GEOIP DATABASE

At the back end, go to FME EXTENSIONS > GeoIP Database. Here you can find the

following settings:

GEOIP DATABASE > MAXMIND GEOIP DATABASE

Note: This module uses the MaxMind GeoLite2 Country IP Database For GeoIP

Information. MaxMind is very reliable and updates its database every month. You can

download the latest database from https://dev.maxmind.com/geoip/geoip2/geolite2/.

Download the file GeoLite2-Country-CSV_xxxx.zip (file size: 1.08M approx and CSV

Formate) and extract it. Copy 2 files name as ‘GeoLite2-Country-Blocks-IPV4.CSV’ and

‘GeoLite2-Country-Locations-en.CSV’ to the /pub/media/geoipcurrencyswitcher

folder inside Magento. Make sure that the files are named as GeoLite2-Country-

Blocks-IPV4.CSV, GeoLite2-Country-Locations-en.CSV and 777 rights are given to the

media folder.


9 USER GUIDE

HOW TO SETUP THE CURRENCY At the back end, go to STORES > Configurations. Here you can find the following

settings:

GENERAL CONFIGURATION

• Base Currency: Select the base currency. The base currency is used for all online

payment transactions. The base currency scope is defined by the catalog price

scope ("Catalog" > "Price" > "Catalog Price Scope")

• Default Display Currency: Select the default display currency for your store

products. All your store products prices will display in this currency

• Allowed Currencies: Select All/Specific currencies that you want to allow on your

store


10 USER GUIDE

FIXER.io

• API Key: Enter the API key. You can download the API key from https://fixer.io/

• Connection Timeout in Seconds: Enter a value for connection timeout in seconds

CURRENCY CONVERTER API

• Connection Timeout in Seconds: Enter a value for connection timeout in seconds

https://fixer.io/


11 USER GUIDE

SCHEDULED IMPORT SETTINGS

• Enabled: Select ‘Yes’ or ‘No’ to Enable or Disable the scheduled import

• Service: Select the import service:

o Fixer.io

o Currency Converter API

• Start Time: Specify the start time when cron will occur

• Frequency: Specify the frequency of cron:

o Daily

o Weekly

o Monthly

• Error Email Recipient: Enter an email address on which error emails will be sent

• Error Email Sender: Option to choose the sender of the error email:

o General Contact

o Sales Representative

o Customer Support

o Custom Email 1

o Custom Email 2

• Error Email Template: Option to choose the template for the error email (Note:

Email template chosen based on theme fallback when "Default" option is selected)

o Currency Update Warnings (Default)


12 USER GUIDE


13 USER GUIDE

FRONTEND VIEW – US STORE

FRONTEND VIEW – AUTO REDIRECTION (GDPR COMPLIANT)


14 USER GUIDE

FRONTEND VIEW – SWITCH STORE VIEWS & CURRENCY


15 USER GUIDE

DISCLAIMER

It is highly recommended to back up your server files and

database before installing this module.

No responsibility will be taken for any adverse effects occurring

during installation.

It is recommended you install on a test server initially to carry

out your own testing.

fme extensions - magento · currency switcher extension for magento 2. a step by step instruction...

Documents