User Guide of Magento 2 IP Geolocation Extension

Features

• Enhance user experience on shopping sites by allowing customers to purchase from their relevant store views.
• Auto-detect visitor’s location via IP address.
• Automatically redirect users to the relevant store view.
• Allow/Restrict customers to switch store views.
• Allow blocking customers by their country’s IPs
• Redirect customers to a specific URL on viewing some restricted Product, Category or URL.
• The admin can add a global restriction URL at which the customers will redirect if the store view is not mapped with any of the countries.
• Switch the store view & currency based on the visitor’s location.
• The extension is compatible with the Hyva theme.
• GraphQl has been implemented for the extension.

The installation is quite simple just like the standard Magento 2 extensions.

From Webkul Store

#1 Download Module

Firstly, you need to log in to Webkul Store, go to My Account>My Purchased Products section.

Then verify and then download and extract the contents of this zip folder on the system.

#2 Upload Folder

Once the module zip is extracted, follow path src>app and then copy the app folder into the Magento 2 root directory on the server as shown below:

#3 Run Commands

After uploading the module folder, you need to run the following commands in the Magento 2 root directory:

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

php bin/magento indexer:reindex

php bin/magento cache:flush

For multilingual support, the admin will navigate through Store > Configuration > General > Locale Options.

Select the locale as English (the language into which the admin wants to translate his store content).

If a user wants to translate their module from English to German, then they need to follow the path app/code/Webkul/IP Geolocation/i18n in their unzipped folder.

The user will get a CSV file with the name “en_US.csv”.

Now they will rename that CSV as “de_DE.csv” and translate all right side content after the comma in the German language.

After editing the CSV, save it and then upload it to the path app/code/Webkul/IP Geolocation/i18n where they have installed Magento2 on the server.

The module will get translated into the German Language. It supports both RTL and LTR languages.

The user can edit the CSV like the image below.

After the successful extension installation, The admin navigates through Stores > Configuration > IP Geolocation > IP Geolocation Settings to configure the extension.

The admin needs to make some changes in the general settings of the extension to set it up.

• Enable:- The admin can Enable or Disable the extension.
• Google API Key:- Enter Google API Key here as the Google API is used in the module for the geolocation.
• IP Info Access Token: To get an access token, please visit here: http://ipinfo.io/

Note: For Google API Key, Please visit

• Store View Change:- Allow or Restrict customers to change their store view from the store view change.
• Currency change:- Allow or Restrict customers to change their currency from the Currency Change option.

Global IP Redirection –

If the Admin didn’t set any IP Geolocation redirection based on category, product or URL then the global URL will work for redirection.

Redirect Popup Setting –

The admin can set the popup message for the customers while redirection is in process. Thus, the same message will be displayed on the front end.

Redirect Users to Relevant Store View based on their IP address.

After the configuration, if the admin has allowed the customers to change their store views and currency as per the Location Change & Currency Change option.

Thereafter, by the help of IP Geolocation extension, the website will identify the customer location first and show the relevant store view and currency to them.

For example, U.S.A customers with U.S IP addresses are redirected to U.S store view only when navigating to your website. 

But as the admin has allowed the Location change and currency change and configured the country-specific IP address.

Then in such case the U.S customers can also view the other store views available on the website.

Now the customer selects the German store view and its relevant currency from the currency option.

If Location & Currency Change Are Restricted

If location & currency change is restricted by the admin, in such case:

For Example:- the user of the U.S can view only the store view available for the U.S and the relevant currency only.

Global IP Redirection

Redirection URL: The admin can set a Redirection URL at which the customers get redirected to a specific URL, in case, if their countries IP is not configured by the admin.

For instance, as shown below.

From here the admin after configuring the extension will manage the IP Geolocation extension.

IP Geolocation Store View Details

Now the admin will navigate to the store redirect sub-menu to map the store views with countries.

The admin can view the list of all the website store views which are mapped accordingly with the specific countries.

With the help of an action option, the admin can easily delete a specific or multiple store redirects at a time.

Also by clicking on the “Add New” option, the admin can create a new mapping.

• Now for adding or mapping a new store, the admin will firstly enable the status.
• Enter the name of the redirect store.
• Select the countries whom IPs’ will be enabled for store view.
• Select the store view and click on the Save button.

Currency Details

After mapping the countries with store views, now the admin will map the currency with specific countries so that on visiting the store.

The customer can see their desired currency option for making payment.

The admin will navigate to the IP Geolocation > Currency sub-menu option. As shown below in the snapshot.

The admin can view the list of all the currency mapped accordingly with the specific countries.

From here, the admin can delete the added currencies as well as can add new one as per the desired store view.

For mapping a currency with multiple countries, the admin clicks on “Add New” button.

• The admin will firstly enable the status
• Select the currency & finally select specific or multiple countries and save it
• The customers of these countries can select the currency on the website while shopping.

Redirect

Here the admin restricts the customers based on their Country & state IP addresses’ to view the products, categories & URLs.

The admin can view all the created redirection on the basis of product, URL & categories type.

Admin can create a new redirection on either product, URL or category as per the selected countries by clicking on Add new button.

• The admin from here can enable the status of redirect feature.
• Selects the type i.e product, category or URL which must be restrict from the customer.
• After that, select product or category or enter URL as per the type selected in the above field.
• Enter the redirect URL where the customer reaches after trying to access the product, category or URL.
• In addition, the admin selects the countries & its relevant states whom customers are restricted to access the types selected.

Blocked IPs’

Under this option, the admin can enter multiple IPs’, to block or blacklist customers

The admin from here can view the list of blocked countries IPs & can also add the new one by clicking on the “Add New” button.

• The admin needs to enable the status of the feature.
• Can enter multiple countries’ IP addresses to block.
• Enter the redirect URL to which the customer gets redirected to when belongs to the entered Ip addresses’.

In conclusion, that’s all for the Magento 2 IP Geolocation Extension.

Get in touch

Still, have any issues please feel free to add a ticket and let us know your views to make the extension better http://webkul.uvdesk.com/.

Explore the Adobe Commerce Cloud development services by Webkul. You may also browse other Magento 2 marketplace addons. Also our quality Magento 2 extensions.