# 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 (opens new window) or from the WordPress Plugin Directory (opens new window).

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

# Installation

To install the Fetchify plugin from the WordPress Plugin Directory, go to Plugins / Add New in your WordPress admin panel and search for 'Fetchify'. Select 'Install Now' and enter your FTP credentials if necessary. When the plugin has finished installing, select 'Activate'.

Alternatively, unpack the zip file and copy the clicktoaddress-auto-complete folder to your WordPress installation’s wp-content/plugins folder. Then, in your WordPress admin panel, go to Plugins / Installed Plugins, and activate the Fetchify plugin.

# Configuration

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 UK Postcode Lookup cannot both be active at the same time.

For Address Auto-Complete, UK 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 (opens new window) 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

UK 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 UK 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!

# 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.