PHPackages                             mastersoft/address-widget - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mastersoft/address-widget

ActiveMagento2-module[Utility & Helpers](/categories/utility)

mastersoft/address-widget
=========================

A Magento 2 Address Autocomplete module for Checkout and Customer Address

1.1.2(2y ago)06.8k—0%2OSL-3.0HTML

Since Mar 8Pushed 2y ago1 watchersCompare

[ Source](https://github.com/MastersoftGroup/mastersoft-address-magento)[ Packagist](https://packagist.org/packages/mastersoft/address-widget)[ RSS](/packages/mastersoft-address-widget/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)DependenciesVersions (6)Used By (0)

mastersoft-address-magento
==========================

[](#mastersoft-address-magento)

Mastersoft Address Autocomplete extension or module for Magento2.

Releases
--------

[](#releases)

- v1.0.x is compatible for Magento 2.2 (tested with Magento 2.2.4)
- v1.1.x is compatible for Magento 2.3 (tested with Magento 2.3.4 and 2.2.4)

Installation
------------

[](#installation)

Go to your Magento2 Home (usually is in `/var/www/html` directory).

### Composer Installation (Recommended)

[](#composer-installation-recommended)

Make sure git is installed: `apt-get install git`.

```
/var/www/html# cp composer.json composer.json.old
composer require mastersoft/address-widget
php bin/magento module:enable Mastersoft_AddressWidget
php bin/magento setup:upgrade
```

If successful, you should find the module source in `/var/www/html/vendor/mastersoft/address-widget/` directory.

Verify `Mastersoft_AddressWidget` module has been installed properly: `php bin/magento module:status`. It should be listed in the Enabled Modules.

Next is to [configure Mastersoft Address Configuration](#configuration).

### Updating Existing Composer Installation

[](#updating-existing-composer-installation)

For example to update to Mastersoft Address Widget v1.0.2.

```
composer require mastersoft/address-widget:1.0.2 --no-update
composer update
php bin/magento setup:upgrade
```

(Optional) Follow steps in [Additional Steps - For Production Mode Only](#additional-steps---for-production-mode-only).

If the page is blank or encounter permission error in the admin store or store homepage, see [Installation Troubleshooting](#installation-troubleshooting).

### Manual Installation

[](#manual-installation)

1. Download the zip file in `ZIP` directory.
2. Unzip it in your Magento2 Home directory, it will merge with existing directories and files.

You should find the module source in `/var/www/html/app/code/Mastersoft/AddressWidget/` directory.

```
/var/www/html# cp composer.json composer.json.old
php bin/magento module:enable Mastersoft_AddressWidget
php bin/magento setup:upgrade
```

Verify `Mastersoft_AddressWidget` module has been installed properly: `php bin/magento module:status`. It should be listed in the Enabled Modules.

Next is to [configure Mastersoft Address Configuration](#configuration).

### Additional Steps - For Production Mode Only

[](#additional-steps---for-production-mode-only)

These are additional steps after `php bin/magento setup:upgrade` - for `Production` mode only.

```
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy en_AU en_US

```

### Installation Troubleshooting

[](#installation-troubleshooting)

If the page is blank or encounter permission error or other errors in the store homepage.

```
php bin/magento cache:clean
php bin/magento cache:flush
chown -R :www-data var/cache
chmod -R 777 app/ var/ pub/ generated/
rm -rf var/cache/* var/page_cache/*
```

Configuration
-------------

[](#configuration)

In Magento2 Admin Dashboard of your Store: go to `Stores` -> `Configuration` -> `Services` -> `Mastersoft Address`.

**Get your FREE licence key [here](https://www.loqate.com/anz/register/).**

To configure the Widget Options, here is the full list of available [FeatureOption](http://developer.mastersoftgroup.com/harmony/api/object/address.html#FeatureOption).

For more detail, please see the [Configuration in User Guide](user-guide.md#configuration).

### Disable/Enable Module

[](#disableenable-module)

There are 2 ways to disable/enable this module:

1. In [Mastersoft Address Configuration](#configuration): `Enable Module` field OR
2. In Magento Command ```
    // Disable module
    php bin/magento module:disable Mastersoft_AddressWidget --clear-static-content

    // Enable module
    php bin/magento module:enable Mastersoft_AddressWidget

    php bin/magento setup:upgrade
    php bin/magento module:status
    ```

Uninstallation
--------------

[](#uninstallation)

### Composer Uninstallation

[](#composer-uninstallation)

**This will work only if the module has been installed using Composer.**

```
php bin/magento module:disable Mastersoft_AddressWidget --clear-static-content
php bin/magento module:uninstall Mastersoft_AddressWidget -r -c
php bin/magento setup:upgrade
composer remove mastersoft/address-widget
```

### Manual Uninstallation

[](#manual-uninstallation)

```
php bin/magento module:disable Mastersoft_AddressWidget --clear-static-content
php bin/magento setup:upgrade

// If was installed using Composer
rm -rf vendor/mastersoft

// If was installed manually
rm -rf app/code/Mastersoft
```

Remove module data in magento2 database:

```
DELETE FROM setup_module WHERE module='Mastersoft_AddressWidget';
DELETE FROM core_config_data WHERE path like 'Mastersoft_AddressWidget/%';
```

Remove `Mastersoft_AddressWidget` module reference from `app/etc/config.php` file.

```
php bin/magento setup:upgrade
php bin/magento cache:flush

```

User Guide
----------

[](#user-guide)

For more detail documentation, please refer to this [User Guide](user-guide.md).

Support
-------

[](#support)

If you have any questions or issues with this module, open an issue on [GitHub](https://github.com/MastersoftGroup/mastersoft-address-magento/issues). Alternatively you can contact us via e-mail or via our website below.

E-mail:
Homepage:

Copyright
---------

[](#copyright)

(c) 2023 Mastersoft

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~487 days

Total

5

Last Release

1043d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2fc5290926b368371aed4d69100bb83363fd6748de2941b43b2fe73ce3e8621?d=identicon)[MastersoftGroup](/maintainers/MastersoftGroup)

---

Top Contributors

[![MastersoftGroup](https://avatars.githubusercontent.com/u/22928311?v=4)](https://github.com/MastersoftGroup "MastersoftGroup (57 commits)")

### Embed Badge

![Health badge](/badges/mastersoft-address-widget/health.svg)

```
[![Health](https://phpackages.com/badges/mastersoft-address-widget/health.svg)](https://phpackages.com/packages/mastersoft-address-widget)
```

###  Alternatives

[reinink/remember-query-strings

Laravel middleware that automatically remembers and restores query strings.

76598.2k3](/packages/reinink-remember-query-strings)[arielcr/numero-a-letras

Convierte un número a su valor correspondiente en letras.

51115.7k](/packages/arielcr-numero-a-letras)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)