Magento 2 GeoIP Lookup v2.x Installation

Here you will learn how to correctly install the Magento 2 GeoIP Lookup extension using two methods – Installation via the FTP or Composer.

Important Information:

  1. First of all, make sure your system meets all the requirements necessary for the correct functioning of our GeoIP Lookup Extension for Magento.
  2. For more details on system requirements, please read Magento 2 system requirements.

You can choose one of the following two methods to install the extension on your Magento 2 store:

Important Note for Hyvä Theme Users:

Magento 2 GeoIP Lookup extension is compatible with Hyvä themes out of the box. Install the extension via Composer or FTP and benefit from its features, all while enjoying the lightning-fast performance of the Hyvä storefront.

Extension Installation via Composer

In order to install your Magento 2 GeoIP Lookup extension via Composer, open the console (SSH terminal) and follow the steps:

Step 1. Switch to your Magento 2 root directory in the terminal

cd /FULL_PATH_TO_YOUR_MAGENTO2

where “FULL_PATH_TO_YOUR_MAGENTO2” is the path to your Magento 2 folder on your server.

Step 2. Add the Plumrocket repository to your Composer configurations

composer config repositories.plumrocket composer https://plumrocket.com/repo/

Step 3. Download Plumrocket extension files

composer require plumrocket/module-geoiplookup

After running this command, you may be prompted to enter the username and password (see the How to Get Plumrocket Composer Repository Keys user guide).

Step 4. Install database and static resources

php bin/magento cache:flush
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

After running these commands, the extension should be installed successfully. A similar message should be displayed in your console as shown below:

Step 5. Set the serial key

Step-by-step guide:

  1. Navigate to your Magento 2 Admin Panel and click on the “Plumrocket” tab.
  2. If there is the “GeoIP Lookup” tab in the list, it means that the extension has been successfully installed.
  3. Navigate to the “GeoIP Lookup” -> select the “Configuration” option.
  4. Your Serial Key field should be auto-filled with the green check mark displayed. This means that the Serial Key has been successfully activated and the extension can be enabled. However, if the green check mark is not there – you will need to enter your product Serial Key manually. Please follow the License Installation for Magento 2 instructions for more information.
GeoIP_Lookup_installation-1

Next Step > Magento 2 GeoIP Lookup Configuration

Extension Installation via FTP

Step 1. Download and unzip the extension files

Step-by-step guide:

  1. Log into your account at https://plumrocket.com.
  2. Select “My Account” in the menu. (To open this page you have to log in first)
  3. Navigate to “My Downloads” in the menu.
  4. Press on the “Download” link to download the latest version of your Plumrocket Magento 2 extension.

Unzip the Magento 2 GeoIP Lookup extension’s files and proceed to the next step.

Step 2. Upload files to the server

To upload files to the server, you may use any FTP-client. To show you how it works, we used the FileZilla FTP-client.

Step-by-step guide:

  1. This is your client side. You will see the unpacked catalog containing the GeoIP Lookup Extension.
  2. This is your root directory on the server side. This is where the files should be uploaded.
  3. All the files have to be uploaded to the server. Select the files and press the right mouse button.
  4. Select the “Upload” option for these files.

Step 3. SSH Installation

1. In the terminal, switch to your Magento 2 root directory using the command:

cd /FULL_PATH_TO_YOUR_MAGENTO2

where “FULL_PATH_TO_YOUR_MAGENTO2” is the path to your Magento 2 folder on your server.

2. Update database and static resources:

php bin/magento cache:flush
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

After running these commands, the extension should be installed successfully. A similar message should be displayed in your console as displayed below:

Step 4. Set the serial key

Step-by-step guide:

  1. Navigate to your Magento 2 Admin Panel and click on the “Plumrocket” tab.
  2. If there is the “GeoIP Lookup” tab in the list, it means that the extension has been successfully installed.
  3. Navigate to the “GeoIP Lookup” -> select the “Configuration” option.
  4. Your Serial Key field should be auto-filled with the green check mark displayed. This means that the Serial Key has been successfully activated and the extension can be enabled. However, if the green check mark is not there – you will need to enter your product Serial Key manually. Please follow the License Installation for Magento 2 instructions for more information.
GeoIP_Lookup_installation-3

Next Step > Magento 2 GeoIP Lookup Configuration

Was this article helpful?