The AddressFinder plugin for BigCommerce adds an autocomplete capability to the billing and shipping address fields for New Zealand and Australian BigCommerce stores.
- Get verified addresses – No more mistakes. Save addresses straight from your webform to your database.
- Access the latest addresses – Access addresses frequently refreshed from multiple sources.
- No software required – AddressFinder is a JavaScript widget and API. This plugin requires ZERO programming ability.
Register for a free AddressFinder account at one of these links:
Existing users can obtain their API key from the AddressFinder Portal.
Read more on the AddressFinder BigCommerce Plugin page.
Addressfinder-BigCommerce requires IE10, IE11, Edge, Chrome, Safari, or Firefox.
Follow the instructions below, or watch the installation video.
These instructions are compatible with themes from BigCommerce's new Stencil theme platform. If you created your store within the last 6 months you will have a Stencil theme. If you are unsure check the BigCommerce documentation for a list of themes and their platforms.
If you are using a Blueprint theme you can find the alternate setup instructions on the AddressFinder website
- Open the BigCommerce Admin Dashboard
- Click Settings in the sidebar
- Scroll down to the Advanced section
- Click Data solutions
- Select 'Site Verification Tags' and click Connect
-
Copy and paste the following javascript snippet into the input field.
<script> (function(d,w){ w.AddressFinderConfig = { key: "ADDRESSFINDER_DEMO_KEY", debug: false } w.addEventListener('DOMContentLoaded', function(){ var s = d.createElement("script"); s.src = "https://api.addressfinder.io/assets/bigcommerce/v1/boot.js"; s.async = 1; d.body.appendChild(s); }); })(document, window); </script>
- Replace the ADDRESSFINDER_DEMO_KEY in the snippet with your account key and click Connect.
- Test on your website. The autocomplete service should now be working on the checkout and create account pages.
New users can register for a free AddressFinder account at one of these links:
Existing users can obtain their API key from the AddressFinder Portal.
If you want to adjust the default behaviour of the widget you may add additional options.These options should be added inside an object with the key 'widgetOptions' and should be in the form of key value pairs. This section may be excluded for default behaviour. For a full list of possible options visit our Widget Documentation
w.AddressFinderPlugin = {
key_nz: "ADDRESSFINDER_DEMO_KEY",
key_au: "ADDRESSFINDER_DEMO_KEY",
widgetOptions: {
byline: false
}
};
If you need to add different options for each country you can enter them in objects with the keys 'nzWidgetOptions' and 'auWidgetOptions'.
w.AddressFinderPlugin = {
key_nz: "ADDRESSFINDER_DEMO_KEY",
key_au: "ADDRESSFINDER_DEMO_KEY",
nzWidgetOptions: {
byline: false
},
auWidgetOptions: {
byline: true
}
};
w.AddressFinderConfig = {
key: "ADDRESSFINDER_DEMO_KEY",
// Toggle each widget on/off. Options: (true/false)
// The address widget is enabled by default
addressWidgetEnabled: true,
emailWidgetEnabled: true,
phoneWidgetEnabled: true,
// Note: avWidgetOptions, evWidgetOptions and pvWidgetOptions objects are optional. You can optionally omit them if you prefer.
// visit https://addressfinder.nz/docs/javascript_widget_reference_nz/ for a full list of NZ widget options
// visit https://addressfinder.com/r/docs/javascript_widget_reference_au/ for a full list of AU widget options
avWidgetOptions: {
// address widget options go here
},
// visit https://addressfinder.com/r/docs/email/javascript-reference/ for a full list of email validation options
evWidgetOptions: {
check: "connection",
rules: {
role: {
rule: "block",
message: "We do not accept role email addresses, please enter a different email to continue"
}
}
},
// visit https://addressfinder.com/r/docs/phone/javascript-reference/ for a full list of phone validation options
pvWidgetOptions: {
// defaultCountryCode will only be used for pages where there is no country select
defaultCountryCode: "NZ",
allowedCountryCodes: "AU,NZ",
// This will format the number after it has been verified
// Options include: "rawNational", "formattedNational", "rawInternational", "formattedInternational"
formatNumber: "formattedInternational",
rules: {
nonMobile: {
rule: "block"
}
}
},
debug: true,
};
For the full list of NZ specific options For the full list of AU specific options
See BUILD.md for instructions on how to build this plugin from source.
The AddressFinder plugin for BigCommerce is released under the permissive free software MIT License.