Linux 软件免费装

在这里免费安装WordPress以及其他软件

Banner图

UK Address Autocomplete & Postcode Lookup for Forms & WooCommerce

开发者 postio
更新时间 2026年8月16日 00:05
PHP版本: 7.4 及以上
WordPress版本: 7.0
版权: GPLv2 or later
版权网址: 版权信息

标签

woocommerce address autocomplete postcode lookup uk address address finder

下载

1.0.0

详情介绍:

Postio is a UK address, email, and phone validation API. This plugin drops UK address autocomplete onto your existing forms — automatically — so customers fill billing, shipping, and contact addresses in two keystrokes instead of twenty. Automatic, where your builder has an address field Paste your key and these wire themselves. No classes, no snippets, no per-form setup: Two-minute setup, everywhere else Some builders have no address field at all — there's nothing for us to detect, because there's nothing there. You tell us which of your fields are which by adding a class to each one, and it works exactly the same from then on: You don't have to go hunting for the classes. Settings → Postio detects which of these you have installed and prints the exact snippet for your builder on the screen, ready to copy. Anything else Custom mappings at Settings → Postio bind any search box to any set of output fields by CSS selector. That covers page builders, bespoke themes and hand-written forms — anything that renders ordinary HTML inputs. Plus a block (Postio Address Finder) that drops onto any page in the block editor for one-off address pickers. Why Postio How it works When the customer types into an address field on any of the supported forms, the plugin shows ranked suggestions backed by the live Postio API. On selection, every other address sub-field on the form (Town, Postcode, etc.) auto-fills. The autocomplete script ships with the plugin — nothing is loaded from a remote CDN. It is ~4.2 KB gzipped and is only enqueued on pages that actually have a relevant form, and only when an API key is configured.

安装:

  1. Upload to /wp-content/plugins/postio-address-validation, or install through the Plugins → Add New screen.
  2. Activate.
  3. Go to Settings → Postio and paste your API key. Don't have one? Signing up at https://postio.co.uk is free and takes under a minute.
  4. Click Test connection to confirm.
That's it for WooCommerce, Gravity Forms, Fluent Forms, Forminator and WPForms Pro. If you use Contact Form 7, Ninja Forms or Elementor Forms, the settings screen will show you the one class to add to each address field.

屏幕截图:

  • WooCommerce block checkout, mid-typing, with live UK address suggestions.
  • Fluent Forms address field, auto-filled from a single selection.
  • The Postio Address Finder block in the editor sidebar.

升级注意事项:

1.0.0 First release on the WordPress.org plugin directory. 0.2.0 Clearer setup: a Settings link on the Plugins screen, live builder detection, and inline wiring instructions for the builders that need them. 0.1.0 First public release.

常见问题:

Do I need a paid Postio account?

You need a Postio account. The plugin itself is free; usage is metered against your Postio API credits.

Which form builders are supported?

WooCommerce plus seven form builders. Five of the eight wire themselves; the other three take one class per field, with the snippet shown to you on the settings screen. Anything not on the list works through Custom mappings. Want a builder added to the automatic list? Email admin@postio.co.uk, or open an issue at https://github.com/postio-uk/postio-wordpress-plugin.

My builder isn't listed — will this still work?

Yes. Go to Settings → Postio → Custom mappings and add a row. Each row binds one search input (by CSS selector) to one or more output fields — line 1, line 2, town, postcode. That covers any theme or builder that renders plain HTML inputs, which is nearly all of them.

How do I wire up a Contact Form 7 form?

CF7 has no built-in address field, so opt in by class. On each address field shortcode, add the matching class — class:postio-line-1, class:postio-line-2, class:postio-town, class:postio-postcode. Add an optional [text address-search class:postio-search] field above the address fields if you want a dedicated lookup input separate from line 1. Without it, line 1 doubles as the search input — typing into it shows suggestions, picking one fills line 1 and the other fields. Only postio-line-1 is required. Anything missing is left untouched.

How do I wire up a Ninja Forms form?

Add Display CSS Classes on the relevant fields — postio-line-1, postio-line-2, postio-town, postio-postcode. Add postio-search to a dedicated lookup field if you want one separate from line 1. Only postio-line-1 is required.

How do I wire up an Elementor Forms form?

Elementor Forms is part of Elementor Pro. On each address field's Advanced → Custom CSS Classes, add the matching class — postio-line-1, postio-line-2, postio-town, postio-postcode. Add postio-search to a dedicated lookup field if you want one separate from line 1. Only postio-line-1 is required.

Will Postio overwrite my country dropdown?

No. Country fields are intentionally not auto-mapped: most form builders use ISO country codes (GB, US) in their dropdowns, but Postio returns the constituent UK country (England, Scotland, etc.). Setting an unmatched value would clear the dropdown, which is worse than leaving it on whatever the customer already chose.

Does this work outside the UK?

Postio's data is UK-only (Royal Mail PAF + Ordnance Survey). Use it on UK address forms.

What about GDPR?

The plugin sends no customer data to Postio's servers — only the postcode / search terms the customer types into the autocomplete, and only while they're typing. No customer data is logged on Postio's side beyond the request itself.

Where is the source for the bundled script?

assets/address-finder.js is a build of the @postio/address-finder-bundled package (MIT licensed), published on npm. You do not need to go anywhere to read it: the complete original TypeScript source is embedded in the source map shipped alongside it, assets/address-finder.js.map. The plugin's own source is at https://github.com/postio-uk/postio-wordpress-plugin.

更新日志:

1.0.0 0.2.0 0.1.0