WebLiveHub Stream

Embed WebLiveHub streams into WordPress using your Hosted Backend and the official PHP SDK.

Description

The WebLiveHub Stream plugin allows you to easily embed live streams and video content from the WebLiveHub platform directly into your WordPress site.

This plugin acts as a bridge between your WordPress site and your WebLiveHub Hosted Backend. It utilizes the official WebLiveHub PHP SDK to securely generate tokens and render the streaming player.

Key Features:

• Easy Integration: Connects to your WebLiveHub Hosted Backend with simple configuration.
• Gutenberg Block: Includes a "WebLiveHub Stream" block for easy insertion into posts and pages.
• Shortcode Support: Provides a [weblivehub_stream] shortcode for flexible usage in classic editor or widgets.
• Secure: Handles authentication securely on the server-side using your Hosted Backend credentials.

Prerequisites:

1. A WebLiveHub account.
2. A configured Hosted Backend in your WebLiveHub Console.
3. Your Hosted Backend Endpoint, User ID, and Password.

Installation

1. Upload the plugin files to the /wp-content/plugins/weblivehub-stream directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Settings -> WebLiveHub Stream to configure the plugin.
4. Enter your Hosted Backend Endpoint, User ID, and Password obtained from your WebLiveHub Console.
5. Save the settings.

Usage

Once configured, you can display a stream in two ways:

1. Using the Gutenberg Block

1. Edit a Post or Page.
2. Click the + button to add a new block.
3. Search for "WebLiveHub Stream".
4. Add the block to your content.
5. In the block settings (sidebar), enter the Streamer User ID you wish to display.

2. Using the Shortcode

You can use the [weblivehub_stream] shortcode in any post, page, or widget area.

Basic Usage: [weblivehub_stream streamer="STREAMER_USER_ID"]

Advanced Usage: [weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" width="100%" height="600px"]

You can also use the unified style attribute (recommended for flexibility):

[weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" style="width: 100%; height: 600px; display: block;"]

Parameters:

• streamer (Required): The User ID of the streamer to display.
• host_label (Optional): The host label to use (e.g., connect, live, live-client). Defaults to the plugin setting.
• width (Optional): The width of the player (e.g., 100%, 640px).
• height (Optional): The height of the player (e.g., 600px).
• style (Optional): CSS style string for the container (overrides width/height).

Frequently Asked Questions

Where do I find my Hosted Backend Endpoint?

Log in to your WebLiveHub Console, navigate to the Hosted Backends page, and copy the URL for your backend.

Where do I find my User ID and Password?

These are the credentials you created or were assigned when setting up your Hosted Backend access in the WebLiveHub Console.

Changelog

1.0.4

• Feature: Improved Block Editor experience with visual placeholder.
• Feature: Moved Streamer ID input to Inspector sidebar.
• Update: Reverted to using WordPress default "Additional CSS class(es)" instead of custom field.
• i18n: Added Simplified Chinese (zh_CN) and Spanish (es_ES) translations; improved translation generator and added consistency checks.
• i18n: Added Hong Kong Traditional Chinese (zh_HK), Japanese (ja) and French (fr_FR) translations; generated PO/MO/JED JSON and handle-specific fallbacks.

1.0.3

• Feature: Consolidated Width and Height settings into a single "Style" field for better flexibility.
• Feature: Added "Custom CSS Class" field and moved it out of the Advanced section.
• Update: Renamed "Backend" label to "Backend + user id + password" for clarity.
• Update: Changed default player language to English (en) and removed "Auto" option.
• Fix: Resolved duplicate "Default" option in Backend selection.

1.0.0

• Initial release.