what3words Autosuggest Plugin free WordPress plugin
Description
what3words Autosuggest Plugin free WordPress plugin
This plugin allows you to easily add searching for, capturing, and validating a what3words address to a form on your WordPress powered site.
Returning suggestions based on full or partial 3 word addresses, the AutoSuggest feature helps users with the following types of input error:
– typing errors
– spelling errors
– misremembered words (e.g. singular vs. plural) or words in the wrong order
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.
Configuration
Enabling the plugin in a post or page
To enable the plugin on a post or page, simply add a text input field, contained inside a form, and add the field’s id to the plugin’s Input Selector(s) configuration option as described below.
what3words API settings
A what3words API key is required to use this plugin as it authenticates and interacts with the what3words API.
If you don’t have a what3words API key yet, you can quickly and easily sign-up and register for one.
General Settings
Input Selectors (WordPress only) – the input fields that the plugin is configured to search for 3 word addresses, specified as a list of css selectors. Multiple fields can be supplies using commas, e.g. “.class, #id”.
Input Placeholder Text – an optional placeholder to be displayed in the input fields that are configured in the Input Selector(s) option. We recommend providing an example what3words address here with “e.g.” to illustrate how a what3words address should be entered, for example, “e.g. index.home.raft”.
WooCommerce Support
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, the #shipping_w3w and #billing_w3w selectors will be automatically added to the list of Input Selector(s).
Filter Support And Usage
what3words AutoSuggest plugin supports a single filter to change the default set of installation settings and options at plugin activation time.
what3wordssearchbox_default_settings
Applied to the default set of plugin settings and options. Note that this filter is called once, upon plugin activation, when there are no what3words AutoSuggest plugin settings/options existing in the database.
Example: Add the date and time that the plugin was first activated
add_filter (‘what3wordssearchbox_default_settings’, ‘add_activation_timestamp’); function add_activation_timestamp ($options) { // options = array (option name => option value) $options[‘plugin_activation_timestamp’] = date (DATE_ATOM); return $options; }