This plugin enables your customers to complete their billing\/shipping addresses by entering their postcode and selecting their address from the options given.<\/p>\n\n
It utilises getAddress.io (https:\/\/getaddress.io) to do the lookup using their Royal Mail Postcode Address File.<\/p>\n\n
An API key is required for the integration to work, and the integration only appears when the customer has selected United Kingdom (or, more specifically, the ISO-3166-2 code \"GB\") for their country.<\/p>\n\n
It can optionally be turned off for the shipping or billing addresses, and can be enabled or disabled in each of the checkout, customer account and WooCommerce admin screens.<\/p>\n\n
Postcodes that are looked up are saved in a custom database table for 24 hours to help reduce your costs for use of the getAddress.io API.<\/p>\n\n
With the update to v3.2.4, I have had to make the difficult decision to discontinue this plugin.<\/p>\n\n
There are legal and ethical concerns regarding the source of the data used by the getAddress.io API, and consequently to protect myself and my users, I have little choice but to discontinue the plugin development.<\/p>\n\n
After the plugin update (or a new installation) the plugin will remain active for 30 days and then the lookup facilities will no longer be available, at which point you should deactivate and uninstall the plugin. A notice will be displayed in the admin panel informing you of this, showing the date that your lookup will cease to function.<\/p>\n\n
I am unable to field queries regarding possible alternative providers or plugins, but WooCommerce have recently added a native Address Lookup system into version 10.3 of WooCommerce which should rapidly become popular and gain the support of most postcode lookup services.<\/p>\n\n
For more information: https:\/\/blog.ideal-postcodes.co.uk\/ideal-postcodes-wins-high-court-ruling<\/p>\n\n
WooCommerce<\/a>, at least version 3.0.\ngetAddress.io API Key<\/a>. A number of pricing plans are available.<\/p>\n\n Note:<\/strong> Currently, this plugin does NOT support WooCommerce Checkout Blocks introduced as the default checkout experience in WooCommerce version 8.3, it can only be used with the WooCommerce checkout shortcode. I aim to make this plugin compatible with Checkout Blocks as soon as possible.<\/p>\n\n Once installed and activated, you need to go to the WooCommerce -> Settings -> General page in the WordPress dashboard. You can enter your API key and set your other options here.<\/p>\n\n Certain plugins that also modify checkout fields can conflict with this plugin and prevent it from working.<\/p>\n\n Usually, the symptom of this is that the \"Find Address\" button does not appear.<\/p>\n\n Since version 2.1, I've added a Hook Priority setting at the bottom of the settings for the plugin that you can use to try and fix these conflicts.<\/p>\n\n The default priority is 10, but using a higher number makes my plugin modify the checkout later in the process - you will probably need to experiment to find the priority that makes my plugin's changes happen after the conflicting plugin.<\/p>\n\n For example, a priority of 1001 seems to fix conflicts with the \"Checkout Field Editor\" plugin by ThemeHigh.<\/p>\n\n For developers, I've included a few filters that you can use to customise certain aspects of the plugin. These are:<\/p>\n\n All of these filters take one argument, Note: Although these two texts are translatable, filters will override any translations.<\/p>\n\n All of these filters take one argument, Note: By default, the error messages are \"customer friendly\", i.e. they don't go into much detail about the cause of the error!<\/p>\n\n Install via the WordPress Plugin Directory, or download a release from this repository and install as you would a normal WordPress plugin.<\/p>\n\n\nUsage<\/h3>\n\n
Conflicts with other plugins<\/h3>\n\n
Filter Reference<\/h3>\n\n
User Interface<\/h4>\n\n
$text<\/code>.<\/p>\n\ngazchaps-woocommerce-getaddress-io_find-address-button-text - the text shown on the Find Address buttons (default: Find Address)\ngazchaps-woocommerce-getaddress-io_find-address-searching-text - the text shown when the Find Address button is selected (default: Searching...)\ngazchaps-woocommerce-getaddress-io_enter-address-manually-text - the text shown for the \"Enter an address manually\" link (default: Enter an address manually)\n<\/code><\/pre>\n\nError Messages<\/h4>\n\n
$message<\/code>, the error message that will be displayed to the user.<\/p>\n\ngazchaps-woocommerce-getaddress-io_api_error_400 - shown when the postcode supplied is invalid\/empty\ngazchaps-woocommerce-getaddress-io_api_error_401 - shown when the API key provided in the settings is invalid\ngazchaps-woocommerce-getaddress-io_api_error_404 - shown when no addresses were found for the supplied postcode\ngazchaps-woocommerce-getaddress-io_api_error_429 - shown when the API key has hit its usage limit\ngazchaps-woocommerce-getaddress-io_api_error_500 - shown when there is a server error at getAddress.io\n<\/code><\/pre>\n\nStyling<\/h4>\n\n
gazchaps-woocommerce-getaddress-io_billing_selector_row_class - changes the CSS class on the form-row that the billing address selector is placed into\ngazchaps-woocommerce-getaddress-io_shipping_selector_row_class - changes the CSS class on the form-row that the shipping address selector is placed into\ngazchaps-woocommerce-getaddress-io_clear_additional_fields - defaults to true, set to '__return_false' to stop the \"additional fields\" area of the checkout having a clear style applied to it<h3>License<\/h3>Licensed under the [GNU General Public License v2.0](http:\/\/www.gnu.org\/licenses\/gpl-2.0.html)\n<\/code><\/pre>\n\n\n3.2.4 (05\/11\/2025)<\/h4>\n\n
\n
3.2.3 (10\/10\/2024)<\/h4>\n\n
\n
3.2.2 (04\/09\/2024)<\/h4>\n\n
\n
3.2.1 (16\/04\/2024)<\/h4>\n\n
\n
3.2 (26\/10\/2023)<\/h4>\n\n
\n
3.1 (19\/10\/2023)<\/h4>\n\n
\n
3.0 (08\/10\/2023)<\/h4>\n\n
\n
2.3 (14\/06\/2023)<\/h4>\n\n
\n
2.2 (10\/02\/2022)<\/h4>\n\n
\n
2.1 (09\/12\/2021)<\/h4>\n\n
\n
2.0.4 (15\/07\/2021)<\/h4>\n\n
\n
2.0.3 (10\/06\/2021)<\/h4>\n\n
\n
2.0.2 (10\/06\/2021)<\/h4>\n\n
\n
2.0.1 (09\/06\/2021)<\/h4>\n\n
\n
2.0 (09\/06\/2021)<\/h4>\n\n
\n
1.5.1 (27\/08\/2020)<\/h4>\n\n
\n
1.5 (14\/08\/2020)<\/h4>\n\n
\n
1.4 (12\/06\/2020)<\/h4>\n\n
\n
1.3 (06\/05\/2020)<\/h4>\n\n
\n
1.2 (02\/05\/2019)<\/h4>\n\n
\n
1.1 (25\/02\/2019)<\/h4>\n\n
\n
1.0 (24\/02\/2019)<\/h4>\n\n
\n