Template:SaintMedia/doc

Usage

This template defines the Cargo table `SaintMedia` and stores/displays metadata about media related to Catholic saints (e.g., podcasts, videos, audiobooks, social media) in an infobox. It is typically used via a form (e.g., Form:SaintMedia) or directly on media pages. The table is defined when the template is first saved, and subsequent uses store data. The infobox displays metadata, while media content (e.g., embedded video, audio, or social media post) should be added in the page body using the EmbedVideo extension.

Parameters

• Name: The title of the media (e.g., "The Life of St. Josephine Bakhita"). Defaults to page name.
• Type: The format of the media (e.g., Podcast, Video, Audiobook, Social Media). Defaults to "Video".
• AuthorCreator: The wiki page for the individual, organization, or channel producing the content (e.g., "Bishop Robert Barron", "Augustine Institute").
• Saint: The saint(s) featured (e.g., "St. Josephine Bakhita", "St. Peter, St. Paul"). Supports multiple values, separated by commas.
• SubscriptionRequired: Whether the content is free or requires a subscription (e.g., Free, Subscription). Defaults to "Free".
• Length: The duration of the media, with the following options:

 ** Under 5 minutes: Very short YouTube videos (e.g., Ascension Presents, Sensus Fidelium, 2–5 minutes) or brief podcast segments (e.g., Saint Stories for Kids). Ideal for bite-sized meditations or feast day highlights.
 ** 5–15 minutes: Short podcast episodes (e.g., Saint Stories for Kids, 10–15 minutes) and concise YouTube videos (e.g., Ascension Presents, 5–15 minutes). Suited for brief saint stories or family-friendly content.
 ** 15–30 minutes: Podcast episodes (e.g., Catholic Saints by Augustine Institute, ~23 minutes; Saints Alive, 20–30 minutes) and YouTube videos (e.g., Catholic Saints on FORMED, 15–30 minutes). Fits moderately detailed discussions or dramatized stories.
 ** 30–60 minutes: Longer podcast episodes (e.g., Catholic Classics, up to 53 minutes) and extended YouTube videos (e.g., Pints with Aquinas, 20–60 minutes). Represents in-depth talks or interviews.
 ** 1–3 hours: Extended YouTube content (e.g., Sensus Fidelium talks, 1–2 hours; The Counsel of Trent, up to 3 hours) and short audiobooks. Suitable for comprehensive lectures.
 ** Over 3 hours: Most audiobooks (e.g., The Confessions by St. Augustine, 12–15 hours; Diary of Saint Maria Faustina Kowalska, 18–22 hours) and long YouTube audiobook readings or livestreams (e.g., Pints with Aquinas livestreams). Reflects full-length biographies or spiritual writings.

• Language: The language of the media (e.g., English, Spanish, Italian, Other). Defaults to "English".
• TargetAudience: The intended audience (e.g., Kids, Adults, Everyone). Defaults to "Everyone".
• Tags: Categories for the media (e.g., Documentary, Sermon, Educational, Inspirational, Family-Friendly, Biography, Spirituality, Miracles, Patronage). Supports multiple values, separated by commas. Optional.

Example

{{SaintMedia
|Name=The Life of St. Josephine Bakhita
|Type=Video
|AuthorCreator=Catholic Online
|Saint=St. Josephine Bakhita
|SubscriptionRequired=Free
|Length=15–30 minutes
|Language=English
|TargetAudience=Everyone
|Tags=Documentary,Inspirational
}}
== Description ==
This video provides a 20-minute documentary on St. Josephine Bakhita’s journey from slavery to sainthood.

== Embedded Media ==
{{#ev:youtube|dQw4w9WgXcQ}}

Notes

• The Cargo table `SaintMedia` is defined when this template is saved. If it doesn’t appear in Special:CargoTables, use Special:CreateCargoTable with the #cargo_declare code or transclude on a setup page (e.g., SaintMediaSetup).
• Use Form:SaintMedia for easy data entry with page autocompletion for AuthorCreator and token input for Saint and Tags.
• Query the table using

Function: CargoSQLQuery::run Query: SELECT `cargo__SaintMedia`.`_pageID` AS `cargo_backlink_page_id_SaintMedia`,`Name` AS `Name`,`Type` AS `Type`,`Saint` AS `Saint`,`Tags__full` AS `Tags` FROM `cargo__SaintMedia` WHERE Saint HOLDS 'St. Josephine Bakhita' ORDER BY `cargo__SaintMedia`.`_pageID`,`Name`,`Type`,`Saint`,`cargo__SaintMedia`.`Tags__full` LIMIT 100

or No results for precise searches.

• The infobox displays metadata only. Embed media in the page body using EmbedVideo syntax.
• Ensure Cargo (3.0+), Page Forms, and EmbedVideo are properly configured in LocalSettings.php. Check EmbedVideo documentation for social media support (e.g., Twitter/X).