Wiki source code of Home

Version 34.1 by Isaac Mejia on 2025/12/15 18:00

version	line-number	content
6.1	1	{{velocity}}
11.1	2	## ---------------------------------------------
6.1	3	## KB Home (Main.WebHome)
11.1	4	## Discover category landing pages dynamically.
34.1	5	## (WITH HARD ALLOWLIST)
11.1	6	## ---------------------------------------------
4.1	7
11.1	8	## 1) Find all top-level category pages under "Main"
	9	## We exclude:
	10	## - WebHome itself
	11	## - any technical KB* pages (KBStyles, KBArticleHeader, etc.)
	12	## - hidden docs
9.1	13	#set ($xwql =
11.1	14	"select doc.fullName, doc.title, doc.name " +
9.1	15	"from XWikiDocument doc " +
11.1	16	"where doc.space = 'Main' " +
	17	"and doc.name <> 'WebHome' " +
	18	"and doc.name not like 'KB%' " +
9.1	19	"and doc.hidden <> true " +
	20	"order by lower(doc.title)"
25.1	21	)##
	22	#set ($query = $services.query.xwql($xwql))##
	23	#set ($rows = $query.execute())##
9.1	24
11.1	25	## 2) Icon map (optional overrides)
	26	#set ($kbCategoryIcons = {
	27	"Member Management": "👥",
	28	"Configuration": "⚙️",
	29	"Billing & Payments": "💳",
	30	"Payment Management": "💳",
	31	"Reporting & Analytics": "📊",
	32	"Notifications": "🔔",
	33	"Integrations": "🔗"
25.1	34	})##
9.1	35
11.1	36	## 3) Optional hand-authored descriptions for known categories
	37	#set ($kbCategoryDescriptions = {
9.1	38	"Member Management": "How to manage members, families, and profiles.",
	39	"Configuration": "Set up locations, billing, and core system settings.",
	40	"Billing & Payments": "Invoices, collections, and payment processing.",
11.1	41	"Payment Management": "Articles and guides for Payment Management.",
9.1	42	"Reporting & Analytics": "Understand your numbers and performance.",
11.1	43	"Notifications": "Articles and guides for Notifications.",
	44	"Integrations": "Connect Member Solutions with other tools in your stack."
25.1	45	})##
9.1	46
34.1	47	## --- HARD ALLOWLIST: only show these categories on the homepage ---
	48	## IMPORTANT: These must match the CATEGORY PAGE DISPLAY TITLE / NAME shown on cards.
	49	#set ($allowedCategories = [
	50	"Check-In",
	51	"Configuration",
	52	"Lead Management",
	53	"Member Management",
	54	"Member Portal",
	55	"Notifications",
	56	"Payment Management",
	57	"Reporting"
	58	])##
	59
11.1	60	## 4) Build a normalized list of category objects
25.1	61	#set ($kbCategories = [])##
11.1	62
25.1	63	#foreach ($row in $rows)##
	64	#set ($fullName = $row.get(0))## ## e.g. "Main.Member Management"
	65	#set ($title = $row.get(1))## ## display title
	66	#set ($pageName = $row.get(2))## ## page name, used in URL & article space
	67	#set ($catDoc = $xwiki.getDocument($fullName))##
11.1	68
	69	## Label shown on the card
25.1	70	#set ($label = $catDoc.displayTitle)##
	71	#if ("$!label" == "")##
	72	#set ($label = $pageName)##
	73	#end##
11.1	74
34.1	75	## Only include categories we actually want
	76	#if ($allowedCategories.contains($label))##
11.1	77
34.1	78	## Description (custom if defined, otherwise auto)
	79	#set ($desc = $kbCategoryDescriptions.get($label))##
	80	#if ("$!desc" == "")##
	81	#set ($desc = "Articles and guides for $label.")##
	82	#end##
11.1	83
34.1	84	## Article space: Main.<PageName with spaces replaced by underscores>
	85	#set ($articleSpace = "Main." + $pageName.replace(" ", "_"))##
11.1	86
34.1	87	## Count non-hidden, non-WebHome pages in that article space
	88	#set ($articleCount = 0)##
	89	#set ($countXwql =
	90	"select count(doc.fullName) " +
	91	"from XWikiDocument doc " +
	92	"where doc.space = :space " +
	93	"and doc.name <> 'WebHome' " +
	94	"and doc.hidden <> true"
	95	)##
	96	#set ($countQuery = $services.query.xwql($countXwql).bindValue("space", $articleSpace))##
	97	#set ($resultList = $countQuery.execute())##
	98	#if ($resultList && $resultList.size() > 0)##
	99	#set ($articleCount = $resultList.get(0))##
	100	#end##
11.1	101
34.1	102	## Icon, with a sensible default
	103	#set ($icon = $kbCategoryIcons.get($label))##
	104	#if ("$!icon" == "")##
	105	#set ($icon = "📘")##
	106	#end##
