jQuery Configuration
Configuration Options
When the Autoaddress jQuery plugin is initialised, you must pass in your license key. This is the only mandatory setting to pass into the control, for the rest of settings have default values set.
Basic Initialisation
<script type="text/javascript"> $(function(){ $("#myDiv").AutoAddress({ key : "YOUR_KEY", vanityMode : true, addressProfile : "Demo5LineV2" }); }); </script>
General Properties
Option | Description | Type | Default |
---|---|---|---|
key* | Unique Key Per Customer IMPORTANT: The key parameter name must be all lower case. |
string | None |
language | Language for the plugin. Allowed values are "en" for English and "ga" for Irish. |
string | "en" |
country | Change the country search for the plugin. Allowed values are "ie" for Ireland, "ni" for Northern Ireland and "gb" for Great Britain. |
string | "ie" |
autocomplete | Toggle for enabling AutoComplete feature on the plugin | boolean | true |
autocompleteMinChars | Number of characters that are typed before AutoComplete feature starts. | int | 3 |
optionsLimit | An upper limit on the number of options that may be returned. The default value is -1. Having the limit set to -1 allows for intelligent grouping when many address options are returned. | int | None |
geographicAddress | Turns on or off Geographic Address in results. | boolean | false |
vanityMode | Turns on or off Vanity mode, which displays non-Postal compliant user preferred addresses as part of the response data (See Find Address API for more details). | boolean | false |
addressElements | Turns on or off address elements (See Find Address API for more details). | boolean | false |
addressProfile | Name of address profile that determines how addresses are returned (See Find Address API for more details). | string | None |
width | Width of the Autoaddress plugin. By default this is set to "Auto" which means it will fit in whichever container it is placed in automatically and set it`s width to 100% of that container. If you wish to change the width of the plugin, simply add the width in px. I.e "200" or "300" | string | "Auto" |
displayBusinessListings | Turn on or off the Business Listings tab for responses which return mixed residential and commercial results. When turned off only residential options will be returned. | boolean | "true" |
defaultSearch | Turn on or off the default search behavior. | boolean | "false" |
* Required Field
Message Properties
Below you will see how you can also configure all the messages displayed as part of the Autoaddress jQuery Plugin. The following code snippet for example changes to text on the search button.$("#myDiv").AutoAddress({ key : "YOUR_KEY", vanityMode : true, addressProfile : "Demo5LineV2", searchButtonLabel : "Go" });
Option | Description | Type | Default |
---|---|---|---|
placeHolderLabel | Hint to describe to expected input into the search field. Displayed before user starts typing. | string | "Enter Full Address or Postcode" |
searchButtonLabel | Value of the text on Search Button. | string | "Search" |
optionsFoundLabel | Text displayed to indicate to select one of the options returned. Only displayed when options are available. | string | "Please select an option below" |
incompleteAddressLabel | Info message displayed when the search result was an Incomplete Address. | string | "Too little information, please enter more details." |
partialAddressLabel | Info message displayed when the search result was an Partially Matched Address. | string | "Couldn't find [unmatched] try again or enter address manually below." |
nuaAddressFoundLabel | Info message displayed when the search result was an Non Unique Address (NUA). Other addresses share this address and require the user to add an Eircode to make the address unique. | string | "We’ve found the address, please add your Postcode in the text box below if you know it" |
noResultFoundLabel | Info Message displayed when no result could be found for the search. | string | "No search results have been found." |
addressFoundLabel | Success message when a full address or Eircode has been found. | string | "Postcode Found, address populated below" |
noEircodeAppendedLabel | Success message when a full address has been found but no Eircode available for that address. | string | "Address found, but no Postcode Available" |
inputRequiredLabel | Info message displayed when no input has been entered by the user. | string | "Enter a full address or Postcode to begin your search." |
errorMessageLabel | Info message displayed when an Error has occurred. | string | "Sorry, an unexpected error has occurred." |
addressTabLabel | Tab Label | string | "Address" |
businessTabLabel | Tab Label | string | "Business" |