Media Feeds & Podcast RSS — Developer Guide & Admin UI
1. Installation & Peer Setup
Section titled “1. Installation & Peer Setup”pnpm add @vicacha-devs/strapi-plugin-media-feeds2. Server Configuration (config/plugins.ts)
Section titled “2. Server Configuration (config/plugins.ts)”Add the plugin configuration to your Strapi v5 config/plugins.ts file:
export default ({ env }: { env: (key: string, defaultValue?: string) => string }) => ({ "media-feeds": { enabled: true, config: { podcastTitle: env("PODCAST_TITLE", "Community Lectures"), podcastLanguage: "es", }, },});
3. Strapi v5 Admin UI Tour
Section titled “3. Strapi v5 Admin UI Tour”Once enabled, the plugin registers its workspace and settings inside the Strapi v5 Admin panel using Strapi Design System v2 components:

Key Localized Admin UI Labels
Section titled “Key Localized Admin UI Labels”| Translation Key | Rendered UI Label |
|---|---|
common.disabled |
Disabled |
common.enabled |
Enabled |
common.remove |
Remove |
field.author_organization |
Author / Organization |
field.default_locale |
Default Locale |
field.live_broadcast_title |
Live Broadcast Title |
field.live_event_slug |
Linked Event Slug (Optional) |
field.live_schedule_label |
Schedule / Broadcast Window Label |
4. Content-Type Entities, Locations & Schemas (strapi.documents)
Section titled “4. Content-Type Entities, Locations & Schemas (strapi.documents)”Registers two localized, draft-and-publish Collection Types (plugin::media-feeds.media-item and plugin::media-feeds.media-series). Media Series group episodes into podcast shows or video playlists; Media Items store multi-language audio/video episodes, OEmbed metadata, audio enclosures, transcripts, and chapter markers. Supports schemaExtensions in config/plugins.ts.
Where to Find Content-Type Entities in Strapi v5
Section titled “Where to Find Content-Type Entities in Strapi v5”- Content Manager:
/admin/content-manager/collection-types/plugin::media-feeds.media-item&/admin/content-manager/collection-types/plugin::media-feeds.media-series(visible: true) - Content-Type Builder:
/admin/plugins/content-type-builderunder Collection Types (Media Episode & Feed Item&Media Series & Podcast Show) - Plugin Workspace & Settings:
/admin/plugins/media-feeds(Episode Hub, Series, OEmbed Enricher, Live Stream Control) and/admin/settings/media-feeds - Database Tables:
media_feed_itemsandmedia_feed_series
plugin::media-feeds.media-item — Media Episode & Feed Item
Section titled “plugin::media-feeds.media-item — Media Episode & Feed Item”Generic multi-language video, podcast, audio lecture, YouTube item, or live broadcast
Kind:
collectionType· DB Table:media_feed_items· Admin Location:/admin/content-manager/collection-types/plugin::media-feeds.media-item· Draft & Publish:Yes· i18n:Yes
| Attribute | Strapi Type | Required | Constraints / Target |
|---|---|---|---|
title |
string |
Yes | — |
slug |
uid |
Yes | — |
description |
text |
Yes | — |
transcript |
richtext |
No | — |
type |
string |
Yes | default: "video" |
provider |
enumeration |
No | enum: youtube, spotify, apple_podcasts, vimeo, soundcloud, direct, upload; default: "youtube" |
externalId |
string |
No | — |
sourceUrl |
string |
No | — |
embedUrl |
string |
No | — |
speaker |
string |
No | — |
speakerSlug |
string |
No | — |
seriesSlug |
string |
No | — |
duration |
string |
No | — |
publishedAtLabel |
string |
No | — |
imageUrl |
string |
No | — |
imageAlt |
string |
No | — |
thumbnail |
media |
No | — |
audioFile |
media |
No | — |
transcriptFile |
media |
No | — |
spokenLanguages |
json |
No | default: ["es"] |
languageTracks |
json |
No | default: [] |
chapters |
json |
No | default: [] |
featured |
boolean |
No | default: false |
isLive |
boolean |
No | default: false |
plugin::media-feeds.media-series — Media Series & Podcast Show
Section titled “plugin::media-feeds.media-series — Media Series & Podcast Show”Generic multi-language podcast show, video playlist, or lecture series
Kind:
collectionType· DB Table:media_feed_series· Admin Location:/admin/content-manager/collection-types/plugin::media-feeds.media-series· Draft & Publish:Yes· i18n:Yes
| Attribute | Strapi Type | Required | Constraints / Target |
|---|---|---|---|
title |
string |
Yes | — |
slug |
uid |
Yes | — |
description |
text |
Yes | — |
author |
string |
No | — |
coverImageUrl |
string |
No | — |
category |
string |
No | default: "Education" |
defaultType |
string |
No | default: "podcast" |
spokenLanguages |
json |
No | default: ["es","en","ar","tr"] |
rssEnabled |
boolean |
No | default: true |
youtubePlaylistId |
string |
No | — |
spotifyShowUrl |
string |
No | — |
applePodcastsUrl |
string |
No | — |
active |
boolean |
No | default: true |
Strapi v5 Content Manager Integration (/admin/content-manager)
Section titled “Strapi v5 Content Manager Integration (/admin/content-manager)”Content Manager Sidebar Group:
Media, Resources & Library
Content Manager Entities & Components
Section titled “Content Manager Entities & Components”plugin::media-feeds.media-item(Media Episode & Feed Item —/admin/content-manager/collection-types/plugin::media-feeds.media-item)plugin::media-feeds.media-series(Media Series & Podcast Show —/admin/content-manager/collection-types/plugin::media-feeds.media-series)

