WP YouTube Live vs YouList – YouTube playlist shortcode

Displays the current YouTube live video from a specified channel via the shortcode [youtube_live]. Setup Notes Your YouTube livestream must be set to “Public” or it will not work. This is a security feature of YouTube’s API and unfortunately there’s no way to work around it. In addition, your live stream must be set to allow embedding on third-party sites. If that feature is unavailable, you may need to enable monetization for your account. See YouTube documentation for more information or help with allowing embedding. How It Works If no live video is available, you can display a specified video or a “channel player” showing all your recent videos. You can also enable auto-refresh to automatically check for a live video every 30 seconds (warning: will increase server load, so use with caution). By default, the server will check YouTube’s API and then cache that response for 15 minutes before checking the API again (you may change this value in the admin settings). If auto-refresh is enabled, clients will check against your server every 30 seconds and likely will hit that cache as well, so it can potentially take up to 16 minutes before a client will get a live video. The length of both caches can be changed using the wp_youtube_live_transient_timeout filter (see below for more information). If no live video is available when a page is loaded, several fallback options are available: “Show a custom HTML message” allows you to specify a custom message to show “Show scheduled live videos” will show a player and countdown until your next live video “Show last completed live video” will show your most recently-completed live video “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 = ' Please check back later or subscribe to our YouTube channel . Check again '; 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.

This plugin adds the shortcode [youlist] so you can easily embed YouTube™ playlist defined by playlist id (PL in front of the playlist id) comma seperated video ids list user favorites user uploads search query in a single YouTube™ player. Live demo New in version 1.0.6 show random playlists with the new attribute ‘randompid’ added apply_filters for output, style, class and src bug fix New in version 1.0.5 enable nocookies enable the https protocol play videos in a specific quality (fx. hd720) enable wmode to handle z-index issues. Usage Examples To embed a playlist with thumbnails [youlist pid=”PL3FF15AA7ED356D9F”] To embed three videos with thumbnails (comma seperated video id list): [youlist vid=”ZF_K8D414-Y,sFHXWoawnt0,E2uOGOqIyC4″] To embed three videos without thumbnails: [youlist vid=”ZF_K8D414-Y,sFHXWoawnt0,E2uOGOqIyC4″ showinfo=”0″] To embed a playlist from the search string “higgs boson” [youlist search=”higgs boson” width=”600″ height=”400″] To embed a random playlist [youlist randompid=”PL3FF15AA7ED356D9F, PL9AEE7FF9E83DEA62, PL2B8DB1BD4364033F”] To embed a playlist for all uploaded videos for the user “mismag822″ [youlist uid=”mismag822″ listtype=”user_uploads”] To embed a playlist for all favorite videos for the user “mismag822″ [youlist uid=”mismag822″ listtype=”user_favorites”] To embed a playlist width your own custom style [youlist pid=”PL3FF15AA7ED356D9F” style=”width:300px;height:400px;z-index:1;”] To embed a user playlist with all the supported attributes (default values shown): [youlist uid=”mismag822″ randompid=”” showinfo=”1″ width=”680″ height=”480″ class=”youlist” autohide=”2″ autoplay=”0″ disablekb=”0″ listtype=”user_uploads” theme=”dark” modestbranding=”1″ controls=”1″ color=”red” fs=”1″ rel=”1″ start=”0″ loop=”0″ iv_load_policy=”1″ version=”3″ style=”” vq=”” nocookie=”0″ https=”0″ wmode=”” parameters=”” ] Ideas for how to use this plugin You can use it to display ad-video before or after the main video You can have your own short trailer before the main video You can collect lessons/tutorials/music videos You can use it for your YouTube™ playlist You can watch your friends favourites videos You can collect videos for your kid and watch it on your site … etc … Shortcode Parameters The youList-shortcode is a wrapper for most of the YouTube™ iframe parameters described here: https://developers.google.com/youtube/player_parameters iframe parameters: width [integer] – iframe width in pixels height [integer] – iframe height in pixels class [string] – iframe css classname style [string] – iframe css custom style parameters [string] – custom source parameters (&param1=value1&…) youtube parameters: pid [string] – YouTube playlist ID uid [string] – YouTube user ID) vid [string] – Comma seperated YouTube Videos ID list randompid [string] – YouTube random playlist ID, from a comma seperated PID’s list listtype [playlist|user_uploads|search] – YouTube listtype search [string] – YouTube search string) theme [dark|light] – Dark or light control bar modestbranding [0|1] – Prevent the YouTube logo from displaying in the control bar showinfo [0|1] – Display thumbnail images for the videos in the playlist autohide [0|1|2] – Hide the video controls automatically after a video begins playing autoplay [0|1] – The initial video will autoplay when the player loads disablekb [0|1] – Disable the player keyboard controls controls [0|1|2] – Display the video player controls color [red|white] – The color in the video progress bar fs [0|1] – Display the fullscreen button rel [0|1] – Show related videos when playback of the initial video ends start [integer] – Play the video at the given number of seconds from the start of the video loop [0|1] – Play the entire playlist and then start again at the first video iv_load_policy [1|3] – Show video annotations version [2|3] – AS player version https [0|1] – Enable the https protocol nocookie [0|1] – No cookies thank you vq [small|medium|large|hd720|hd1080] – Change video quality