# SilverStripe Mapbox Field Extends: - Symbiote\Addressable\Geocodable Replaces: - dynamic/silverstripe-elemental-customer-service - bigfork/silverstripe-mapboxfield Adds a Mapbox map to the CMS with a draggable marker to allow content authors to add a location to a DataObject or Page. Address will be geocoded automatically or manually using mapbox map. Adds DataObject Extension to store and render GeoJSON data. ## Installation `composer require a2nt/silverstripe-mapboxfield:*` ## Configuration ```yaml --- Name: 'app-map' After: - 'silverstripe-mapboxfield' - 'addressable' --- SilverStripe\Core\Injector\Injector: A2nt\SilverStripeMapboxField\MarkerExtension: properties: geocoder: %$Symbiote\Addressable\MapboxGeocodeService Symbiote\Addressable\GeocodeServiceInterface: class: Symbiote\Addressable\MapboxGeocodeService Symbiote\Addressable\MapboxGeocodeService: mapbox_api_key: 'your mapbox access token' A2nt\SilverStripeMapboxField\MapboxField: map_style: 'mapbox://styles/mapbox/light-v10' ``` ## Usage ```php class MyDataObjectMapPin extends DataObject { private static $extensions = [ Addressable::class, MarkerExtension::class, ]; } ``` ## Example ```php class MyPage extends \Page { private static $db = [ 'MapZoom' => 'Int', ]; public function MapPins() { return MyDataObjectMapPin::get(); } public function getGeoJSON() { $pins = []; foreach ($this->MapPins() as $pin) { $pins[] = $pin->getGeo(); } return json_encode([ 'type' => 'MarkerCollection', 'features' => $pins ]); } } ``` create MyDataObjectMapPin.ss template to render popup content MyPage.ss ```html