Use the [steve_leaflet_map] shortcode in your content.

Common Shortcode Examples

Basic map with coordinates:

[steve_leaflet_map lat="42.3601" lng="-71.0589"]

Simple “page meta” map (single marker from this page/post’s lat/lng + location_name):

[steve_leaflet_map_simple height="300px" zoom="12" layer="topo"]

Map with address geocoding:

[steve_leaflet_map address="1600 Pennsylvania Avenue NW, Washington, DC"]

Map all posts in a category:

[steve_leaflet_map taxonomy="category" term="events"]

Show a list of points below the map:

[steve_leaflet_map taxonomy="category" term="events" show_list="true"]

Load points via REST/AJAX:

[steve_leaflet_map taxonomy="category" term="events" show_list="true" ajax_points="true" ajax_ttl="600"]

Enable clustering:

[steve_leaflet_map taxonomy="category" term="events" show_list="true" ajax_points="true" cluster="true"]

Enable nearby filtering:

[steve_leaflet_map taxonomy="category" term="events" show_list="true" ajax_points="true" locate="true"]

Enable a default nearby distance:

[steve_leaflet_map taxonomy="category" term="events" show_list="true" ajax_points="true" locate="true" distance="25" distance_unit="mi"]

Curated “Find nearby” buttons for specific post types (overrides auto-discovered categories):

[steve_leaflet_map nearby_groups='[{"label":"Find a restaurant nearby","post_type":"restaurant"},{"label":"Find lodging nearby","post_type":"lodging"}]‘ locate=”true”]

Point Set by ID:

[steve_leaflet_map point_set_id="12" show_list="true" ajax_points="true" cluster="true"]

Point Set by slug:

[steve_leaflet_map point_set_id="my-trailheads" show_list="true" ajax_points="true"]

Point Set plus two extra toggleable point layers:

[steve_leaflet_map point_set_id="12" point_set_layers="42:Trails,43:Historic Sites" show_list="true" ajax_points="true" cluster="true"]

Like & Save items:

[steve_leaflet_map source="saved" show_list="true"]

Like & Save items with trails overlay:

[steve_leaflet_map source="saved" show_list="true" trails="true"]

Enable air quality / alerts overlays in a map that supports them:

[steve_leaflet_map overpass_pois="true" airnow="true" airnow_data="false"]

Shortcode Attributes

• height – Map height (default: 400px)
• zoom – Initial zoom level (default: 13)
• lat – Latitude coordinate
• lng – Longitude coordinate
• name – Marker popup text
• address – Address to geocode if lat/lng are not provided
• click_zoom – Zoom level applied when a point is clicked (default: empty = don’t change zoom)
• nearby_groups – Curated “Find nearby” buttons as a JSON array. Overrides auto-discovered categories. Each entry: {“label”:”Find a restaurant nearby”,”post_type”:”restaurant”,”taxonomy”:””,”term”:””}. The post_type is required; taxonomy and term are optional. (default: empty, uses auto-discovery)
• scroll_guard – on or off; overrides the site-wide scroll-guard setting for this map (default: empty = use site setting)
• show_list – Show the point list under the map (default: false)
• ajax_points – Load points via REST/AJAX for large datasets, cached server-side (default: true)
• cluster – Enable marker clustering via Leaflet.markercluster (default: false)
• locate – Enable the Explore nearby panel (default: false)
• distance / distance_unit – Default nearby radius and unit (mi or km; unit default mi)
• show_directions – Show directions links on markers/popups (default: true)
• popup_template – Popup template: default, compact, simple (default: default)
• popup_meta_keys – Comma-separated point.meta keys to render in the popup; when set, only those keys render
• list_template – Points list template: default, compact, simple (default: default)
• list_meta_keys – Comma-separated point.meta keys to render in the list; when set, only those keys render
• list_layout – Points list layout preset: row, list, grid (default: row). list is a compact left-aligned preset (“Title – Address” inline, excerpt below)
• list_show_thumb – Show the point’s featured image in the list (default: true)
• list_show_title – Show the point’s title in the list (default: true)
• list_show_excerpt – Show the point’s excerpt/description in the list (default: true)
• list_show_meta – Show the point’s meta rows in the list (default: true)
• list_show_terms – Show the point’s term/category chips in the list (default: true)

Point Sources

• post_type – Post type to query (default: post); use any for all types
• taxonomy – Taxonomy to filter by; leave blank to auto-detect
• term – Term slug to filter by
• point_taxonomy – Taxonomy used to normalize manual-point categories (default: dataset_category)
• point_category – Readable category label for manual points
• point_set_id – Reusable Point Set ID or slug
• point_set_layers – Extra Point Sets rendered as toggleable layers, as ID:Label,ID:Label (max 4). See “Extra Point Layers” below.
• source – Point source; use saved to map the current visitor’s Like & Save items
• geo_address_key – Meta key used as the address when geocoding this map (default: the site’s configured address meta key)
• map_position – Render the map above or below the content (default: above)

Base Layers

• layer – Default base layer: osm, topo, satellite, cycle (default: osm)
• base_layers_allowlist – Comma-separated base-layer slugs to offer in the Layers control (e.g. osm,satellite,jawg_dark). Empty = offer all.
• base_default – Base-layer slug selected when the map opens (must be in the allowlist when the allowlist is non-empty)

Overlays

Overlays are toggled by the visitor from the map’s Layers control (bottom-right).

• overlays_allowlist – Comma-separated overlay slugs to offer. Empty = offer all. One-place registry: includes/overlays.php.
• overlays_default_enabled – Comma-separated overlay slugs switched on when the map opens

Individual overlay switches: