Skip to main content

Documentation Portal

Installation

You can install the Global-e Magento2 Extension packages in one of two ways:

  • Extract the Zip file provided to you by Global-e that includes the two packages.

  • Run the composer-based installation directly from the Global-e repositories.

Composer-based Installation

The Magento platform natively supports the following installation method.

To install the Global-e Magento2 lite extension:

  1. In your Magento2 installation, locate the composer.json file and open it.

    The composer.json file includes information about both the Global-e package and its corresponding repository.

  2. To avoid installing the old version, either remove or update the 'magento2_lite' version to '1.*'.

    Make sure to confirm with the Global-E Integration team that you are using the stable version of the module.

    For example:

    "require": {
        "globale/magento2_lite": "1.*",
    }
  3. Global-e provides you with the Bitbucket user and application passwords. Replace [SOME_PASSWORD] with your actual password in the Bitbucket repository URL, as shown below.

    For example:

    "repositories":[
     {
        "type": "vcs",
        "url": "https://m2readonly:SOME_PASSWORD@bitbucket.org/globaleteam/magento2_lite.git"
    }

    Note

    • If necessary, Global-e can provide an alternative package version during integration.

    • Global‑e repositories are not publicly accessible, but read-only access can be requested.

  4. Run the standard Magento2 deploy scripts.

  5. Make sure that the Global-e modules are enabled:

    • Globale_BrowsingLite

    • Globale_OrderLite

    For information on enabling modules, see the Magento documentation.

Installation Using a Zip Archive

You can also install the Global-e modules by extracting the Zip file provided to you by Global-e.

  1. Extract the zip file to the app/code directory.

  2. Run the standard Magento2 deploy scripts.

  3. Ensure that the Global-e modules are enabled:

    • Globale_BrowsingLite

    • Globale_OrderLite

Configuration

The Global‑e Magento2 Lite extension provides a configuration screen that allows actual activation of Global‑e Integration on the website along with other settings:

Stores -> Configuration -> Services -> Global-E Integration Lite:

image2.png

All configuration details will be provided by Global‑e during the integration step.

Headless Installation

Global-e Routes

If a full page cache requires a whitelist of dynamic URLs, the following patterns should be whitelisted to support Global-e integration

Frontend area:

/international-ge/*

/international/*

Admin area:

/globale/*

Additionally, Global-e uses Magento2’s REST APIs. Make sure to enable them.

Make sure not to cache them (remove them from varnish or any other cache mechanism).