WordPress Plugin Integration Guide
Use WebLiveHub Stream to embed WebLiveHub streaming content in WordPress by connecting your site to a Hosted Backend.
WordPress Integration
Embed streams using WebLiveHub Stream (block-first)
WebLiveHub Stream is a WordPress plugin that embeds WebLiveHub streaming content by connecting your site to a WebLiveHub Hosted Backend.
Compatibility
- Requires at least: WordPress
6.0 - Tested up to: WordPress
6.9 - Requires PHP:
8.0
How it works
- Your WordPress site connects to a Hosted Backend.
- The plugin generates embed tokens server-side (keep credentials out of posts/pages).
- The page renders the WebLiveHub player.
Before you begin
You need a WordPress site you can administer and a WebLiveHub connection prepared for its broadcaster.
- In Console → Hosted Backends, copy the service URL from the backend you will use. Its Allowed Origins must include your WordPress site's origin.
- In Console → Users, find the authorised connection identity and the broadcaster's public user ID. The connection password belongs to that streaming identity; it is not your WordPress administrator password or your Google sign-in password.
- Use the matching broadcaster account for a presenter page. Enter the connection password directly in WordPress settings; keep it out of page content and support messages.
- Use a browser with access to both camera and microphone. Allow these devices in browser and operating-system permissions.
If your account, backend or broadcaster identity is not ready, contact WebLiveHub with your site URL and intended use. Do not send passwords or tokens.
Installation and support
Source release: WebLiveHub Stream v1.1.0 on GitHub
Download the v1.1.0 source ZIP from the GitHub release. In WordPress, go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP, select Install Now, then Activate. Upload, installation, activation, and opening the settings page succeeded in official WordPress Playground on WordPress 6.9 / PHP 8.3. This check covered a new installation; upgrades, backend connection, and live streaming were not tested. The plugin is not distributed through WordPress.org.
Create your presenter page
- Download Source code (zip) from the v1.1.0 Release. In WordPress, open Plugins → Add New Plugin → Upload Plugin, install the ZIP and activate WebLiveHub Stream.
- Open Settings → WebLiveHub Stream. Use Quick Setup to save the Hosted Backend service URL and matching connection identity and password. Saving confirms the settings were stored; verify the broadcast below.
- In the page-creation section, choose the broadcaster use, enter the matching broadcaster's public ID, and create the page draft. With multiple connections, explicitly select the backend and identity.
- Review the prefilled block in the draft. Preview the page and publish it when ready; creating a draft does not publish it.
- Open the presenter page, allow camera and microphone in both browser and operating-system permissions, and use its start control for your event.
- Confirm the loading overlay disappears or is cancelled and the presenter timer starts. When the event ends, end the broadcast using the interface.
For the next event, reuse this presenter page and verify the start signals again.
Reuse your page
Keep a working presenter page for future events. You can edit its existing WebLiveHub Stream block when you need to change the broadcaster or layout.
Manual block insertion, multiple connections, shortcode and custom CSS remain available for advanced setups. They are optional for the Quick Setup and draft-creation route.
If a device is denied or loading continues, check camera and microphone permissions in both the browser and operating system. Contact support with the step you reached, plugin and browser versions, and a visible error with passwords and tokens removed.
Host Label cheat sheet
| Host Label | When to use |
|---|---|
| connect | test / PoC / general default |
| live | streamer/broadcaster mode (upstream + controls) |
| live-client | viewer mode (watch) |
Advanced / legacy: shortcode usage
Positioning guidance: treat shortcode as an optional fallback for legacy workflows.
[weblivehub_stream streamer="STREAMER_USER_ID"][weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" width="100%" height="600px"]
[weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" style="width: 100%; height: 600px; display: block;"]Security note: Store Hosted Backend credentials only in Settings → WebLiveHub Stream. Do not paste credentials into posts/pages.
Have a real WordPress live-streaming use case? Contact us to discuss setup. Include the site URL and expected first-use date; write “unknown” if it is not set. Do not send passwords or tokens.