2.3 KiB
YouTube
YouTube items are supported in Item pages via the video "display_template".
Provide the full YouTube video link in "object_location" field.
Use the API recipes below to fill in the "image_small" and "image_thumb" fields if desired.
Item page
The default video display_template will display the video embedded in an YouTube Player iframe.
It is styled using Bootstrap ratio class, set as 16x9 ratio (which is default for YouTube, however, if your videos differ significantly from that ratio try modifying the class in _includes/item/video-embed.html).
The embed is given these options:
- Privacy-enhanced mode: does not send data to YouTube unless users click play (enabled by using domain
www.youtube-nocookie.comrather thanwww.youtube.com - Related videos: the option
rel=0asks YouTube to not show related videos. However, YouTube changed this option in 2018 and may still show related videos from the same channel. - Modest branding: the option
modestbranding=1removes some YouTube branding from the iframe player.
Item images
The YouTube image API is not well documented by Google, but is used by many sites and js libraries.
Basically, you can get four sizes of the default thumbnail, or four smaller thumbnails from different points in the video. You can use the domain "img.youtube.com" or "i3.ytimg.com"
Default images:
- thumb 120x90, https://img.youtube.com/vi/{{ youtubeid }}/default.jpg
- medium quality 320x180, https://img.youtube.com/vi/{{ youtubeid }}/mqdefault.jpg
- high quality 480x360, https://img.youtube.com/vi/{{ youtubeid }}/hqdefault.jpg
- SD 640x480 (not available for all videos), https://img.youtube.com/vi/{{ youtubeid }}/sddefault.jpg
- max quality 1280×720 (or 1920x1080?, not available for all videos), https://img.youtube.com/vi/{{ youtubeid }}/maxresdefault.jpg
Auto thumbs:
- default thumb, 480x360, https://img.youtube.com/vi/{{ youtubeid }}/0.jpg
- alternate 120x90, https://img.youtube.com/vi/{{ page.youtubeid }}/1.jpg
- alternate 120x90, https://img.youtube.com/vi/{{ page.youtubeid }}/2.jpg
- alternate 120x90, https://img.youtube.com/vi/{{ page.youtubeid }}/3.jpg
For more control, you can use YouTube Data API, but it requires a key to access.