11.1	107
34.1	108	## Build clean URL: /bin/view/Main/<PageName> (no trailing slash)
	109	#set ($encoded = $escapetool.url($pageName))##
	110	#set ($cleanUrl = "/bin/view/Main/$encoded")##
	111
	112	## Push into our categories array as a small map
	113	#set ($entry = {
	114	"label": $label,
	115	"pageName": $pageName,
	116	"desc": $desc,
	117	"icon": $icon,
	118	"url": $cleanUrl,
	119	"count": $articleCount
	120	})##
	121	#set ($discard = $kbCategories.add($entry))##
	122
	123	#end##
25.1	124	#end##
11.1	125
6.1	126	{{html clean="false"}}
	127	<div class="kb-home">
1.1	128
6.1	129	<!-- HERO -->
	130	<div class="kb-hero">
	131	<h1 class="kb-hero-title">Member Solutions Knowledge Base</h1>
	132	<p class="kb-hero-subtitle">
	133	Guides, walkthroughs, and best practices to help you and your team get the most out of the platform.
	134	</p>
1.1	135
30.1	136	<!-- Hero search wired to custom KB search page -->
	137	<div class="kb-hero-search">
	138	<form action="$xwiki.getURL('Main.KBSearch', 'view')" method="get">
	139	<input
	140	type="text"
	141	name="text"
	142	placeholder="Search for an article (e.g. "family membership")"
	143	aria-label="Search the knowledge base"
	144	/>
	145	</form>
	146	</div>
6.1	147	</div>
4.1	148
6.1	149	<!-- CATEGORY GRID -->
	150	<div class="kb-section">
	151	<h2 class="kb-section-title">Browse by category</h2>
4.1	152
6.1	153	<div class="kb-category-grid">
11.1	154	#foreach ($cat in $kbCategories)
	155	#set ($label = $cat.get("label"))
	156	#set ($desc = $cat.get("desc"))
	157	#set ($icon = $cat.get("icon"))
	158	#set ($url = $cat.get("url"))
	159	#set ($count = $cat.get("count"))
4.1	160
11.1	161	<a class="kb-card" href="$url">
7.2	162	<div>
11.1	163	<div class="kb-card-title">
	164	<span class="kb-card-icon">$icon</span>
	165	$escapetool.xml($label)
	166	</div>
7.2	167	<div class="kb-card-body">
	168	$escapetool.xml($desc)
	169	</div>
	170	</div>
11.1	171	<div class="kb-card-meta">
	172	#if ($count == 1)
	173	1 article
	174	#elseif ($count > 1)
	175	$count articles
	176	#else
	177	Category
	178	#end
	179	</div>
7.2	180	</a>
6.1	181	#end
	182	</div>
4.1	183	</div>
17.1	184
4.1	185	</div>
30.2	186
	187	<style>
	188	/* HOMEPAGE HERO OVERRIDE – BIGGER + MORE BREATHING ROOM */
	189
	190	/* Scope tightly so we only touch KB home hero */
	191	body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero {
34.1	192	padding: 4.2rem 1rem 3.3rem !important;
30.2	193	max-width: 1100px;
	194	margin: 0 auto;
	195	}
	196
	197	/* Title */
	198	body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-title {
	199	font-size: 3.5rem !important;
	200	font-weight: 800 !important;
	201	line-height: 1.15;
	202	margin-bottom: 1rem !important;
	203	color: #0f172a;
	204	}
	205
	206	/* Subtitle */
	207	body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-subtitle {
	208	font-size: 1.35rem !important;
	209	line-height: 1.7;
	210	color: #4b5563 !important;
	211	max-width: 720px;
34.1	212	margin: 0 auto 2.3rem !important;
30.2	213	}
	214
	215	/* Search bar – taller + larger text */
	216	body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-search input[type="text"] {
	217	max-width: 650px !important;
	218	padding: 1.25rem 1.6rem !important;
	219	font-size: 1.2rem !important;
	220	border-radius: 999px;
	221	border: 1px solid #d1d5db;
	222	box-shadow:
	223	0 26px 60px rgba(15, 23, 42, 0.14),
	224	0 2px 4px rgba(15, 23, 42, 0.06) !important;
	225	}
	226
	227	/* Placeholder text tone/size */
	228	body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-search input[type="text"]::placeholder {
	229	font-size: 1.15rem;
	230	color: #9ca3af;
	231	}
	232
	233	/* Extra space between hero and "Browse by category" */
	234	body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-section {
	235	margin-top: 4.6rem !important;
	236	}
	237	</style>
	238
2.1	239	{{/html}}
20.1	240	{{/velocity}}
	241
19.1	242	{{include reference="KBSupportCTA.WebHome"/}}