feat: complete store locator implementation (Phases 1-3) #53

Merged

jmiller merged 6 commits from fix/rename-src-to-source-v2 into main 2026-06-23 16:10:29 +00:00

Conversation 0 Commits 6 Files Changed 47

+2638 -182

jmiller commented 2026-06-23 15:58:08 +00:00

Owner

Copy Link

Copy Source

Summary

Completes the core store locator implementation across three phases, taking the extension from scaffolding stubs to a fully functional Joomla 4/5 store locator package.

Phase 1: Admin CRUD (c415d48)

• LocationController (FormController) for save/cancel/apply
• LocationsController (AdminController) for bulk publish/unpublish/delete
• Location edit view with tabbed form (Details, Address, Contact)
• Admin list renders data rows with edit links and published toggle
• LocationTable::check() — title validation, auto-alias, lat/lng range, timestamps
• LocationsModel::populateState() with search/published filters and ordering
• filter_locations.xml with search tools bar
• Closes #32, Filter XML forms for admin list sidebar (#33)

Phase 2: Site Frontend (4b37489)

• Site DisplayController, LocationsModel (search/city/state filters), LocationModel
• Locations list and detail templates with Schema.org LocalBusiness markup
• SEF URL Router with menu/standard/nomenu rules
• Menu item types: "All Locations" list and "Location Detail" picker
• Site language strings
• Addresses #50

Phase 3: Map & Search Modules (4894a70)

• Map dispatcher loads published locations with coordinates from DB
• Leaflet.js + OpenStreetMap tiles with markers, popups, auto-fit bounds
• Leaflet CSS/JS via Joomla Web Asset Manager
• Search dispatcher loads distinct cities/states for dropdown filters
• City dropdown, radius dropdown, geolocation "Use My Location" button
• Hidden lat/lng fields for proximity search passthrough
• Addresses #51, #3, #35

Also includes