Why This Plugin Creates & Integrates Content Manager Entities
Section titled “Why This Plugin Creates & Integrates Content Manager Entities”@vicacha-devs/strapi-plugin-media-feeds registers Media Episode & Feed Item (plugin::media-feeds.media-item) and Media Series & Podcast Show (plugin::media-feeds.media-series) with i18n.localized: true, draftAndPublish: true, and content-manager.visible: true so media producers can manage multilingual episodes, transcripts, and speaker relations in Content Manager:
- Multilingual (
i18n) Episode & Podcast Show Publishing: Localize episode titles, summaries, full transcripts, and chapter markers acrossen,es,ar, andtr(?plugins[i18n][locale]=en). - Relational Speaker & Series Linking: Link episodes in Content Manager to
Staff, Scholar & Author(api::leader.leader) profiles viaschemaExtensionsand group them underMedia Series & Podcast Show(seriesSlug). - Draft Staging Before Podcast RSS Syndication: Only
Publishedplugin::media-feeds.media-itemrecords are emitted in/api/media-feeds/podcast.xml, allowing producers to stage upcoming episodes inDraftstatus inside Content Manager.
How to Use in Strapi Content Manager (Step-by-Step)
Section titled “How to Use in Strapi Content Manager (Step-by-Step)”- Open in Content Manager: In the left sidebar, click Content Manager -> Collection Types -> Media, Resources & Library and select Media Episode & Feed Item (
/admin/content-manager/collection-types/plugin::media-feeds.media-item?plugins[i18n][locale]=en) or Media Series & Podcast Show (/admin/content-manager/collection-types/plugin::media-feeds.media-series). - Create Podcast Shows & Video Series: In Media Series & Podcast Show, define
title,slug,author,coverUrl,itunesCategory, andrssEnabled. - Publish Multilingual Episodes: In Media Episode & Feed Item, populate
title,slug,mediaType(video,audio,podcast,khutbah,live),sourceUrl,audioEnclosureUrl,durationSeconds, andtranscript, then click Publish. - Workspace vs. Content Manager: Use Content Manager for multilingual transcript authoring, draft staging, and speaker relations; use the Media Feeds Workspace (
/admin/plugins/media-feeds) for 1-click SSRF-safe YouTube/Vimeo OEmbed enrichment and live stream banner toggling.
Content Manager & Plugin Workspace Synchronization
Section titled “Content Manager & Plugin Workspace Synchronization”Content Manager Use Cases & Editorial Workflows
Section titled “Content Manager Use Cases & Editorial Workflows”Content Manager Use Case 1 — Staging & Translating Friday Khutbahs and Podcast Episodes
Section titled “Content Manager Use Case 1 — Staging & Translating Friday Khutbahs and Podcast Episodes”- Why & What it is for: Author English, Spanish, and Arabic episode descriptions, chapter markers, and transcripts in Content Manager before publishing to Apple Podcasts and Spotify.
- How to use in Content Manager: Open
/admin/content-manager/collection-types/plugin::media-feeds.media-item?plugins[i18n][locale]=en, editJumu'ah Khutbah: Mercy and Coexistence, switch locales, and click Publish.
5. End-to-End Use Cases & Workflows
Section titled “5. End-to-End Use Cases & Workflows”Use Case 1 — Apple Podcasts & Spotify iTunes RSS 2.0 XML Syndication
Section titled “Use Case 1 — Apple Podcasts & Spotify iTunes RSS 2.0 XML Syndication”- What it is for: Automatically generate standards-compliant podcast RSS feeds with
<itunes:image>,<enclosure>, duration, and per-series filtering. - How it works: Organize
plugin::media-feeds.media-itemrecords under aplugin::media-feeds.media-series(rssEnabled: true) and syndicateGET /api/media-feeds/podcast.xmlorGET /api/media-feeds/podcast/{seriesSlug}.xml.

