feat: Leaflet marker clustering (markercluster plugin) #61

New Issue

2026-06-28T15:36:37Z

jmiller commented

2026-06-28 15:36:37 +00:00

Summary

When many locations are displayed on the map, markers overlap and become unusable. Implement Leaflet.markercluster to group nearby markers at lower zoom levels.

Requirements

Include leaflet.markercluster.js and CSS assets
Cluster markers by proximity at each zoom level
Show cluster count badge
Expand cluster on click to reveal individual markers
Optional: color-code clusters by category

Reference

Leaflet.markercluster: https://github.com/Leaflet/Leaflet.markercluster
Competitive analysis (#54): all competitors support clustering

Priority

P3 — enhancement for maps with 50+ locations.

## Summary When many locations are displayed on the map, markers overlap and become unusable. Implement Leaflet.markercluster to group nearby markers at lower zoom levels. ## Requirements - Include `leaflet.markercluster.js` and CSS assets - Cluster markers by proximity at each zoom level - Show cluster count badge - Expand cluster on click to reveal individual markers - Optional: color-code clusters by category ## Reference - Leaflet.markercluster: https://github.com/Leaflet/Leaflet.markercluster - Competitive analysis (#54): all competitors support clustering ## Priority P3 — enhancement for maps with 50+ locations.

jmiller commented

2026-06-28 15:36:41 +00:00

Branch created: feature/61-feat-leaflet-marker-clustering-markerclu

git fetch origin
git checkout feature/61-feat-leaflet-marker-clustering-markerclu

Branch created: [`feature/61-feat-leaflet-marker-clustering-markerclu`](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteStoreLocator/src/branch/feature/61-feat-leaflet-marker-clustering-markerclu) ```bash git fetch origin git checkout feature/61-feat-leaflet-marker-clustering-markerclu ```

jmiller commented

2026-06-28 15:51:36 +00:00

Implemented:

Leaflet.markercluster 1.5.3 loaded from CDN (CSS + JS) via WebAssetManager
Markers added to L.markerClusterGroup() instead of directly to map
Graceful fallback: if markercluster JS fails to load, markers render individually via L.layerGroup()
New module parameter enable_clustering (default: Yes) to toggle clustering
Language string MOD_MOKOJOOMSTORELOCATOR_MAP_CLUSTERING added

Implemented: - Leaflet.markercluster 1.5.3 loaded from CDN (CSS + JS) via WebAssetManager - Markers added to `L.markerClusterGroup()` instead of directly to map - Graceful fallback: if markercluster JS fails to load, markers render individually via `L.layerGroup()` - New module parameter `enable_clustering` (default: Yes) to toggle clustering - Language string `MOD_MOKOJOOMSTORELOCATOR_MAP_CLUSTERING` added

jmiller closed this issue

2026-06-28 15:52:07 +00:00

jmiller referenced this issue from a commit

2026-06-28 16:22:52 +00:00

fix: resolve all open issues — detail map, clustering, CSP, GROUP BY, cleanup (#34 #57 #58 #59 #60 #61)

jmiller referenced this issue

2026-06-28 18:49:29 +00:00

v1.2.0 — Categories, API, hardening, polish #62

Sign in to join this conversation.