Loqate Magento 2 API Integration

What is the Loqate API Integration?

Performs address capture and data validation (email, phone number and address) using Loqate API.

Download

Download via composer

Request composer to fetch the module:

composer require loqate-integration/adobe

Manual Download

Download & copy the git content to /app/code/Loqate/ApiIntegration.

Install

Please run the following commands after you download the module.

php bin/magento module:enable Loqate_ApiIntegration
php bin/magento setup:upgrade
php bin/magento setup:di:compile

Configuration Instructions

The configuration for the module is located under Stores -> Configuration -> Loqate.

Magento 2 DevContainer Setup

This repository includes a devcontainer for rapid Magento 2 extension development.

Quick Start

1. Create a devcontainer.env: Before opening the devcontainer you will need to create a devcontainer.env file which you can copy from devcontainer.env.example.
2. Open in VS Code: Use the "Reopen in Container" command (requires the Remote - Containers extension).
3. Wait for Setup: The devcontainer will build, install dependencies, and set up Magento 2 automatically.
4. Access Magento:
   • Storefront: http://localhost:8080
   • Admin: http://localhost:8080/admin
   • Default admin user: admin / admin123
5. Live Extension Development: Your extension source is mounted into the running Magento instance. Changes are reflected immediately after running bin/magento setup:upgrade and clearing cache.

Services

• PHP-FPM (8.1)
• Nginx
• MySQL 8
• Opensearch
• Redis

Notes

• The first startup may take several minutes (Magento install, Composer, DB setup).
• The extension is symlinked into app/code/Loqate/ApiIntegration.
• To re-run setup, use .devcontainer/setup-magento.sh inside the container.
• If you have any DNS issues, you will need to copy your Zscaler certificate into the PHP container - see the Zscaler workaround comment in the Dockerfile.

Useful helpers

• php -r '$e=include "app/etc/env.php"; $d=$e["db"]["connection"]["default"]; printf("mysql -h%s -u%s -p%s %s\n",$d["host"],$d["username"],$d["password"],$d["dbname"]);' Will extract the command to access mysql within the devcontainer, currently that command is mysql -hdb -umagento -pmagento magento
• bin/magento config:show will list all of the config currently set in the instance, this can be set with bin/magento config:set <PATH> <VALUE>

Deployment

Releasing a new version requires two separate deployments: one to the Adobe Marketplace and one via Composer. Before proceeding with either, update the version number in both composer.json and etc/module.xml to reflect the new release, then commit and push the change.

Note that the Git tag for the Composer release is created automatically when changes are merged to master — see the Composer section below.

Adobe Marketplace

1. Create a zip of the whole repository. Ensure that .devcontainer, .git and .gitignore are excluded, as the Magento malware scan does not allow them to be uploaded. The following command will produce a clean archive:

   zip -r loqate-integration.zip . -x "*.git*" -x "*.devcontainer*"
   

2. Log in to your Adobe account at account.magento.com.
3. Navigate to the extension versions page on the Adobe Commerce Developer Portal.
4. Upload the zip archive.
5. Adobe will automatically process and scan the submission. This can take up to 15 business days if a manual approval is required.
   • If the scan fails, review the provided feedback, address the reported issues, and resubmit.
   • If the scan passes, the extension will be published to the marketplace within the hour.

Composer

The Git tag for a Composer release is created automatically. When changes are merged to master, the auto-tag.yml GitHub Action analyses the commits since the previous tag and creates a new version tag based on Conventional Commits:

• feat: commits → MINOR bump (e.g. v2.0.4 → v2.1.0)
• fix: commits → PATCH bump (e.g. v2.0.4 → v2.0.5)
• feat!: or BREAKING CHANGE: → MAJOR bump (e.g. v2.0.4 → v3.0.0)
• Other types (docs:, style:, refactor:, etc.) → no bump (no tag created)

If no conventional commit is found, the action defaults to a PATCH bump. The workflow also publishes a GitHub release with an auto-generated changelog. Once the new tag is pushed, Composer will automatically detect it and make the release available on packagist.

To ensure a release is tagged correctly, make sure your commit messages follow the Conventional Commits format.