Changes for page Home
Last modified by Isaac Mejia on 2025/12/15 18:27
From version 1.1
edited by Isaac Mejia
on 2025/11/14 19:59
on 2025/11/14 19:59
Change comment:
Install extension [org.xwiki.platform:xwiki-platform-distribution-flavor-common/16.10.14]
To version 10.1
edited by Isaac Mejia
on 2025/12/05 16:57
on 2025/12/05 16:57
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,40 +1,114 @@ 1 -== Welcome to your wiki == 1 +{{velocity}} 2 +## KB Home (Main.WebHome) 2 2 3 -XWiki is the best tool to organize your knowledge. A //wiki// is organized in a hierarchy of //pages//. You can create multiple wikis, each with its own set of pages. 4 +## ------------------------------------------------------------ 5 +## 1) Discover category pages automatically 6 +## - Category pages live at: Main.<CategoryLabel>.WebHome 7 +## - We query all docs in space=Main except: 8 +## - WebHome 9 +## - KB-Categories (index page) 10 +## - KBStyles (internal style doc, not a category) 11 +## ------------------------------------------------------------ 12 +#set ($xwql = 13 + "select doc.fullName, doc.title " + 14 + "from XWikiDocument doc " + 15 + "where doc.space = :space " + 16 + "and doc.name not in ('WebHome','KB-Categories','KBStyles') " + 17 + "and doc.hidden <> true " + 18 + "order by lower(doc.title)" 19 +) 4 4 5 -XWiki can be used as a knowledge base (support, documentation, sales, etc.), for collaborative workspaces or even as a complete intranet. 21 +#set ($query = $services.query.xwql($xwql).bindValue("space", "Main")) 22 +#set ($rows = $query.execute()) 6 6 7 -== The basics == 24 +#set ($categories = []) 25 +#foreach ($row in $rows) 26 + #set ($fullName = $row[0]) 27 + #set ($catDoc = $xwiki.getDocument($fullName)) 28 + #set ($discard = $categories.add($catDoc)) 29 +#end 8 8 9 -To make the most out of your wiki, log-in and: 31 +## Optional description overrides (rest of your code stays the same) 32 +#set ($categoryDescriptions = { 33 + "Member Management": "How to manage members, families, and profiles.", 34 + "Configuration": "Set up locations, billing, and core system settings.", 35 + "Billing & Payments": "Invoices, collections, and payment processing.", 36 + "Reporting & Analytics": "Understand your numbers and performance.", 37 + "Integrations": "Connect eFit with other tools in your stack." 38 +}) 10 10 11 -Use the {{displayIcon name="pencil"/}} button above to //edit// this page and start customizing your wiki to your needs. 40 +{{html clean="false"}} 41 +<div class="kb-home"> 12 12 13 -Use the {{displayIcon name="add"/}} button above to //add// more pages to your wiki and create the //hierarchy// that best organizes your content. 43 + <!-- HERO --> 44 + <div class="kb-hero"> 45 + <h1 class="kb-hero-title">Member Solutions Knowledge Base</h1> 46 + <p class="kb-hero-subtitle"> 47 + Guides, walkthroughs, and best practices to help you and your team get the most out of the platform. 48 + </p> 14 14 15 -Use the {{displayIcon name="home"/}} breadcrumbs located above the title to //navigate// inside your pages. It's easy to get lost in a big wiki without them. 50 + <!-- Simple search box that posts to XWiki search --> 51 + <div class="kb-hero-search"> 52 + <form action="$xwiki.getURL('Main.WebHome', 'view')" method="get"> 53 + <input 54 + type="text" 55 + name="text" 56 + placeholder="Search for an article (e.g. "family membership")" 57 + /> 58 + </form> 59 + </div> 60 + </div> 16 16 17 -You can also use the [[Sandbox>>Sandbox.WebHome]] for more demo content and generally a place to experiment with your wiki's features. 62 + <!-- CATEGORY GRID --> 63 + <div class="kb-section"> 64 + <h2 class="kb-section-title">Browse by category</h2> 18 18 19 - {{box}}Learn more on how to use XWiki with the [[Getting Started Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/GettingStarted/WebHome]].{{/box}} 66 + <div class="kb-category-grid"> 67 + #foreach ($catDoc in $categories) 68 + ## Label shown on the card 69 + #set ($label = $catDoc.displayTitle) ## e.g. "Member Management" 20 20 21 -(% class="row" %) 22 -((( 23 -(% class="col-xs-12 col-sm-6" %) 24 -((( 25 -== Extend your wiki == 71 + ## Space/page name used in the URL path: 72 + ## uploader created category pages as Main.<Label>.WebHome, 73 + ## so doc.name is the space segment we need (with spaces). 74 + #set ($spaceName = $catDoc.name) ## e.g. "Member Management" 26 26 27 -To extend the power and functionalities of your wiki with the features that //you// need, head over to the [[Extension Manager>>XWiki.XWikiPreferences||queryString="editor=globaladmin§ion=XWiki.Extensions"]] where you can search for and install extensions. 76 + ## Description: use override map if present, else generic 77 + #set ($desc = $categoryDescriptions.get($label)) 78 + #if (!$desc) 79 + #set ($desc = "Articles and guides for " + $label) 80 + #end 28 28 29 -To browse through the 900+ community contributed extensions available for XWiki, head over to the [[Extensions Repository>>https://extensions.xwiki.org]]. 30 -))) 82 + ## Build clean URL: /bin/view/Main/<SpaceName> (no trailing slash) 83 + #set ($encoded = $escapetool.url($spaceName)) 84 + #set ($cleanUrl = "/bin/view/Main/$encoded") 31 31 32 -(% class="col-xs-12 col-sm-6" %) 33 -((( 34 -== Create your application == 86 + <a class="kb-card" href="$cleanUrl"> 87 + <div> 88 + <div class="kb-card-title">$escapetool.xml($label)</div> 89 + <div class="kb-card-body"> 90 + $escapetool.xml($desc) 91 + </div> 92 + </div> 93 + <div class="kb-card-meta">Category</div> 94 + </a> 95 + #end 96 + </div> 97 + </div> 35 35 36 -Go beyond the available extensions and define the //structure// of your data based on //your// needs, creating //your// own applications with [[App Within Minutes>>AppWithinMinutes]] (AWM). 99 + <!-- BOTTOM CTA --> 100 + <div class="kb-cta"> 101 + <div class="kb-cta-content"> 102 + <h2>Still need help?</h2> 103 + <p> 104 + If you can’t find what you’re looking for, our support team is happy to help. 105 + </p> 106 + </div> 107 + <a href="mailto:support@membersolutions.com" class="kb-cta-button"> 108 + Contact Support 109 + </a> 110 + </div> 37 37 38 - AWM will take care of making it easy for you andyour users to create and manage the data.39 - )))40 - )))112 +</div> 113 +{{/html}} 114 +{{/velocity}}