Magento 2 - Geoip Redirect - Extension User Guide

• Unpack extension files:
  • Log in to our website.
  • Download the Base Extension.
  • Unpack the Base extension file downloaded from our site and upload the contents of the file to the root directory of your magento installation.
  • Unpack the purchased extension file downloaded from our site and upload the contents of the file to the root directory of your magento installation. 

• Go to System > Web Setup Wizard.

• Select component manager to install the extension.

• Enable Modules:
  • Click on Select link on the Base Extension row(Module Name: HS_All). Click the Enable button on the menu that pops up.
  • Next, click on the Select link on the row corresponding to the extension you downloaded (Module Name: HS_GeoipRedirect).

• Step 1: Readiness Check
  • Click on the button Start Readiness Check to check you are running Magento on a compatible environment.
  • Click Next upon completion of previous step.

• Step 2: Create Backup
  • Create a backup before you install the extension, by selecting the checkboxes against the Backup Options and clicking the button Create Backup.
  • Click Next, upon completion.

• Step 3: Enable Module
  • Click on the button Enable.

• You will see this page as your module installation is in progress. You can check for errors in the Console Log.

• Module installation complete.

• Enable GeoIP Redirect: select Yes/No to enable/disable the extension. The extension can be enabled/disabled on a per store basis.
• Redirect only once: select Yes to redirect the visitor only once per session. When No is selected, the visitor will be redirected everytime they visit any applicable store link.

• Apply Redirect Action To: There are 3 options under this.
  • All Urls: In this case you don't need to add any values to URLs field.
  • Specified Urls: When selected, the urls added in the URLs field only will be redirected. Rest of the URLs are restricted from redirecting.
  • Not Specified Urls: When selected, only urls that are not specified in the URLs field will be redirected. Rest of the urls are restricted from redirecting.
• URLs: Click the Add button to add a URL. Make sure the url has a scheme(http://, https://,...) and a host (www.example.com, example.com,...). Additionally, you can also add a path and parameters to the url(http://example.com/path?param1=value1&param2=value2). Make sure the URL matches exactly to the URL shown in the address bar of the your browser.
• Ignore User Agents: Click the Add button to add User Agent(one on each row). Ex: googlebot,..
• Ignore IPs: Click the Add button to add IP(one on each row). Ex: 127.0.0.1,...

• IP: Click the Add button to add IP(one on each row). Ex: 127.0.0.1,...

• Enable Country to Store View Redirection: Select yes if you want to check whether the store is allowed for the country and to redirect to another store that is allowed for the current customer's country.
• Allowed Countries: This field will be available at a store view level. To edit this field, on the top left corner select the store view you want against the Store View label. Then select the allowed countries for that particular store. Multiple countries can be selected.

Selecting countries for Store View

• Switch the configuration scope by choosing the store view you wish to select countries for using the store view switcher at the top of the configuration page.

• Select countries from the dropdown as shown in the image. The store view will be available only to those IPs that are selected in the dropdown.

• Enable Country to URL Redirection: Select yes to enable redirecting to the specified url for the countries added to the field Country to URL Mapping.
• Country to URL Mapping: Click the Add button to add a Country -> Url map. Select a country from the dropdown and specify a url to be redirected to if the current customer's country matches the country listed.

• Enable Country to Currency Redirection: Select yes to enable switching the currency for the current store for the countries added to the field Country to Currency Mapping.
• Country to Currency Mapping: Click the Add button to add a Country -> Currency map. Select a country from the dropdown and select a currency against the country for the extension to switch the currency if the current customer's country matches the country listed.

• Url: Specify a URL to be redirected to, if none of the conditions listed above match the current customer's configuration. This field can be configured at the store view level.

• GeoIP Database Downloaded: Click on the Synchronize button to download the latest database file from the server. Don't do this too often or the sever might ban you for several hours.