Name: wordpress-autosuggest-plugin
Owner: what3words
Description: what3words wordpress autosuggest plugin
Created: 2017-01-24 14:10:45.0
Updated: 2017-03-13 15:50:19.0
Pushed: 2017-03-13 15:45:58.0
Homepage: https://wordpress.org/plugins/3-word-address-validation-field/
Size: 2113
Language: PHP
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
=== 3 word address validation field === Contributors: what3words Tags: what3words, w3w, what 3 words, autosuggest, address, 3 word address, postcode, coordinates, location, delivery, e-commerce, ecommerce, checkout, form, woocommerce Requires at least: 4.0.1 Tested up to: 4.7.2 Stable tag: 4.7.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html
Easily capture 3 word addresses on your website with the 3 word address validation field plugin by what3words.
== Description ==
what3words is a global addressing system. It has divided the world into a grid of 3m x 3m squares and assigned each one a unique 3 word address. what3words is more accurate than traditional street addressing, and even allows location information to be captured for places without addresses, such as parks or beaches.
The 3 word address validation field plugin created by what3words allows you to easily integrate 3 word addresses into a form on your site.
Returning suggestions based on full or partial 3 word addresses, its AutoSuggest feature helps users with the following types of input error:
We recommend using the plugin when you want to capture a precise location from a user. This could be the exact location of your customer?s front door, for example, for delivering their purchase.
= Build more with what3words =
what3words is available in most of the official UN languages, as well as several others. 3 word addresses are pre-assigned and are much easier to remember than lat/long coordinates.
Visit our developer site for more information on how to integrate your products with what3words.
== Installation ==
You can install the 3 word address validation field plugin directly via the plugin directory, or by uploading the files manually to your server.
Once the plugin has been installed, you must configure it via the plugin settings. See ?Configuration? below for more details.
= Configuration =
= what3words API Settings =
A what3words API key is required to use the plugin as it authenticates and interacts with the what3words RESTful API autosuggest method.
If you don?t have a what3words API key yet, you'll need to register for one.
= AutoSuggest Settings =
The 3 word address validation field uses the what3words autosuggest method to help users with input errors. It can be configured with the following settings:
Input field(s). You must specify the jQuery object selector(s) where you would like the 3 word address validation field to appear as an input field (.class or #id). Multiple instances can be separated using commas e.g. ?#shipping_w3w, #billing_w3w?.
Number of results. Defines the number of 3 word address suggestions shown in the autosuggest results. The maximum number of results that can be shown is 20.
Language. The list of languages currently supported by what3words, defined as a 2 letter ISO 639-1 code (default is “en”).
Multilingual. When enabled, uses the multilingual variant of autosuggest API method (check documentation).
UI Direction. Direction of the 3 word address validation field. Options are “Left to Right” or “Right to Left” (e.g. for Arabic).
Input placeholder. Placeholder text for the 3 word address validation field, for example “e.g. lock.spout.radar”. We recommend using a placeholder of a 3 word address in the same language as the autosuggest language.
= WooCommerce Checkout =
The plugin also allows you to automatically add a 3 word address validation field to a WooCommerce checkout form and save the 3 word address against the customer?s order details.
By enabling WooCommerce checkout integration, #shipping_w3w and #billing_w3w will be added by default to the AutoSuggest Input Field settings.
== Frequently Asked Questions ==
For all frequently asked questions, and their answers, please visit our support site.
== Screenshots ==
A 3 word address field with custom placeholder text.
An example of autosuggest results optionally filtered by country.
A validated 3 word address.
Dashboard to configure 3 word address plugin settings.
== Changelog ==
= 1.1.0 =
= 1.0.1 =
= 1.0.0 =