About this plugin
Baxtersweb Maps lets you create interactive OpenStreetMap route maps directly from ACF Pro repeater fields. Display connected routes, multiple stops, numbered markers and points of interest without manually creating separate maps for every page.
Simply add your locations to an ACF repeater attached to any post, page or custom post type, and Baxtersweb Maps generates a responsive Leaflet-powered map from your content.
Ideal for:
- Travel itineraries
- Safari routes
- Hiking trails
- Cycling routes
- Road trips
- Delivery routes
- Campus or facility guides
- Festival and event maps
- Property developments
- Tourism websites
Baxtersweb Maps uses OpenStreetMap and Leaflet for map rendering. If you provide a free openrouteservice API key, routes will follow real roads and paths. Without an API key, markers are connected using a dashed straight line.
Features
- Interactive route maps
- ACF Pro repeater support for ordered map markers
- ACF OpenStreetMap Field support for visual location picking
- Route lines between ordered points
- Optional points of interest that do not affect the route line
- Optional POI title labels displayed beside the existing POI icon
- Built-in Dashicon, theme-class, or plain POI markers
- Individual POI background colours
- Nearby POI grouping with click-to-spread behaviour
- Alphabetical or numbered route markers
- Duplicate map marker handling
- Custom route colour, marker colour, marker text colour, POI colour, map height, border radius, and marker numbering settings
- Works with posts, pages, and custom post types
- One-click ACF field setup
- Quick Intro walkthrough for first-time setup
- Leaflet bundled locally with the plugin
Requirements
Baxtersweb Maps currently requires:
- Advanced Custom Fields Pro
- ACF OpenStreetMap Field
The ACF OpenStreetMap field should use Return Format: Raw data and should allow one marker per row.
Demo
Check out the Baxtersweb Maps demo page to see example route maps, points of interest, and styling options.
Documentation
Read the Baxtersweb Maps documentation for setup instructions, shortcode usage, and developer examples.
External Services
Baxtersweb Maps uses external services for map tiles and optional road-route calculation.
-
OpenStreetMap Standard tiles are loaded in the visitor’s browser from the OpenStreetMap Foundation tile service whenever a map is displayed. The visitor’s IP address, browser details, referring page, and requested tile coordinates may be sent to OpenStreetMap. org/wiki/Privacy_Policy
-
openrouteservice is used only when the site administrator has supplied a valid API key and road geometry needs to be calculated or recalculated. This may occur after route points are saved or changed, after an API key is successfully verified, or when an unrouted map is first rendered. org/ solely to calculate a road-following route.
Returned route geometry is stored in WordPress and reused, so normal visitor views of an already calculated route do not make routing requests. org/privacy-policy/
-
Leaflet JavaScript and CSS, WordPress Dashicons, and all Baxtersweb Maps plugin code are loaded locally. No icon CDN is used.
Baxtersweb Maps does not send WordPress user account data to these services.
Source Code
The plugin source code is included in this plugin package. The JavaScript and CSS files in assets/js and assets/css are human-readable source files and are not generated from a separate build step. No npm, webpack, or other build tooling is required to regenerate the shipped assets.