What is the AddressFinder BigCommerce plugin?

The plugin enables autocomplete of Shipping and Billing Addresses for New Zealand and Australian BigCommerce stores.

The AddressFinder for BigCommerce plugin provides the following features:

• Autocomplete billing and shipping address in checkout page
• Support for both New Zealand and Australian addresses
• This plugin requires ZERO programming ability

Installation Instructions - Stencil theme

BigCommerce have recently introduced a new theme called the Stencil Theme. This theme works differently to the themes used in the past, so new instructions are required to enable AddressFinder.

1. Open the BigCommerce Admin Dashboard
2. Click Advanced Settings in the sidebar
3. Click Web Analytics
4. Tick the Google Analytics checkbox (if unticked)
5. Click on the Google Analytics tab
6. In the text area named Tracking Code, add the following code at the bottom of the box:

   1 2 3 4 5 6 7 8 9 10 11 12 13

   <script> (function(d,w){ w.AddressFinderConfig = { key: "ADDRESSFINDER_DEMO_KEY" }; 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>

7. Replace the ADDRESSFINDER_DEMO_KEY placeholder in the snippet you added in the previous step with your own AddressFinder key. You can use the same key in both of the fields.
8. Press the Save button

Advanced Usage

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

1
2
3
4
5
6
7

    w.AddressFinderPlugin = {
      key_nz: "ADDRESSFINDER_DEMO_KEY",
      key_au: "ADDRESSFINDER_DEMO_KEY",
      widgetOptions: {
        byline: false
      }
    };

Country Specific Options

If you need to add different options for each country you can enter them in objects with the keys 'nzWidgetOptions' and 'auWidgetOptions'

1
2
3
4
5
6
7
8
9
10

    w.AddressFinderPlugin = {
      key_nz: "ADDRESSFINDER_DEMO_KEY",
      key_au: "ADDRESSFINDER_DEMO_KEY",
      nzWidgetOptions: {
        byline: false
      },
      auWidgetOptions: {
        byline: true
      }
    };

Testing

Follow the steps below to confirm that the plugin is working successfully:

1. Visit the store page of the website
2. Choose an item, and click Add to Cart
3. Click Checkout button
4. Choose the Checkout as Guest
5. Click Continue
6. Select the country as New Zealand or Australia
7. Enter in a portion of the address in field Address Line 1
8. Suggested addresses should appear
9. Select one of the suggestions
10. Confirm that the relevant address form fields are populated
11. Untick the “I also want to ship to this address” checkbox
12. Click the button labeled: Bill to this Address
13. Repeat from Step 6 (above)
14. Finally, repeat from Step 4, but select the “Register an Account” option

The AddressFinder plugin for BigCommerce source code is also available on Github.

Get started now for free

• Australia
• New Zealand

Existing user? Get your Licence key from the AddressFinder Portal.

Software Licence

The AddressFinder plugin for BigCommerce is released under the permissive free software MIT Licence.