From bbc8e5762c71acfbc8982ce13b59dc096b096112 Mon Sep 17 00:00:00 2001 From: Jason Irish Date: Tue, 18 Nov 2025 19:21:01 -0600 Subject: [PATCH 1/2] docs: Update README and composer.json for SilverStripe 6 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Update PHP requirement to ^8.3 (SS6 requirement) - Update all dependencies to SS6 compatible versions - Add GitHub Sponsors badge (replacing codecov) - Remove unstable version badge - Add comprehensive Features section (6 capabilities) - Add upgrade notes for v3→v4 - Add SilverStripe 6 upgrade guide reference --- README.md | 37 ++++++++++++++++++++++++++++--------- composer.json | 2 +- 2 files changed, 29 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 6a3d204..80c7236 100644 --- a/README.md +++ b/README.md @@ -3,27 +3,35 @@ SilverStripe wrapper for [Geocoder](https://github.com/geocoder-php/Geocoder) [![CI](https://github.com/dynamic/silverstripe-geocoder/actions/workflows/ci.yml/badge.svg)](https://github.com/dynamic/silverstripe-geocoder/actions/workflows/ci.yml) -[![codecov](https://codecov.io/gh/dynamic/silverstripe-geocoder/branch/master/graph/badge.svg)](https://codecov.io/gh/dynamic/silverstripe-geocoder) -[![Sponsor](https://img.shields.io/badge/Sponsor-Dynamic-brightgreen)](https://github.com/sponsors/dynamic) +[![GitHub Sponsors](https://img.shields.io/github/sponsors/dynamic?label=Sponsors&logo=GitHub%20Sponsors&style=flat&color=ea4aaa)](https://github.com/sponsors/dynamic) [![Latest Stable Version](https://poser.pugx.org/dynamic/silverstripe-geocoder/v/stable)](https://packagist.org/packages/dynamic/silverstripe-geocoder) [![Total Downloads](https://poser.pugx.org/dynamic/silverstripe-geocoder/downloads)](https://packagist.org/packages/dynamic/silverstripe-geocoder) -[![Latest Unstable Version](https://poser.pugx.org/dynamic/silverstripe-geocoder/v/unstable)](https://packagist.org/packages/dynamic/silverstripe-geocoder) [![License](https://poser.pugx.org/dynamic/silverstripe-geocoder/license)](https://packagist.org/packages/dynamic/silverstripe-geocoder) ## Requirements -- Silverstripe ^5 -- dynamic/silverstripe-country-dropdown-field ^2 -- geocoder-php/google-maps-provider ^4.7 -- guzzlehttp/guzzle ^7.4 -- php-http/guzzle7-adapter ^1.0 -- php-http/message ^1.13 +- PHP: ^8.3 +- SilverStripe: ^6 +- dynamic/silverstripe-country-dropdown-field: ^3 +- geocoder-php/google-maps-provider: ^4.7 +- guzzlehttp/guzzle: ^7.4 +- php-http/guzzle7-adapter: ^1.0 +- php-http/message: ^1.13 ## Installation `composer require dynamic/silverstripe-geocoder` +## Features + +- **Address Geocoding**: Automatically convert addresses to latitude/longitude coordinates using Google Maps Geocoding API +- **Address Data Extension**: Adds comprehensive address fields (Address, City, State, PostalCode, Country, Lat, Lng) to any DataObject +- **Distance Calculation**: Calculate and filter DataObjects by distance from a given address +- **Static Map Generation**: Generate static Google Maps images with custom styling and markers +- **Country Dropdown Integration**: Includes country selection field with international support +- **Flexible Configuration**: Disable geocoding per DataObject, customize map styles, and use custom marker icons + ## License See [License](license.md) @@ -121,6 +129,17 @@ public function updateAddressValue(&$address) { } ``` +## Upgrading from version 3 + +SilverStripe Geocoder v4.0 is compatible with SilverStripe 6. Key changes: + +- Updated to SilverStripe CMS 6 +- Requires PHP 8.3 or higher +- Updated `dynamic/silverstripe-country-dropdown-field` from ^2 to ^3 (SS6 compatible) +- Extension namespace changes (ORM → Core\Extension) + +See the [SilverStripe 6 Upgrade Guide](https://docs.silverstripe.org/en/6/) for more details. + ## Maintainers * [Dynamic](http://www.dynamicagency.com) () diff --git a/composer.json b/composer.json index 6ad45c6..ae57ddb 100644 --- a/composer.json +++ b/composer.json @@ -16,7 +16,7 @@ } ], "require": { - "php": "^8.1", + "php": "^8.3", "dynamic/silverstripe-country-dropdown-field": "^3", "geocoder-php/google-maps-provider": "^4.7", "guzzlehttp/guzzle": "^7.4", From 510e7bc60136b711205a636a5bf879ef346d0fb9 Mon Sep 17 00:00:00 2001 From: Jason Irish Date: Tue, 18 Nov 2025 19:54:09 -0600 Subject: [PATCH 2/2] docs: Address Copilot review feedback - Add silverstripe/recipe-core ^6 to requirements list - Clarify extension namespace change is internal only --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 80c7236..427cde6 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ SilverStripe wrapper for [Geocoder](https://github.com/geocoder-php/Geocoder) ## Requirements - PHP: ^8.3 -- SilverStripe: ^6 +- silverstripe/recipe-core: ^6 - dynamic/silverstripe-country-dropdown-field: ^3 - geocoder-php/google-maps-provider: ^4.7 - guzzlehttp/guzzle: ^7.4 @@ -136,9 +136,9 @@ SilverStripe Geocoder v4.0 is compatible with SilverStripe 6. Key changes: - Updated to SilverStripe CMS 6 - Requires PHP 8.3 or higher - Updated `dynamic/silverstripe-country-dropdown-field` from ^2 to ^3 (SS6 compatible) -- Extension namespace changes (ORM → Core\Extension) +- Internal extension namespace changes (ORM → Core\Extension); no changes required in user code -See the [SilverStripe 6 Upgrade Guide](https://docs.silverstripe.org/en/6/) for more details. +For details on the SilverStripe 6 upgrade, see the [SilverStripe 6 upgrade guide](https://docs.silverstripe.org/en/6/changelogs/6.0.0/). ## Maintainers * [Dynamic](http://www.dynamicagency.com) ()