PHPackages                             mastersoft/woocommerce-mastersoft-address - 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. [Payment Processing](/categories/payments)
4. /
5. mastersoft/woocommerce-mastersoft-address

ActiveWordpress-plugin[Payment Processing](/categories/payments)

mastersoft/woocommerce-mastersoft-address
=========================================

Performance checkout with Address lookup and validation, business lookup and validation, email and phone validation​

2.0.0(2y ago)2142GPL-2.0-or-laterPHP

Since Sep 14Pushed 2y ago1 watchersCompare

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

READMEChangelog (9)Dependencies (1)Versions (9)Used By (0)

mastersoft-address-woocommerce
==============================

[](#mastersoft-address-woocommerce)

Loqate AU NZ Address Autocomplete plugin for WooCommerce.

Performance Address lookup and validation for WooCommerce Checkout and Account Billing and Shipping Addresses, as well as checkout with Address lookup and validation, business lookup and validation, email and phone validation​

For the up to date user guide please visit

Description
-----------

[](#description)

Turns your checkout into a performance checkout by saving the customer time in checkout, reduces failed deliveries, reduces failed contacts and builds trust. Powered by the most curated address and location data in the world. Loqate is the most advanced software for capturing, verifying and enriching address data globally - delivering the unrivalled precision businesses need.

Features:

- Autocomplete billing and shipping address, business lookup, email and phone validation in Checkout page
- Autocomplete address in My Account page for Customer's billing address and shipping address
- Support for over 245 countries addresses, including AU, NZ, US, UK, CA etc
- Flexible configurations for the lookup and validation depending on the business needs.

Get started with a [FREE Trial licence key](https://www.loqate.com/anz/register/).

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

[](#installation)

This plugin requires WooCommerce. Please make sure WooCommerce is installed.

### Automatic installation

[](#automatic-installation)

Automatic installation is not currently available.

### Manual installation

[](#manual-installation)

1. Download the zip file of the latest release from [GitHub](https://github.com/MastersoftGroup/woocommerce-mastersoft-address).
2. Upload the zip file to your WordPress plugins directory by either:
    - Upload the zip file using your WordPress Admin:

        Log in to WordPress Admin &gt; go to `Plugins` &gt; `Add New` &gt; `Upload Plugin` button &gt; upload the zip file

        **OR**
    - Upload and unzip the zip file into your WordPress plugins directory: `WP_ROOT/wp-content/plugins/`. The `WP_ROOT` is usually `/var/www/html/`.

After installation, the WordPress plugins directory should include the `woocommerce-mastersoft-address` directory with the same file structure as the GitHub.

### Composer installation

[](#composer-installation)

The plugin is also available for installation from [Packagist](https://packagist.org/packages/mastersoft/woocommerce-mastersoft-address).

1. Download and install composer:

    ```
    $ curl -sS https://getcomposer.org/installer | php
    $ mv composer.phar /usr/local/bin/composer

    ```
2. Install with composer by either:

    - Create `composer.json` file in the `WP_ROOT` and add the `mastersoft/woocommerce-mastersoft-address` package. For example, to add `woocommerce-mastersoft address` v1.0.1.

        ```
        {
            "require": {
                "mastersoft/woocommerce-mastersoft-address": "1.0.1"
            }
        }

        ```

        Install the package:

        `$ composer install`

        **OR**
    - Use extended composer command and install:

        `$ composer require mastersoft/woocommerce-mastersoft-address:`

        The `` is optional.

After installation, the WordPress plugins directory should include the `woocommerce-mastersoft-address` directory with the same file structure as the GitHub.

#### Updating an existing Composer installation

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

1. Update `composer.json` in your WordPress plugins directory with the version to be downloaded:

    `$ composer require mastersoft/woocommerce-mastersoft-address: --no-update `

    Alternatively, you can also update the version of `mastersoft/woocommerce-mastersoft-address` package in the `composer.json` file by directly editing it.
2. Download and install the updated version of `mastersoft/woocommerce-mastersoft-address`:

    `$ composer update`

### Post installation

[](#post-installation)

1. Activate plugin: log in your WordPress Admin &gt; got to `Plugins` &gt; `Installed Plugins` &gt; scroll to `Mastersoft Address` plugin and click `Activate`
2. Configure plugin by following the [Configuration](#configuration) guide.

### Disable/enable plugin

[](#disableenable-plugin)

To disable: log in to your WordPress Admin &gt; go to `Plugins` &gt; `Installed Plugins` &gt; scroll to `Mastersoft Address` plugin and click `Deactivate` to disable plugin.

This will disable the functionality but will still keep all your configuration settings, so you do not need to configure when you enable the plugin again.

To enable: log in to your WordPress Admin &gt; go to `Plugins` &gt; `Installed Plugins` &gt; scroll to `Mastersoft Address` plugin and click `Activate` to enable plugin.

### Uninstallation

[](#uninstallation)

Log in to your WordPress Admin &gt; go to `Plugins` &gt; `Installed Plugins` &gt; scroll to `Mastersoft Address` and click `Deactivate` and `Delete`.

This will uninstall and delete all the configuration settings in your database.

If there is an error message during the deleting process `Could not fully remove the plugin ....`, please make sure the file ownership is set to `www-data`. To correct the ownership, change to your WordPress plugins directory:

`$ chown -R www-data:www-data woocommerce-mastersoft-address`

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

[](#configuration)

Log in to your WordPress Admin &gt; go to `WooCommerce` &gt; `Settings` &gt; `Mastersoft Address` tab.

- **Licence Key:** (mandatory). Get your [FREE Trial licence key](https://www.loqate.com/anz/register/). Must be in **username-without-domain:password** format. Default Value: blank/empty.
- **URL:** Default value if empty/blank: `https://hosted.mastersoftgroup.com`.
- **Default Widget Options:** Generic Widget Options for both AUSTRALIA and NEW ZEALAND. Pre-configured and default value:

    `{ singleLineHitNumber: 5, caseType: "TITLE" }`
- **Widget Options for AUSTRALIA:** Widget Options for AUSTRALIA only. If the same key is in the Default Widget Options, the value here will take precedence for AUSTRALIA. Pre-configured and default value:

    `{ sot: "GNAF" }`.
- **Widget Options for NEW ZEALAND:** Widget Options for NEW ZEALAND only. If the same key is in the Default Widget Options, the value here will take precedence for NEW ZEALAND. Pre-configured and default value:

    `{ sot: "NZAD", exposeAttributes: "1" }`.

    All Widget Options must be in valid JSON format. Here is the full list of available [Feature Options](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/objects/address-objects#featureoption).

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

### How do I get a licence key?

[](#how-do-i-get-a-licence-key)

You can get a [FREE Trial licence key](https://www.loqate.com/anz/register/) and start using it right away.

### What are all available Widget Options to configure in the settings?

[](#what-are-all-available-widget-options-to-configure-in-the-settings)

Widget Options are basically `sot` for `Source of Truth` value and key value of `FeatureOptions`.

Currently these Source of Truth are available for AUSTRALIA: `AUPAF`, `GNAF` and for NEW ZEALAND: `NZPAF`, `NZAD`.

Here is the full list of [Feature Options](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/objects/address-objects#featureoption).

### Why the Region for New Zealand is not auto-selected after selecting an address?

[](#why-the-region-for-new-zealand-is-not-auto-selected-after-selecting-an-address)

New Zealand Region will only be selected if Source of Truth is `NZAD` and `exposeAttributes` is turned on.

Go to `Mastersoft Address` WooCommerce Settings in your WordPress Admin and change `Widget Options for NEW ZEALAND` value to `{ sot: "NZAD", exposeAttributes: "1" }`.

### Where can I report bugs or ask further questions?

[](#where-can-i-report-bugs-or-ask-further-questions)

Any questions or bugs can be reported either by opening an issue on [Mastersoft GitHub](https://github.com/MastersoftGroup/mastersoft-address-woocommerce/issues).

Alternatively, you can contact us via our website .

### Where can I find the REST API documentation?

[](#where-can-i-find-the-rest-api-documentation)

You can find the documentation of our REST API [here](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification).

Changelog
---------

[](#changelog)

The [release history](https://github.com/MastersoftGroup/woocommerce-mastersoft-address/releases) is available on GitHub.

Support
-------

[](#support)

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

Copyright
---------

[](#copyright)

(c) 2023 Mastersoft

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 71.4% 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 ~293 days

Recently: every ~83 days

Total

7

Last Release

1033d ago

Major Versions

1.3.0 → 2.0.02023-07-11

### 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 (10 commits)")[![hannahzhoulucky](https://avatars.githubusercontent.com/u/80011523?v=4)](https://github.com/hannahzhoulucky "hannahzhoulucky (2 commits)")[![chwang7](https://avatars.githubusercontent.com/u/80013836?v=4)](https://github.com/chwang7 "chwang7 (1 commits)")[![tnyjhnsn](https://avatars.githubusercontent.com/u/17973712?v=4)](https://github.com/tnyjhnsn "tnyjhnsn (1 commits)")

---

Tags

autocompletewordpressaddresswordpress plugincheckoutwoocommerceaddress autocompleteloqateaddress validationwoocommerce-pluginmastersoft

### Embed Badge

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

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

###  Alternatives

[wp-pay-extensions/gravityforms

Gravity Forms driver for the WordPress payment processing library.

1133.3k2](/packages/wp-pay-extensions-gravityforms)

PHPackages © 2026

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