feat: initial implementation with manifest fixes #36

Merged

jmiller merged 16 commits from dev/initial-implementation into main 2026-05-23 22:34:48 +00:00

Conversation 0 Commits 16 Files Changed 82

+5076 -190

jmiller commented 2026-05-23 22:33:05 +00:00

Owner

Copy Link

Copy Source

Full store locator suite with hardcoded manifest names.

Full store locator suite with hardcoded manifest names.

jmiller added 16 commits 2026-05-23 22:33:05 +00:00

feat(component): implement core logic for models, table, and templates ... d0b9a40157

- LocationTable: alias generation, lat/lng validation, timestamps
- Admin LocationsModel: filters for published, category, search, ordering
- Site LocationsModel: search, city/state filter, Haversine radius search
- Admin list template: render location rows with edit links
- Map module dispatcher: load locations with coordinates for markers
- Search module dispatcher: distinct cities/states, radius options
- Site template: website, hours, image display with Schema.org

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(component): complete core MVC, map rendering, and router ... f2afe8e9d9

Admin:
- LocationController (FormController for save/edit/cancel)
- LocationsController (AdminController for publish/delete/ordering)
- Location edit view with tabbed form and Leaflet coordinate picker
- Component extension implements RouterServiceInterface

Frontend:
- Single location detail view with Schema.org JSON-LD
- SEF URL router (locations list + location detail by alias)
- Location detail template with map, contact info, directions
- Locations list now links to detail pages with distance display

Map module:
- Full Leaflet.js rendering with OpenStreetMap tiles
- MarkerCluster plugin for dense marker areas
- DOM-based popup content (XSS-safe, no innerHTML)
- Google Maps provider with clustering support
- Auto-fit bounds to show all markers
- "Get Directions" link in popups

Package:
- Post-install script enables bundled modules automatically
- Fixed .gitignore to allow src/**/site/ paths

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(component): implement high-priority issues #8-#12 ... dd90c3ee91

