# WooCommerce Integration Guide

# Integration with WooCommerce address forms made simple

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

# Preparation

# Download

Download our WooCommerce plugin from the plugins page or from the WordPress Plugin Directory.

We offer one plugin for WooCommerce which contains the following products:

  • Address Auto-Complete (global address lookup for over 240 countries)
  • Postcode Lookup (UK only)
  • Phone Validation (global)
  • Email Validation

# Sign Up

Next, you need to sign up for a Fetchify account.

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

# Installation

# Step 1

Unpack the zip file and copy the clicktoaddress-auto-complete folder to your WordPress installation’s wp-content/plugins folder.

# Step 2

In your WordPress admin panel, go to Plugins / Installed Plugins, and activate the Fetchify plugin.

# Step 3

From the admin panel, go to WooCommerce / Settings / Integration and select the Fetchify tab.

Here you will need to insert your access token, which is required to use the plugin. To get an access token, you will need to sign up for an account with us, and we will email you an access token.

On this page you can also choose the products you would like to enable. All products are disabled by default. Note that Address Auto-Complete and Postcode Lookup cannot both be active at the same time.

For Address Auto-Complete, Postcode Lookup and Phone Validation, additional configuration options are available. These options will only become visible once the product has been enabled. Hover over the tooltip icons for more information about each setting.

When you have finished configuring the plugin, click the ‘Save changes’ button at the bottom of the page.

# WPML Configuration

Our plugin is compatible with WPML which allows translation of certain texts in the search UI. The following texts can be translated.

Address Auto-Complete:

  • Search field label
  • Reveal fields button
  • Hide fields button
  • Search field placeholder
  • Country search placeholder
  • Change country button
  • Generic error message
  • No results message

Postcode Lookup:

  • Lookup button text
  • Search in progress message
  • Unknown postcode message
  • Invalid postcode message
  • Server error message
  • Unknown error message

# Requirements

If you want to use WPML to translate the Fetchify plugin, the following plugins must first be installed:

  • Fetchify
  • WPML Multilingual CMS
  • WPML String Translation
  • WooCommerce Multilingual

You must also configure the Fetchify plugin first. You can find the plugin settings in WooCommerce / Settings / Integration / Fetchify. Select the products that you would like to enable and enter the texts you would like to use for your site's default language.

# Step 1

In your WordPress admin panel, go to WPML / String Translation.

# Step 2

A list will be displayed showing all strings available for translation. First you should filter this list to show only the options related to the plugin. You can do this using 'Select strings within domain'. You should select this domain: admin_texts_woocommerce_clicktoaddress_autocomplete_settings. This will display all the options from the Fetchify plugin that can be translated. Note that some of these options are for Address Auto-Complete and some are for Postcode Lookup. You can ignore any options that do not require translation.

# Step 3

For each option, click the 'translations' button next to the string. Here you can set custom translations for each language that you have enabled. When you are happy with the translation, make sure you mark that translation as complete, then save your changes.

Your translated texts will now appear in the search UI!


# Test

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

The following free postcodes are available for testing: Address Auto-Complete only: SL6 1QZ Postcode Lookup only: AA1 1AA, AA1 1AB, AA1 1AD and AA1 1AE.

If you need assistance, drop us an email on support@fetchify.com – we will help!

# Go Live

Once your trial lookups 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.

# Installation

  • 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/1/2020, 11:19:23 AM