ShopWired Integration

Ideal Postcodes provides a ShopWired integration that facilitates UK address search and validation across a ShopWired Store.

This extension is free to download and install. However, our address validation services require a paid account at ideal-postcodes.co.uk.

This integration works by hooking into the custom scripts enabled for Google Analytics. It waits until a valid address form is present before binding itself.

Contact us if you get stuck. Drop by our developer chat page for in-depth assistance.

Features

• Address autocompletion on checkout shipping and billing pages
• Checks if the API Key is usable before enabling autocomplete
• Populates organisation name from selected address

Screenshots

Address Finder

Postcode Lookup

Links

• Guide
• Changelog
• npm Module
• GitHub Repository
• CDN

Support

If you need support, you can either reach out to us on our support page or drop by our developer chat page.

Installation

This integration is installed via adding our initialisation script via Advanced Customisation.

Access Advanced Customisation

From the Administration page sidebar, navigate to Checkout → Platform Checkout and scroll down to Advanced Customisation.

Insert Activation Code

In the Script contents editor, insert the below configuration code and click on Save.

<script>
  window.idpcConfig = {
    apiKey: "Your API Key goes here"
  };
</script>

<script 
  async 
  type="text/javascript"
  crossorigin="anonymous"
  src="https://cdn.jsdelivr.net/npm/@ideal-postcodes/shopwired">
</script>

When inserting the configuration and initialisation codes into the editor, take special care to replace the following:

• The apiKey attribute in the first script tag. This should be replaced with the Key on your account.

Versions are automatically logged and tracked on our Changelog. It is possible to pin a specific version by appending @version to the script URL. e.g. src="https://cdn.jsdelivr.net/npm/@ideal-postcodes/shopwired@1.1.3.

Improve Load Times

The plugin needs to download external assets like jQuery to function. You can speed up the plugin load times by pre-emptively fetching the necessary scripts. To speed up load times, add the following above your activation code:

<script 
  src="https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js" integrity="sha256-9/aliU8dGd2tb6OSsuzixeV4y/faTqgFtohetphbbj0=" 
  crossorigin="anonymous">
</script>
<script 
  src="https://cdn.jsdelivr.net/npm/jquery-postcodes@3.0.8/dist/postcodes.min.js" integrity="sha256-JZSN3ZEXOFlpSMFjQkHjbKnjHlsFVf8N7p1SbCI0XHI=" 
  crossorigin="anonymous">
</script>
<script 
  src="https://cdn.jsdelivr.net/npm/ideal-postcodes-autocomplete@0.2.1/dist/ideal-postcodes-autocomplete.min.js" integrity="sha256-lZPaPHBx7V2Gj9iAc8QfVcW02KlWB2gbrqXpGfiEGgo="
  crossorigin="anonymous">
</script>
<link 
  rel="stylesheet" 
  href="https://cdn.jsdelivr.net/npm/ideal-postcodes-autocomplete@0.2.1/css/ideal-postcodes-autocomplete.css" integrity="sha256-ewtQO/9EEPz6LsP/kWLv+bzykzIAr+d6s0WqA2B4clQ=" 
  crossorigin="anonymous"
/>

Testing

Your first key on your Ideal Postcodes account will carry a free test balance which you can use to verify and test your integration. Please contact support if you need a larger test balance.

Going Live

In order to go live, you will need to purchase a balance of lookups on your API Key. This can be done manually or automated from your dashboard. Each address search consumes one lookup from your Key balance.

See our account setup guide for the quickest way to go live by creating your first API Key and enabling automated top-ups.

Configuration

The minimum configuration is as follows:

<script>
  window.idpcConfig = {
    apiKey: "Your API Key goes here"
  };
</script>

See our integration configuration guide to understand how to customise this.

Defaults

The available configuration attributes for the configuration are as follows:

{
   // API Key is not set by default
  apiKey: "",

  // Postcode Lookup is enabled
  postcodeLookup: true,

  // Autocomplete is enabled
  autocomplete: true,

  // Company name field is updated
  populateOrganisation: true,
  // County name field is not updated
  populateCounty: false,

  // Advanced configuration
  autocompleteOverride: {},
  postcodeLookupOverride: {}
}

API Key

Your API Key is central to how our service recognises your integration. See our guide on API Keys to find out more.

API Keys can also be safeguarded against potential misuse. Please see our guide on securing your API Key to find out more.