Geocoding support for shop module. Get coordinates for addresses, and convert visitor IP to location.
PHP
Latest commit f4d50fd Jun 12, 2016 @wilr wilr Update test path
Permalink
Failed to load latest commit information.
_config
code Add LICENSE Jun 12, 2016
tests Update test path Jun 12, 2016
.editorconfig Added standard .editorconfig file Dec 31, 2015
.gitattributes
.scrutinizer.yml
.travis.yml
LICENSE Add LICENSE Jun 12, 2016
README.md Update naming Mar 4, 2016
composer.json Update naming Mar 4, 2016

README.md

SilverShop Geocoding

Adds geocoding support to SilverShop. Work out address coordinates, based on entered address.

Makes use of the geocoder-php/Geocoder library.

Installation

composer reqire silvershop/geocoding

Configuration

A default configuration is provided, but you can define your own.

In _config.php:

$geocoder = new \Geocoder\Geocoder();
$adapter  = new \Geocoder\HttpAdapter\CurlHttpAdapter();
$geocoder->registerProvider(
    new \Geocoder\Provider\ChainProvider(array(
        new \Geocoder\Provider\HostIpProvider($adapter),
        new \Geocoder\Provider\GoogleMapsProvider($adapter)
    ))
);
AddressGeocoding::set_geocoder($geocoder);

To test ips locally, you can configure a 'test ip' in your config:

Address:
  test_ip: 202.160.48.114

Add relocateuser=1 to a url to rerun the geocoder.

Disable address coordinates geocoding

By default an address's latitude and longitude is automatically retrieved on save if it has not already been worked out. This behavior can be disabled like this:

Address:
  enable_geocoding: false

Disable automatic visitor ip geocoding

By default this module geocodes the ip of every visitor. This behaviour can be disabled like this:

Page:
  geocode_visitor_ip: false

Warning

Relying on 3rd-party geocoding services can potentially slow down your website, especially if the external service comes under heavy load. You may want to consider setting up your own geocoding server instance.

Map fall back

If an address can't be geocoded, then provide a fallback checkout step for designating the coordinates with a google map field.

Be sure to add the checkout step to yaml config. After billing address will probably work best:

CheckoutPage:
  steps:
    'membership' : 'CheckoutStep_Membership'
    'contactdetails' : 'CheckoutStep_ContactDetails'
    'shippingaddress' : 'CheckoutStep_Address'
    'billingaddress' : 'CheckoutStep_Address'
    'addresslocation' : 'CheckoutStep_AddressLocationFallback' #here
    'shippingmethod' : 'CheckoutStep_ShippingMethod'
    'paymentmethod' : 'CheckoutStep_PaymentMethod'
    'summary' : 'CheckoutStep_Summary'