Restores the scheduled video refresh if its cron jobs have gone missing (site clone, cron clean-up, multisite), corrects the description of the Auto player, and fixes keyboard focus in the lightbox and slider.<\/p>","1.5.19":"
Fixes a case where a bad answer from YouTube could empty a channel's feed until the next refresh, and makes videos added by "Load More" follow the feed's player and display settings.<\/p>","1.5.18":"
Maintenance release: removes a Plugin Check warning introduced in 1.5.17. No change in behaviour.<\/p>","1.5.17":"
Fixes the "Load More" button disappearing on sites with a page cache, and channels being refreshed far less often than the refresh-interval setting says (especially with more than three channels).<\/p>","1.5.16":"
Shorts detection now uses the channel's Shorts list (YouTube's 3-minute Shorts were being missed and short regular videos mislabelled), and the "maxres" thumbnail setting now serves the real 1280\u00d7720 image. Run Refresh All to apply to cached videos.<\/p>","1.5.15":"
Hides never-aired live broadcast placeholders that showed up as dead cards and opened to a YouTube "player configuration error" (Error 153) when clicked. Live and upcoming streams are unaffected.<\/p>","1.5.14":"
Upcoming streams now drop off within an hour of their start time (was 6h) and no longer show a stale countdown. Also loads the stylesheet earlier to remove the flash of unstyled cards, plus admin polish.<\/p>","1.5.13":"
Fixes Load More returning wrong videos on channels\/feeds with live streams, keeps feed ids scoped when paginating, and stops sliders truncating when Load More is set.<\/p>","1.5.6":"
Fixes lightbox video playback in Firefox, Vivaldi, and on iPad. The lightbox no longer loads YouTube's IFrame API script, which was being blocked by tracker protection in those browsers.<\/p>","1.4.26":"
Fixes video playback not working on tablets (iPad) in portrait orientation when using the auto player mode.<\/p>","1.4.11":"
Fixes lightbox not visible on themes with CSS transform on body (The7, Visual Composer). Lightbox now renders outside all theme containers.<\/p>","1.4.10":"
Fixes lightbox player not appearing on themes with CSS transforms on content wrappers.<\/p>","1.4.9":"
YouTube embeds now use the privacy-enhanced youtube-nocookie.com domain, fixing playback in Vivaldi and other privacy-focused browsers.<\/p>","1.4.8":"
Fixes incorrect player default in admin shortcode reference. Adds Getting Started guide for new users on the Dashboard.<\/p>","1.4.7":"
Maintenance release with minor internal improvements.<\/p>","1.4.6":"
Fixes landscape mobile: play and lightbox buttons now work correctly on phones in landscape orientation.<\/p>","1.4.5":"
Channel reorder SQL now passes Plugin Check security validation.<\/p>","1.4.4":"
WordPress.org Plugin Review compliance: proper escaping, WP_Filesystem, directory silencers, block editor i18n, and license standardization.<\/p>","1.4.3":"
Channel reorder optimized to a single database query.<\/p>","1.4.2":"
Major quality update: fixes N+1 queries, timezone bugs, cache key collisions, and accessibility gaps. Adds REST API limits, Gutenberg slider layout, dark theme support, and timeout-safe batch refresh.<\/p>","1.4.1":"
RSS feed results are now cached for 15 minutes, significantly reducing HTTP requests during frequent live status checks.<\/p>","1.4.0":"
New Auto player adapts to screen size (lightbox on desktop, inline on mobile). Landscape mobile gets optimized layouts. Private\/deleted videos are now automatically purged from cache. Also adds tab navigation modes, Live Broadcast Boost, server cron guidance, and avatar strip.<\/p>","1.3.1":"
Smarter live stream ordering: streams closest to the current time now appear first, so imminent broadcasts are no longer buried below old or far-future scheduled streams.<\/p>","1.3.0":"
Live stream support: automatic detection of live and upcoming broadcasts, dedicated [sdawchfo_live] shortcode, RSS feed discovery, and import\/export for easy migration.<\/p>","1.2.0":"
Mobile experience upgrade: bottom sheet player, better touch navigation, and thumbnail loading fix for tabbed layouts.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3474789,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3474789,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3474789,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3474789,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.10","1.4.11","1.4.12","1.4.13","1.4.14","1.4.15","1.4.16","1.4.17","1.4.18","1.4.19","1.4.20","1.4.24","1.4.25","1.4.26","1.4.27","1.4.28","1.4.29","1.4.34","1.4.35","1.4.36","1.4.37","1.4.38","1.4.5","1.4.6","1.4.7","1.4.8","1.4.9","1.5.0","1.5.1","1.5.10","1.5.11","1.5.12","1.5.14","1.5.15","1.5.16","1.5.17","1.5.18","1.5.19","1.5.2","1.5.20","1.5.3","1.5.4","1.5.5","1.5.6","1.5.7","1.5.8","1.5.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3474789,"resolution":"1","location":"assets","locale":"","width":1200,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3474789,"resolution":"2","location":"assets","locale":"","width":1200,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3474789,"resolution":"3","location":"assets","locale":"","width":1200,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3474789,"resolution":"4","location":"assets","locale":"","width":1200,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3474789,"resolution":"5","location":"assets","locale":"","width":1200,"height":900},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3474789,"resolution":"6","location":"assets","locale":"","width":1200,"height":900}},"screenshots":{"1":"Dashboard with shortcode builder and channel status overview","2":"Grid layout displaying videos from a single channel","3":"Tabbed layout with multiple channels","4":"Lightbox video player with navigation","5":"Live and upcoming stream display with badges","6":"Admin settings page with customizable labels"}},"plugin_section":[],"plugin_tags":[5325,230,6302,222,1610],"plugin_category":[50,56],"plugin_contributors":[257114,256141],"plugin_business_model":[],"class_list":["post-285384","plugin","type-plugin","status-publish","hentry","plugin_tags-channel","plugin_tags-embed","plugin_tags-live-stream","plugin_tags-video","plugin_tags-youtube","plugin_category-media","plugin_category-social-and-sharing","plugin_contributors-rstake","plugin_contributors-sdaweb","plugin_committers-rstake"],"banners":{"banner":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/banner-772x250.png?rev=3474789","banner_2x":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/banner-1544x500.png?rev=3474789","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/icon-128x128.png?rev=3474789","icon_2x":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/icon-256x256.png?rev=3474789","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/screenshot-1.png?rev=3474789","caption":"Dashboard with shortcode builder and channel status overview"},{"src":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/screenshot-2.png?rev=3474789","caption":"Grid layout displaying videos from a single channel"},{"src":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/screenshot-3.png?rev=3474789","caption":"Tabbed layout with multiple channels"},{"src":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/screenshot-4.png?rev=3474789","caption":"Lightbox video player with navigation"},{"src":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/screenshot-5.png?rev=3474789","caption":"Live and upcoming stream display with badges"},{"src":"https:\/\/ps.w.org\/sdaweb-channels-for-youtube\/assets\/screenshot-6.png?rev=3474789","caption":"Admin settings page with customizable labels"}],"raw_content":"\n
SDAweb Channels for YouTube is a lightweight, privacy-friendly way to showcase YouTube content on your WordPress site. Add any number of public YouTube channels and display their videos using shortcodes or a Gutenberg block. Videos are cached locally so visitor page views consume zero API quota.<\/p>\n\n
[sdawchfo_live]<\/code> shortcode for live and upcoming content<\/li>\n- Live badge with concurrent viewer count and pulse animation<\/li>\n
- Upcoming badge with scheduled start time countdown<\/li>\n
- Toggleable \"Live now\" and \"Coming up\" section headings<\/li>\n
- Stale guard: upcoming streams auto-expire 1 hour after their scheduled start, live after 24 hours \u2014 no stuck statuses<\/li>\n
- 5-minute background polling keeps live status current (1-minute with Broadcast Boost)<\/li>\n
- Live Broadcast Boost \u2014 configurable day\/time window for 1-minute polling during scheduled broadcasts<\/li>\n
- Zero-quota RSS feed discovery catches scheduled broadcasts not in the uploads playlist<\/li>\n
- Live and upcoming streams are automatically excluded from regular shortcodes<\/li>\n<\/ul>\n\n
Channel Management<\/h4>\n\n\n- Add channels by URL, handle (@username), or channel ID<\/li>\n
- Drag-and-drop reordering controls tab and section display order<\/li>\n
- Custom labels per channel for friendly display names<\/li>\n
- Automatic video caching with configurable 1\u201324 hour refresh intervals (up to 3 channels per cron run)<\/li>\n
- Manual refresh per channel or all channels at once<\/li>\n
- Import and export channels and settings as JSON<\/li>\n<\/ul>\n\n
Shortcodes<\/h4>\n\n
Four shortcodes cover every use case:<\/p>\n\n
\n[sdawchfo_channel]<\/code> \u2014 Videos from a single channel (by id, handle, or label)<\/li>\n[sdawchfo_channels]<\/code> \u2014 Multiple channels in grid, tabs, or slider layout<\/li>\n[sdawchfo_feed]<\/code> \u2014 Combined feed mixing videos from all channels<\/li>\n[sdawchfo_live]<\/code> \u2014 Live and upcoming streams with empty-state message<\/li>\n<\/ul>\n\nAll shortcodes support these attributes: count<\/code>, columns<\/code>, layout<\/code>, sort<\/code>, player<\/code>, pagination<\/code>, per_page<\/code>, show_stats<\/code>, show_duration<\/code>, show_channel<\/code>, and live_only<\/code>.<\/p>\n\nAdditional Features<\/h4>\n\n\n- Gutenberg block with live preview and inspector controls<\/li>\n
- Shortcode builder in the admin dashboard \u2014 no coding required<\/li>\n
- Customizable frontend labels (26 strings) for full translation support<\/li>\n
- Customizable appearance: badge styles, button styles, tab colors, and time text colors with color pickers<\/li>\n
- Load More pagination with configurable batch size<\/li>\n
- Video stats: views, likes, duration, publish date<\/li>\n
- Detects and labels YouTube Shorts using the channel's own Shorts list (covers up-to-3-minute Shorts)<\/li>\n
- Up to 100 videos per channel with automatic API pagination<\/li>\n
- Import\/export for easy migration between sites<\/li>\n
- Tab navigation modes: scroll, wrapping pills, or avatar strip<\/li>\n
- REST API endpoints for custom and headless integrations<\/li>\n
- Server cron setup guidance in the admin settings<\/li>\n
- Channel name truncation setting for the avatar strip<\/li>\n
- Automatic cleanup of private and deleted videos from cache<\/li>\n
- Dark theme support via CSS custom property (--sdawchfo-card-bg)<\/li>\n
- Admin settings: tabbed Plugin Overview with 7 sections, quick-access links, and info tooltips explaining technical terms<\/li>\n<\/ul>\n\n
Privacy & Performance<\/h4>\n\n\n- All video data is cached in your local database<\/li>\n
- Visitor page views make zero external API calls<\/li>\n
- No cookies are set and no visitor data is sent to third parties<\/li>\n
- YouTube embeds use the privacy-enhanced
youtube-nocookie.com<\/code> domain<\/li>\n- YouTube embeds load only when a visitor clicks play<\/li>\n
- Lazy loading: thumbnail images load only when they scroll into view<\/li>\n<\/ul>\n\n
Third-Party Services<\/h3>\n\nYouTube Data API v3<\/h4>\n\n
This plugin connects to the YouTube Data API v3 to fetch channel information and video data. API calls are made server-side only when:<\/p>\n\n
\n- An admin adds or refreshes a channel<\/li>\n
- The scheduled cron refresh runs (configurable interval, default 6 hours)<\/li>\n
- The live status cron runs (every 5 minutes, or every 1 minute during a configured Broadcast Boost window)<\/li>\n<\/ul>\n\n
No API calls are made during normal visitor page views \u2014 all data is served from the local cache.<\/p>\n\n
\n- Service provider: Google LLC<\/li>\n
- API endpoint:
https:\/\/www.googleapis.com\/youtube\/v3<\/code><\/li>\n- YouTube API Terms of Service<\/a><\/li>\n
- Google Privacy Policy<\/a><\/li>\n<\/ul>\n\n
A YouTube Data API v3 key is required. You can obtain one for free from the Google Cloud Console<\/a>.<\/p>\n\nYouTube RSS Feeds<\/h4>\n\n
This plugin fetches public YouTube RSS feeds (https:\/\/www.youtube.com\/feeds\/videos.xml<\/code>) to discover recently published and scheduled videos. These requests are read-only, use no API quota, and contain only publicly available video IDs.<\/p>\n\n\n- Service provider: Google LLC (YouTube)<\/li>\n
- YouTube Terms of Service<\/a><\/li>\n
- Google Privacy Policy<\/a><\/li>\n<\/ul>\n\n
YouTube Embeds<\/h4>\n\n
When a visitor clicks play on a video, an iframe loads from YouTube's privacy-enhanced domain (youtube-nocookie.com<\/code>). No embed loads until the visitor initiates playback. No cookies are set by this domain.<\/p>\n\n\n- Service provider: Google LLC (YouTube)<\/li>\n
- YouTube Terms of Service<\/a><\/li>\n
- Google Privacy Policy<\/a><\/li>\n<\/ul>\n\n\n
\n- Upload the
sdaweb-channels-for-youtube<\/code> folder to \/wp-content\/plugins\/<\/code><\/li>\n- Activate the plugin through the Plugins menu in WordPress<\/li>\n
- Go to YouTube Channels > Settings<\/strong> and enter your YouTube Data API v3 key<\/li>\n
- Click Test Connection<\/strong> to verify the key works<\/li>\n
- Go to YouTube Channels > Dashboard<\/strong> or Channels<\/strong> to add your first channel<\/li>\n
- Use the Shortcode Builder<\/strong> on the Dashboard to generate shortcodes, or add the Gutenberg block<\/strong> in the editor<\/li>\n<\/ol>\n\n\n