Geocoding (#12):
- Geocoder helper with Nominatim (free default) and Google API
- Auto-geocode on save when address present but no coordinates
- Batch geocoding support for imports
- Component params for provider selection and API key

Geolocation (#9):
- "Use My Location" button with browser Geolocation API
- Permission handling (denied, unavailable, timeout states)
- Auto-selects first radius option on location detection
- Status messages with auto-dismiss

Import (#10):
- CSV import controller with column mapping
- Geocode option during import
- Update-existing option (match by title)
- Import view with file upload form
- CSV template download

Export (#11):
- CSV export controller with filter support
- UTF-8 BOM for Excel compatibility
- Export button on locations list toolbar

Get Directions (#8):
- Links in map popups and list/detail views
- Opens Google Maps directions with destination coords
- "Get Directions" button on location detail page

Sample Data:
- 8 Tennessee store locations with real coordinates
- Inject via admin toolbar button
- Duplicate prevention by alias check

Also: component config for geocoding, import submenu, toolbar
buttons for export/sample data.

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(i18n): add en-US language files for all extensions ... 10114d22d2

Copies of en-GB language files for US English locale support.

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(version): bump 00.00.00 → 00.00.01 [skip ci] 4b62455e92

chore(ci): update release workflows with package type support ... 89a21593e0

Synced from Template-Joomla: pre-release.yml and auto-release.yml now
handle Joomla package extensions (type="package" with sub-extensions).

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(component): implement multi-category, custom markers, and custom fields (#1, #2, #6) ... 45258bd7ad

Multi-category support (#1):
- Categories table with parent_id hierarchy, color, marker_icon
- Location-category junction table for many-to-many relationships
- Category CRUD: admin model, table, controller, view, form
- Categories list view with color swatch, parent, location count
- Category edit form with color picker and marker icon upload
- LocationCategoriesField: multi-select for assigning categories
- LocationModel saves/loads junction table on save/edit
- Categories submenu in admin

Custom map markers (#2):
- Category color field drives marker pin color (SVG data URI)
- Custom marker_icon media field overrides color-based marker
- Leaflet markers use createLeafletIcon() with category color/icon
- Map loads category data alongside locations (single extra query)
- Category legend below map with color swatches
- Marker preview on category edit form

Custom fields (#6):
- Component implements FieldsServiceInterface
- Two contexts: com_mokojoomstorelocator.location and .category
- getContexts(), validateSection(), getValidSections() implemented
- Joomla's com_fields can now define fields for locations and categories

Closes #1, #2, #6

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(component): implement all medium and low priority issues (#13-#25, #27) ... a7145dc108

Category filtering (#13):
- Category site view with model filtering by junction table
- Category page template with color swatch and description
- Router routes for /category/alias URLs

Responsive design (#14):
- Dedicated storelocator.css with mobile-first grid layout
- Click-to-call phone styling on mobile
- Responsive video embeds and image gallery

Business hours (#15):
- Hours display on detail page with openingHours Schema.org
- CSS for structured hours table

Menu item types (#16):
- Router supports locations, location, and category views
- Menu item params via router configuration

SEO optimization (#17):
- Meta title and description set from location data
- Schema.org JSON-LD with full LocalBusiness markup
- Canonical SEF URLs for all views via Router
- Category URLs for filtered views

Admin list enhancements (#18):
- Already implemented: filters, search, pagination, batch ops
- (Covered in earlier commits)

Location photos gallery (#19):
- images field (newline-separated paths) in location form
- CSS grid gallery on detail page with lazy loading

Store video display (#20):
- video_url field in location form
- VideoHelper parses YouTube/Vimeo URLs to embed URLs
- Responsive iframe embed with youtube-nocookie.com

Email/contact form (#21):
- Noted for future plugin implementation

Multi-language (#22):
- All strings in en-GB and en-US language files
- (Full i18n already in place)

Access control (#23):
- Component uses Joomla core ACL (inherits from MVCComponent)

Performance and caching (#24):
- Category data loaded in single query with junction join
- Map module uses efficient bulk category query
- Lazy loading on images and video iframes

Print-friendly view (#25):
- Print button on location detail
- Print CSS hides map, buttons, navigation
- Static map image from OpenStreetMap for print output

CSV import enhancements (#27):
- Noted for future enhancement

Also:
- Database: added images and video_url columns
- Location detail template: category tags, gallery, video, print, custom fields
- Category color swatches on tags and legend

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(component): implement final issues #21 and #27 ... c855b85ec4

Contact form per location (#21):
- ContactController with send() action
- Email sent to location's configured email via Joomla mailer
- Captcha integration via Joomla captcha plugins
- Form validation (name, email, message required)
- Contact form embedded on location detail page
- CSRF token protection

CSV import enhancements (#27):
- 3-step wizard: Upload → Map Columns → Preview → Import
- Auto-detect column names (name→title, zip→postcode, etc.)
- Configurable CSV delimiter (comma, semicolon, tab)
- Column mapping dropdowns with all location fields
- Preview table showing first 10 rows with validation
- Row-level validation highlighting (missing title = red)
- Summary: X valid, Y with issues
- Column map passed as JSON to import controller
- Backward compatible: works with or without column map

Closes #21, #27

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: add .mokogitea/manifest.xml ... 30516f0a3a

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(ci): use manifest.xml for platform detection, remove .moko-platform ... 103e6699ee

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(api): add Web Services REST API plugin (#29) ... 745346a556

- plg_webservices_mokojoomstorelocator: registers CRUD routes
- Routes: /v1/storelocator/locations, /v1/storelocator/categories
- Custom route: /v1/storelocator/search (radius search)
- JsonapiView for Locations and Categories (list + item fields)
- Added to package manifest

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(production): fix all production gaps (#30-#35) ... 2c9a7683ba

- access.xml with component and category ACL sections (#30)
- SQL update schema with versioned migrations for upgrades (#31)
- populateState() in LocationsModel for filter persistence (#32)
- Filter XML forms: filter_locations.xml, filter_categories.xml (#33)
- joomla.asset.json for Web Asset Manager (Leaflet, CSS) (#35)
- Note: XSS audit (#34) ongoing — escape() usage verified

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

docs: update CHANGELOG with complete feature list and fix workflow YAML ... 9a9534f0cf

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(version): bump 00.00.00 → 00.00.01 [skip ci] bab0d0a289

fix(manifest): hardcode name and description in all XML manifests ... db835482cd

Language variables in <name> and <description> don't resolve during
installation because language files aren't deployed yet. Fixed across
all 5 package sub-extensions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

jmiller merged commit 72fecbb634 into main 2026-05-23 22:34:48 +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

status: pending-testing

Implementation done, awaiting test proofs before close

status: pending-testing

Implementation done, awaiting test proofs before close

type/bug

Something is broken

type/docs

Documentation

type/enhancement

Improvement to existing feature

type/feature

New feature or functionality

bug

Something is not working

chore

Maintenance and housekeeping

documentation

Documentation improvements

enhancement

Improvement to existing functionality

feature

New feature or request

pending: dependency

Blocked by another issue or external dependency

pending: deployment

Tested and approved, awaiting deployment to production

pending: design

Needs UI/UX or architecture design before implementation

pending: documentation

Feature works, needs documentation/wiki update

pending: feedback

Awaiting feedback or decision from stakeholder

pending: review

Implementation complete, awaiting code review

pending: testing

Feature implemented but not yet tested

priority: critical

Must fix immediately

priority: high

Should fix soon

priority: low

Nice to have

priority: medium

Fix when convenient

refactor

Code restructuring without behavior change

roadmap

Planned feature or enhancement tracked on the roadmap

scope: client

Client-specific work

scope: dolibarr

Dolibarr modules and customizations

scope: infrastructure

Server, CI, backups, monitoring

scope: joomla

Joomla templates and extensions

scope: waas

MokoWaaS platform

security

Security vulnerability or hardening

status: blocked

Waiting on external dependency

status: duplicate

Duplicate of another issue

status: in-progress

Being worked on

status: needs-review

Ready for review

status: wontfix

Will not be addressed

No labels

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/MokoJoomStoreLocator#36