Skip to content

bmlt-enabled/crumb

Repository files navigation

Crumb Widget logo

Crumb for WordPress

WordPress Plugin WordPress Tested PHP Version docs

WordPress plugin that embeds the Crumb Widget meeting finder via shortcode.

Usage

[crumb]

Override settings per page:

[crumb server="https://your-server/main_server" service_body="42" geolocation="true"]

Installation

  1. Upload to /wp-content/plugins/crumb/
  2. Activate in WordPress admin
  3. Go to Settings → Crumb and enter your BMLT Server URL
  4. Add [crumb] to any page or post

Settings

Configured under Settings → Crumb. Settings can be overridden per-shortcode via attributes.

Setting Shortcode Attribute Description
Server URL server Required. Full URL to your BMLT Server
Service Body IDs service_body Optional. Single ID or comma-separated list
Default View view Optional. list (default), map, or both (map above list)
Base Path Optional. Page slug for pretty URLs
geolocation Optional. true or false per page
columns Optional. Comma-separated list of list-view columns
Widget Configuration Optional. JSON for CrumbWidgetConfig

Pretty URLs

By default, meeting detail URLs use hash-based routing (#/monday-night-meeting-42). To enable clean URLs like /meetings/monday-night-meeting-42, enter the page slug (e.g. meetings) in the Base Path for Pretty URLs setting. After saving, go to Settings → Permalinks and click Save Changes to update rewrite rules.

Switching from Crouton

Crumb is an alternative to crouton and can drop in without page edits. Just install Crumb and deactivate crouton — existing pages keep working.

  • Crouton shortcodes [bmlt_tabs], [bmlt_map], [crouton_tabs], and [crouton_map] are registered automatically and translated to the Crumb widget (map shortcodes render with view="both", tabs with view="list").
  • Shortcode attributes root_server, service_body, service_body_1, formats, and report_update_url are mapped to their Crumb equivalents.
  • Crouton's saved settings (server URL, service body, format IDs, update URL) are used as fallbacks whenever the corresponding Crumb setting is empty.
  • If both plugins are active, crouton continues to handle its own shortcodes; Crumb only takes over once crouton is deactivated.

Full documentation at crumb.bmlt.app.

About

Wordpress plugin that embeds the Crumb meeting finder widget

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors