SK Playlist Embed

Description

SK Playlist Embed lets you display YouTube channel videos and playlists on your WordPress site using the YouTube Data API v3. Choose from grid or list layouts with flexible columns (1-5), frontend pagination, and a centered video modal.

Features:

  • Display videos from any YouTube channel or playlist
  • Two layout options: Grid and List
  • Flexible columns (1-5) in grid layout
  • Responsive design — desktop, tablet, and mobile
  • Lightbox modal with autoplay
  • Lazy loading for optimal performance
  • Transient-based caching with configurable duration
  • WP-Cron auto-refresh support
  • Daily scheduled cache refresh
  • REST API endpoints for admin operations
  • Live preview in the admin settings
  • SEO-friendly markup
  • Shortcode: [skplem type="channel|playlist" id="YOUR_ID"]

Obtaining a YouTube API Key

  1. Go to the Google Cloud Console.
  2. Create a new project or select an existing one.
  3. Enable the YouTube Data API v3.
  4. Go to Credentials and create an API key.
  5. Copy the key and paste it in the plugin settings.

Shortcode Usage

Basic usage:

[skplem type="channel" id="UC_CHANNEL_ID"]

With all options:

[skplem type="playlist" id="PL_PLAYLIST_ID" layout="grid" columns="3" max="12" thumbnail="medium" title="yes" description="yes" show_count="yes" paginate="yes" per_page="12"]

Attributes:

  • typechannel or playlist (required)
  • id — YouTube channel ID or playlist ID (required)
  • layoutgrid or list (default: from settings)
  • columns — 1 to 5 (default: from settings)
  • max — max videos to show, 1 to 50 (default: from settings)
  • thumbnaildefault, medium, or high (default: from settings)
  • titleyes or no
  • descriptionyes or no
  • show_countyes or no
  • paginateyes or no
  • per_page — videos per page (default: 12)

External Services

This plugin uses the YouTube Data API v3 (operated by Google) to fetch video metadata from YouTube channels and playlists.

Data sent: When you enter a Channel ID or Playlist ID, the plugin sends that ID along with your API key to the YouTube Data API v3 to retrieve video titles, descriptions, thumbnails, and publish dates. No personal data is transmitted.

Service links:
* YouTube Terms of Service
* Google Privacy Policy
* YouTube Data API v3 Documentation

Installation

  1. Upload the sk-playlist-embed folder to /wp-content/plugins/.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Go to SK Playlist in your WordPress admin menu.
  4. Enter your YouTube Data API v3 key in the General tab.
  5. Click Test API to verify your key.
  6. Add your channel or playlist IDs in the Sources tab.
  7. Configure display settings in the Display tab.
  8. Use the shortcode [skplem type="channel" id="YOUR_CHANNEL_ID"] on any post or page.

FAQ

Do I need a YouTube API key?

Yes. The plugin uses the YouTube Data API v3, which requires a free API key from Google Cloud Console.

How many videos can I display?

You can display up to 50 videos per source. Set this in the plugin settings or via the max shortcode attribute.

Does the plugin cache API requests?

Yes. API responses are cached using WordPress transients. The default cache duration is 300 seconds (5 minutes) and is configurable in the settings.

Can I auto-refresh the cache?

Yes. Enable WP-Cron refresh in the Schedule tab and set your preferred interval. You can also schedule specific times for daily refresh.

Is the plugin responsive?

Yes. Videos are displayed in a responsive CSS grid that adapts to desktop, tablet, and mobile screens.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“SK Playlist Embed” is open source software. The following people have contributed to this plugin.

Contributors

Translate “SK Playlist Embed” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.6.0

  • Renamed plugin from “SK YouTube Embed” to “SK Playlist Embed”
  • Changed textdomain from sk-youtube-embed to sk-playlist-embed
  • Updated all @package annotations to SK_Playlist_Embed
  • Removed “YouTube” trademark from plugin display name
  • Added External Services section to readme.txt documenting YouTube Data API v3 usage
  • Added explicit type parameter to all register_setting() calls
  • Fixed Plugin URI returning 404
  • Renamed all prefixes from syep_/SYEP_ to skplem_/SKPLEM_ for uniqueness (options, functions, classes, constants, CSS classes, JS handles, REST routes, shortcode)

2.5.0

  • Playlist videos now sorted newest first by actual video publish date
  • Fetches up to 50 playlist items, sorts by video publish date, then limits to max_results

2.4.0

  • Renamed all classes from YEP_ to SKPLEM_ prefix for WordPress naming standards compliance
  • Fixed PHPCS class naming warnings

2.3.0

  • Modal now renders via wp_footer (always in DOM, survives content filtering)
  • Modal width set to 500px centered with close button
  • JS rewritten to create modal dynamically if missing from DOM
  • Fixed modal not opening when optimization plugins defer scripts

2.2.0

  • Fixed REST preview PHPCS escaping warnings
  • Fixed readme.txt stable tag and tested-up-to headers
  • Updated shortcode documentation in readme