| 开发者 | clearpathlabs |
|---|---|
| 更新时间 | 2026年10月10日 00:13 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
api.snapaddress.io to provide address autocomplete functionality. When a customer (at checkout or in My Account) or a member of staff (on the admin order screen) types a postcode or partial address into the lookup, the plugin sends that search text to the SnapAddress API and receives matching address suggestions.
snapaddress folder to /wp-content/plugins/ or install directly from the WordPress plugin directoryNo. SnapAddress uses Royal Mail PAF data directly. There's no dependency on Google Maps, Google Places, or any Google service.
Yes. SnapAddress works with both the block-based checkout and classic checkout, on both the shipping and billing address forms.
Yes. New accounts get 100 free lookups with no credit card required - enough to test the integration on your checkout before buying a credit pack.
You buy a one-time pack of lookup credits (from 500 upwards). The suggestions shown while someone types are free; a credit is used only when they pick a postcode and the full list of addresses is fetched - so a typical address search costs one credit. There is no monthly subscription. When your credits run low, you top up with another pack whenever you choose.
Everything keeps working. Wherever the lookup appears - checkout, My Account or the admin order screen - it falls back to standard manual address entry, so customers can still complete their orders and staff can still type an address. You top up when you're ready.
Go to WooCommerce > SnapAddress and tick "My Account > Addresses" and/or "Admin order and subscription screens" under "Show the lookup on", then save. Both are off until you turn them on. Checkout can be switched off on the same screen.
Yes. A lookup made by a member of staff on the admin order screen uses a credit exactly like one made by a customer at checkout. The suggestions shown while typing are free; a credit is used when a postcode is picked and its addresses are fetched.
Purchased credits are valid for 12 months from the date of purchase, and free trial credits for 3 months. This is a requirement of Royal Mail's PAF licensing terms, which apply to all PAF-based address providers. A 500-credit Starter pack lasts most small stores several months.
SnapAddress uses Royal Mail's Postcode Address File (PAF), which contains more than 30 million UK addresses and is updated monthly. It includes flat-level accuracy for multi-occupancy buildings, which Google Places does not provide for UK addresses.
When a customer or member of staff uses the address lookup, the search text they type (a postcode or partial address) is sent to the SnapAddress API to return matching suggestions. No names, emails, or payment details are sent. See our privacy policy at snapaddress.io/privacy for full details of what is processed and retained.
Yes, if the stores belong to your business. One SnapAddress account can serve all of them, and you can create a separate API key for each store from your dashboard. If you build or run stores for other businesses, for example as an agency, each business needs its own SnapAddress account, because credits can't be shared between businesses (a condition of the Royal Mail PAF licence).
By default the search box appears directly above the street address field. On checkout and in My Account, if your theme uses a custom layout and you want it somewhere else, add an empty element with a data-snapaddress-anchor attribute where the search box should render, for example <div data-snapaddress-anchor="billing"></div> (use "shipping" for the shipping section). The search box renders inside that element. Place the anchor outside the billing/shipping fields container (WooCommerce re-orders elements inside it), and if more than one anchor exists for a section, the first one on the page wins.
Yes. On classic checkout the search box deliberately inherits your theme's own checkout field styling, so in most themes it already matches the fields around it without any work. To customise it further, target .snapaddress-lookup__input for the field and .snapaddress-lookup__label for its label, or override the --snapaddress-* custom properties listed at the top of the plugin's stylesheet to restyle the suggestions dropdown. None of the search box's own styling uses !important, so plain rules in Appearance > Customise > Additional CSS will apply. On the admin order screen the search box uses WooCommerce's own admin field styling, so it matches the other order fields.