Changes for page Home
Last modified by Isaac Mejia on 2025/12/15 18:27
From version 24.1
edited by Isaac Mejia
on 2025/12/05 18:07
on 2025/12/05 18:07
Change comment:
There is no comment for this version
To version 29.1
edited by Isaac Mejia
on 2025/12/09 16:03
on 2025/12/09 16:03
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,34 @@ 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 title 52 - #set ($pageName = $row.get(2)) ## page name, used in URL & article space 53 - #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 61 ## Description (custom if defined, otherwise auto) 62 - #set ($desc = $kbCategoryDescriptions.get($label)) 63 - #if ("$!desc" == "") 64 - #set ($desc = "Articles and guides for $label.") 65 - #end 62 + #set ($desc = $kbCategoryDescriptions.get($label))## 63 + #if ("$!desc" == "")## 64 + #set ($desc = "Articles and guides for $label.")## 65 + #end## 66 66 67 67 ## Article space: Main.<PageName with spaces replaced by underscores> 68 - #set ($articleSpace = "Main." + $pageName.replace(" ", "_")) 68 + #set ($articleSpace = "Main." + $pageName.replace(" ", "_"))## 69 69 70 70 ## Count non-hidden, non-WebHome pages in that article space 71 - #set ($articleCount = 0) 71 + #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 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## 84 84 85 85 ## Icon, with a sensible default 86 - #set ($icon = $kbCategoryIcons.get($label)) 87 - #if ("$!icon" == "") 88 - #set ($icon = "📘") 89 - #end 86 + #set ($icon = $kbCategoryIcons.get($label))## 87 + #if ("$!icon" == "")## 88 + #set ($icon = "📘")## 89 + #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") 92 + #set ($encoded = $escapetool.url($pageName))## 93 + #set ($cleanUrl = "/bin/view/Main/$encoded")## 94 94 95 95 ## Push into our categories array as a small map 96 96 #set ($entry = { ... ... @@ -100,9 +100,9 @@ 100 100 "icon": $icon, 101 101 "url": $cleanUrl, 102 102 "count": $articleCount 103 - }) 104 - #set ($discard = $kbCategories.add($entry)) 105 -#end 103 + })## 104 + #set ($discard = $kbCategories.add($entry))## 105 +#end## 106 106 107 107 {{html clean="false"}} 108 108 <div class="kb-home"> ... ... @@ -115,16 +115,17 @@ 115 115 </p> 116 116 117 117 <!-- Enhanced search box (still uses XWiki search under the hood) --> 118 - <div class="kb-hero-search"> 119 - <form action="$xwiki.getURL('Main.WebHome', 'view')" method="get"> 120 - <input 121 - type="text" 122 - name="text" 123 - placeholder="Search for an article (e.g. "family membership")" 124 - aria-label="Search the knowledge base" 125 - /> 126 - </form> 127 - </div> 118 +<div class="kb-hero-search"> 119 + <form action="$xwiki.getURL('Main.WebSearch', 'view')" method="get"> 120 + ## XWiki will use ?text=... as the search query 121 + <input 122 + type="text" 123 + name="text" 124 + placeholder="Search for an article (e.g. "family membership")" 125 + aria-label="Search the knowledge base" 126 + /> 127 + </form> 128 +</div> 128 128 </div> 129 129 130 130 <!-- CATEGORY GRID -->