docs/superpowers/specs/2026-07-02-wiki-search-result-badge-design.md

@@ -59,6 +59,13 @@ NodeBB version:
 Planning resolves which, based on the actual stock partials in the pinned
 NodeBB/theme base.
 
+**Resolved (2026-07-03): template override.** Harmony's row markup is small and
+self-contained, so the theme overrides `partials/posts_list_item.tpl` (`/search`
+posts view — shared with account/groups pages, where the wiki flags are never
+set and the conditional no-ops), `partials/search-results.tpl` (`/search` topics
+view), and `partials/quick-search-results.tpl` (dropdown). No client-side
+decoration needed.
+
 ## Styling
 
 Add badge styles in the theme SCSS (`scss/`, wired via `theme.scss`), matching

languages/en-GB/westgate.json

@@ -0,0 +1,3 @@
+{
+	"wiki-badge": "Wiki"
+}

scss/westgate/_search.scss

@@ -0,0 +1,17 @@
+/* Wiki badge on global search results (quick-search dropdown + /search page).
+   Marks results tagged by nodebb-plugin-westgate-wiki (isWikiArticle/wikiPath). */
+.westgate-wiki-badge {
+	font-family: var(--wg-font-ui);
+	font-size: 0.62em;
+	font-weight: 600;
+	letter-spacing: 0.09em;
+	text-transform: uppercase;
+	color: var(--wg-gold);
+	background: rgba(194, 163, 90, 0.1);
+	border: 1px solid var(--wg-ledger-border);
+	vertical-align: middle;
+}
+
+.quick-search-results .westgate-wiki-badge {
+	font-size: 0.7rem;
+}

templates/partials/posts_list_item.tpl

@@ -0,0 +1,28 @@
+<li component="post" class="posts-list-item  {{{ if ./deleted }}} deleted{{{ else }}}{{{ if ./topic.deleted }}} deleted{{{ end }}}{{{ end }}}{{{ if ./topic.scheduled }}} scheduled{{{ end }}}" data-pid="{./pid}" data-uid="{./uid}">
+    <hr/>
+    <a class="topic-title fw-semibold fs-5 mb-2 text-reset text-break d-block" href="{{{ if ./isWikiArticle }}}{config.relative_path}{./wikiPath}{{{ else }}}{config.relative_path}/post/{encodeURIComponent(./pid)}{{{ end }}}">
+    {{{ if ./isWikiArticle }}}<span class="badge westgate-wiki-badge"><i class="fa fa-book-open"></i> [[westgate:wiki-badge]]</span> {{{ else }}}{{{ if ./isMainPost }}}<i class="fa fa-book text-muted" title="[[topic:topic]]"></i> {{{ end }}}{{{ end }}}{./topic.title}
+    </a>
+
+    <div class="post-body d-flex flex-column gap-1 mb-2">
+        <div class="d-flex gap-2 post-info text-sm align-items-center">
+            <div class="post-author d-flex align-items-center gap-1">
+                <a class="lh-1 text-decoration-none" href="{config.relative_path}/user/{./user.userslug}">{buildAvatar(./user, "16px", true, "not-responsive")}</a>
+                <a class="lh-1 fw-semibold" href="{config.relative_path}/user/{./user.userslug}">{../user.displayname}</a>
+            </div>
+            <span class="timeago text-muted lh-1" title="{./timestampISO}"></span>
+        </div>
+
+        <div component="post/content" class="content text-sm text-break">
+            {./content}
+        </div>
+    </div>
+    <div class="mb-3 d-flex flex-wrap gap-1 w-100">
+        {buildCategoryLabel(./category, "a", "border")}
+        <span data-tid="{./topic.tid}" component="topic/tags" class="lh-1 tag-list d-flex flex-wrap gap-1 {{{ if !./topic.tags.length }}}hidden{{{ end }}}">
+            {{{ each ./topic.tags }}}
+            <a href="{config.relative_path}/tags/{./valueEncoded}"><span class="badge border border-gray-300 fw-normal tag tag-class-{./class}" data-tag="{./value}">{./valueEscaped}</span></a>
+            {{{ end }}}
+        </span>
+    </div>
+</li>

templates/partials/quick-search-results.tpl

