WooCommerce extension for UK address search and validation
Features
- Address Finder and/or Postcode Lookup on
- Checkout shipping and billing pages
- Customer account pages
- Adds Address Finder to WooCommerce admin pages (e.g. order creation, update)
- Checks if key is usable before enabling autocomplete
- Optionally populate organisation name from selected address
- Optionally populate county information
If you need support, you can either reach out to us on our support page or drop by our developer chat page.
Demo
Address Finder
Postcode Lookup
Address Finder in Admin Dashboard
Works With
Installation
Download Options
You can install this plugin manually or via WordPress plugins.
Manual Installation
- Retrieve the plugin from the GitHub repository and download the latest from the releases page
- Unzip the release and upload the
uk-address-postcode-validation
directory to/wp-content/plugins/uk-address-postcode-validation
WordPress Plugins
The plugin is available on the WordPress Plugins directory.
You can download it from your dashboard:
- Click on
Plugins
->Add New
in the left sidebar - Search for
Ideal Postcodes
- Click
Install Now
on the plugin namedUK Address Postcode Validation
- Click
Activate
when the plugin is installed
Configuration
- Activate the plugin through the
Plugins
screen in WordPress - Configure the plugin. Click on the WooCommerce link in the sidebar, followed by the
Integration
tab on the settings page. - From the options available, click on
UK Address Postcode Validation
. - Add your API Key. You will need to add your API Key from your Ideal Postcodes dashboard. Your first Key will have a free test balance. To go live, you will need to prepurchase a lookup balance on your Key.
Configuration
The Ideal Postcodes extension can be configured via the WooCommerce Settings page. From the left sidebar of the admin dashboard, click WooCommerce
-> Settings
-> Integration
-> UK Address Postcode Validation
.
Required
Enabled
Activates or deactivates the extension altogether.
API Key
The API Key is required to verify your account for address validation. This can be found on your account dashboard on ideal-postcodes.co.uk.
Optional
Enable Populate Organisation
Addresses selected which carry an organisation attached will overwrite the value of the Company Name field.
Enable County
This will populate the county field. County data is no longer used in the UK to identify a premise. However, this can be enabled if you prefer.
Separate Address Finder
This will created a separate input field specifically for the Address Finder above your address fields. By default, the Address Finder is only applied to the first address line.
Enable Address Validation based on country
This will enable or disable our Address Validation tools based on whether a supported territory has been selected.
Advanced Configuration
Postcode Lookup Configuration Override
Defaults to blank or empty (i.e. ""
). Please take care when updating this field as invalid input will prevent address validation from running.
This globally overrides the Postcode Lookup configuration object. See the Postcode Lookup library documentation to find out more.
Address Autocomplete Configuration Override
Defaults to blank or empty (i.e. ""
). Please take care when updating this field as invalid input will prevent address validation from running.
This globally overrides the Address Finder configuration object. See the Address Finder library documentation to find out more.
Elementor
Elementor is a free WordPress website builder, which also allows you to create custom checkouts for WooCommerce.
Elementor stops checkout plugins from running by disabling the default page actions. Follow the steps below to fix this:
Adjustments
Step 1. Add a PHP snippet to your WordPress site either via functions.php
or a PHP snippet plugin. The snippet defines a function which activates the WooCommerce specific checkout hooks.
/**
* Re-invokes certain WooCommerce hooks to activate the Ideal Postcodes address validation plugin on checkout
* Requires a shortcode "[do_woocommerce_hooks]" to be added to the checkout page
*/
add_shortcode('do_woocommerce_hooks', function(){
// Loads JavaScript and CSS assets
do_action('woocommerce_before_checkout_form');
// Injects credentials and initialises above assets
do_action('woocommerce_before_checkout_form');
});
Step 2. On your custom checkout page, add a shortcode with the following contents:
[do_woocommerce_hooks]
This will cause the function defined in Step 1 to run, loading in address validation.