Mesh-Plug Shortcodes

Mesh-Plug Shortcodes (Updated March 09 2026)

Mesh-Plug supports two primary operating modes:

  • Observer mode: read-only dashboard from server snapshots (best for public pages)
  • Live mode: direct browser-to-MQTT connection over WebSocket (admin/operator use only)

With the latest updates, the map is now fully interactive (drag/pan + zoom), and supports modern free basemaps.

1) Main Dashboard (Recommended)

Observer / Public Dashboard (Read-Only, Shareable)

[mesh_plug mode="observer" height="520px"]

Use this for:

  • Public pages
  • Shared community dashboards
  • HOA / neighborhood watch / info pages

Behavior:

  • No direct MQTT connection from the visitor browser
  • Data is served from server snapshot API
  • No MQTT credentials exposed to viewers

Live Dashboard (Admin / Operator)

[mesh_plug mode="live" height="520px"]

Use this for:

  • Real-time operations
  • Packet/chat monitoring
  • Troubleshooting and testing

Behavior:

  • Connects directly to your MQTT broker over WebSocket
  • Requires valid broker credentials in plugin settings
  • Shows live packet log and updates immediately

Use only on restricted pages.

2) Auto Mode (Backward Compatibility)

[mesh_plug]

Behavior:

  • Resolves automatically by user capability and cache settings
  • Typically admin-capable users can run live; public users are observer

Best practice: explicitly set mode in new shortcodes.

3) Map Controls and Map Style (New)

Map options are now built into the main shortcode:

[mesh_plug mode="observer" height="520px" map_tiles="voyager" fit="1" fit_max_zoom="13"]

Supported map attributes:

  • map_tiles="voyager|osm|light|dark"
    Default: voyager
  • map_zoom="13"
    Initial zoom preference
  • map_min_zoom="2" / map_max_zoom="18"
    Zoom limits
  • fit="1|0|once"
    Auto-fit behavior:
  • 1: keep fitting until user interacts
  • 0: fixed center/zoom behavior
  • once: fit first time, then stop auto-fitting
  • fit_max_zoom="13"
    Max zoom when auto-fit runs
  • center="lat,lon"
    Example: center="47.6062,-122.3321"

In-map controls now include Zoom In, Zoom Out, and Fit reset.

4) Common Attributes (Current)

  • mode="observer|live|auto"
  • height="520px"
  • poll_ms="5000" (observer snapshot refresh interval)
  • map_tiles, map_zoom, map_min_zoom, map_max_zoom, fit, fit_max_zoom, center

5) Recommended Shortcodes

Public share page:

[mesh_plug mode="observer" height="600px" map_tiles="voyager" fit="1"]

Admin operations page:

[mesh_plug mode="live" height="700px" map_tiles="dark" fit="once"]

Public map-focused presentation (single panel, map tab included):

[mesh_plug mode="observer" height="500px" map_tiles="light" fit="1" fit_max_zoom="12"]

6) Permissions Guidance

  • Public/Member pages: use mode="observer"
  • Admin/operator pages: use mode="live" only where access is restricted
  • Keep live mode off public URLs to avoid exposing broker connection behavior