Crumb is a lightweight WordPress plugin that embeds the Crumb Widget meeting finder on any page or post using a simple shortcode. Features: List and map views with real-time search and filters Meeting detail with directions and virtual meeting join link Multi-language support Shareable per-meeting U
server — BMLT server URL (overrides the value set in Settings → Crumb)
service_body — Service body ID or comma-separated list; leave empty to show all meetings
format_ids — Format ID or comma-separated list of BMLT format IDs to lock the widget to; leave empty to show all formats
view — Default view when the widget loads: list (default), map , or both (map above list with no toggle); can also be overridden at runtime via the ?view= query parameter
geolocation — Enable or disable geolocation for this page: true or false
geolocation_radius — Geolocation search radius. Positive integer = fixed radius in miles (or km per server settings). Negative integer = BMLT auto-radius: the server expands the search until it finds roughly that many meetings (e.g. -50 finds ~50 nearby meetings). Overrides the Geolocation Radius setting and Widget Configuration.
update_url — URL template for the Update Meeting Info link shown at the bottom of the meeting detail panel. Supports tokens {meeting_id} , {meeting_name} , {server_url} , {return_url} (URL-encoded on substitution). Works with bmlt-workflow, hosted forms, or mailto: URLs.
columns — Comma-separated list of columns to show in list view (e.g. time,name,location,address,service_body ). Available values: time , distance (only renders when geolocation is active), name , location (venue/building name), address (street address with in-person/online badges), service_body , formats (one chip per format, using its localized name). Omit a name to hide that column; the order you list them in is the order they render. Overrides the List Columns setting. Leave unset to use the List Columns setting, or the widget default ( time,distance,name,location,address ) when that is empty too.
language — Force the widget UI language for this page (e.g. en , es , fr , de , pt , it , sv , da , el , fa , pl , ru , ja , fi ). Leave unset to auto-detect from the visitor’s browser.
query — Raw BMLT query string passed through to the widget’s rawQuery() for filters the structured options can’t express (e.g. multi-value meeting_key_value[] ). When set, this replaces the default load entirely — service_body , format_ids , and ?services are ignored — and forces geolocation off (the widget can’t safely layer lat/long/geo_width on top of an arbitrary query). Encode brackets as %5B / %5D because WordPress shortcodes can’t contain literal [ or ] . Example: [crumb query="meeting_key=location_nation&meeting_key_value%5B%5D=USA"] . Shortcode-only; no admin setting.
Switching from Crouton
Crumb is an alternative to the crouton plugin and can drop in without page edits in most cases. Activating Crumb will:
Register the crouton shortcodes ( [bmlt_tabs] , [bmlt_map] , [crouton_tabs] , [crouton_map] ) and translate them to the Crumb widget. Map shortcodes render with view="both" (map + list) and tabs shortcodes render with view="list" . Shortcode attributes root_server , service_body , service_body_1 , formats , report_update_url , and query_string are mapped to their Crumb equivalents ( query_string becomes data-query and routes through the widget’s rawQuery() ).
Reuse crouton’s saved settings as fallbacks when the corresponding Crumb option is empty (BMLT server URL, service bodies, format IDs, update URL). Open Settings → Crumb to confirm the inherited values and click Save Changes to persist them.
Crumb only handles those shortcodes when crouton is deactivated — if both plugins are active, crouton continues to handle its own shortcodes. To switch: install Crumb, then deactivate crouton. No page edits required.
Documentation
Full documentation at crumb.bmlt.app .
External services
This plugin relies on two external services. Both are part of the BMLT (Basic Meeting List Toolkit) ecosystem — free, open-source tools built for Narcotics Anonymous service bodies (https://bmlt.app).
1. Crumb Widget CDN
The widget JavaScript is loaded from a CDN operated by the BMLT project.
Service: cdn.aws.bmlt.app — delivers the Crumb Widget JavaScript file
Purpose: Provides the JavaScript component that renders the meeting list interface
Data sent: Standard HTTP request headers (IP address, browser user-agent, referring URL). No personal or meeting-search data is sent to the CDN.
When: The script is loaded once per page load on any page that contains the [crumb] shortcode
Terms of use / License: https://github.com/bmlt-enabled/crumb-widget/blob/main/LICENSE
2. BMLT Server (meeting data)
The widget fetches meeting data from a BMLT server whose URL you configure in Settings → Crumb. This server is typically operated by a regional NA service body and is not a service operated by the Crumb project.
Service: Your configured BMLT server (e.g. https://your-region.bmlt.app/main_server/)
Purpose: Retrieve NA meeting listings (names, times, locations, formats) to display in the widget
Data sent: Search query parameters (filters, keyword, selected formats). If geolocation is enabled and the user consents via a browser prompt, the user’s geographic coordinates are also sent to this server.
When: On each search or filter action within the widget
Privacy policy: Determined by the operator of your configured BMLT server. Learn more at https://bmlt.app.
See it in action
Screenshots & previews.
List view — meeting results with day, time, location, and address. Click any meeting name to see full details.Map view — meeting locations plotted on an interactive map with the same search and filter controls.
02 / Source details
Gettingstarted.
01Upload the plugin files to /wp-content/plugins/crumb/ .
02Activate the plugin through the Plugins screen in WordPress.
03Go to Settings → Crumb and enter your BMLT Server URL.
04Add [crumb] to any page or post.
03 / Source details
Frequently asked questions.
Where do I find my server URL?
It is the URL to your BMLT server, typically ending in /main_server . Contact your service body’s regional tech team if you are unsure.
Can I show only meetings from a specific service body?
Yes. Enter the service body ID (or a comma-separated list of IDs) in the Service Body IDs field, or use the service_body shortcode attribute. Child service bodies are always included automatically.
Can I set the widget to open in map view by default?
Yes. Choose Map from the Default View dropdown in Settings → Crumb , or use view="map" in the shortcode. You can also choose Both to display the map above the meeting list simultaneously with no list/map toggle. Visitors can also switch views at runtime via the ?view= query parameter.
Can I get clean URLs without the # in them?
Yes. Enter the page slug (e.g. meetings ) in the Base Path for Pretty URLs setting under Settings → Crumb . After saving, go to Settings → Permalinks and click Save Changes to update rewrite rules. Meeting detail URLs will then look like /meetings/monday-night-meeting-42 instead of /#/monday-night-meeting-42 .
Can I deep-link to a specific view?
Yes. Append ?view=list or ?view=map to any page URL that contains the [crumb] shortcode to open the widget in that view. This works regardless of the default view set in Settings → Crumb, making it easy to link directly to the map view from a button or menu item.
Does it work with page builders?
The shortcode works in any context that processes WordPress shortcodes. If your page builder does not render shortcodes automatically, use its dedicated shortcode block.
I’m switching from the crouton plugin — do I have to edit my pages?
No. Crumb registers the crouton shortcodes ( [bmlt_tabs] , [bmlt_map] , [crouton_tabs] , [crouton_map] ) and renders them with the Crumb widget. It also reads crouton’s saved settings (server URL, service body, format IDs, update URL) as fallbacks. Just install Crumb, deactivate crouton, and existing pages keep working. See the Switching from Crouton section above for details.
FinderPress Media Auditor helps site administrators scan for broken images, missing Media Library files, unreachable media URLs, and other media issues across WordPress content. Use it to audit images, video, audio, PDFs, featured images, and attachment files without sending scan data to an external
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati