crumb.bmlt.app<\/a>.<\/p>\n\nExternal services<\/h3>\n\n
This plugin relies on two external services. Both are part of the BMLT (Basic Meeting List Toolkit) ecosystem \u2014 free, open-source tools built for Narcotics Anonymous service bodies (https:\/\/bmlt.app).<\/p>\n\n
1. Crumb Widget CDN<\/strong><\/p>\n\nThe widget JavaScript is loaded from a CDN operated by the BMLT project.<\/p>\n\n
\n- Service: cdn.aws.bmlt.app \u2014 delivers the Crumb Widget JavaScript file<\/li>\n
- Purpose: Provides the JavaScript component that renders the meeting list interface<\/li>\n
- 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>\n
- When: The script is loaded once per page load on any page that contains the [crumb] shortcode<\/li>\n
- Privacy policy: https:\/\/crumb.bmlt.app\/privacy.html<\/li>\n
- Terms of use \/ License: https:\/\/github.com\/bmlt-enabled\/crumb-widget\/blob\/main\/LICENSE<\/li>\n<\/ul>\n\n
2. BMLT Server (meeting data)<\/strong><\/p>\n\nThe widget fetches meeting data from a BMLT server whose URL you configure in Settings \u2192 Crumb. This server is typically operated by a regional NA service body and is not a service operated by the Crumb project.<\/p>\n\n
\n- Service: Your configured BMLT server (e.g. https:\/\/your-region.bmlt.app\/main_server\/)<\/li>\n
- Purpose: Retrieve NA meeting listings (names, times, locations, formats) to display in the widget<\/li>\n
- 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>\n
- When: On each search or filter action within the widget<\/li>\n
- Privacy policy: Determined by the operator of your configured BMLT server. Learn more at https:\/\/bmlt.app.<\/li>\n<\/ul>\n\n\n
\n- Upload the plugin files to
\/wp-content\/plugins\/crumb\/<\/code>.<\/li>\n- Activate the plugin through the Plugins screen in WordPress.<\/li>\n
- Go to Settings \u2192 Crumb<\/strong> and enter your BMLT Server URL.<\/li>\n
- Add
[crumb]<\/code> to any page or post.<\/li>\n<\/ol>\n\n\n\nWhere do I find my server URL?<\/h3><\/dt>\nIt is the URL to your BMLT server, typically ending in \/main_server<\/code>. Contact your service body's regional tech team if you are unsure.<\/p><\/dd>\nCan I show only meetings from a specific service body?<\/h3><\/dt>\nYes. Enter the service body ID (or a comma-separated list of IDs) in the Service Body IDs field, or use the service_body<\/code> shortcode attribute. Child service bodies are always included automatically.<\/p><\/dd>\nCan I set the widget to open in map view by default?<\/h3><\/dt>\nYes. Choose Map<\/strong> from the Default View dropdown in Settings \u2192 Crumb<\/strong>, or use view=\"map\"<\/code> in the shortcode. You can also choose Both<\/strong> to display the map above the meeting list simultaneously with no list\/map toggle. Visitors can also switch views at runtime via the ?view=<\/code> query parameter.<\/p><\/dd>\nCan I get clean URLs without the # in them?<\/h3><\/dt>\nYes. Enter the page slug (e.g. meetings<\/code>) in the Base Path for Pretty URLs<\/strong> setting under Settings \u2192 Crumb<\/strong>. After saving, go to Settings \u2192 Permalinks<\/strong> and click Save Changes<\/strong> to update rewrite rules. Meeting detail URLs will then look like \/meetings\/monday-night-meeting-42<\/code> instead of \/#\/monday-night-meeting-42<\/code>.<\/p><\/dd>\nCan I deep-link to a specific view?<\/h3><\/dt>\nYes. Append ?view=list<\/code> or ?view=map<\/code> to any page URL that contains the [crumb]<\/code> shortcode to open the widget in that view. This works regardless of the default view set in Settings \u2192 Crumb, making it easy to link directly to the map view from a button or menu item.<\/p><\/dd>\nDoes it work with page builders?<\/h3><\/dt>\nThe shortcode works in any context that processes WordPress shortcodes. If your page builder does not render shortcodes automatically, use its dedicated shortcode block.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.2.0<\/h4>\n\n\n- Added Format IDs<\/strong> setting and
format_ids<\/code> shortcode attribute to lock the widget to specific BMLT formats (single ID or comma-separated list).<\/li>\n<\/ul>\n\n1.1.1<\/h4>\n\n\n- Added
both<\/code> as a valid view<\/code> option \u2014 displays the map above the meeting list with no list\/map toggle.<\/li>\n<\/ul>\n\n1.1.0<\/h4>\n\n\n- Added Base Path for Pretty URLs<\/strong> setting \u2014 enables clean meeting detail URLs (e.g.
\/meetings\/monday-night-meeting-42<\/code>) using WordPress rewrite rules. Leave empty to keep default hash-based routing.<\/li>\n<\/ul>\n\n1.0.3<\/h4>\n\n\n- Added Widget Configuration setting (JSON) for CrumbWidgetConfig options (language, geolocation, darkMode, columns, map tiles, etc.).<\/li>\n
- Added
geolocation<\/code> shortcode attribute to enable or disable geolocation per page.<\/li>\n<\/ul>\n\n1.0.2<\/h4>\n\n\n- Updated readme to document external services (CDN and BMLT server) with privacy policy links.<\/li>\n
- Fixed late-escaping of inline CSS output per WordPress coding standards.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Added
view<\/code> shortcode attribute and admin setting to set the default widget view (list<\/code> or map<\/code>).<\/li>\n<\/ul>\n\n1.0.0<\/h4>\n\n\n- Initial release.<\/li>\n<\/ul>","raw_excerpt":"Embeds the Crumb Widget NA meeting finder on any page or post via a simple shortcode.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/296510","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=296510"}],"author":[{"embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/bmltenabled"}],"wp:attachment":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=296510"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=296510"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=296510"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=296510"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=296510"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=296510"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}