symbiote/silverstripe-addressable

SilverStripe addressable and geocoding module

5.1.0 2022-10-11 23:36 UTC

Requires

• guzzlehttp/guzzle: ^5.3.1|^6.2.1|^7
• silverstripe/framework: ^4.10.0

Requires (Dev)

• phpunit/phpunit: ^9.5
• squizlabs/php_codesniffer: ^3.0

Replaces

• ajshort/silverstripe-addressable: 5.1.0
• silverstripe-australia/addressable: 5.1.0

BSD-3-Clause

• Symbiote
• Marcus Nyeholt

• geocoding
• silverstripe
• addressable
• symbiote

README

Adds address fields to a DataObject and also has support for automatic geocoding of the provided address.

Composer Install

composer require symbiote/silverstripe-addressable:~4.0

Requirements

• SilverStripe 4.0+

Documentation

• Quick Start
• Advanced Usage
• License
• Contributing

Changes from SilverStripe 3.X

• GoogleGeocoding changed class name to Symbiote\Addressable\GeocodeService
  • The static method address_to_point was changed to a non-static method called addressToPoint. This allows you to use the Injector and replace GeocodeService with something else if you need to.
• Addressable::set_allowed_states(array('' => '', 'NSW' => "New South Wales")); has been deprecated in favour of config values.
• Addressable::set_allowed_countries(array('' => '', 'AU' => "Australia")); has been deprecated in favour of config values.
• Addressable::set_postcode_regex(...); has been deprecated in favour of config values.
  • Addressable::set_postcode_regex config value has been deprecated in favour of Addressable::postcode_regex
    • NOTE: Previously there was a hack in Addressable that read Addressable::set_postcode_regex config value, then called Addressable::set_postcode_regex() to update the protected static postcode_regex; value in the Addressable __construct() method.

Credits

• Mark Taylor for adding the ability to easily embed a map with AddressMap
• Nic for writing tests for this module
• AJ Short for initially writing this module