Template:Topic Card: Difference between revisions

Latest revision as of 19:58, 23 September 2025

This template creates a Topic Card (curated entry point for hub pages).

Template for Topic Cards used on hub pages.

Template parameters[Edit template data]
This template prefers block formatting of parameters.
Parameter		Description	Type	Status
Display Title	`Display Title`	Main title shown on the card.	Line	required
Card Image	`Card Image`	Image file for the card (e.g., "Topic_habits.webp").	File	optional
Card Description	`Card Description`	Short teaser text for the card.	String	required
Appears in Main Category	`Appears in Main Category`	Main Category page where this card appears (e.g., "Master Yourself").	Page name	required
Platform Section	`Belongs to Platform Section`	Exactly "Knowledge" or "Resources". Suggested values `Knowledge` `Resources`	Line	required
Tags (for query)	`Queries for Tag`	Comma-separated Tag pages. Accepts either "Tag:Habits, Tag:Routines" or "Habits, Routines".	Line	required
Excludes Tag	`Excludes Tag`	Optional comma-separated Tag pages to exclude.	Line	optional
Match Mode	`Match Mode`	"ANY" (OR) or "ALL" (AND). Defaults to ANY. Suggested values `ANY` `ALL`	Line	optional
Status	`Status`	"Draft", "Published", or "Archived". Defaults to "Draft". Suggested values `Draft` `Published` `Archived` Default Draft	Line	optional

@@ Line 1: / Line 1: @@
 <includeonly>
+<!-- Visible Infobox (for display on the wiki page only) -->
 {| class="wikitable" style="float:right; margin-left:1em; width:300px;"
-| colspan="2" style="text-align:center;" | [[File:{{{Card Image|}}}|290px]]
+|-
+| colspan="2" style="text-align:center;" | {{#if:{{{Card Image|}}}|[[File:{{{Card Image}}}|290px]]|}}
 |-
 ! Display Title
 | {{{Display Title|}}}
 |-
-! Description
+! Card Description
-| [[Has card description::{{{Card Description|}}}]]
+| {{{Card Description|}}}
+|-
+! Appears in Main Category
+| {{{Appears in Main Category|}}}
 |-
-! Appears In Category
+! Platform Section
-| [[Appears in category::{{{Appears In Category|}}}]]
+| {{{Belongs to Platform Section|}}}
 |-
-! Queries For Tags
+! Tags (for query)
-| {{{Queries For Tags|}}}
+| {{#arraymap:{{{Queries for Tag}}}|,|x|[[x|{{#replace:x|Tag:|}}]]|,&#32;}}
+{{#if:{{{Match Mode|}}}|
+ {{!}}-
+ ! Match Mode
+ {{!}} {{{Match Mode}}}
+}}
+{{#if:{{{Excludes Tag|}}}|
+ {{!}}-
+ ! Excludes Tag
+ {{!}} {{#arraymap:{{{Excludes Tag}}}|,|y|[[y|{{#replace:y|Tag:|}}]]|,&#32;}}
+}}
 |}
+<!-- Hidden Semantic Data (headless CMS source of truth) -->
 <div style="display:none;">
-<!-- Invisible Data Section -->
 [[Has display title::{{{Display Title|}}}]]
-[[Belongs to section::{{{section|}}}]]
+<!-- Robust image handling: add File: if missing -->
-[[Has card image::{{{Card Image|}}}]]
+{{#if:{{{Card Image|}}}
-{{#arraymap:{{{Queries For Tags|}}}|,|x|[[Queries for tag::x]]}}
+ | [[Has card image::{{#ifeq:{{lc:{{#titleparts:{{{Card Image}}}|1|1}}}}|file|{{{Card Image}}}|File:{{{Card Image}}}}}]]
+}}
+[[Has card description::{{{Card Description|}}}]]
+{{#if:{{{Appears in Main Category|}}}
+ | [[Appears in main category::{{{Appears in Main Category}}}]]
+}}
+{{#if:{{{Belongs to Platform Section|}}}
+ | [[Belongs to platform section::{{{Belongs to Platform Section}}}]]
+}}
+<!-- Set multi-value properties by splitting the comma-separated input from the form -->
+{{#if:{{{Queries for Tag|}}}
+ | {{#arraymap:{{{Queries for Tag}}}|,|x|[[Queries for tag::x]]|\s}}
+}}
+{{#if:{{{Excludes Tag|}}}
+ | {{#arraymap:{{{Excludes Tag}}}|,|y|[[Excludes tag::y]]|\s}}
+}}
+[[Match mode::{{{Match Mode|ANY}}}]]
+<!-- Publication status (Draft by default) -->
+[[Has status::{{{Status|Draft}}}]]
+[[Category:Topic Cards]]
 </div>
-[[Category:Topic Cards]]
 </includeonly><noinclude>
-This template is for Topic Cards that define curated resource collections.
+This template creates a Topic Card (curated entry point for hub pages).
+<templatedata>
+{
+	"params": {
+		"Display Title": {
+			"label": "Display Title",
+			"description": "Main title shown on the card.",
+			"type": "line",
+			"required": true
+		},
+		"Card Image": {
+			"label": "Card Image",
+			"description": "Image file for the card (e.g., \"Topic_habits.webp\").",
+			"type": "wiki-file-name"
+		},
+		"Card Description": {
+			"label": "Card Description",
+			"description": "Short teaser text for the card.",
+			"type": "string",
+			"required": true
+		},
+		"Appears in Main Category": {
+			"label": "Appears in Main Category",
+			"description": "Main Category page where this card appears (e.g., \"Master Yourself\").",
+			"type": "wiki-page-name",
+			"required": true
+		},
+		"Belongs to Platform Section": {
+			"label": "Platform Section",
+			"description": "Exactly \"Knowledge\" or \"Resources\".",
+			"type": "line",
+			"suggestedvalues": [
+				"Knowledge",
+				"Resources"
+			],
+			"required": true
+		},
+		"Queries for Tag": {
+			"label": "Tags (for query)",
+			"description": "Comma-separated Tag pages. Accepts either \"Tag:Habits, Tag:Routines\" or \"Habits, Routines\".",
+			"type": "line",
+			"required": true
+		},
+		"Excludes Tag": {
+			"label": "Excludes Tag",
+			"description": "Optional comma-separated Tag pages to exclude.",
+			"type": "line"
+		},
+		"Match Mode": {
+			"label": "Match Mode",
+			"description": "\"ANY\" (OR) or \"ALL\" (AND). Defaults to ANY.",
+			"type": "line",
+			"suggestedvalues": [
+				"ANY",
+				"ALL"
+			]
+		},
+		"Status": {
+			"label": "Status",
+			"description": "\"Draft\", \"Published\", or \"Archived\". Defaults to \"Draft\".",
+			"type": "line",
+			"suggestedvalues": [
+				"Draft",
+				"Published",
+				"Archived"
+			],
+			"default": "Draft"
+		}
+	},
+	"description": "Template for Topic Cards used on hub pages.",
+	"format": "block"
+}
+</templatedata>
 </noinclude>