WP YouTube Live for WordPress

“Show recent videos from my channel” will show a playlist of recent videos from your channel

“Show a specified playlist” will show a specified playlist

“Show a specified video” will show a specified video

“Show nothing at all” will show nothing at all

When a video ends, users’ browsers will check your server again to see if a live video is available. If so, it will load that; if not, it will fall back as set in your options.

Shortcode Options

width: player width in pixels; defaults to what you set on the settings page

height: player height in pixels; defaults to what you set on the settings page

autoplay: whether or not to start playing immediately on load; defaults to false

auto_refresh: (either true or false) overrides the auto-refresh setting on the settings page

fallback_behavior: choose from the following: upcoming, completed, channel, playlist, video, message, no_message

upcoming: the next upcoming scheduled video on the specified channel

playlist: a specified playlist (shortcode must also include the fallback_playlist attribute)

video: a specified video (shortcode must also include the fallback_video attribute)

message: a specified message

no_message: nothing at all

fallback_playlist: a playlist URL to show when there are no live videos

fallback_video: a video URL to show when there are no live videos

fallback_message: a message to show when there are no live videos

js_only: (either true or false) workaround for some caching issues; if a caching plugin (W3 Total Cache, WP Super Cache, etc.) or proxy (CloudFlare, etc.) caches the HTML while a video is live, visitors may continue to see an old live video even if it has ended. If set js_only is set to true, the server never displays the player code in the initial request and instead sends it in response to uncached ajax requests. This may also result in the video player being slightly delayed on page load due to the extra request, depending on the clients’ bandwidth and latency.

Example shortcode: [youtube_live width="720" height="360" autoplay="true"]

Filters The filter wp_youtube_live_no_stream_available will customize the message viewers see if there is no live stream currently playing, and takes effect after the fallback_message shortcode attribute is parsed (if fallback_message="no_message" is set in a shortcode, it will override the filter). For example, add this to your theme’s functions.php file:

add_filter( 'wp_youtube_live_no_stream_available', 'my_ytl_custom_message' ); function my_ytl_custom_message( $message ) { $message = '<p>Please check back later or subscribe to <a target="_blank" href="https://youtube.com/channel/UCH…">our YouTube channel</a>.</p> <p><button type="button" class="button" id="check-again">Check again</button><span class="spinner" style="display:none;"></span></p>'; return $message; }

The filter wp_youtube_live_transient_timeout is available to customize the cache timeout length in seconds. For example, add this to your theme’s functions.php file to set the cache length to 15 seconds instead of the default 900:

add_filter( 'wp_youtube_live_transient_timeout', 'my_ytl_custom_timeout' ); function my_ytl_custom_timeout( $timeout ) { return 15; }

Event Listener When a live stream is loaded, the wpYouTubeLiveStarted event is fired; you can use this to create custom front-end features on your site by adding an event listener:

window.addEventListener('wpYouTubeLiveStarted', function() { /* your code here */ console.log('stream started'); /* your code here */ });

Development of this plugin is done on GitHub. Pull requests are always welcome.