README

Display a map, directions, and contact info for your location.

Requirements

• SilverStripe ^6.0
• PHP ^8.3
• dnadesign/silverstripe-elemental: ^6.0
• dynamic/silverstripe-geocoder: ^4.0

Installation

composer require dynamic/silverstripe-elemental-customer-service

Usage

Adds a Customer Service block to display a map, directions and contact info for your location. Userful for a Contact Us page.

Note

In order to use the Geocoder and address map, you will need to set two Google API keys. Each key needs to have specific API libraries enabled:

• geocoder_api_key
  • Geocoding API
• map_api_key
  • Maps JavaScript API
  • Maps Static API

They can be set in your YML file like this:

Dynamic\SilverStripeGeocoder\GoogleGeocoder:
  geocoder_api_key: 'your-key-here'
  map_api_key: 'your-key-here'

For more, see Silverstripe Geocoder

Screen Shots

Front End sample of a Customer Service Element

CMS - Customer Service Element Main Tab

CMS - Customer Service Element - Address Tab

Getting more elements

See Elemental modules by Dynamic

Configuration

See SilverStripe Elemental Configuration

Upgrading from version 3

SilverStripe Elemental Customer Service 4.0 is compatible with SilverStripe 6. Key changes:

• Updated to SilverStripe CMS 6
• Requires PHP 8.3 or higher
• Updated to Elemental 6 and Geocoder 4
• Namespace changes for DataExtension and validation classes
• No breaking changes to the API or templates

Maintainers

• Dynamic (dev@dynamicagency.com)

Bugtracker

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

• Create a new issue
• Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
• Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.