Zoey Integration Guide

Integration with Zoey address forms made simple

A step-by-step guide to integration with Zoey address forms.

Preparation

Download

Download one of our Zoey plugins from the plugins page. We offer plugins for Address Auto-Complete (global address lookup for over 240 countries) and Postcode Lookup (UK only). The plugins are free to download.

Visit the download page

Sign Up

Next, you need to sign up for a Crafty Clicks account.

When you sign up, you will receive an access token by email. There is no obligation to buy anything and you automatically get 30 trial credits. If you need more credits to test the integration, please get in touch (support@craftyclicks.co.uk) and we will try to accommodate you.

Installation

Select the plugin you would like to install.

Install Address Auto-Complete

Step 1

Log in to your website’s admin panel, then click on Edit My Design from the menu on the left, then click on Edit My Design on the main panel. It will redirect you to the website’s own editor.

Step 2

Click on the gear icon next to the ‘Save Draft’ button and select CSS/Javascript/HTML Editor.

Step 3

Select the JavaScript tab. Open cc_c2a_zoey.js select all of its content and paste it into the JavaScript tab.

On line 16, replace xxxxx-xxxxx-xxxxx-xxxxx with your access token.

Click on Save.

Configuration (optional)

You can experiment with different ambient and accent combinations on line 17 and 18, which can ensure that our integration perfectly fits into your website’s theme.

If you are only shopping to the UK, you can restrict the address search to UK only. First, locate enabledCountries on line 20 and add “GB” between the square brackets (with the quotation marks). Then, change the value of the countrySelector from true to false on line 22.

To disable Google Auto-Full, change the value of the disableGoogleAutoFill from false to true on line 23.

Click on Save when you have finished making changes.

Install Postcode Lookup

Step 1

Log in to your website’s admin panel, then click on ‘Edit My Design’ from the menu on the left, then click on ‘Edit My Design’ on the main panel. It will redirect you to the website’s own editor.

Step 2

Click on the gear icon next to the ‘Save Draft’ button and select CSS/Javascript/HTML Editor.

Step 3

Select the JavaScript tab. Open cc_lookup_uk.js, select all of its contents and paste it into the JavaScript tab.

On line 14, replace xxxxx-xxxxx-xxxxx-xxxxx with your access token.

Click on Save.

Configuration (optional)

If you would like to use a busy image, upload crafty_postcode_busy.gif via Advanced -> Import & Export -> Image Import. Then copy the link to crafty_postcode_busy.gif and insert it on line 15. Experiment with the rest of the options and find the combination that suits your website the best. Click the Save button when you have finished making changes.

FAQ

Test

Before you go live, test the integration to make sure it is working properly.

For the Postcode Lookup integration only, we have the following free postcodes for testing: AA1 1AA, AA1 1AB, AA1 1AD and AA1 1AE.

If you need assistance, drop us an email on support@craftyclicks.co.uk – we will help!

Go Live

Once your trial credits run out, you will need to decide on the best purchasing option based on the volume of usage you expect on your site. If you would like us to advise you then please get in touch.

Questions

  • Do you offer support? Yes, we do offer support during normal business hours in the UK. If you run into any issues, let us know and we will be happy to help.
  • Is this free? The extension is free to download and try, but to use it on a live site you will need a paid account with us.
  • Do I need to sign up for an account to try it? Yes, you’ll need a trial account, at least. You can easily sign up for a free trial account.
Last Updated: 9/11/2018, 1:32:56 PM