Core Video Options
Core Video Options Guide
This guide covers the video options provided by the Core plugin: global video settings, individual video settings, ad settings, quality controls, archive filters, and livestream options.
Open the Core Video Settings
In WordPress, go to VideoHub360 → Settings.
Use this screen to configure the global defaults used by video posts.
Configure Global Video Ads
Find Global Ad Settings.
You can set:
- Global Pre-roll Ad URL: the default ad that plays before videos.
- Global Mid-roll Ad URL: the default ad used during video playback.
- Global Mid-roll Timing: the playback times when mid-roll ads should appear. Enter the timing in seconds, separated by commas. Example:
30,60,120. - Global Post-roll Ad URL: the default ad that plays after a video ends.
- Global Post-roll Enabled: turns post-roll ads on globally.
Save the settings after making changes.
Configure Ad Click-Through Settings
Find Ad Click-Through Settings.
You can set:
- Global Ad Click-Through URL: the default destination URL used when viewers click video ads.
- Enable Click Tracking: tracks ad clicks for analytics.
- Open Links in New Tab: opens ad click-through links in a new browser tab.
Leave the global click-through URL blank if ads should not be clickable by default.
Configure Video URL Slugs
Find URL Slug Settings.
You can set the URL slugs for:
- Video Post Slug
- Category Slug
- Location Slug
- Series Slug
After changing slugs, go to Settings → Permalinks and click Save Changes once so WordPress refreshes the video URLs.
Configure the Video Archive Page
Find Archive Page Header.
You can:
- Turn the full-width archive banner header on or off.
- Set the archive header title.
Find Archive Page Filters.
You can control whether the archive shows filters for:
- Category
- Series
- Location
Each filter also has a label field so you can rename the filter text shown on the archive page.
Configure Global Video Quality
Find Video Quality & Streaming Settings.
You can set:
- Default Video Quality: the default quality used by video players.
- Default Mirror Setting: the default mirror or flip behavior for video players.
- Allow users to change video quality: lets viewers choose quality in the player.
- Allow users to control mirror/flip settings: lets viewers adjust mirror settings.
- Show quality badge on videos: displays the selected quality on videos.
- Enable 4K Ultra HD streaming options: enables 4K quality choices.
Only enable 4K streaming if your hosting and video delivery setup can handle the larger bandwidth requirements.
Configure Default Livestream Offline Messages
Find Livestream Offline / Ended Messages.
You can set the default messages or icons shown when livestreams are offline or ended, including:
- Default Stream Ended HTML
- Default Stream Ended Icon
- Default Live Room Offline HTML
- Default Live Room Offline Icon
- Stream Ended by Moderator HTML
- Stream Ended / Host Needs Restart HTML
Use these fields to control what viewers see when a livestream is unavailable or has ended.
Add or Edit an Individual Video
Go to VideoHub360 → Add New Video or edit an existing video from VideoHub360 → All Videos.
On the video edit screen, use VideoHub360 Video Details to configure options for that specific video.
Configure Regular Video Playback
Find Video Settings.
You can set:
- Video MP4 URL: the main MP4 file used for regular video playback.
- Ad (Pre-roll) MP4 URL: a pre-roll ad for this video.
- Mid-Roll Ad MP4 URL: a mid-roll ad for this video.
- Mid-Roll Ad Timing: the times when mid-roll ads should play, entered as seconds separated by commas.
- Post-Roll Ad MP4 URL: a post-roll ad for this video.
- Enable Post-Roll Ad for this video: turns on the post-roll ad for this video.
Per-video ad fields can override the global ad settings.
Configure Per-Video Ad Click URLs
In the same Video Settings area, find Ad Click-Through URLs.
You can set:
- Pre-roll Ad Click URL
- Mid-roll Ad Click URL
- Post-roll Ad Click URL
If a per-video click URL is blank, the video can use the global click-through URL when one is configured.
Set the Manual View Count
Use Manual View Count to set the displayed view count for the video.
Enter a number and update the video.
Use a Custom HTML Embed
Use Custom HTML Embed when you want an embed to display instead of the MP4 player.
This field can be used for embed code such as YouTube, Vimeo, or another HTML video embed.
When this field is filled, it overrides the regular MP4 video player for that video.
Override Video Quality for One Video
Find Video Quality & Mirror Settings.
To use custom quality settings for one video:
- Check Override global quality settings for this video.
- Choose the video’s Video Quality.
- Choose the video’s Mirror Setting.
- Update the video.
Leave the override unchecked when the video should use the global quality settings from VideoHub360 → Settings.
Configure a Livestream Video
Find Livestream Settings.
To make a video use livestream mode:
- Set Currently Live Status to Yes – Livestream Mode.
- Set the Live Start Time if you want the stream to show when it started.
- Add an Offline Message or Placeholder for times when the stream is offline.
- Choose the Stream Source Type.
- Complete the fields for the selected stream source.
- Update the video.
Available stream source types are:
- Embed: for iframe or embed HTML such as YouTube Live or Twitch.
- Self-Hosted HLS/DASH: for an HLS
.m3u8or DASH.mpdstream URL. - Streaming API Platform: for an API-provided HLS/DASH playback URL.
- Agora.io WebRTC: for Agora-powered interactive or broadcast streaming.
Configure Agora Options for a Livestream
When Stream Source Type is set to Agora.io WebRTC, configure:
- Streaming Mode: choose Interactive Mode or Broadcast Mode.
- Channel Name: enter the Agora channel name for the livestream.
- Allow Everyone to be Host: lets viewers join directly as hosts.
- Require Passcode To Join: requires viewers to enter a passcode before joining as presenters.
Do not use Allow Everyone to be Host and Require Passcode To Join together.
Configure Livestream Display Options
Livestream videos also include display controls for:
- Show Viewer Count
- Enable live chat for this video
- Chat Placement Override
- Show Live Badge
- Live Badge Text
- Live Badge Color
Use Chat Placement Override only when one video needs a different chat placement than the global chat setting.
Stop or Restart a Stream
On the video edit screen, use Stream Control when managing a livestream video.
- Stop Stream removes live indicators while keeping the stream settings saved.
- Restart Stream re-enables the live indicators.
Test the Video Options
After saving a video:
- View the video on the frontend.
- Confirm the correct player appears.
- Confirm the correct ad behavior appears if ads are configured.
- Confirm the archive filters appear only for the enabled filters.
- Confirm quality controls appear only if quality switching is enabled.
- For livestreams, confirm the correct stream source loads and the live badge displays as expected.
Troubleshooting
The video URL does not work
Confirm the Video MP4 URL is a direct MP4 file URL and that the file is publicly reachable.
The custom embed appears instead of the MP4 player
Check Custom HTML Embed. If this field has content, it displays instead of the MP4 player.
Mid-roll ads are not appearing
Confirm the mid-roll ad URL is saved and the timing field uses seconds separated by commas, such as 30,60,120.
Post-roll ads are not appearing
Confirm Enable Post-Roll Ad for this video is checked for that video, or confirm Global Post-roll Enabled is enabled in VideoHub360 → Settings.
Ad clicks do not open a destination page
Confirm a click-through URL is saved either for the individual video ad or in VideoHub360 → Settings → Ad Click-Through Settings.
Video URLs show a 404 after changing slugs
Go to Settings → Permalinks and click Save Changes once.
The livestream still shows as offline
Confirm Currently Live Status is set to Yes – Livestream Mode and that the selected stream source has its required fields completed.
Agora livestream does not load
Confirm the site’s Agora credentials are saved in VideoHub360 → Settings → Agora.io Settings, and confirm the video is using Agora.io WebRTC with a channel name.
