Address autocomplete and validation

开发者	smartyandrewb
更新时间	2026年9月16日 03:52
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPL-2.0-or-later
版权网址:	版权信息

下载

1.0.0

详情介绍:

Address autocomplete and validation adds real-time address autocomplete and verification to your WooCommerce block checkout, powered by the Smarty address intelligence API. Features:

Real-time address suggestions as customers type — US and international
Automatic form-fill for street, city, state, and postal code on selection
Address verification at checkout submission — catches typos before the order is placed
Side-by-side correction UI when a standardized address is available
Prompts for a missing apartment, suite, or unit number when one is expected
Address autocomplete on admin order pages when you create or edit an order
One-click account connection — sign in with Smarty and pick a key, no copy-and-paste
Automatically detects which Smarty services your account is subscribed to
Supports US territories with ZIP+4 postal codes (Guam, Palau, American Samoa, and more)
Works with both shipping and billing address fields
Styled to match your theme — no layout conflicts

Requirements:

WooCommerce block checkout (the classic shortcode checkout is not supported)
A Smarty account with at least one embedded key — sign up for free at smarty.com

安装:

In your WordPress admin, go to Plugins → Add New and search for "Address autocomplete and validation".
Click Install Now, then Activate.
Go to WooCommerce → Settings → Integrations → Smarty Address Autocomplete and Validation.
Click Connect with Smarty and sign in to your Smarty account to authorize the connection.
Back on the settings page, select an embedded key from the dropdown and click Save changes.
Optionally, use the Active Subscriptions toggles to enable or disable individual Smarty services.
Make sure your checkout page is using the WooCommerce block checkout.

You don't need to copy or paste an API key — the plugin loads the embedded keys from your Smarty account for you after you connect. If you don't have an account, sign up for free. Prefer to install manually? Use Plugins → Add New → Upload Plugin to upload the ZIP, or extract the smarty-address-autocomplete-for-woocommerce folder into /wp-content/plugins/.

屏幕截图:

升级注意事项:

1.0.0 Initial release.

常见问题:

Does this work with the classic WooCommerce checkout?

No. The plugin is built for the WooCommerce block checkout introduced in WooCommerce 8.3. The classic shortcode-based checkout ([woocommerce_checkout]) is not supported.

How do I connect the plugin to my Smarty account?

On the settings page, click Connect with Smarty and sign in to authorize the connection. The plugin then loads the embedded keys from your account into a dropdown — just pick one and click Save changes. No copying or pasting of keys is required.

I don't have any embedded keys to select.

That means the connected Smarty account has no embedded keys yet. Log in at smarty.com, create an embedded key under API Keys, then click Change Key on the settings page to reload the list. Embedded keys are designed for client-side use and can be scoped to your domain, so make sure the key is authorized for your store's domain.

What are the Active Subscriptions toggles?

After you connect, the plugin detects which Smarty services your account is subscribed to (US and international address verification and autocomplete). Subscribed services are enabled by default; toggle any off if you don't want to use them. Services you're not subscribed to are shown but can't be enabled.

What happens if my connection expires?

If your saved authorization expires or is revoked, the plugin shows a notice with a Reconnect now link. Click it, then click Connect with Smarty again to restore the connection.

Does autocomplete work for international addresses?

Yes. When a customer selects a non-US country, the plugin automatically switches to the Smarty international autocomplete API. Supported countries are listed in the Smarty documentation.

Does address verification work internationally?

Yes. Verification is supported for countries covered by the Smarty international street address API. For unsupported countries, verification is skipped and checkout proceeds normally.

Will this slow down my checkout?

Autocomplete suggestions are fetched asynchronously with a 200ms debounce, so they don't block typing. Verification happens only when the customer clicks Place Order and adds less than one second in most cases.

What happens if the Smarty API is unreachable?

Autocomplete silently skips suggestions. Verification fails open — if the API call errors, the checkout proceeds without verification so customers are never blocked by an outage.

更新日志: