addressfinder/module-magento2 1.1.3

Address Autocomplete for your Magento 2 store by AddressFinder




OSL-3.0, AFL-3.0

Requires (dev)










AddressFinder Magento

Using the Magento 2 plugin

Follow the user guide on the AddressFinder website:


To install the AddressFinder module for Magento 2, simply run:

composer require addressfinder/module-magento2
bin/magento module:enable AddressFinder_AddressFinder
bin/magento setup:upgrade
bin/magento cache:flush

You'll generally need to recompile your dependency injection cache and redeploy themes, especially in production. This process varies from site to site and is outside the context of installing this module, but generally is:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy


Download Docker for Mac

Setup for Magento 2.0 or 2.1

There are different docker-compose files for the versions of Magento and PHP because they all need individual docker volumes for quicker spin-up in development (i.e. you won't have to re-install Magento every time you switch version).

docker-compose -f docker-compose.yml -f docker-compose.<versions>.yml up app
open http://localhost:8000/

Create an new admin user. Passwords must be at least 8 characters long, include both numbers and letters, and a variety of cases.

docker-compose -f docker-compose.yml -f docker-compose.<versions>.yml exec phpfpm bash
bin/magento admin:user:create --admin-firstname=kate --admin-lastname=norquay [email protected] --admin-user=kate --admin-password=G00dG00d

Get the Magento Admin path. Each Magento install creates a unique url to the admin portal.

docker-compose -f docker-compose.yml -f docker-compose.<versions>.yml exec phpfpm bin/magento info:adminuri

Setup for Magento 2.2

docker-compose -f up
docker-compose -f exec apache rm index.php
docker-compose -f exec apache install-magento2

Symlink the AddressFinder plugin to the Magento codebase

sed -i '' "s/# SYMLINK PLUGIN HERE/- .\/AddressFinder:\/var\/www\/html\/app\/code\/AddressFinder/"

To get the module working

  • Change your store configuration to support New Zealand & Australia.

    Do this at Admin > Stores > Configuration > General > Country Options


You'll find the logs in /var/www/html/var/log


Make your changes to ./src/ then run gulp to automatically build the addressfinder_magento.js file in the AddressFinder module (See view/frontend/web/js).

Changes will be updated in the Magento codebase immediately.

Where to look

The following table indicates which file to edit for making page specific changes:

File Page
AddressFinder/AddressFinder/view/frontend/templates/customer.phtml Website > My Account > Edit Address
AddressFinder/AddressFinder/view/frontend/templates/checkout.phtml Website > Checkout
AddressFinder/AddressFinder/etc/adminhtml/system.xml, AddressFinder/AddressFinder/etc/config.xml Admin > Stores > Configuration > Services > AddressFinder

Can't see your changes?


Magento allows requirejs-config.js files to be defined per module. Multiple config files are concatenated into a single file.

When making updates to any requirejs-config.js, you may need to recompile static content to see changes.

docker-compose -f docker-compose.yml -f docker-compose.<versions>.yml exec phpfpm bash
rm -rf pub/static/*
bin/magento setup:static-content:deploy
The etc directory

If you modify etc/adminhtml/system.xml or etc/config.xml, you may need to clear and flush the cache to see changes.

docker-compose -f docker-compose.yml -f docker-compose.<versions>.yml exec phpfpm bin/magento cache:clean
docker-compose -f docker-compose.yml -f docker-compose.<versions>.yml exec phpfpm bin/magento cache:flush


Run bash to create a zip package for distribution.