@@ -0,0 +1,50 @@
+{{{ if (multiplePages && !config.theme.topMobilebar) }}}
+<div class="show-more-container">
+	<div class="text-center d-block d-md-none">
+		<a href="{url}" class="btn btn-sm btn-primary">[[search:see-more-results, {matchCount}]]</a>
+	</div>
+	<li role="separator" class="dropdown-divider d-block d-md-none"></li>
+</div>
+{{{ end }}}
+
+<ul id="quick-search-results" class="quick-search-results list-unstyled mb-0 p-0 pe-1 overflow-auto overscroll-behavior-contain ff-base ghost-scrollbar" style="max-width: {dropdown.maxWidth}; max-height: {dropdown.maxHeight};">
+	<li role="separator" class="dropdown-divider d-none d-md-block"></li>
+	{{{ each posts }}}
+	<li data-tid="{posts.topic.tid}" data-pid="{posts.pid}" class="d-flex flex-column gap-1">
+		<a href="{{{ if posts.isWikiArticle }}}{config.relative_path}{posts.wikiPath}{{{ else }}}{config.relative_path}/post/{encodeURIComponent(posts.pid)}{{{ end }}}"
+			class="btn btn-ghost btn-sm ff-secondary rounded-1 text-start text-reset d-block text-truncate px-2 py-1">
+			{{{ if posts.isWikiArticle }}}<span class="badge westgate-wiki-badge"><i class="fa fa-book-open"></i> [[westgate:wiki-badge]]</span> {{{ end }}}<span class="quick-search-title fw-semibold text-sm">{posts.topic.title}</span>
+			<br/>
+			<p class="snippet text-xs text-break text-wrap mb-0">
+			{posts.snippet}
+			</p>
+		</a>
+		<div class="d-flex gap-2 post-info px-2 text-xs">
+			<div class="category-item d-inline-block ff-secondary">
+				{buildCategoryLabel(posts.category, "span")}
+			</div>
+			<span class="timeago text-muted" title="{posts.timestampISO}"></span>
+		</div>
+	</li>
+	{{{ if !@last }}}
+	<li role="separator" class="dropdown-divider"></li>
+	{{{ end }}}
+	{{{ end }}}
+
+</ul>
+
+{{{ if multiplePages }}}
+<div class="text-center mt-2 d-none d-md-block">
+	<a href="{url}" class="btn btn-sm btn-primary">[[search:see-more-results, {matchCount}]]</a>
+</div>
+{{{ end }}}
+{{{ if (multiplePages && config.theme.topMobilebar) }}}
+<div class="text-center mt-2 d-block d-md-none">
+	<a href="{url}" class="btn btn-sm btn-primary">[[search:see-more-results, {matchCount}]]</a>
+</div>
+{{{ end }}}
+
+{{{if !posts.length}}}
+<div class="text-center no-results py-2 py-md-0">[[search:no-matches]]</li>
+<li role="separator" class="dropdown-divider d-block d-md-none"></li>
+{{{end}}}

templates/partials/search-results.tpl

