Plugin Documentation by “MB Création” v1.0.4

---

“Google Address Autocomplete for Woocommerce”

---

Table of Contents

1. About
2. Installation
3. Usage during checkout
4. Notes for developpers (hooks)

---

A) About - top

Google Address Autocomplete for Woocommerce simplify the checkout process, helping the customer to enter his address with the Google Places suggest.

---

B) Installation - top

Google Address Autocomplete for Woocommerce requires WordPress 3.8+ (may work on older version but has not been tested) and WooCommerce 2.0 or 2.1.

Just like every plugin, just copy the woocommerce-google-address folder in your wp-content/plugins folder then activate it through WordPress dashboard.

If the installation went OK, the plugin is directly available on the checkout page of your site.

If you encounter issue with the Google Map Api (in your browser console) it could be a good idea to register your website on the google map website and register it to get an official API Key (totally free). Visit this website (https://developers.google.com/maps/documentation/javascript/get-api-key#key) to register your url and obtain a "browser key". Then add it to your website : WooCommerce general settings section > Google Adresse Autocomplete.

---

C) Usage during checkout - top

• The plugin regroups and hides the components of the address : address_1, address_2, city, state, postcode, country.
• It adds a new "Address field" based on Google Places API.
• The user begins to type his address, Google completes it
• The user select his address
• The hidden fields are shown, automaticly fielded with the Google's informations.
• NB : if the user chooses an address in a country which is not available in the WooCommerce settings, the fields are set to empty.
• Works for billing and shipping informations without conflict.
• Should works for every country (including non-latin alphabets and non-alphabetical langugages). The format of the postal address varies for a country to another. We tried to make our plugin respect the formatting for every country, but if the formatting for your country isn't right, please send us an email from the contact page with an exemple address and we will fix it.

---

D) Notes for developpers - top

a) Availables filters

Nine filters are availables for developpers to manipulate default behaviour of the plugin :

• woogoogad_billing_fields_to_group_filter : array of the billing form's element ids to group. Default : array('billing_address_1', 'billing_address_2', 'billing_city', 'billing_state', 'billing_postcode', 'billing_country')
• woogoogad_shipping_fields_to_group_filter : array of the shipping form's element ids to group. Default : array('shipping_address_1', 'shipping_address_2', 'shipping_city', 'shipping_state', 'shipping_postcode', 'shipping_country')
• woogoogad_use_css_filter : Whether to import or not the (light) default css. Default : true
• woogoogad_billing_address_not_found_label_filter : The text of the link "Addess not found ?" in billing form. Default : __('Address not found ?', 'woogoogad') (which means you can also use the po file included with the plugin to change this label)
• woogoogad_shipping_address_not_found_label_filter : The text of the link "Addess not found ?" in shipping form. Default : __('Address not found ?', 'woogoogad')
• woogoogad_billing_address_label_filter : The label for the added google autocomplete field (billing form). Default : __('Address ', 'woogoogad').'<abbr class="required" title="required">*</abbr>'
• woogoogad_shipping_address_label_filter : The label for the added google autocomplete field (shipping form). Default : __('Address ', 'woogoogad').'<abbr class="required" title="required">*</abbr>'
• woogoogad_billing_row_classes_filter : The classes applied to the paragraph around the added google autocomplete field (billing form). Default : array('form-row-wide', 'address-field')
• woogoogad_shipping_row_classes_filter : The classes applied to the paragraph around the added google autocomplete field (shipping form). Default : array('form-row-wide', 'address-field')
• woogoogad_billing_fields_to_put_after_address_filter : The ids of the form rows to add after the billing address box. Default : array().
• woogoogad_shipping_fields_to_put_after_address_filter : The ids of the form rows to add after the shipping address box. Default : array().
• woogoogad_billing_row_placeholder : The placeholder to the Google address billing field. Default : __('Start typing your address...', 'woogoogad').
• woogoogad_shipping_row_placeholder : The placeholder to the Google address shipping field. Default : __('Start typing your address...', 'woogoogad').
• woogoogad_hide_address_fields_for_returning_customers_filter : Should the address fields be hidden in case of returning customers. Default : false.

b) Usage examples

Disable the inclusion of the default css

// functions.php of the theme folder

add_filter('woogoogad_use_css_filter', '__return_false');

Changing the order of the fields inside the grouped fields for billing address (putting country first)

// functions.php of the theme folder

function my_theme_woogoogad_billing_fields_to_group_filter($array)
{
	return array('billing_country', 'billing_address_1', 'billing_address_2', 'billing_city', 'billing_state', 'billing_postcode');
}
add_filter('woogoogad_billing_fields_to_group_filter', 'my_theme_woogoogad_billing_fields_to_group_filter');

Adding a custom (but already defined) shipping_address_3 to the grouped fields for shipping address

// functions.php of the theme folder

function my_theme_woogoogad_shipping_fields_to_group_filter($array)
{
	array('shipping_address_1', 'shipping_address_2' , 'shipping_address_3', 'shipping_city', 'shipping_state', 'shipping_postcode', 'shipping_country');
}
add_filter('woogoogad_shipping_fields_to_group_filter', 'my_theme_woogoogad_shipping_fields_to_group_filter');

Renaming the 'address not found ?' link in the billing form

// functions.php of the theme folder

function my_theme_woogoogad_billing_address_not_found_label_filter($label)
{
	return 'My new label';
}
add_filter('woogoogad_billing_address_not_found_label_filter', 'my_theme_woogoogad_billing_address_not_found_label_filter');

Putting name and email after the address in the billing form

// functions.php of the theme folder

function woogoogad_billing_fields_to_put_after_address($fields)
{
	$fields[] = 'billing_email_field';
	$fields[] = 'billing_phone_field';
	return $fields;
}
add_filter('woogoogad_billing_fields_to_put_after_address_filter', 'woogoogad_billing_fields_to_put_after_address');

Putting company name after the address in the shipping form

// functions.php of the theme folder

function woogoogad_shipping_fields_to_put_after_address($fields)
{
	$fields[] = 'shipping_company_field';
	return $fields;
}
add_filter('woogoogad_shipping_fields_to_put_after_address_filter', 'woogoogad_shipping_fields_to_put_after_address');

Hide address fields for returning customers

// functions.php of the theme folder

function woogoogad_hide_address_fields_for_returning_customers($val)
{
	return true;
}
add_filter('woogoogad_hide_address_fields_for_returning_customers_filter', 'woogoogad_hide_address_fields_for_returning_customers');

Virginie Garcin – MB Création

Go To Table of Contents

---