GEOIP STORE SWITCHER FOR MAGENTO 2

Transcription

1 1 User Guide GEOIP Store Switcher for Magento 2 GEOIP STORE SWITCHER FOR MAGENTO 2 USER GUIDE BSSCOMMERCE 1

2 2 User Guide GEOIP Store Switcher for Magento 2 Contents 1. GEOIP Store Switcher for Magento 2 Extension Overview How does GEOIP Store Switcher for Magento 2 Extension work? In Update Database GEOIP In General In GEOIP Block Contact Us...11 BSSCOMMERCE 2

3 3 User Guide GEOIP Store Switcher for Magento 2 1. GEOIP Store Switcher for Magento 2 Extension Overview Being an owner of a global Magento 2 store, you must know better than anyone the challenges of running a multiple store view ecommerce. GEOIP Store Switcher for Magento 2 will bring up user experiences in multi-store website to a whole new level. The extension helps detect user s IP location and redirect them to the appropriate store view. 2. How does GEOIP Store Switcher for Magento 2 Extension work? Please go to Stores Configuration BSSCOMMERCE and start configuration 2.1 In Update Database GEOIP Before enabling the extension, you need to update GEOIP database. Please choose one of the 3 options below. In Update Database from MaxMind, please click in Upgrade Data for the Database to be updated. The auto-updated database is downloading from Country Lite Database in MaxMind homepage. Hence, not all IP countries are available in this database. If you want to use the paid database version from MaxMind, you can pay to download a zip file from them and use the Upload Custom File option. BSSCOMMERCE 3

4 4 User Guide GEOIP Store Switcher for Magento 2 On the other hand, the extension also use another tools named IPinfo to identify the IP in case it cannot be found in the database. Hence, the paid database version from MaxMind is not necessary. In Upload Custom File, you can upload a custom file (such as paid database version from MaxMind) to be the database. The file format must be.zip and is compressed from a.csv file. After finishing uploading, chose Save Config then click Upgrade Data. In some cases, the uploaded file is larger than the limit of the server, this option will be not available. In Upload Custom URL, you can fill in the URL of the database file if you can not upload it in the Custom File option. After completing, chose Save Config then click Upgrade Data. In the following configuration, please go to Stores Configuration BSSCOMMERCE GEOIP Switch Store 2.2 In General In Redirect Scope: There are 3 options: Global, Website and Store. To explain how to configure this correctly, we will use the following website hierarchy as an example. BSSCOMMERCE 4

5 5 User Guide GEOIP Store Switcher for Magento 2 If you choose Store as Redirect Scope, the visitors will be redirected within the store views under the same store. For example, Canada customers will always be redirected to Canada Store View when they go to American Store. If they go to the rest 2 stores (French, UK), they will not be redirected. It s similar for Website as Redirect Scope. Visitors will be redirected when they access any of your store views under the same website. For example, Canada customers will always be redirected to Canada store view when they go to any of the store views and store under English website. If they go to French website, they will not be redirected. For Global Scope, visitors will be redirected when they enter any store views. For example, Canada customers will always be redirected to Canada store view in any case. BSSCOMMERCE 5

6 6 User Guide GEOIP Store Switcher for Magento 2 In Allow Manual Switch after Redirect: Choose Yes to allow customer to switch store view after being redirecting, otherwise choose No. In case you enable manual switch, if the customers switch store after being redirected in the first access on the site, they will not be redirected afterwards. In Restriction IP: Enter one IP per line to set the IPs to be except from redirection. In Restriction URL: Enter one URL per line to set the URLs to be except from redirection. When visitors access these URLs, they will be shown in the default store view. BSSCOMMERCE 6

7 7 User Guide GEOIP Store Switcher for Magento 2 In Restriction User Agent: Select user agents to prevent them from being redirected when crawling to your site. In Enable Cookie: Choose Yes to enable saving cookies about GEOIP data, otherwise choose No. In case the cookies are enabled, the data about GEOIP will be saved. When visitors go to your site, the GEOIP data will be taken from the previous visit. In Time Save Cookies: Choose the time duration for the cookies to be saved. There are 4 options, 30 days, 3 months, 6 months and 1 year. To use the IP for Tester feature, please do these following steps: Select "No" in Enable Cookie. Enter the IP address you want to test with. Click on Save Config and go the Cache Management to Flush Cache. Click "Test Now" to show the displaying store view with the test IP. BSSCOMMERCE 7

8 8 User Guide GEOIP Store Switcher for Magento 2 In Apply Redirect for Country: Please change the scope to Store View and start configuration. You can assign countries from which will be redirected to each store view. For countries which are not assigned to any store view, visitors from those will be redirected to the default store view. BSSCOMMERCE 8

9 9 User Guide GEOIP Store Switcher for Magento In GEOIP Block In Enable: Choose Yes to enable GEOIP Block, otherwise choose No. In IP Blacklist: Enter one IP per line to set the IPs to be blocked. Then, visitors from these IPs cannot access your site. When trying to do so, they will only be redirected to an URL you set below. BSSCOMMERCE 9

10 10 User Guide GEOIP Store Switcher for Magento 2 In Countries Blacklist: Select countries to be blocked from your site. Then, visitors from these countries cannot access your site. When trying to do so, they will only be redirected to an URL you set below. In Redirect Visitor to URL: Enter URL including or If you want to redirect blocked visitors to a CMS page, please enter URL key of the page. If leave this option blank, visitors will be redirected to Homepage. BSSCOMMERCE 10

11 11 User Guide GEOIP Store Switcher for Magento 2 3. Contact Us Any questions or concern about us, feel free contact: Website: Support: support@bsscommerce.com Skype: support.bsscommerce BSS Support team is always ready to aid you with any issue related to our products. Additionally, we also give you Website development and Administration Support. We do offer: 1. Free installation services for commercial products. 2. Free updates within offered support period. Our duties: 1. Responsibility for resolving product bugs. 2. Help with technical queries. 3. Technical support in installation and product usage. BSSCOMMERCE 11