Embeds the Crumb Widget NA meeting finder on any page or post via a simple shortcode.

bmltenabled

pjaudiomv

jbraswell

radius314

otrok7

alanb2718

odathp

californiasteve9390

crouton

crouton provides a UI and more for view recovery meetings as stored in a Basic Meeting List Toolbox (BMLT) database.

BMLTGuy

BMLT WordPress Satellite

This is a "satellite" plugin for the Basic Meeting List Toolbox (BMLT).

BMLT Meeting Map

The BMLT Meeting Map provides a map so people can find NA meetings stored in a the Basic Meeting List Toolbox (BMLT) Server.

paulnagle

BMLT Tabbed Map

bmlt_tabbed_map implements a Tabbed Map for BMLT.

Crumb is a lightweight WordPress plugin that embeds the <a href="https://crumb.bmlt.app/" rel="nofollow ugc">Crumb Widget</a> meeting finder on any page or post using a simple shortcode.
Features:
<ul>
<li>List and map views with real-time search and filters</li>
<li>Meeting detail with directions and virtual meeting join link</li>
<li>Multi-language support</li>
<li>Shareable per-meeting URLs</li>
</ul>
<h4>Usage</h4>
Add the shortcode to any page or post:
<pre><code>[crumb]
</code></pre>
Override settings per page:
<pre><code>[crumb server="https://your-server/main_server" service_body="42" format_ids="17,54" view="map" geolocation="true" geolocation_radius="30"]
</code></pre>
Shortcode attributes:
<ul>
<li><code>server</code> — BMLT server URL (overrides the value set in Settings → Crumb)</li>
<li><code>service_body</code> — Service body ID or comma-separated list; leave empty to show all meetings</li>
<li><code>format_ids</code> — Format ID or comma-separated list of BMLT format IDs to lock the widget to; leave empty to show all formats</li>
<li><code>view</code> — Default view when the widget loads: <code>list</code> (default), <code>map</code>, or <code>both</code> (map above list with no toggle); can also be overridden at runtime via the <code>?view=</code> query parameter</li>
<li><code>geolocation</code> — Enable or disable geolocation for this page: <code>true</code> or <code>false</code></li>
<li><code>geolocation_radius</code> — 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. <code>-50</code> finds ~50 nearby meetings). Overrides the Geolocation Radius setting and Widget Configuration.</li>
<li><code>update_url</code> — URL template for the Update Meeting Info link shown at the bottom of the meeting detail panel. Supports tokens <code>{meeting_id}</code>, <code>{meeting_name}</code>, <code>{server_url}</code>, <code>{return_url}</code> (URL-encoded on substitution). Works with bmlt-workflow, hosted forms, or <code>mailto:</code> URLs.</li>
<li><code>columns</code> — Comma-separated list of columns to show in list view (e.g. <code>time,name,location,address,service_body</code>). Omit a name to hide that column. Leave unset to use the widget default.</li>
<li><code>language</code> — Force the widget UI language for this page (e.g. <code>en</code>, <code>es</code>, <code>fr</code>, <code>de</code>, <code>pt</code>, <code>it</code>, <code>sv</code>, <code>da</code>, <code>el</code>, <code>fa</code>, <code>pl</code>, <code>ru</code>, <code>ja</code>). Leave unset to auto-detect from the visitor’s browser.</li>
<li><code>query</code> — Raw BMLT query string passed through to the widget’s <code>rawQuery()</code> for filters the structured options can’t express (e.g. multi-value <code>meeting_key_value[]</code>). When set, this replaces the default load entirely — <code>service_body</code>, <code>format_ids</code>, and <code>?services</code> 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 <code>%5B</code> / <code>%5D</code> because WordPress shortcodes can’t contain literal <code>[</code> or <code>]</code>. Example: <code>[crumb query="meeting_key=location_nation&meeting_key_value%5B%5D=USA"]</code>. Shortcode-only; no admin setting.</li>
</ul>
<h4>Switching from Crouton</h4>
Crumb is an alternative to the <a href="https://wordpress.org/plugins/crouton/" rel="ugc">crouton</a> plugin and can drop in without page edits in most cases. Activating Crumb will:
<ul>
<li>Register the crouton shortcodes (<code>[bmlt_tabs]</code>, <code>[bmlt_map]</code>, <code>[crouton_tabs]</code>, <code>[crouton_map]</code>) and translate them to the Crumb widget. Map shortcodes render with <code>view="both"</code> (map + list) and tabs shortcodes render with <code>view="list"</code>. Shortcode attributes <code>root_server</code>, <code>service_body</code>, <code>service_body_1</code>, <code>formats</code>, <code>report_update_url</code>, and <code>query_string</code> are mapped to their Crumb equivalents (<code>query_string</code> becomes <code>data-query</code> and routes through the widget’s <code>rawQuery()</code>).</li>
<li>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.</li>
</ul>
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.
<h4>Documentation</h4>
Full documentation at <a href="https://crumb.bmlt.app/" rel="nofollow ugc">crumb.bmlt.app</a>.
<h3>External services</h3>
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.
<ul>
<li>Service: cdn.aws.bmlt.app — delivers the Crumb Widget JavaScript file</li>
<li>Purpose: Provides the JavaScript component that renders the meeting list interface</li>
<li>Data sent: Standard HTTP request headers (IP address, browser user-agent, referring URL). No personal or meeting-search data is sent to the CDN.</li>
<li>When: The script is loaded once per page load on any page that contains the [crumb] shortcode</li>
<li>Privacy policy: https://crumb.bmlt.app/privacy.html</li>
<li>Terms of use / License: https://github.com/bmlt-enabled/crumb-widget/blob/main/LICENSE</li>
</ul>
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.
<ul>
<li>Service: Your configured BMLT server (e.g. https://your-region.bmlt.app/main_server/)</li>
<li>Purpose: Retrieve NA meeting listings (names, times, locations, formats) to display in the widget</li>
<li>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.</li>
<li>When: On each search or filter action within the widget</li>
<li>Privacy policy: Determined by the operator of your configured BMLT server. Learn more at https://bmlt.app.</li>
</ul>

Alternatives to Crumb

Top alternatives