Use Case 2 — SSRF-Hardened YouTube, Vimeo & Spotify OEmbed Auto-Enrichment
Section titled “Use Case 2 — SSRF-Hardened YouTube, Vimeo & Spotify OEmbed Auto-Enrichment”- What it is for: Allow editors to paste a YouTube or Vimeo URL and automatically populate episode title, thumbnail, embed URL, and provider ID.
- How it works: In
/admin/plugins/media-feeds, triggerPOST /media-feeds/enrich(which validates hostnames against SSRF private IP ranges) before savingplugin::media-feeds.media-item.

Use Case 3 — Live Broadcast Status Banner & Stream Switcher
Section titled “Use Case 3 — Live Broadcast Status Banner & Stream Switcher”- What it is for: Toggle a live khutbah, lecture, or webinar stream on the website header with real-time status polling.
- How it works: Mark an episode
isLive: trueor update live stream settings in/admin/plugins/media-feeds, and pollGET /api/media-feeds/livefrom the frontend.

6. REST API Endpoints (content-api & admin)
Section titled “6. REST API Endpoints (content-api & admin)”| Method | Endpoint Path | Scope | Controller Handler | Auth |
|---|---|---|---|---|
GET |
/media-feeds/overview |
admin |
admin.getOverview |
Bearer JWT |
GET |
/media-feeds/settings |
admin |
admin.getSettings |
Bearer JWT |
PUT |
/media-feeds/settings |
admin |
admin.updateSettings |
Bearer JWT |
POST |
/media-feeds/enrich-url |
admin |
admin.enrichUrl |
Bearer JWT |
POST |
/media-feeds/sync-youtube |
admin |
admin.syncYouTube |
Bearer JWT |
GET |
/api/media-feeds/episodes |
content-api |
content-api.listEpisodes |
Public |
GET |
/api/media-feeds/episodes/{slug} |
content-api |
content-api.getEpisodeBySlug |
Public |
GET |
/api/media-feeds/series |
content-api |
content-api.listSeries |
Public |
GET |
/api/media-feeds/live |
content-api |
content-api.getLiveStatus |
Public |
GET |
/api/media-feeds/rss.xml |
content-api |
content-api.getRssXml |
Public |
GET |
/api/media-feeds/podcast.xml |
content-api |
content-api.getRssXml |
Public |
7. Programmatic Server Usage (strapi.plugin & strapi.documents)
Section titled “7. Programmatic Server Usage (strapi.plugin & strapi.documents)”// Registered services on plugin "media-feeds": "settings", "feedService", "syncService"const pluginService = strapi.plugin("media-feeds")?.service("feedService");
// Querying records via the Strapi v5 Document Service APIconst records = await strapi.documents("plugin::media-feeds.media-item").findMany({ limit: 25, sort: "createdAt:desc",});8. Troubleshooting & Verification
Section titled “8. Troubleshooting & Verification”- Admin panel changes not visible: Run
pnpm strapi buildafter modifyingconfig/plugins.ts. - Peer dependency isolation: Keep
hoistPattern: ["*", "!@strapi/*"]inpnpm-workspace.yamlso@strapi/*contexts are never duplicated. - TypeScript type-checking: Validate both
admin/tsconfig.jsonandserver/tsconfig.jsonviapnpm --filter <pkg> test:ts.