Papaya design &amp; marketing

Sagar Gurnani

<p>Papaya YouTube Widget is a simple, lightweight plugin that provides you with a widget and a shortcode to include videos from a YouTube channel in your sidebar or on a page, a post or any custom content.</p>
<p>For simplicity’s sake, the design and layout is limited to one main video, followed by a grid.</p>
<p>To use this plugin, you will need a Google API Key and your YouTube Channel’s ID. Short descriptions of how to get these are included in the instructions. If you need more help, please refer to Google’s YouTube’s own documentation.</p>
<p>If you would like to customize the way this plugin works, or add features to it, consider hiring the plugin author.</p>


Papaya YouTube Widget

Simple, lightweight plugin that provides a widget and shortcode to include videos from a YouTube channel in your sidebar or on a page.

sdaweb

rstake

<p>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>
<h4>Layouts & Playback</h4>
<ul>
<li><strong>Grid</strong> — Responsive multi-column grid (1–4 columns)</li>
<li><strong>Tabs</strong> — Channel-tabbed interface with 3 navigation modes: scroll, wrapping pills, and avatar strip</li>
<li><strong>Slider</strong> — Horizontal carousel with arrow navigation</li>
<li><strong>Auto player</strong> (default) — Adapts to screen size: inline on desktop, lightbox on mobile phones</li>
<li><strong>Lightbox player</strong> — Fullscreen overlay with keyboard shortcuts (arrow keys, Escape), swipe gestures, and prev/next navigation</li>
<li><strong>Inline player</strong> — Play directly inside the video card with expand-to-lightbox</li>
<li><strong>Link mode</strong> — Opens videos on YouTube in a new tab</li>
<li><strong>Avatar strip</strong> — Compact row of channel avatars with labeled names and smart truncation</li>
<li><strong>Mobile bottom sheet</strong> — Touch-optimized player with swipe-to-dismiss</li>
<li><strong>Landscape mobile</strong> — Optimized layouts: horizontal cards for live streams, 2-column grid for regular content</li>
</ul>
<h4>Live & Upcoming Streams</h4>
<ul>
<li>Automatic detection of live broadcasts and scheduled upcoming streams</li>
<li>Smart sort order: live streams first, then all streams sorted by proximity to the current time — the most relevant broadcasts always appear first</li>
<li>Dedicated <code>[sdawchfo_live]</code> shortcode for live and upcoming content</li>
<li>Live badge with concurrent viewer count and pulse animation</li>
<li>Upcoming badge with scheduled start time countdown</li>
<li>Toggleable “Live now” and “Coming up” section headings</li>
<li>Stale guard: upcoming streams auto-expire after 6 hours, live after 24 hours — no stuck statuses</li>
<li>5-minute background polling keeps live status current (1-minute with Broadcast Boost)</li>
<li>Live Broadcast Boost — configurable day/time window for 1-minute polling during scheduled broadcasts</li>
<li>Zero-quota RSS feed discovery catches scheduled broadcasts not in the uploads playlist</li>
<li>Live and upcoming streams are automatically excluded from regular shortcodes</li>
</ul>
<h4>Channel Management</h4>
<ul>
<li>Add channels by URL, handle (@username), or channel ID</li>
<li>Drag-and-drop reordering controls tab and section display order</li>
<li>Custom labels per channel for friendly display names</li>
<li>Automatic video caching with configurable 1–24 hour refresh intervals (up to 3 channels per cron run)</li>
<li>Manual refresh per channel or all channels at once</li>
<li>Import and export channels and settings as JSON</li>
</ul>
<h4>Shortcodes</h4>
<p>Four shortcodes cover every use case:</p>
<ul>
<li><code>[sdawchfo_channel]</code> — Videos from a single channel (by id, handle, or label)</li>
<li><code>[sdawchfo_channels]</code> — Multiple channels in grid, tabs, or slider layout</li>
<li><code>[sdawchfo_feed]</code> — Combined feed mixing videos from all channels</li>
<li><code>[sdawchfo_live]</code> — Live and upcoming streams with empty-state message</li>
</ul>
<p>All shortcodes support these attributes: <code>count</code>, <code>columns</code>, <code>layout</code>, <code>sort</code>, <code>player</code>, <code>pagination</code>, <code>per_page</code>, <code>show_stats</code>, <code>show_duration</code>, <code>show_channel</code>, and <code>live_only</code>.</p>
<h4>Additional Features</h4>
<ul>
<li>Gutenberg block with live preview and inspector controls</li>
<li>Shortcode builder in the admin dashboard — no coding required</li>
<li>Customizable frontend labels (26 strings) for full translation support</li>
<li>Customizable appearance: badge styles, button styles, tab colors, and time text colors with color pickers</li>
<li>Load More pagination with configurable batch size</li>
<li>Video stats: views, likes, duration, publish date</li>
<li>Detects and labels YouTube Shorts</li>
<li>Up to 100 videos per channel with automatic API pagination</li>
<li>Import/export for easy migration between sites</li>
<li>Tab navigation modes: scroll, wrapping pills, or avatar strip</li>
<li>REST API endpoints for custom and headless integrations</li>
<li>Server cron setup guidance in the admin settings</li>
<li>Channel name truncation setting for the avatar strip</li>
<li>Automatic cleanup of private and deleted videos from cache</li>
<li>Dark theme support via CSS custom property (–sdawchfo-card-bg)</li>
<li>Admin settings: tabbed Plugin Overview with 7 sections, quick-access links, and info tooltips explaining technical terms</li>
</ul>
<h4>Privacy & Performance</h4>
<ul>
<li>All video data is cached in your local database</li>
<li>Visitor page views make zero external API calls</li>
<li>No cookies are set and no visitor data is sent to third parties</li>
<li>YouTube embeds use the privacy-enhanced <code>youtube-nocookie.com</code> domain</li>
<li>YouTube embeds load only when a visitor clicks play</li>
<li>Lazy loading: thumbnail images load only when they scroll into view</li>
</ul>
<h3>Third-Party Services</h3>
<h4>YouTube Data API v3</h4>
<p>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>
<ul>
<li>An admin adds or refreshes a channel</li>
<li>The scheduled cron refresh runs (configurable interval, default 6 hours)</li>
<li>The live status cron runs (every 5 minutes, or every 1 minute during a configured Broadcast Boost window)</li>
</ul>
<p>No API calls are made during normal visitor page views — all data is served from the local cache.</p>
<ul>
<li>Service provider: Google LLC</li>
<li>API endpoint: <code>https://www.googleapis.com/youtube/v3</code></li>
<li><a href="https://developers.google.com/youtube/terms/api-services-terms-of-service" rel="nofollow ugc">YouTube API Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
</ul>
<p>A YouTube Data API v3 key is required. You can obtain one for free from the <a href="https://console.cloud.google.com/apis/credentials" rel="nofollow ugc">Google Cloud Console</a>.</p>
<h4>YouTube RSS Feeds</h4>
<p>This plugin fetches public YouTube RSS feeds (<code>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>
<ul>
<li>Service provider: Google LLC (YouTube)</li>
<li><a href="https://www.youtube.com/t/terms" rel="nofollow ugc">YouTube Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
</ul>
<h4>YouTube Embeds</h4>
<p>When a visitor clicks play on a video, an iframe loads from YouTube’s privacy-enhanced domain (<code>youtube-nocookie.com</code>). No embed loads until the visitor initiates playback. No cookies are set by this domain.</p>
<ul>
<li>Service provider: Google LLC (YouTube)</li>
<li><a href="https://www.youtube.com/t/terms" rel="nofollow ugc">YouTube Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
</ul>
<h4>YouTube IFrame Player API</h4>
<p>When a visitor opens the lightbox player, the YouTube IFrame Player API script (<code>https://www.youtube.com/iframe_api</code>) is loaded to enable programmatic playback control (mute/unmute toggle). This script is only loaded when the lightbox is first opened — not on page load. No data is sent to YouTube beyond what the standard embed already transmits.</p>
<ul>
<li>Service provider: Google LLC (YouTube)</li>
<li>API documentation: <a href="https://developers.google.com/youtube/iframe_api_reference" rel="nofollow ugc">YouTube IFrame Player API</a></li>
<li><a href="https://www.youtube.com/t/terms" rel="nofollow ugc">YouTube Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
</ul>


SDAweb Channels for YouTube

Display YouTube channels with grids, tabs, sliders, live stream badges, and lightbox playback.

Papaya YouTube Widget vs SDAweb Channels for YouTube