WP Manifestindependent plugin directory
manifest / media / dmf-media

DMF Media

WordPress plugin to display YouTube channel, playlist and video feeds with a Gutenberg block.

by David Martínez · github.com/damarfu/dmf-media · website

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/damarfu/dmf-media/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/damarfu/dmf-media ↗

Lightweight WordPress plugin to display YouTube channel videos using the official RSS feed.

DMF Media is designed to integrate perfectly with GeneratePress and GenerateBlocks, providing clean HTML and letting your theme control the layout.

Features

  • Displays the latest videos from a YouTube channel.
  • Displays videos from a public YouTube playlist.
  • Displays a specific YouTube video by ID or URL.
  • Uses the official YouTube RSS feed.
  • Lightweight cache system.
  • Responsive layout.
  • Integrated modal video player.
  • Autoplay on click.
  • ESC key and click outside to close.
  • Shortcode support.
  • Gutenberg block with live preview in the editor.
  • Minimal CSS, easy to customize.

Requirements

  • WordPress 6.7+
  • PHP 8.1+

Installation

  1. Upload the plugin.
  2. Activate it.
  3. Go to Settings → DMF Media.
  4. Configure your YouTube Channel ID and default video limit.
  5. Save changes.

Uninstall

Deleting the plugin from Plugins → Delete removes the dmf_media_settings option and the plugin transients (feeds, playlists and video metadata). Deactivating the plugin keeps the configuration and the cache.

Development

The plugin includes a small test suite with no external dependencies. It stubs the WordPress functions used by the plugin, so you do not need a WordPress installation or extra Composer packages:

php tests/run.php
# or
composer test

The suite covers the RSS parser, YouTube ID normalization, the resolver (limit, offset, caching and error paths), settings sanitization and block rendering.

Nota: .git/, .git-bak/, dist/ y tests/ son de desarrollo. Para instalar en una web, usa el ZIP de la release o copia solo los archivos del plugin; no copies .git ni .git-bak.

Configuration

Channel ID

The Channel ID is the unique identifier for a YouTube channel. It starts with UC, for example:

UCfoi0nD0pW_ipZOldgTrp4A

You can find it in a YouTube Studio or channel URL that contains /channel/UC....

YouTube handles such as @channelname are not supported as a Channel ID yet.

Default video limit

The default limit determines how many channel videos DMF Media displays when the shortcode does not include a limit attribute. The valid range is 1–15 videos, the maximum that YouTube delivers through its public RSS feed.

Shortcodes

Channel feed

Use the configured Channel ID and default limit:

[dmf_media]

Override the number of videos for one shortcode, from 1 to 15:

[dmf_media limit="3"]

Omitir los vídeos más recientes disponibles en el feed RSS antes de aplicar el límite:

[dmf_media offset="1" limit="5"]
[dmf_media offset="2" limit="5"]

offset="1" omite el vídeo más reciente; offset="2" omite los dos más recientes. Después se aplica limit para determinar cuántos vídeos se muestran. Este atributo funciona con feeds de canal y playlists, pero solo puede trabajar con los vídeos que YouTube proporciona mediante RSS: actualmente un máximo de 15, tanto en canales como en playlists. No se aplica al modo de vídeo manual.

Use another Channel ID without changing the default configuration:

[dmf_media channel="UCxxxxxxxxxxxxxxxx"]

YouTube playlist

Display videos from a public playlist by Playlist ID:

[dmf_media playlist="PLxxxxxxxx"]

You can also use a standard playlist URL, including m.youtube.com, watch?...&list= and embed/videoseries forms:

[dmf_media playlist="https://www.youtube.com/playlist?list=PLxxxxxxxx"]
[dmf_media playlist="https://www.youtube.com/watch?v=VIDEO_ID&list=PLxxxxxxxx"]

Besides PL playlists, DMF Media accepts uploads (UU), likes (LL), favourites (FL), mixes (RD) and album (OLAK5uy_) playlist IDs.

The limit attribute applies to playlists too. If it is omitted, DMF Media uses the configured default limit:

[dmf_media playlist="PLxxxxxxxx" limit="6"]

DMF Media reads public playlists through the YouTube RSS feed, so no API key is required. YouTube currently provides a maximum of 15 videos per playlist through this feed. The limit attribute can reduce that number, but cannot display more videos than YouTube provides.

Manual video

Display one specific video by ID:

[dmf_media video="VIDEO_ID"]

Display one specific video with a YouTube URL:

[dmf_media video="https://www.youtube.com/watch?v=VIDEO_ID"]

The video attribute also supports youtu.be, shorts, embed, live and m.youtube.com URLs.

Source priority

DMF Media uses sources in this order: video > playlist > channel.

When video is used, DMF Media displays only that video and ignores the playlist, channel and limit attributes:

[dmf_media video="VIDEO_ID" playlist="PLxxxxxxxx" channel="UCxxxxxxxx" limit="5"]

When playlist is used without video, DMF Media displays the playlist and ignores channel.

When offset is used, DMF Media skips that number of the most recent videos available in the YouTube RSS feed before applying limit:

[dmf_media offset="1" limit="5"]

YouTube currently provides a maximum of 15 videos through RSS, both for channels and public playlists. offset and limit can only work with those available videos.

Gutenberg block

DMF Media also provides the DMF Media block. It uses the same renderer, cache, modal and settings as the shortcode, and both can coexist on the same site.

  1. Edit a page or post and add the DMF Media block.
  2. In the block sidebar, choose the source: the channel configured in Settings → DMF Media, another channel, a public playlist or a single video.
  3. Adjust the number of videos and the offset if needed. A limit of 0 uses the value from Settings.

The block is dynamic: the video list is generated on every request, so new videos appear without editing the page. It supports wide and full alignment and can be placed inside GenerateBlocks containers and grids. The editor shows a live preview, but playback is tested on the frontend.

The block does not replace the shortcode. Use the block for new content edited in Gutenberg and the shortcode for widgets, PHP templates or existing content.

Philosophy

DMF Media focuses on content, not layout.

The plugin provides:

  • Video data
  • Thumbnails
  • Titles
  • Player

Your WordPress theme or block builder is responsible for the design.

Roadmap

v0.1

  • ✅ RSS Feed
  • ✅ Cache
  • ✅ Modal player
  • ✅ Responsive layout
  • ✅ Shortcodes

v0.2

  • ✅ Manual video by ID or YouTube URL
  • ✅ YouTube playlist support
  • ✅ offset attribute
  • ⏳ Support @channel
  • ⏳ Vimeo support

v0.3

  • ✅ Gutenberg block with live preview
  • ⏳ Presentation attributes (aspect ratio, card styles)
  • ⏳ Native developer hooks

License

GPL-2.0-or-later