Changes for page Home
Last modified by Isaac Mejia on 2025/12/15 18:27
From version 33.1
edited by Isaac Mejia
on 2025/12/15 17:50
on 2025/12/15 17:50
Change comment:
There is no comment for this version
To version 22.1
edited by Isaac Mejia
on 2025/12/05 17:59
on 2025/12/05 17:59
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -17,9 +17,9 @@ 17 17 "and doc.name not like 'KB%' " + 18 18 "and doc.hidden <> true " + 19 19 "order by lower(doc.title)" 20 -) ##21 -#set ($query = $services.query.xwql($xwql)) ##22 -#set ($rows = $query.execute()) ##20 +) 21 +#set ($query = $services.query.xwql($xwql)) 22 +#set ($rows = $query.execute()) 23 23 24 24 ## 2) Icon map (optional overrides) 25 25 #set ($kbCategoryIcons = { ... ... @@ -30,7 +30,7 @@ 30 30 "Reporting & Analytics": "📊", 31 31 "Notifications": "🔔", 32 32 "Integrations": "🔗" 33 -}) ##33 +}) 34 34 35 35 ## 3) Optional hand-authored descriptions for known categories 36 36 #set ($kbCategoryDescriptions = { ... ... @@ -41,34 +41,36 @@ 41 41 "Reporting & Analytics": "Understand your numbers and performance.", 42 42 "Notifications": "Articles and guides for Notifications.", 43 43 "Integrations": "Connect Member Solutions with other tools in your stack." 44 -}) ##44 +}) 45 45 46 46 ## 4) Build a normalized list of category objects 47 -#set ($kbCategories = []) ##47 +#set ($kbCategories = []) 48 48 49 -#foreach ($row in $rows) ##50 - #set ($fullName = $row.get(0)) #### e.g. "Main.Member Management"51 - #set ($title = $row.get(1)) #### display title52 - #set ($pageName = $row.get(2)) #### page name, used in URL & article space53 - #set ($catDoc = $xwiki.getDocument($fullName)) ##49 +#foreach ($row in $rows) 50 + #set ($fullName = $row.get(0)) ## e.g. "Main.Member Management" 51 + #set ($title = $row.get(1)) ## display title 52 + #set ($pageName = $row.get(2)) ## page name, used in URL & article space 53 + #set ($catDoc = $xwiki.getDocument($fullName)) 54 54 55 55 ## Label shown on the card 56 - #set ($label = $catDoc.displayTitle) ##57 - #if ("$!label" == "") ##58 - #set ($label = $pageName) ##59 - #end ##56 + #set ($label = $catDoc.displayTitle) 57 + #if ("$!label" == "") 58 + #set ($label = $pageName) 59 + #end 60 60 61 - ## Description ( customifdefined,otherwiseauto)62 - #set ($desc = $kbCategoryDescriptions.get($label)) ##63 - #if ("$!desc" == "") ##64 - #set ($desc = "Articles and guides for $label.") ##65 - #end ##61 + ## Default description (auto-generated if we don't have a custom one) 62 + #set ($desc = $kbCategoryDescriptions.get($label)) 63 + #if ("$!desc" == "") 64 + #set ($desc = "Articles and guides for $label.") 65 + #end 66 66 67 - ## Article space: Main.<PageName with spaces replaced by underscores> 68 - #set ($articleSpace = "Main." + $pageName.replace(" ", "_"))## 67 + ## Article space follows the convention: 68 + ## Main.<PageName with spaces replaced by underscores> 69 + ## e.g. Member Management -> space "Main.Member_Management" 70 + #set ($articleSpace = "Main." + $pageName.replace(" ", "_")) 69 69 70 70 ## Count non-hidden, non-WebHome pages in that article space 71 - #set ($articleCount = 0) ##73 + #set ($articleCount = 0) 72 72 #set ($countXwql = 73 73 "select count(doc.fullName) " + 74 74 "from XWikiDocument doc " + ... ... @@ -75,22 +75,22 @@ 75 75 "where doc.space = :space " + 76 76 "and doc.name <> 'WebHome' " + 77 77 "and doc.hidden <> true" 78 - ) ##79 - #set ($countQuery = $services.query.xwql($countXwql).bindValue("space", $articleSpace)) ##80 - #set ($resultList = $countQuery.execute()) ##81 - #if ($resultList && $resultList.size() > 0) ##82 - #set ($articleCount = $resultList.get(0)) ##83 - #end ##80 + ) 81 + #set ($countQuery = $services.query.xwql($countXwql).bindValue("space", $articleSpace)) 82 + #set ($resultList = $countQuery.execute()) 83 + #if ($resultList && $resultList.size() > 0) 84 + #set ($articleCount = $resultList.get(0)) 85 + #end 84 84 85 85 ## Icon, with a sensible default 86 - #set ($icon = $kbCategoryIcons.get($label)) ##87 - #if ("$!icon" == "") ##88 - #set ($icon = "📘") ##89 - #end ##88 + #set ($icon = $kbCategoryIcons.get($label)) 89 + #if ("$!icon" == "") 90 + #set ($icon = "📘") 91 + #end 90 90 91 91 ## Build clean URL: /bin/view/Main/<PageName> (no trailing slash) 92 - #set ($encoded = $escapetool.url($pageName)) ##93 - #set ($cleanUrl = "/bin/view/Main/$encoded") ##94 + #set ($encoded = $escapetool.url($pageName)) 95 + #set ($cleanUrl = "/bin/view/Main/$encoded") 94 94 95 95 ## Push into our categories array as a small map 96 96 #set ($entry = { ... ... @@ -100,32 +100,8 @@ 100 100 "icon": $icon, 101 101 "url": $cleanUrl, 102 102 "count": $articleCount 103 - })## 104 - #set ($discard = $kbCategories.add($entry))## 105 -#end## 106 - 107 -## --- HARD ALLOWLIST: only show these categories on the homepage --- 108 -#set ($allowedCategories = ["Check-In","Configuration","Lead Management","Member Management","Member Portal","Notifications","Payment Management","Reporting"]) 109 - 110 -#foreach ($row in $catRows) 111 - #set ($fullName = $row.get(0)) 112 - #set ($title = $row.get(1)) 113 - #set ($pageName = $row.get(2)) 114 - #set ($catDoc = $xwiki.getDocument($fullName)) 115 - 116 - #set ($label = $catDoc.displayTitle) 117 - #if ("$!label" == "") 118 - #set ($label = $pageName) 119 - #end 120 - 121 - ## Only include categories we actually want 122 - #if ($allowedCategories.contains($label)) 123 - 124 - #set ($articleSpace = "Main." + $pageName.replace(" ", "_")) 125 - #set ($entry = {"label": $label, "space": $articleSpace}) 126 - #set ($discard = $kbCategories.add($entry)) 127 - 128 - #end 105 + }) 106 + #set ($discard = $kbCategories.add($entry)) 129 129 #end 130 130 131 131 {{html clean="false"}} ... ... @@ -138,9 +138,9 @@ 138 138 Guides, walkthroughs, and best practices to help you and your team get the most out of the platform. 139 139 </p> 140 140 141 - <!-- HerosearchwiredtocustomKBsearchpage -->119 + <!-- Enhanced search box (still uses XWiki search under the hood) --> 142 142 <div class="kb-hero-search"> 143 - <form action="$xwiki.getURL('Main. KBSearch', 'view')" method="get">121 + <form action="$xwiki.getURL('Main.WebHome', 'view')" method="get"> 144 144 <input 145 145 type="text" 146 146 name="text" ... ... @@ -147,8 +147,6 @@ 147 147 placeholder="Search for an article (e.g. "family membership")" 148 148 aria-label="Search the knowledge base" 149 149 /> 150 - <!-- optional: add a button if you want --> 151 - <!-- <button type="submit" class="kb-search-button">Search</button> --> 152 152 </form> 153 153 </div> 154 154 </div> ... ... @@ -190,60 +190,8 @@ 190 190 </div> 191 191 192 192 </div> 193 - 194 -<style> 195 -/* HOMEPAGE HERO OVERRIDE – BIGGER + MORE BREATHING ROOM */ 196 - 197 -/* Scope tightly so we only touch KB home hero */ 198 -body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero { 199 - padding: 4.2rem 1rem 3.3rem !important; /* more air above + below */ 200 - max-width: 1100px; 201 - margin: 0 auto; 202 -} 203 - 204 -/* Title */ 205 -body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-title { 206 - font-size: 3.5rem !important; 207 - font-weight: 800 !important; 208 - line-height: 1.15; 209 - margin-bottom: 1rem !important; 210 - color: #0f172a; 211 -} 212 - 213 -/* Subtitle */ 214 -body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-subtitle { 215 - font-size: 1.35rem !important; 216 - line-height: 1.7; 217 - color: #4b5563 !important; 218 - max-width: 720px; 219 - margin: 0 auto 2.3rem !important; /* more space before search bar */ 220 -} 221 - 222 -/* Search bar – taller + larger text */ 223 -body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-search input[type="text"] { 224 - max-width: 650px !important; 225 - padding: 1.25rem 1.6rem !important; 226 - font-size: 1.2rem !important; 227 - border-radius: 999px; 228 - border: 1px solid #d1d5db; 229 - box-shadow: 230 - 0 26px 60px rgba(15, 23, 42, 0.14), 231 - 0 2px 4px rgba(15, 23, 42, 0.06) !important; 232 -} 233 - 234 -/* Placeholder text tone/size */ 235 -body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-hero-search input[type="text"]::placeholder { 236 - font-size: 1.15rem; 237 - color: #9ca3af; 238 -} 239 - 240 -/* Extra space between hero and "Browse by category" */ 241 -body.viewbody.page-WebHome[class*="space-Main"] #xwikicontent .kb-section { 242 - margin-top: 4.6rem !important; 243 -} 244 -</style> 245 - 246 246 {{/html}} 170 + 247 247 {{/velocity}} 248 248 249 249 {{include reference="KBSupportCTA.WebHome"/}}