YouTube Channel
Add to ListAdd My YouTube Channel widget to the widget area or shortcode to post/page content, set Channel ID or Playlist ID, chose resource to use and keep defaults for all other options. And voila! You will get the latest video from chosen YouTube channel or playlist.
IMPORTANT My YouTube Channel does not support Live Streams and does not have Gutenberg Block. Use Shortcode Block or Classic Block to insert shortcode to page/post content.
If you like our plugin and find it useful, please write a review and rate it.
For a manually picked set of videos from YouTube, check out Easy YouTube Gallery.
Features
- Show latest videos from My YouTube Channel (ordered in reverse chronological order related to the creation date), or from Playlist
- Option to get a random video from any of two resources
- Responsive (one full-width video per row) or non-responsive
- Preferred aspect ratio relative to width (16:9 and 4:3)
- Custom width for video embeded object (default is 306px)
- Four modes to display video: thumbnail (
default), HTML5 (iframe), HTML5 Asynchronous (iframe2) abd Playlist Embed (playlist) - Thumbnail mode opens the video in lightbox
- [NEW] Optionally store thumbnail images locally for improved speed performance and cache policy
- Enhanced Privacy – please note that display mode HTML5 (IFRAME) Asynchronous (shortcode parameter
iframe2) does not support Enhanced Privacy due to YouTube API limitations - Hide or show video title above/below/inside video wrapped to HTML tag by your choice (h3, h4, h5, span or div)
- Custom feed caching timeout
- Optional video autoplay with optional muted audio
- (Optional) TinyMCE button on post/page edit (can be disabled on General plugin settings page), which open a shortcode GUI generator to help you build a shortcode
- Show link to channel/handle below videos (vanity and legacy username are deprecated since v3.23.0)
- Final look is highly customisable thanks to classes for each element of YTC block!
Requirements
For a fully functional plugin, PHP 7.4 or newer has required! If you use older PHP, we highly recommend you request from your developer, server support or hosting company to update PHP to a secure version.
Styling
Use Customizer, style.css from the child theme or Head & Footer Code plugin to custom style and tweak the look and feel of the My YouTube Channel blocks. You can utilise the following classes:
.widget_youtube-channel– class of whole widget (parent for widget title and YTC block).youtube_channel– YTC block wrapper class. Additional classes are available:.default– for non-responsive block.responsive– when you have enabled responsive option
.ytc_title– class for video title container above thumbnail/video object.ytc_title_above– additional class for video title above video/thumbnail.ytc_title_below– additional class for video title below video/thumbnail.ytc_title_inside– additional class for video title printed inside of the thumbnail.ytc_title_inside_bottom– additional class for bottom aligned video title printed inside of the thumbnail
.ytc_video_container– class of container for single item, plus:.ytc_video_1,.ytc_video_2, … – class of container for single item with ordering number of item in widget.ytc_video_first– class of first container for single item.ytc_video_mid– class of all other containers for single item.ytc_video_last– class of last container for single item.ar16_9– class for Aspect Ratio 16:9.ar4_3– class for Aspect Ration 4:3
.ytc_thumb– class of anchor for Thumbnail mode.fluid-width-video-wrapper– class for parent element of IFRAME for enabled responsive.ytc_description– class for video description text below thumbnail/video object.ytc_link– class of container for link to channel
Known Issues
- Video title and description for embedded playlist mode do not work.
- Removing the YouTube logo from the playback control bar does not work for all videos.
- Autoplay does not work always
If WordFence or other malware scan tool detect My YouTube Channel file youtube-channel.php as a potential risk because base64_encode() and base64_decode() functions, remember that we use this two functions to store and restore JSON feeds to transient cache, so potential detection is false positive.
Credits
- For playing videos in lightbox we use Bigger Picture.
Shortcode
Along with Widget, you can add My YouTube Channel block inline by using shortcode [youtube_channel]. Default plugin parameters will be used for shortcode, but you can customize all parameters per shortcode.
General Settings
class(string) Set custom class if you wish to target special styling for specific YTC blockchannel(string) ID of preferred YouTube channel. Do not set full URL to channel, but just last part from URL – ID (name)handle(string) defined custom handle from YouTube handlevanity(string) DEPRECATED part after www.youtube.com/c/ from Custom URLusername(string) DEPRECATED Optional legacy YouTube username.playlist(string) ID of preferred YouTube playlist.resource(int) Resource to use for feed:0Channel (User uploads)1DEPRECATED Favorites (for defined channel)2Playlist3DEPRECATED Liked Videos
cache(int) Period in seconds for caching feed. You can disable caching by setting this option to 0, but if you have a lot of visits, consider at least short caching (couple minutes).fetch(int) Number of videos that will be used as stack for random pick (min 2, max 50)num(int) Number of videos to display per YTC block.random(bool) Option to randomize videos on every page load.
Video Settings
ratio(int) Set preferred aspect ratio for thumbnail and video. You can use:316:9 (widescreen)14:3
responsive(bool) Distribute one full width video per row.width(int) Width of thumbnail and video in pixels.display(string) Object that will be used to represent video. We have couple predefined options:thumbnailThumbnail will be used and video will be loaded in lightbox. (default)iframeHTML5 (iframe)iframe2HTML5 (iframe) with asynchronous loading – recommendedplaylistEmbedded playlist (same behaviour as old functiononly_pl)
thumb_quality(string) Define image quality for thumbnail display mode. Default ishqdefault, available:defaultDefault Quality (120x90px)mqdefaultMedium Quality (320x180px)hqdefaultHigh Quality (480x360px)sddefaultStandard Definition (640x480px)maxresdefaultMaximum Resolution (1280x720px)
no_thumb_title(bool) By default YouTube thumbnail will have tooltip with info about video title and date of publishing. By setting this option to 1 or true you can hide tooltipthemelight(bool) By default YouTube have dark play controls theme. By setting this option to 1 or true you can get light theme in player (HTML5 and Flash)controls(bool) Set this option to 1 or true to hide playback controls.autoplay(bool) Enable autoplay of first video in YTC video stack by setting this option to 1 or truemute(bool) Set this option to 1 or true to mute videos set to autoplay on loadnorel(bool) Set this option to 1 or true to hide related videos after finished playbaknobrand(bool) Set this option to 1 or true to hide YouTube logo from playback control barnolightbox(bool) Set this option to 1 or true to prevent YTC block with thumbnail to open in lightbox. If you have other plugin that trigger youtube links for lightbox, that one will steal links from this YTC block.target(string) If you enable nolightbox for specific YTC block, you can force opening of thumbnail links in new tab/window if you set this shortcode option to_blankliketarget="_blank".
Content Layout
showtitle(string):none– Hide titleabove– Display title above video/thumbnailbelow– Display title below video/thumbnailinside– Display top aligned title inside thumbnail; ifdisplayis notthumbnailthen treat asaboveinside_b– Display bottom aligned title inside thumbnail; ifdisplayis notthumbnailthen treat asbelow
titletag– Video title HTML tag to wrap title (H3, H4, H5, div, span, strong, etc)showdesc(bool) Set to 1 or true to show video description.desclen(int) Set number of characters to cut down length of video description. Set to 0 to use full length description.noinfo(bool) Set to 1 or true to hide overlay video infos (from embedded player)noanno(bool) Set to 1 or true to hide overlay video annotations (from embedded player)
Link to Channel
goto_txt(string)popup(int) Control where link to channel will be opened:0open link in same window1DEPRECATED open link in new window with JavaScript2open link in new window with target=”_blank” anchor attribute
link_to(string) URL to link:noneHide link (defult)handleYouTube handle URLchannelChannel pagevanityDEPRECATED Vanity custom URLlegacyDEPRECATED Legacy username page
Please note, to enhance plugin functionality, we can change or deprecate some shortcode parameters in future.
Filter hooks
You can modify final output of video block by hooking to filter ytc_print_video.
Four parameters are provided:
video_content– HTML of original video blockitem– YouTube video object which contains:snippet->publishedAt– date of publishing YouTube videoshippet->title– YouTube video titleshippet->description– YouTube video descriptionsnippet->resourceId->videoId– YouTube video ID
instance– Current My YouTube Channel Block parameters, including global settings:handlechannelvanityDEPRECATEDusernameDEPRECATEDplaylistresourcecachefetchnumskipprivacyratiowidthresponsivedisplayfullscreencontrolsautoplayautoplay_mutenorelplaysinlineshowtitletitletagshowdescdesclenmodestbrandinghideannogoto_txtpopup_gotolink_totinymcenolightboxapikeythumb_qualitytimeoutrandomno_thumb_titleclasstarget
y– order number of video (1for first,2for second, etc)
Example:
add_filter( 'ytc_print_video', 'customized_ytc_print_video', 10, 4 );
function customized_ytc_print_video( $video_block, $item, $instance, $y ) {
// Do whatever you wish to do
// ...
return $video_block;
}
