README.md

# MokoSuiteStoreLocator

A Joomla 4/5 package providing a store locator listing component with coordinating map and search modules.

## Package Contents

| Extension | Type | Element |
|---|---|---|
| Store Locator Component | component | `com_mokosuitestorelocator` |
| Store Locator Map | module (site) | `mod_mokosuitestorelocator_map` |
| Store Locator Search | module (site) | `mod_mokosuitestorelocator_search` |

## Requirements

- Joomla 5.x or 6.x
- PHP 8.2+
- MySQL 8.0+ / MariaDB 10.4+

## Installation

1. Download the latest `pkg_mokosuitestorelocator-x.x.x.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteStoreLocator/releases)
2. In Joomla Administrator, go to **System > Install > Extensions**
3. Upload the package ZIP — all extensions install automatically

## Features

### Implemented
- **Admin CRUD** — full location management with tabbed edit form (details, address, coordinates, contact, image)
- **Admin list** — searchable, filterable, sortable locations list with bulk publish/unpublish/delete
- **Site frontend** — locations list and detail views with pagination
- **Schema.org** — LocalBusiness structured data markup on all frontend templates
- **SEF URLs** — router with menu, standard, and nomenu rules
- **Menu items** — "All Locations" list and single "Location Detail" picker
- **Interactive map** — Leaflet.js with OpenStreetMap tiles, markers with popups, auto-fit bounds
- **Location search** — city dropdown, radius filter, and browser geolocation ("Use My Location")
- **Proximity search** — Haversine distance filtering with distance-sorted results
- **Get Directions** — Google Maps directions link on detail page and map popups
- **Auto-geocoding** — coordinates auto-populated from address on save (Nominatim/OSM)
- **CSV import** — bulk-create locations from spreadsheet with auto-detected column mapping

### Planned
- Marker clustering for dense location areas
- Multi-category support with custom map markers
- ACL permissions and SQL upgrade schema
- REST API via Joomla Web Services plugin
- MokoSuiteShop integration for multi-store ecommerce

## Development

```bash
composer install  # Install PHP dev dependencies
```

Source code lives in `source/packages/` — one directory per sub-extension.

## License

GPL-3.0-or-later — Moko Consulting
docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00			`# MokoSuiteStoreLocator`
feat(package): initial scaffold for MokoJoomStoreLocator 2026-05-21 11:44:21 -05:00
			`A Joomla 4/5 package providing a store locator listing component with coordinating map and search modules.`

			`## Package Contents`

docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00			`\| Extension \| Type \| Element \|`
			`\|---\|---\|---\|`
			\| Store Locator Component \| component \| `com_mokosuitestorelocator` \|
			\| Store Locator Map \| module (site) \| `mod_mokosuitestorelocator_map` \|
			\| Store Locator Search \| module (site) \| `mod_mokosuitestorelocator_search` \|
feat(package): initial scaffold for MokoJoomStoreLocator 2026-05-21 11:44:21 -05:00
			`## Requirements`

fix: code review fixes, Joomla 5/6 compat, XSS prevention 2026-06-23 11:08:46 -05:00			`- Joomla 5.x or 6.x`
			`- PHP 8.2+`
			`- MySQL 8.0+ / MariaDB 10.4+`
feat(package): initial scaffold for MokoJoomStoreLocator 2026-05-21 11:44:21 -05:00
			`## Installation`

docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00			1. Download the latest `pkg_mokosuitestorelocator-x.x.x.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteStoreLocator/releases)
feat(package): initial scaffold for MokoJoomStoreLocator 2026-05-21 11:44:21 -05:00			`2. In Joomla Administrator, go to System > Install > Extensions`
			`3. Upload the package ZIP — all extensions install automatically`

			`## Features`

docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00			`### Implemented`
			`- Admin CRUD — full location management with tabbed edit form (details, address, coordinates, contact, image)`
			`- Admin list — searchable, filterable, sortable locations list with bulk publish/unpublish/delete`
			`- Site frontend — locations list and detail views with pagination`
			`- Schema.org — LocalBusiness structured data markup on all frontend templates`
			`- SEF URLs — router with menu, standard, and nomenu rules`
			`- Menu items — "All Locations" list and single "Location Detail" picker`
chore: fix script.php location, update README and changelog for release 2026-06-23 11:02:19 -05:00			`- Interactive map — Leaflet.js with OpenStreetMap tiles, markers with popups, auto-fit bounds`
			`- Location search — city dropdown, radius filter, and browser geolocation ("Use My Location")`
feat: v1.1 competitive parity — proximity search, directions, geocoding, CSV import 2026-06-23 11:50:02 -05:00			`- Proximity search — Haversine distance filtering with distance-sorted results`
			`- Get Directions — Google Maps directions link on detail page and map popups`
			`- Auto-geocoding — coordinates auto-populated from address on save (Nominatim/OSM)`
			`- CSV import — bulk-create locations from spreadsheet with auto-detected column mapping`
docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00
			`### Planned`
chore: fix script.php location, update README and changelog for release 2026-06-23 11:02:19 -05:00			`- Marker clustering for dense location areas`
docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00			`- Multi-category support with custom map markers`
chore: fix script.php location, update README and changelog for release 2026-06-23 11:02:19 -05:00			`- ACL permissions and SQL upgrade schema`
docs: update README with MokoSuite naming and current feature status 2026-06-23 10:34:00 -05:00			`- REST API via Joomla Web Services plugin`
			`- MokoSuiteShop integration for multi-store ecommerce`

			`## Development`

			```bash
			`composer install # Install PHP dev dependencies`
			```

			Source code lives in `source/packages/` — one directory per sub-extension.
feat(package): initial scaffold for MokoJoomStoreLocator 2026-05-21 11:44:21 -05:00
			`## License`

			`GPL-3.0-or-later — Moko Consulting`