Integrations
WordPress Plugin
Display your Beacon status page on any WordPress site. Floating widget, shortcode, and admin dashboard widget — no coding required.
Installation
Upload the plugin via WP Admin.
- Go to Plugins > Add New > Upload Plugin
- Upload the beacon-status.zip file
- Activate the plugin
Configuration
Navigate to Settings > Beacon and configure:
| Setting | Description |
|---|---|
| Base URL | Your Beacon instance URL |
| Workspace slug | Found in your workspace settings |
| Page slug | The slug of the status page to display |
| Widget enabled | Toggle the floating badge on/off |
| Widget position | bottom-right, bottom-left, top-right, or top-left |
Floating widget
Once configured, the floating status badge appears automatically on every page of your WordPress site. Visitors click it to see components and active incidents. No code needed.
Shortcode
Embed an inline status summary in any post or page.
[beacon_status]
[beacon_status show_components="true" show_incidents="true" link="true"]| Attribute | Default | Description |
|---|---|---|
| show_components | true | Show component list |
| show_incidents | true | Show active incidents |
| link | true | Link to full status page |
Admin dashboard widget
A status summary widget appears automatically in your WordPress admin dashboard. It shows the overall status, component list, and active incidents — so your team can see system health without leaving WP Admin.
Caching
API responses are cached as WordPress transients for 60 seconds. This reduces external API calls and keeps your site fast. The cache clears automatically.
Features
- No coding required — configure in WP Admin
- Works with any WordPress theme
- Cached API calls (60-second transient)
- No external dependencies — no Composer, no npm
- Shortcode respects prefers-color-scheme
- All output properly escaped (esc_html, esc_attr, esc_url)
Troubleshooting
- Widget not appearing? Verify the workspace and page slugs in Settings > Beacon. The status page must be set to public.
- Shortcode shows nothing? Check that your Beacon instance is reachable from your WordPress server. Try visiting the status JSON URL directly.
- Stale data? The plugin caches for 60 seconds. Wait a minute or deactivate/reactivate the plugin to clear the transient.