Skip to content
Magento V1 e-commerce plugin
PHP CSS JavaScript HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
js/what3words
lib/What3Words
skin
.gitignore
README.md
composer.json
modman

README.md

magento1-what3words

v.1.0 Updated 01/12/17

What3Words Magento1 Integration

Overview

The what3words Magento integration (developed by Gene Commerce http://gene.co.uk/) allows Magento merchants to add an option to their checkout that will let customers use a what3words address for shipping.

When enabled, the module adds a configurable and customisable what3words input field to both the billing and shipping address forms in the checkout. This lets customers save a what3words address to their address book to be easily reused in future orders.

The extension implements the official what3words jQuery plugin (https://github.com/what3words/jquery-plugin-w3w-autosuggest).

Configuration

Enable in the what3words section of the system config and add your API key,

To display on shipping labels, please update the following config setting:

Customers -> Customer Configuration -> Address Templates -> PDF to the following:

{{depend prefix}}{{var prefix}} {{/depend}}{{var firstname}} {{depend middlename}}{{var middlename}} {{/depend}}{{var lastname}}{{depend suffix}} {{var suffix}}{{/depend}}| {{depend company}}{{var company}}|{{/depend}} {{if street1}}{{var street1}} {{/if}} {{depend street2}}{{var street2}}|{{/depend}} {{depend street3}}{{var street3}}|{{/depend}} {{depend street4}}{{var street4}}|{{/depend}} {{if city}}{{var city}},|{{/if}} {{if region}}{{var region}}, {{/if}}{{if postcode}}{{var postcode}}{{/if}}| {{var country}}|{{if w3w}}{{var w3w}}, {{/if}}| {{depend telephone}}T: {{var telephone}}{{/depend}}| {{depend fax}}<br/>F: {{var fax}}{{/depend}}| {{depend vat_id}}<br/>VAT: {{var vat_id}}{{/depend}}|

Data flow

The system handles the 3 word address in the following steps:

  1. From the billing / shipping address save actions, an Observer (What3Words_What3Words_Model_Observer) saves the 3 word address to the sales_quote_w3w table.

See What3Words/What3Words/etc/config.xml for exact events being observed.

  1. If the customer selects the 'Save in Address Book' option, the 3 word address is also recorded in the customer_address_w3w table and as well as being saved to the customer address attribute 'w3w'.

  2. The same observer class watches the sales_order_place_after event and saves the 3 word address to sales_order_w3w, after retrieving this from the sales_quote_w3w table.

Modification with custom checkouts

The fields.js file appends the html scripts in

frontend/base/default/template/what3words/checkout

to the billing and shipping forms in the

initBillingField and initShippingField methods.

These can be adapted to work with whatever markup has been changed, by altering the jQuery selectors.

You can’t perform that action at this time.