Who It’s For

• Businesses with dealer or agent networks — display your distribution network with filterable group buttons
• Multi-location and franchise businesses — let customers find their nearest branch or service centre
• Retailers and distributors — show stockists, resellers, or collection points on an interactive map
• Agencies — deploy a polished location finder on client sites without API keys or heavy dependencies
• Any site needing a “find us” map — events, venues, service areas, pickup points, and more

Key Benefits

• No Google API key required — uses OpenStreetMap tiles via Leaflet, so there are no billing accounts, usage limits, or API configuration to worry about
• Filter by group — organise locations into groups (regions, types, brands) and let visitors filter the map and card grid with a single click
• Map and card grid together — markers and location cards update simultaneously, giving visitors two ways to browse your locations
• Manage everything in the admin — add and edit locations, groups, logos, contact details, and coordinates from a clean Joomla backend interface
• Flexible display options — use as a module in any page position or as a full-page menu item; configure height, marker colour, default group, and card layout per instance
• Stay lightweight — no jQuery, no Bootstrap dependencies in the frontend output; vanilla CSS and JS scoped to the map wrapper

How It Works

• Install the package and go to MapLab → Groups in the admin panel.
• Create your groups — regions, types, or any categories that make sense for your locations (e.g. North Island, South Island).
• Go to MapLab → Locations and add your locations — enter a title, assign a group, set the latitude and longitude, and fill in contact details as needed.
• Add a MapLab — Map module to a page position, or create a menu item using the MapLab → Location Map type.
• Visitors see an interactive Leaflet map with filter buttons and a card grid — clicking a group button updates both instantly.

Built on Joomla’s native MVC architecture with PSR-4 autoloading. Leaflet 1.9.4 is bundled with the extension — no CDN dependency, no API keys, no build tools.