Maps 1.6.0 Is Now Available for Geeklog

A new version of the Maps plugin for Geeklog is now available.

Maps 1.6.0 is a major modernization release that brings the plugin up to date with current Geeklog versions, modern PHP environments, and the Google Maps Platform, while preserving compatibility with older installations.

The new version is available from the official Geeklog Plugins repository:

https://github.com/Geeklog-Plugins/maps

A major modernization of the Maps plugin

Maps has been part of the Geeklog plugin ecosystem for many years. Version 1.6.0 represents a significant update of its codebase rather than a simple maintenance release.

The goal was to preserve the useful concepts of the original plugin while making it easier to install, maintain, integrate and evolve.

Maps 1.6.0 has been validated with:

• Geeklog 2.1.1 through 2.2.2
• PHP 5.6 through PHP 8.3
• MySQL and MariaDB versions supported by the corresponding Geeklog release

The release also introduces a compatibility layer designed to let the plugin work across these different Geeklog generations.

Modern Google Maps support

One of the most important parts of the work concerns the Google Maps integration itself.

Maps 1.6.0 modernizes the loading of the Google Maps Platform and updates marker rendering, clustering and geocoding.

The old marker presentation has also been replaced with a cleaner implementation. Marker clusters now use a more compact renderer, while generated map pins have been refined without removing the colors and labels configured by administrators.

Canonical marker pages once again include an individual map centered on the selected marker, together with driving directions using the modern Google Maps Directions API.

A much cleaner administration interface

The administration area received extensive attention during the modernization.

Maps, markers, icons, overlays and overlay groups now share a more consistent editing experience.

Administration pages have clearer titles, better action placement and responsive forms. The Maps dashboard has also been reorganized so the most important information appears in a more logical order.

Marker lists now provide clearer status information, sorting and modification dates, while several old interface inconsistencies have been removed.

The objective is simple: administrators should spend their time managing geographic content rather than fighting an interface designed for a much older generation of browsers and themes.

A new guided CSV import assistant

Maps 1.6.0 also introduces a substantially improved CSV import workflow.

Administrators can now prepare large collections of markers using a guided assistant that provides:

• minimum and recommended field presets
• configurable field mapping
• tabular preview before import
• validation of imported data
• batch summaries
• confirmation before insertion
• automatic geocoding when coordinates are not supplied
• permission handling consistent with the plugin configuration

This should make Maps much more practical for directories, local databases, activity maps and other projects involving many locations.

Better public pages and SEO

Public map pages have also been redesigned.

The old database-style presentation has been replaced with cleaner editorial cards for map listings, marker information and metadata.

Maps 1.6.0 adds several SEO improvements as well:

• canonical URLs
• 301 redirects for legacy marker URLs
• improved meta descriptions
• Open Graph metadata
• Twitter metadata
• Schema.org Place and GeoCoordinates
• marker entries in the sitemap
• dedicated SEO settings for the /maps/ section

These improvements allow geographic content managed by Geeklog to become much easier for search engines and external services to understand.

Maps becomes more interoperable with other Geeklog plugins

Another important direction in Maps 1.6.0 is interoperability.

Maps and markers can now expose canonical Item Info and ID-to-URL information to other Geeklog components.

A marker service API is also available for trusted inter-plugin consumers.

Maps now emits generic PLG_itemSaved and PLG_itemDeleted lifecycle notifications. This opens interesting possibilities for integration with plugins such as IndexNow, Hub, Hello, Documents, Store and future Geeklog extensions.

This is an important step toward a Geeklog ecosystem where plugins do not simply coexist but can exchange useful information and react to content changes.

Security and compatibility improvements

A large amount of less visible work has also gone into the release.

Administration mutations have been hardened, CSRF protections improved, uploads reviewed and CSV processing made safer.

The modernization also addresses numerous compatibility problems accumulated over the years, including issues related to modern PHP versions, SQL behavior, redirects and Geeklog's current document rendering APIs.

Several historical issues in the Maps repository can therefore now be considered resolved by the 1.6.0 codebase.

Existing installations can be upgraded

Maps 1.6.0 retains the sequential upgrade migrations developed during the 1.5.x modernization work.

Existing installations therefore do not need to start again from scratch.

As always, administrators should back up their database and shared Maps image resources before upgrading, copy the new files and then use Geeklog's normal plugin upgrade process.

Download and testing

Maps 1.6.0 is now available from the official Geeklog Plugins repository:

https://github.com/Geeklog-Plugins/maps

The repository also contains the installable archive:

dist/maps_1.6.0_2.1.1.zip

Testing, feedback and contributions are welcome.

In particular, feedback from existing Maps users will be valuable as work continues on future improvements, including marker filtering, categories, additional language support and deeper interoperability with other Geeklog plugins.

Maps 1.6.0 brings an old and useful Geeklog plugin onto a much more modern foundation. More importantly, it gives us a solid base on which to continue building.