Moradas — Portuguese Address Autocomplete for WooCommerce

Description

Customers type their address once, in one line, and pick it from a list. The
plugin fills in the street, the postal locality and the exact seven-digit
Portuguese postal code (código postal, CP7): the code carriers need on the
shipping label, chosen by door number. Moradas is Portuguese for “addresses”.

It is built for stores that ship to Portugal. Missing accents, abbreviations and
small typos are understood (“av liberdade lisboa 196” becomes Avenida da
Liberdade, Lisboa, 1250-147), and a postal code typed on its own fills in the
street and the locality. The service behind the plugin is free and public: no
API key, no account, and the typed text is not stored.

How it works

1. The customer starts typing in the address field of the checkout: street,
   locality and door number, all in one line.
2. Suggestions appear under the field as they type, each with its postal code.
   When a street has several postal codes and the door number is still missing,
   the suggestion says so.
3. The customer picks one. Street, locality and postal code are filled in, and
   every field stays editable.

What you get in the checkout

• One line is enough: “av liberdade lisboa 196” resolves to Avenida da Liberdade, Lisboa, 1250-147.
• The exact CP7 for the door number, not just a code for the street or the town.
• A postal code works as input too: “1000-098” fills in Praça do Chile, Lisboa.
• Forgiving matching: accents are optional (“sao joao”), abbreviations are understood (“av” for Avenida), small typos are corrected.
• Larger towns are ranked first.
• Suggestions only for Portugal: for any other country the checkout is untouched.
• On WooCommerce 9.9 and newer the suggestion list is drawn by WooCommerce itself, so it follows your theme.
• Nothing is added to the order and no extra fields are created: the plugin fills the standard address, city and postcode fields.

Privacy

• No cookies, no tracking, no account.
• While the customer types in the address field, the typed text is sent to the Moradas service at moradas.dev to produce the suggestions (see “External services” below). Nothing is sent from any other page, from the WordPress admin, or when the plugin is activated.
• No name, e-mail, phone number, order or account data is sent.
• The service does not store the typed text; it keeps only hourly aggregate usage counts.
• The bundled widget can report errors to the service; in this plugin that option is switched off.

Compatibility

• Both checkouts: the Checkout Blocks (the default checkout) and the classic shortcode checkout. The plugin registers itself as a WooCommerce address autocomplete provider, so the same suggestions appear in both.
• WordPress 6.5 or newer, PHP 7.4 or newer. WooCommerce 9.9 or newer for the block checkout (tested up to 11.2); with older WooCommerce versions the plugin still works in the classic checkout, using its own suggestion list.
• Declares compatibility with High-Performance Order Storage (HPOS) and with the Cart and Checkout blocks.

Free, no API key

The service at https://moradas.dev is public and free, including for commercial
use. There is no key to paste and no account to create. Fair-use limits are
described at https://moradas.dev/docs. Stores that run their own instance of the
service can point the plugin to it under WooCommerce → Settings → Advanced → Moradas.

Portuguese translation included

The plugin’s interface text (the settings, the admin notices and the “enter the
door number” hint in the checkout) ships with a Portuguese (Portugal)
translation. The suggestions themselves are addresses, so they read the same in
any language.

External services

This plugin connects to the Moradas address API (https://moradas.dev), a free
public service run by the authors of this plugin, to turn what the customer types
into address suggestions and into the exact postal code. Without this service the
plugin has nothing to suggest.

When it is used: only on the checkout page and only when the country is Portugal,
while the customer types in the address field, and once more when a suggestion is
picked. Nothing is sent when the plugin is activated, in the WordPress admin, or
on any other page.

What is sent: the text typed in the address field (for example
“av liberdade lisboa 196”) and, when a postal code has to be resolved, the
identifier of the chosen street together with the door number. No name, e-mail,
phone number, order or account data is sent. The requests go from the customer’s
browser straight to the API, without cookies; like any web request, they include
the browser’s IP address and user agent. The service does not store the typed
text and keeps only hourly aggregate usage counts.

Terms of use and usage limits: https://moradas.dev/docs
Privacy policy: https://moradas.dev/privacy