bmltenabled

pjaudiomv

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>

Crumb

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

paulnagle

This plugin provides a Tabbed Map interface for the Basic Meeting List Toolbox (BMLT). Simply put the shortcode [bmlt_tabbed_map] into a WordPress page to get your very own tabbed map interface to BMLT. Please visit Settings – BMLT Tabbed Map for more shortcode instructions.

BMLT Tabbed Map

this plugin is awesome, love how simple it is to configure. Just set map and plug in shortcode. Ties right into tomato the BMLT root server aggregator. 

quick, easy to use.

bmlt_tabbed_map implements a Tabbed Map for BMLT.

Crumb vs BMLT Tabbed Map