=== WooCommerce AddressFinder ===
Contributors: Abletech
Tags: woocommerce, addressfinder, address, autocomplete, new zealand, australia, shipping, valid
Requires at least: 4.1
Tested up to: 4.5
Stable tag: 1.0.10
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Enables autocomplete of Shipping and Billing Addresses for New Zealand and Australian WooCommerce stores.

== Description ==

The AddressFinder plugin for WooCommerce adds an autocomplete capability to the
delivery and billing address fields of your online store.

= Get Verified Addresses =

No more mistakes. Save addresses straight from your webform to your database.

= Access the latest addresses =

Leave the hard work to us. Access addresses frequently refreshed from multiple sources.

= No software required =

AddressFinder is a JavaScript widget and API. This plugin requires ZERO programming
ability.

= Supported Countries =

* [Australia](https://addressfinder.com.au/)
* [New Zealand](https://addressfinder.nz/)

= Demonstration Video =

[vimeo http://vimeo.com/157373924]

= Compatibility =

WooCommerce AddressFinder requires:

* Wordpress v4.1 or higher
* WooCommerce v2.3 or higher


== Installation ==

= Demonstration video =

Follow the instructions below, or watch the [installation video](https://vimeo.com/abletech/addressfinder-woocommerce).

= Installation instructions =

This section describes how to install the plugin and get it working.

1. Use the Wordpress Admin Menu, select Plugins -> Add New
1. Search for `woocommerce-addressfinder`
1. Press the Install Now button
1. Activate the plugin through the 'Plugins' screen in WordPress
1. Use the WooCommerce -> Settings -> Checkout screen to input your AddressFinder API keys.
1. Done

New users can register for a free account at one of these links:

* [Free Account for Australia](https://portal.addressfinder.io/signup/au/free?rc=woo_readme)
* [Free Account for New Zealand](https://portal.addressfinder.io/signup/nz/free?rc=woo_readme)

Existing users can obtain their API key from the [AddressFinder Portal](https://portal.addressfinder.io/).

Read more on the AddressFinder [WooCommerce Plugin](https://addressfinder.nz/docs/woocommerce/?rc=woo_readme) page.


== Frequently Asked Questions ==

= What is the WooCommerce plugin? =

The WooCommerce plugin provides the following features:

* Autocomplete billing and shipping address in checkout page
* Autocomplete address in my account page
* Only enabled when country is selected as New Zealand or Australia

= Which AddressFinder plan is right for you? =

AddressFinder offers both free and paid plans, we recommend you start with the free plan which gives you up to 1000 completed address searches per month. Sign up for a Free Plan now and then follow the "Download and install" instructions below.

If you need more than 1000 address searches per month from day one then sign up for a Pro Plan now, these start from $1,500 per annum (No credit card required we will invoice you).

If your usage grows beyond a free plan it is easy to upgrade to a Pro Plan on the AddressFinder portal.

You can read more about AddressFinder plans here:

* [AddressFinder New Zealand Plans](https://addressfinder.nz/plans/?rc=woo_readme)
* [AddressFinder Australia Plans](https://addressfinder.com.au/plans/?rc=woo_readme)


== Screenshots ==

1. Autocomplete billing and shipping address in checkout page.
1. In the Admin section of your wordpress website, navigate to *Plugins* -> *Installed Plugins* and activate the plugin by pressing Activate on AddressFinder.
1. Find your AddressFinder API key at [https://portal.addressfinder.io]([https://portal.addressfinder.io])
1. In the Admin interface, navigate to the *WooCommerce* -> *Settings* -> *Checkout* page and enter your API key/s in the new section for AddressFinder settings. Leaving either the New Zealand or Australia field blank will simply disable autocompletion for the respective country.


== Changelog ==
= 1.0.10 =
* Added debug flag to admin screen
* Improve handling of missing form fields
= 1.0.9 =
* Confirm compatibility with Wordpress 4.5
= 1.0.8 =
* Clean up WooCommerce settings page
= 1.0.7 =
* Minor fixes
= 1.0.6 =
* Add a default z-index style to handle sites that use positioned elements
* Load AddressFinder widget later to improve compatibility with the multistep-checkout-wizard plugin
= 1.0.5 =
* Fix fault with New Zealand city field
* Ignore WooCommerce placeholder instruction. Instead populate address_1 and address_2 as per Australian standards
= 1.0.3 =
* Initial release, enjoy!

== Upgrade Notice ==
= 1.0.9 =
* Nothing to do here, just install and go.


== Contributors ==

* Jordan Carter (https://github.com/jordandcarter)
* Andrew Pett   (https://github.com/aspett)
* Nigel Ramsay  (https://github.com/nigelramsay)