@@ -0,0 +1,55 @@
+{{{ if matchCount }}}
+<div class="card card-header text-xs px-2 py-1 fw-semibold border-0 align-self-start">[[search:results-matching, {matchCount}, {search_query}, {time}]] </div>
+{{{ else }}}
+{{{ if search_query }}}
+<div class="badge text-bg-warning align-self-start">[[search:no-matches]]</div>
+{{{ end }}}
+{{{ end }}}
+
+<div id="results" class="search-results" data-search-query="{search_query}">
+	{{{ if showAsPosts }}}
+	{{{ if posts.length }}}
+	<!-- IMPORT partials/posts_list.tpl -->
+	{{{ end }}}
+	{{{ end }}}
+
+	{{{ if showAsTopics }}}
+	{{{ each posts }}}
+	<hr/>
+	<div class="topic-row  mb-3">
+		<a class="topic-title fw-semibold fs-5 text-reset text-break" href="{{{ if ./isWikiArticle }}}{config.relative_path}{./wikiPath}{{{ else }}}{config.relative_path}/post/{encodeURIComponent(./pid)}{{{ end }}}">
+			{{{ if ./isWikiArticle }}}<span class="badge westgate-wiki-badge"><i class="fa fa-book-open"></i> [[westgate:wiki-badge]]</span> {{{ end }}}{{{ if !./isMainPost }}}RE: {{{ end }}}{./topic.title}
+		</a>
+		<div class="post-body d-flex flex-column gap-1">
+			<div class="d-flex gap-3 post-info">
+				<div class="post-author d-flex gap-1">
+					<a class="lh-1 text-decoration-none" href="{config.relative_path}/user/{./user.userslug}">{buildAvatar(./user, "16px", true, "not-responsive")}</a>
+					<a class="fw-semibold text-sm" href="{config.relative_path}/user/{./user.userslug}">{../user.displayname}</a>
+				</div>
+				<span class="timeago text-sm text-muted" title="{./timestampISO}"></span>
+			</div>
+		</div>
+	</div>
+	{{{ end }}}
+	{{{ end }}}
+
+	{{{ if users.length }}}
+	<!-- IMPORT partials/users_list.tpl -->
+	{{{ end }}}
+
+	{{{ if tags.length }}}
+	<div class="tag-list row row-cols-2 row-cols-lg-3 row-cols-xl-4 gx-3 gy-2">
+	<!-- IMPORT partials/tags_list.tpl -->
+	</div>
+	{{{ end }}}
+
+	{{{ if categories.length }}}
+	<ul class="categories list-unstyled">
+		{{{each categories}}}
+		<!-- IMPORT partials/categories/item.tpl -->
+		{{{end}}}
+	</ul>
+	{{{ end }}}
+
+	<!-- IMPORT partials/paginator.tpl -->
+</div>

tests/wiki-search-badge-contract.test.js

@@ -0,0 +1,42 @@
+'use strict';
+
+// Contract: search results tagged by nodebb-plugin-westgate-wiki
+// (isWikiArticle + wikiPath) render with a wiki badge and link to /wiki/...,
+// while untagged forum results keep the stock /post/... link.
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+
+function read(relativePath) {
+	const filePath = path.join(__dirname, '..', relativePath);
+	assert(fs.existsSync(filePath), `${relativePath} should exist`);
+	return fs.readFileSync(filePath, 'utf8');
+}
+
+function assertIncludes(haystack, needle, message) {
+	assert(
+		haystack.includes(needle),
+		message || `Expected file to include ${needle}`
+	);
+}
+
+[
+	['templates/partials/posts_list_item.tpl', './isWikiArticle', '{./wikiPath}', '/post/{encodeURIComponent(./pid)}'],
+	['templates/partials/search-results.tpl', './isWikiArticle', '{./wikiPath}', '/post/{encodeURIComponent(./pid)}'],
+	['templates/partials/quick-search-results.tpl', 'posts.isWikiArticle', '{posts.wikiPath}', '/post/{encodeURIComponent(posts.pid)}'],
+].forEach(([templatePath, flag, wikiHref, forumHref]) => {
+	const template = read(templatePath);
+	assertIncludes(template, flag, `${templatePath} should branch on the wiki result flag`);
+	assertIncludes(template, wikiHref, `${templatePath} should link wiki results to their wikiPath`);
+	assertIncludes(template, forumHref, `${templatePath} should keep the stock post link for forum results`);
+	assertIncludes(template, 'westgate-wiki-badge', `${templatePath} should render the wiki badge`);
+});
+
+assertIncludes(read('theme.scss'), 'westgate/search', 'theme.scss should import the search styles');
+assertIncludes(read('scss/westgate/_search.scss'), '.westgate-wiki-badge', 'search styles should define the wiki badge');
+
+const languageKeys = JSON.parse(read('languages/en-GB/westgate.json'));
+assert(languageKeys['wiki-badge'], 'westgate language file should define the wiki-badge label');
+
+console.log('wiki search badge contract tests passed');

theme.scss

@@ -7,6 +7,7 @@
 @import "./scss/westgate/categories";
 @import "./scss/westgate/topics";
 @import "./scss/westgate/posts";
+@import "./scss/westgate/search";
 @import "./scss/westgate/controls";
 @import "./scss/westgate/widgets";
 @import "./scss/westgate/responsive";