Template:SaintMedia: Difference between revisions

Jump to navigation Jump to search
no edit summary
(author as link)
No edit summary
Line 1: Line 1:
<noinclude>
<noinclude>
{{#template_params:Name
{{#template_params:Name
|Type (placeholder=Audio,Video,Podcast|default=Video)
|Type (placeholder=Podcast,Video,Audiobook,Social Media|default=Video)
|AuthorCreator (default=Unknown)
|AuthorCreator
|Saint
|Saint
|SubscriptionRequired (placeholder=Free,Subscription|default=Free)
|SubscriptionRequired (placeholder=Free,Subscription|default=Free)
|Focus (placeholder=Biography,Spirituality,Miracles,Patronage,Modern Relevance)
|Length (placeholder=Under 5 minutes,5–15 minutes,15–30 minutes,30–60 minutes,1–3 hours,Over 3 hours)
|DateAdded
|Language (placeholder=English,Spanish,Italian,Other|default=English)
|TargetAudience (placeholder=Kids,Adults,Everyone|default=Everyone)
|Tags (placeholder=Documentary,Sermon,Educational,Inspirational,Family-Friendly,Biography,Spirituality,Miracles,Patronage)
}}
}}


Line 13: Line 15:
|Type=Text
|Type=Text
|AuthorCreator=Page
|AuthorCreator=Page
|Saint=Text
|Saint=List (,) of String
|SubscriptionRequired=Text
|SubscriptionRequired=Text
|Focus=Text
|Length=Text
|DateAdded=Date
|Language=Text
|TargetAudience=Text
|Tags=List (,) of String
}}
}}
</noinclude>
</noinclude>
Line 26: Line 30:
|Saint={{{Saint|}}}
|Saint={{{Saint|}}}
|SubscriptionRequired={{{SubscriptionRequired|}}}
|SubscriptionRequired={{{SubscriptionRequired|}}}
|Focus={{{Focus|}}}
|Length={{{Length|}}}
|DateAdded={{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY}}
|Language={{{Language|}}}
|TargetAudience={{{TargetAudience|}}}
|Tags={{{Tags|}}}
}}
}}


Line 45: Line 51:
|label5 = Subscription Required
|label5 = Subscription Required
|data5 = {{{SubscriptionRequired|Free}}}
|data5 = {{{SubscriptionRequired|Free}}}
|label6 = Focus
|label6 = Length
|data6 = {{{Focus|}}}
|data6 = {{{Length|}}}
|label7 = Added on
|label7 = Language
|data7 = {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY}}
|data7 = {{{Language|English}}}
|label8 = Target Audience
|data8 = {{{TargetAudience|Everyone}}}
|label9 = Tags
|data9 = {{{Tags|}}}
}}
}}


Line 55: Line 65:
<noinclude>
<noinclude>
== Usage ==
== Usage ==
This template defines the Cargo table `SaintMedia` and stores/displays metadata about media related to Catholic saints (e.g., podcasts, videos, audiobooks) 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. Only the infobox is displayed, with no section heading or media content.
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 ===
=== Parameters ===
* '''Name''': The title of the media (e.g., "The Life of St. Teresa of Avila"). Defaults to page name.
* '''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., Audio, Video, Podcast). Defaults to "Video".
* '''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"). Defaults to "Unknown".
* '''AuthorCreator''': The wiki page for the individual, organization, or channel producing the content (e.g., "Bishop Robert Barron", "Augustine Institute").
* '''Saint''': The primary saint(s) featured (e.g., "St. Augustine", "St. Joan of Arc").
* '''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".
* '''SubscriptionRequired''': Whether the content is free or requires a subscription (e.g., Free, Subscription). Defaults to "Free".
* '''Focus''': The content’s angle (e.g., Biography, Spirituality, Miracles, Patronage, Modern Relevance). Optional.
* '''Length''': The duration of the media, with the following options:
* '''DateAdded''': Automatically set to the current date.
  ** '''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 ===
=== Example ===
<pre>
<pre>
{{SaintMedia
{{SaintMedia
|Name=The Life of St. Teresa of Avila
|Name=The Life of St. Josephine Bakhita
|Type=Video
|Type=Video
|AuthorCreator=Augustine Institute
|AuthorCreator=Catholic Online
|Saint=St. Teresa of Avila
|Saint=St. Josephine Bakhita
|SubscriptionRequired=Subscription
|SubscriptionRequired=Free
|Focus=Spirituality
|Length=15–30 minutes
|Language=English
|TargetAudience=Everyone
|Tags=Documentary,Inspirational
}}
}}
{{#ev:youtube|dQw4w9WgXcQ}}
This video provides a 20-minute documentary on St. Josephine Bakhita’s journey from slavery to sainthood.
</pre>
</pre>
To embed media in the page body using EmbedVideo:
* YouTube: <code>{{#ev:youtube|dQw4w9WgXcQ}}</code> (replace with actual video ID).
* Vimeo: <code>{{#ev:vimeo|example}}</code>.
* Audio: <code>{{#ev:audio|https://example.com/audio.mp3}}</code> (for uploaded or external audio files).
* Social Media: For platforms like X, use <code>{{#ev:twitter|123456789}}</code> (replace with tweet ID, if supported by EmbedVideo).


=== Notes ===
=== Notes ===
* The Cargo table `SaintMedia` is defined when this template is saved. If the table doesn’t appear in Special:CargoTables, use Special:CreateCargoTable with the #cargo_declare code or transclude on a setup page (e.g., SaintMediaSetup).
* 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.
* Use [[Form:SaintMedia]] for easy data entry with page autocompletion for AuthorCreator and token input for Saint and Tags.
* Query the table using {{#cargo_query:tables=SaintMedia|fields=Name,Type,AuthorCreator,Saint|where=Saint LIKE '%Teresa%'}} to retrieve data.
* Query the table using {{#cargo_query:tables=SaintMedia|fields=Name,Type,Saint,Tags|where=Saint HOLDS 'St. Josephine Bakhita'}} or {{#cargo_query:tables=SaintMedia|fields=Name,Tags|where=Tags HOLDS 'Documentary'}} for precise searches.
* The template displays only an infobox with metadata, without a section heading or media content.
* The infobox displays metadata only. Embed media in the page body using EmbedVideo syntax.
* The infobox uses the `{{Infobox}}` template for a standardized appearance, with AuthorCreator linked to its wiki page.
* 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).
* If errors persist, check Cargo version (3.0+ recommended) and permissions in LocalSettings.php.


[[Category:Templates]]
[[Category:Templates]]
</noinclude>
</noinclude>

Navigation menu