• source/ directory rename from src/ (6d7838a)
• MokoSuite naming update in README
• Makefile removed (no longer used)
• .gitignore fix for source/packages/*/site/

What's NOT in this PR (Phase 4+)

• Proximity/Haversine distance filtering (lat/lng passed but not filtered)
• Marker clustering (Leaflet.markercluster)
• ACL permissions (#30), SQL update schema (#31), XSS audit (#34)
• Multi-category (#1), custom markers (#2), REST API (#29), Shop integration (#48)

Test Plan

• Package installs cleanly on Joomla 4.4+ / 5.x
• Admin: create, edit, publish, unpublish, delete locations
• Admin: search/filter/sort in locations list
• Site: locations list view renders with pagination
• Site: location detail view shows full info with Schema.org markup
• Site: SEF URLs work via menu items
• Map module: Leaflet map renders with markers and popups
• Search module: city dropdown populated, radius options display
• Search module: geolocation button sets lat/lng fields
• Search form submits to component locations view with filters

## Summary Completes the core store locator implementation across three phases, taking the extension from scaffolding stubs to a fully functional Joomla 4/5 store locator package. ### Phase 1: Admin CRUD (`c415d48`) - `LocationController` (FormController) for save/cancel/apply - `LocationsController` (AdminController) for bulk publish/unpublish/delete - Location edit view with tabbed form (Details, Address, Contact) - Admin list renders data rows with edit links and published toggle - `LocationTable::check()` — title validation, auto-alias, lat/lng range, timestamps - `LocationsModel::populateState()` with search/published filters and ordering - `filter_locations.xml` with search tools bar - Closes #32, #33 ### Phase 2: Site Frontend (`4b37489`) - Site DisplayController, LocationsModel (search/city/state filters), LocationModel - Locations list and detail templates with Schema.org `LocalBusiness` markup - SEF URL Router with menu/standard/nomenu rules - Menu item types: "All Locations" list and "Location Detail" picker - Site language strings - Addresses #50 ### Phase 3: Map & Search Modules (`4894a70`) - Map dispatcher loads published locations with coordinates from DB - Leaflet.js + OpenStreetMap tiles with markers, popups, auto-fit bounds - Leaflet CSS/JS via Joomla Web Asset Manager - Search dispatcher loads distinct cities/states for dropdown filters - City dropdown, radius dropdown, geolocation "Use My Location" button - Hidden lat/lng fields for proximity search passthrough - Addresses #51, #3, #35 ### Also includes - `source/` directory rename from `src/` (`6d7838a`) - MokoSuite naming update in README - Makefile removed (no longer used) - `.gitignore` fix for `source/packages/*/site/` ## What's NOT in this PR (Phase 4+) - Proximity/Haversine distance filtering (lat/lng passed but not filtered) - Marker clustering (Leaflet.markercluster) - ACL permissions (#30), SQL update schema (#31), XSS audit (#34) - Multi-category (#1), custom markers (#2), REST API (#29), Shop integration (#48) ## Test Plan - [ ] Package installs cleanly on Joomla 4.4+ / 5.x - [ ] Admin: create, edit, publish, unpublish, delete locations - [ ] Admin: search/filter/sort in locations list - [ ] Site: locations list view renders with pagination - [ ] Site: location detail view shows full info with Schema.org markup - [ ] Site: SEF URLs work via menu items - [ ] Map module: Leaflet map renders with markers and popups - [ ] Search module: city dropdown populated, radius options display - [ ] Search module: geolocation button sets lat/lng fields - [ ] Search form submits to component locations view with filters

jmiller added 4 commits 2026-06-23 15:58:09 +00:00

feat: complete admin CRUD for locations (Phase 1) ... c415d4813f

Add full admin editing capability for store locations:
- LocationController (FormController) for save/cancel/apply
- LocationsController (AdminController) for bulk publish/unpublish/delete
- Location edit view with tabbed form (Details, Address, Contact)
- Admin list renders data rows with edit links and published toggle
- LocationTable::check() validates title, auto-alias, lat/lng, timestamps
- LocationsModel with populateState(), search/published filters, ordering
- filter_locations.xml with search tools bar
- Language strings for filters, sort options, save messages

Also includes MokoSuite-renamed package scaffolding (source/packages/).
Removes unused Makefile.

Closes #32 — populateState for filter persistence
Closes #33 — filter XML forms for admin list

Authored-by: Moko Consulting

feat: add site frontend with locations list, detail view, and SEF router (Phase 2) ... 4b37489c41

Build the complete public-facing frontend for the store locator:
- Site DisplayController routing to list and detail views
- LocationsModel with search, city, and state filters (published only)
- LocationModel for single location by ID
- Locations list template with Schema.org LocalBusiness markup
- Location detail template with address, contact, hours, map placeholder
- SEF URL router with menu/standard/nomenu rules
- Menu item types: "All Locations" list and "Location Detail" picker
- Site language strings for views and menu items
- Router wired into component extension class and service provider
- .gitignore exception for source/packages/*/site/

Addresses #50

Authored-by: Moko Consulting

docs: update README with MokoSuite naming and current feature status ... 07a4fcc0b5

Rename from MokoJoomStoreLocator to MokoSuiteStoreLocator, update
package element names, add implemented vs planned feature sections,
add development instructions.

Authored-by: Moko Consulting

feat: wire up map and search modules with Leaflet and geolocation (Phase 3) ... 4894a703c2

Map module:
- Dispatcher queries published locations with coordinates from DB
- Leaflet.js + OpenStreetMap tile layer integration
- Markers with popup info (name, address, phone)
- Auto-fit bounds to show all markers
- Leaflet CSS/JS via Joomla Web Asset Manager

Search module:
- Dispatcher loads distinct cities/states for dropdown filters
- Builds radius options from module params
- City dropdown filter (toggled by show_city_filter param)
- Radius dropdown with configurable values and unit (miles/km)
- Geolocation "Use My Location" button via browser API
- Hidden lat/lng fields for proximity search passthrough
- New language strings for all search UI elements

Both dispatchers now implement DatabaseAwareInterface for DB access.

Addresses #51, #3, #35

Authored-by: Moko Consulting

jmiller added 1 commit 2026-06-23 16:02:34 +00:00

chore: fix script.php location, update README and changelog for release ... f73e536d05

- Move script.php to source/ (alongside package manifest) with MokoSuite naming
- Update README: map and search now listed as implemented, not planned
- Set changelog version to 1.0.0

Authored-by: Moko Consulting

jmiller added 1 commit 2026-06-23 16:08:52 +00:00

fix: code review fixes, Joomla 5/6 compat, XSS prevention ... e26d0ed400

Security:
- Fix stored XSS in Leaflet popup — HTML-escape loc.title/address/phone
- Use HTMLHelper::_('content.prepare') for description output

Joomla 5/6 compatibility:
- Bump PHP minimum to 8.2, Joomla minimum to 5.0.0
- script.php implements InstallerScriptInterface with typed signatures
- Restore updateservers and dlid in package manifest
- Update all manifest creationDates to 2026-06-23

Code quality:
- Replace hard-coded English errors with Text::_() language strings
- Add COM_MOKOJOOMSTORELOCATOR_ERROR_* language keys
- Use Text::_() for Locations list toolbar title
- Import missing Text class in LocationTable and Locations HtmlView

Documentation:
- Update CLAUDE.md: MokoSuite naming, source/ paths, PHP 8.2, namespace
- Update README: Joomla 5/6, PHP 8.2+, MySQL 8.0+

Authored-by: Moko Consulting

jmiller merged commit d3e73a0ea4 into main 2026-06-23 16:10:29 +00:00

jmiller deleted branch fix/rename-src-to-source-v2 2026-06-23 16:10:30 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

area/admin

Administrator interface

area/component

Core component (com_mokojoomstorelocator)

area/database

Database schema or queries

area/frontend

Site/frontend display

area/import-export

Data import/export features

area/module-map

Map module (mod_mokojoomstorelocator_map)

area/module-search

Search module (mod_mokojoomstorelocator_search)

priority/critical

Must have for v1.0

priority/high

Important for initial release

priority/low

Future enhancement

priority/medium

Nice to have for v1.0

type/bug

Something is broken

type/docs

Documentation

type/enhancement

Improvement to existing feature

type/feature

New feature or functionality

No labels

Priority -

Type -

Milestone

No items

No Milestone

Assignees

Clear assignees

jmiller (Jonathan Miller)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteStoreLocator#53