What is the AddressFinder BigCommerce plugin?

As BigCommerce no longer supports BluePrint themes, we have also dropped our support for the AddressFinder-BluePrint plugin.

If you still use a BluePrint theme, you are welcome to follow the integration instructions below and test the plugin. If things work as expected then feel free to use the plugin, however, if testing reveals issues we suggest you remove it as we are not in a position to resolve these.

The AddressFinder for BigCommerce plugin provides the following features:

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

Installation Instructions - Older themes

1. Log into the control panel for your site, and navigate to Store Setup > Design.
2. Your current theme will be displayed in the Themes tab; click Edit HTML/CSS to access your template files.
3. Install the plugin:
   1. Find the checkout_express.html file
   2. Scroll to the bottom of the page
   3. Copy the following JavaScript snippet and paste it in just before the closing </body> tag

        
          (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);
        
      

   4. Replace the ADDRESSFINDER_DEMO_KEY placeholder in the snippet you added in the previous step with your own AddressFinder keys
4. Then, repeat Step 3 for the files createaccount.html and shippingaddressform.html.

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

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

    
      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'

    
      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.

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.