How to install Glopal's Magento 2 extension?

IMPORTANT NOTE:  Installing the plug-in while not being registered as a Glopal merchant won't allow you to benefit from any of Glopal's e-commerce modules. If you wish to test Glopal's solution, please register here

Content:

Module Download and Installation
Post Installation Check
Activating the store
Configuration

To install Glopal's Magento 2 extension, you will need:

• Developer to download and install module to the Magento 2 instance, verifying installation
• Store owner to setup Glopal account and store activation inside module configuration
• Store owner to provide required information to Glopal Customer Care agents during an introduction call (need by Glopal to set up international sites, advertising campaigns and activate the store)

Module Download and Installation

Glopal Magento 2 module can be installed manually from the ZIP archive or via Glopal composer repository.

Important: As a developer, please ensure that you switch to the correct user before running listed commands. If you were not using these commands for regular maintenance purposes before (they are used for plugin activation, cache flushing, reindexing, etc.), you may want to consult with your hosting provider tech support first for extra details related to your particular Magento 2 environment.

Option A: Install from ZIP archive

Step 1: Download ZIP archive

Please find a ZIP file with the module source here.

Step 2: Copy files to the server

Have your developers install this Magento2 module by extracting and copying files to the Magento2 installation.

The module should be extracted to "app/code/" inside Magento2 installation.

Extracting files should produce directory as "app/code/Glopal/Connector", and files like "app/code/Glopal/Connector/etc/config.xml"

Step 3: Run setup and deployment commands

magento setup:upgrade
magento setup:static-content:deploy
magento deploy:mode:set production

Option B: Install via composer

Glopal is using a private repository for our Magento 2 extension. The repository works in the same way as Magento's marketplace with the only exception that it must be added to your composer.json file before installing the package.

Repository is authenticated with a token. Please request the token from your Account Manager.

Step 1: Add the repository to your composer.json

composer config repositories.glopal composer https://glopal.repo.packagist.com/magento/

Step 2: Install the package providing authentication

composer require glopal/glopal-magento2

Authentication required (glopal.repo.packagist.com):
Username: token
Password: YOUR-GLOPAL-COMPOSER-TOKEN

Step 3: Run setup and deployment commands

magento setup:upgrade
magento setup:static-content:deploy
magento deploy:mode:set production

Post Installation Check

To confirm module installation, developers can visit /glopal_connector endpoint. It should return a message "Request needs to be signed by Glopal." confirming that Glopal module is installed.

After installing the module, the store owner is required to perform activation from the Magento admin dashboard under Store > Configuration > Glopal to setup Glopal account and initiate store setup.

Module description notes for Developers

• The module enables a connection between your Magento2 store and Glopal services.
  It exposes a set of connection endpoints under /glopal_connector (and /webinterpret_connector) allowing Glopal to connect with the store, synchronize products for advertising and shipping and send completed international orders back into Magento2 store.
  In case there would be some server restrictions in maximum request time preventing such connection, Glopal may ask you to white-list specific requests having particular HTTP header value.
  
  
• Glopal is localizing international sites with a Localization Engine solution that works as a front proxy before the Magento2 store. For every international visitor browsing an international site, Glopal will forward requests back to the store, localizing the content in real time before serving the visitor. If your Magento2 store has some DDoS protection that may block requests from Glopal, please get in touch with our support in order to setup HTTP header based white-listing allowing requests from Glopal Localization Engine.
  
  
• The module will add small JavaScript content to pages in order to provide geoip features to international visitors and to ensure that international sites, once they are enabled, are properly indexed.
  
  
• Domestic visitors will not encounter any changes to the domestic page once the module is installed.

Activating the store

Step 1: Open Settings
Step 2: Connect Account
Step 3: Activate stores

Step 1: Open Settings

• Once the module is installed international stores can be activated for a selected store view from Magento2 dashboard.
  
  
• Go to Stores > Configuration > Glopal > Settings.
  
  
• If you have more than one store views, select the store view to be used as a reference when launching international sites.
  All international sites will use content, catalog, price and availability of this reference store view - with Glopal localizing site language and currency.
  If launching with Glopal's Marketing Solution (Google Shopping Ads), you should have products from this reference store view uploaded to your Google Merchant Center account.

Step 2: Connect Account

• Fill in the form and create your account.
  If you already have a Glopal account, click on “Connect your account” link and log in.

Step 3: Activate stores

• Fill in the form with your plugin settings and activate your stores.

Configuration

Attribute Mapping

Glopal uses Magento 2 extension for plug & play integration with the Glopal Checkout.

This will automatically transfer product items and details from the Magento cart to Glopal Checkout. To pass additional non-standardized attributes (like HS code or brand name) you can configure Cart Transfer Attribute Mapping.

As different products may require different mapping, multiple attributes from different attribute sets may be mapped to the same Glopal Attribute.

1. Select Glopal Attribute
2. Select Product Attribute Set
3. Select Product Attribute from that set

If you need to map additional attributes, click the Add button.