domma-cms 0.6.13 → 0.6.15

package/plugins/form-builder/data/forms/feedback.json

@@ -0,0 +1,131 @@
+{
+  "slug": "feedback",
+  "title": "Feedback",
+  "description": "Share your feedback with us",
+  "fields": [
+    {
+      "name": "name",
+      "type": "string",
+      "label": "Your Name",
+      "required": true,
+      "placeholder": "Please enter your full name",
+      "helper": "Please enter your full name",
+      "validation": {
+        "min": 2,
+        "max": 100
+      }
+    },
+    {
+      "name": "email",
+      "type": "email",
+      "label": "Email Address",
+      "required": true,
+      "placeholder": "your@email.com",
+      "helper": "Please enter your email address"
+    },
+    {
+      "name": "rating",
+      "type": "select",
+      "label": "Overall Rating",
+      "required": true,
+      "helper": "Tell us how we are doing!",
+      "options": [
+        {
+          "value": "none",
+          "label": "Please Choose"
+        },
+        {
+          "value": "excellent",
+          "label": "Excellent"
+        },
+        {
+          "value": "good",
+          "label": "Good"
+        },
+        {
+          "value": "average",
+          "label": "Average"
+        },
+        {
+          "value": "poor",
+          "label": "Poor"
+        }
+      ]
+    },
+    {
+      "name": "category",
+      "type": "select",
+      "label": "Category",
+      "required": true,
+      "placeholder": "Please select a category",
+      "helper": "",
+      "options": [
+        {
+          "value": "general",
+          "label": "General"
+        },
+        {
+          "value": "bug-report",
+          "label": "Bug Report"
+        },
+        {
+          "value": "feature-request",
+          "label": "Feature Request"
+        },
+        {
+          "value": "praise",
+          "label": "Praise"
+        }
+      ]
+    },
+    {
+      "name": "subject",
+      "type": "string",
+      "label": "Subject",
+      "required": true,
+      "placeholder": "Brief summary of your feedback",
+      "helper": "",
+      "validation": {
+        "max": 200
+      }
+    },
+    {
+      "name": "message",
+      "type": "textarea",
+      "label": "Your Feedback",
+      "required": true,
+      "placeholder": "Please share your thoughts in detail…",
+      "helper": "Please share your thoughts in detail…",
+      "rows": 4,
+      "validation": {
+        "min": 10,
+        "max": 2000
+      }
+    }
+  ],
+  "settings": {
+    "submitText": "Submit Feedback",
+    "successMessage": "Thank you for your feedback! We appreciate you taking the time.",
+    "layout": "stacked",
+    "honeypot": true,
+    "rateLimitPerMinute": 3
+  },
+  "actions": {
+    "email": {
+      "enabled": true,
+      "recipients": "",
+      "subjectPrefix": "[feedback]"
+    },
+    "webhook": {
+      "enabled": false,
+      "url": "",
+      "method": "POST"
+    },
+    "collection": {
+      "enabled": true,
+      "slug": "feedback"
+    }
+  },
+  "createdAt": "2026-03-17T12:35:44.569Z",
+  "updatedAt": "2026-03-17T12:35:44.569Z"
+}

package/plugins/form-builder/data/forms/notes.json

@@ -0,0 +1,79 @@
+{
+  "slug": "notes",
+  "title": "Notes",
+  "description": "Free-form notes with categories and tags.",
+  "fields": [
+    {
+      "name": "title",
+      "type": "string",
+      "label": "Title",
+      "required": true,
+      "placeholder": "Note title"
+    },
+    {
+      "name": "content",
+      "type": "textarea",
+      "label": "Content",
+      "required": true,
+      "placeholder": "Write your note here…",
+      "rows": 5
+    },
+    {
+      "name": "category",
+      "type": "select",
+      "label": "Category",
+      "required": false,
+      "options": [
+        {
+          "value": "general",
+          "label": "General"
+        },
+        {
+          "value": "idea",
+          "label": "Idea"
+        },
+        {
+          "value": "reminder",
+          "label": "Reminder"
+        },
+        {
+          "value": "reference",
+          "label": "Reference"
+        }
+      ]
+    },
+    {
+      "name": "tags",
+      "type": "string",
+      "label": "Tags",
+      "required": false,
+      "placeholder": "Comma-separated tags",
+      "helper": "Separate tags with commas"
+    }
+  ],
+  "settings": {
+    "submitText": "Save Note",
+    "successMessage": "Note saved successfully.",
+    "layout": "stacked",
+    "honeypot": true,
+    "rateLimitPerMinute": 3
+  },
+  "actions": {
+    "email": {
+      "enabled": false,
+      "recipients": "",
+      "subjectPrefix": "[notes]"
+    },
+    "webhook": {
+      "enabled": false,
+      "url": "",
+      "method": "POST"
+    },
+    "collection": {
+      "enabled": true,
+      "slug": "notes"
+    }
+  },
+  "createdAt": "2026-03-17T12:35:44.569Z",
+  "updatedAt": "2026-03-17T12:35:44.569Z"
+}

package/plugins/form-builder/data/forms/to-do.json

@@ -0,0 +1,100 @@
+{
+  "slug": "to-do",
+  "title": "To-Do",
+  "description": "Task tracking with status, priority, and due dates.",
+  "fields": [
+    {
+      "name": "title",
+      "type": "string",
+      "label": "Title",
+      "required": true,
+      "placeholder": "Task title"
+    },
+    {
+      "name": "description",
+      "type": "textarea",
+      "label": "Description",
+      "required": false,
+      "placeholder": "Task details…",
+      "rows": 3
+    },
+    {
+      "name": "status",
+      "type": "select",
+      "label": "Status",
+      "required": true,
+      "options": [
+        {
+          "value": "pending",
+          "label": "Pending"
+        },
+        {
+          "value": "in-progress",
+          "label": "In Progress"
+        },
+        {
+          "value": "done",
+          "label": "Done"
+        }
+      ]
+    },
+    {
+      "name": "priority",
+      "type": "select",
+      "label": "Priority",
+      "required": false,
+      "options": [
+        {
+          "value": "low",
+          "label": "Low"
+        },
+        {
+          "value": "medium",
+          "label": "Medium"
+        },
+        {
+          "value": "high",
+          "label": "High"
+        }
+      ]
+    },
+    {
+      "name": "due_date",
+      "type": "date",
+      "label": "Due Date",
+      "required": false
+    },
+    {
+      "name": "assigned_to",
+      "type": "string",
+      "label": "Assigned To",
+      "required": false,
+      "placeholder": "Name or email"
+    }
+  ],
+  "settings": {
+    "submitText": "Add Task",
+    "successMessage": "Task added successfully.",
+    "layout": "stacked",
+    "honeypot": true,
+    "rateLimitPerMinute": 3
+  },
+  "actions": {
+    "email": {
+      "enabled": false,
+      "recipients": "",
+      "subjectPrefix": "[to-do]"
+    },
+    "webhook": {
+      "enabled": false,
+      "url": "",
+      "method": "POST"
+    },
+    "collection": {
+      "enabled": true,
+      "slug": "to-do"
+    }
+  },
+  "createdAt": "2026-03-17T12:35:44.569Z",
+  "updatedAt": "2026-03-17T12:35:44.569Z"
+}

package/plugins/form-builder/data/submissions/contacts.json

@@ -0,0 +1 @@
+[]

package/plugins/form-builder/data/submissions/enquiries.json

@@ -0,0 +1 @@
+[]

package/plugins/form-builder/data/submissions/feedback.json

@@ -0,0 +1 @@
+[]

package/plugins/form-builder/data/submissions/notes.json

@@ -0,0 +1 @@
+[]

package/plugins/form-builder/data/submissions/to-do.json

@@ -0,0 +1 @@
+[]

package/plugins/site-search/admin/templates/site-search.html

@@ -0,0 +1,67 @@
+<div class="view-header">
+    <h1><span data-icon="search"></span> Site Search</h1>
+    <div>
+        <button id="save-settings-btn" class="btn btn-primary">
+            <span data-icon="save"></span> Save
+        </button>
+    </div>
+</div>
+
+<div class="card mb-4">
+    <div class="card-header"><h2>Settings</h2></div>
+    <div class="card-body">
+
+        <div class="row mb-3">
+            <div class="col">
+                <label class="form-label">Search placeholder text</label>
+                <input id="field-placeholder" type="text" class="form-input" placeholder="Search pages...">
+                <span class="form-hint">Displayed inside the search input when empty.</span>
+            </div>
+        </div>
+
+        <div class="row mb-3">
+            <div class="col">
+                <label class="form-check-label">
+                    <input id="field-keyboard-shortcut" type="checkbox">
+                    Enable keyboard shortcut (Ctrl+K / ⌘K)
+                </label>
+                <span class="form-hint">Allows visitors to open the search overlay using a keyboard shortcut.</span>
+            </div>
+        </div>
+
+        <div class="row mb-3">
+            <div class="col-6">
+                <label class="form-label">Max results</label>
+                <input id="field-max-results" type="number" class="form-input" min="1" max="50" placeholder="10">
+                <span class="form-hint">Maximum number of results to return per search (1–50).</span>
+            </div>
+            <div class="col-6">
+                <label class="form-label">Minimum query length</label>
+                <input id="field-min-query-length" type="number" class="form-input" min="1" max="5" placeholder="2">
+                <span class="form-hint">Minimum characters required before searching (1–5).</span>
+            </div>
+        </div>
+
+        <div class="row">
+            <div class="col-6">
+                <label class="form-label">Debounce delay (ms)</label>
+                <input id="field-debounce-ms" type="number" class="form-input" min="100" max="1000" placeholder="300">
+                <span class="form-hint">Delay after typing stops before search fires (100–1000ms).</span>
+            </div>
+        </div>
+
+    </div>
+</div>
+
+<div class="card mb-4">
+    <div class="card-header"><h2>How it works</h2></div>
+    <div class="card-body">
+        <p class="text-muted mb-2">Site Search adds a search icon to the public navbar. Visitors can click it or use
+            the keyboard shortcut to open a full-screen overlay with live results.</p>
+        <ul class="text-muted" style="padding-left:1.25rem;line-height:1.8;">
+            <li>Results are weighted: title matches score highest, followed by tags, description, and page content.</li>
+            <li>Draft pages and private pages are excluded from results.</li>
+            <li>Use <kbd>↑</kbd> <kbd>↓</kbd> to navigate results, <kbd>↵</kbd> to open, <kbd>Esc</kbd> to close.</li>
+        </ul>
+    </div>
+</div>

package/plugins/site-search/admin/views/site-search.js

@@ -0,0 +1,45 @@
+/**
+ * Site Search Plugin — Admin Settings View
+ */
+import {apiRequest} from '/admin/js/api.js';
+
+export const siteSearchView = {
+    templateUrl: '/plugins/site-search/admin/templates/site-search.html',
+
+    async onMount($container) {
+        let settings = {};
+        try {
+            settings = await apiRequest('/plugins/site-search/settings');
+        } catch {
+            E.toast('Could not load settings.', {type: 'error'});
+        }
+
+        $container.find('#field-placeholder').val(settings.placeholder || 'Search pages...');
+        $container.find('#field-keyboard-shortcut').prop('checked', settings.keyboardShortcut !== false);
+        $container.find('#field-max-results').val(settings.maxResults ?? 10);
+        $container.find('#field-min-query-length').val(settings.minQueryLength ?? 2);
+        $container.find('#field-debounce-ms').val(settings.debounceMs ?? 300);
+
+        $container.find('#save-settings-btn').off('click').on('click', async () => {
+            const data = {
+                placeholder: $container.find('#field-placeholder').val() || 'Search pages...',
+                keyboardShortcut: $container.find('#field-keyboard-shortcut').prop('checked'),
+                maxResults: parseInt($container.find('#field-max-results').val(), 10) || 10,
+                minQueryLength: parseInt($container.find('#field-min-query-length').val(), 10) || 2,
+                debounceMs: parseInt($container.find('#field-debounce-ms').val(), 10) || 300
+            };
+
+            try {
+                await apiRequest('/plugins/site-search/settings', {
+                    method: 'PUT',
+                    body: JSON.stringify(data)
+                });
+                E.toast('Settings saved.', {type: 'success'});
+            } catch {
+                E.toast('Failed to save settings.', {type: 'error'});
+            }
+        });
+
+        Domma.icons.scan();
+    }
+};

package/plugins/site-search/config.js

@@ -0,0 +1,10 @@
+/**
+ * Site Search Plugin — Default Configuration
+ */
+export default {
+    placeholder: 'Search pages...',
+    keyboardShortcut: true,
+    maxResults: 10,
+    minQueryLength: 2,
+    debounceMs: 300
+};

package/plugins/site-search/plugin.js

@@ -0,0 +1,188 @@
+/**
+ * Site Search Plugin — Server
+ *
+ * Endpoints (prefix: /api/plugins/site-search):
+ *   GET  /search?q=term  — public: full-text search across all published pages
+ *   GET  /settings       — public: return plugin settings (used by inject script)
+ *   PUT  /settings       — admin-auth: save user overrides
+ */
+import {listPages} from '../../server/services/content.js';
+import {getPluginSettings, savePluginState} from '../../server/services/plugins.js';
+
+/**
+ * Strip markdown syntax and shortcodes from content for plain-text searching.
+ *
+ * @param {string} content
+ * @returns {string}
+ */
+function stripMarkdown(content) {
+    if (!content) return '';
+    return content
+        // Remove shortcodes (self-closing and wrapping)
+        .replace(/\[[a-z][^\]]*\/\]/gi, '')
+        .replace(/\[[a-z][^\]]*\][\s\S]*?\[\/[a-z]+\]/gi, '')
+        .replace(/\[[a-z][^\]]*\]/gi, '')
+        // Remove HTML tags
+        .replace(/<[^>]+>/g, '')
+        // Remove headings (keep text)
+        .replace(/^#{1,6}\s+/gm, '')
+        // Remove bold / italic
+        .replace(/\*{1,3}([^*]+)\*{1,3}/g, '$1')
+        .replace(/_{1,3}([^_]+)_{1,3}/g, '$1')
+        // Remove images
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, '')
+        // Remove links (keep text)
+        .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1')
+        // Remove code blocks
+        .replace(/```[\s\S]*?```/g, '')
+        .replace(/`[^`]+`/g, '')
+        // Remove blockquotes marker
+        .replace(/^>\s+/gm, '')
+        // Collapse whitespace
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+
+/**
+ * Build a snippet of ~length chars around the first occurrence of term in content.
+ *
+ * @param {string} rawContent  - raw markdown content
+ * @param {string} term
+ * @param {number} length
+ * @returns {string}
+ */
+function buildSnippet(rawContent, term, length = 120) {
+    const text = stripMarkdown(rawContent);
+    if (!text) return '';
+
+    const lower = text.toLowerCase();
+    const idx = lower.indexOf(term.toLowerCase());
+
+    if (idx === -1) {
+        return text.length > length ? text.slice(0, length) + '…' : text;
+    }
+
+    const half = Math.floor(length / 2);
+    const start = Math.max(0, idx - half);
+    const end = Math.min(text.length, start + length);
+    const snippet = text.slice(start, end);
+
+    return (start > 0 ? '…' : '') + snippet + (end < text.length ? '…' : '');
+}
+
+/**
+ * Score a page against a search query using weighted field matching.
+ *
+ * @param {object} page
+ * @param {string} query
+ * @param {string[]} words - query split into words
+ * @returns {number}
+ */
+function scorePage(page, query, words) {
+    let score = 0;
+    const title = (page.title || '').toLowerCase();
+    const description = (page.description || '').toLowerCase();
+    const tagsRaw = Array.isArray(page.tags) ? page.tags : [];
+    const tags = tagsRaw.map(t => t.toLowerCase());
+    const stripped = stripMarkdown(page.content || '').toLowerCase();
+    const q = query.toLowerCase();
+
+    // Title scoring
+    if (title === q) {
+        score += 100;
+    } else if (title.includes(q)) {
+        score += 60;
+    } else if (words.every(w => title.includes(w))) {
+        score += 40;
+    } else if (words.some(w => title.includes(w))) {
+        score += 20;
+    }
+
+    // Tags scoring
+    if (tags.includes(q)) {
+        score += 30;
+    } else if (tags.some(t => t.includes(q))) {
+        score += 20;
+    } else if (words.every(w => tags.some(t => t.includes(w)))) {
+        score += 15;
+    } else if (words.some(w => tags.some(t => t.includes(w)))) {
+        score += 8;
+    }
+
+    // Description scoring
+    if (description.includes(q)) {
+        score += 25;
+    } else if (words.some(w => description.includes(w))) {
+        score += 10;
+    }
+
+    // Content scoring
+    if (stripped.includes(q)) {
+        score += 10;
+    } else if (words.every(w => stripped.includes(w))) {
+        score += 5;
+    } else if (words.some(w => stripped.includes(w))) {
+        score += 2;
+    }
+
+    return score;
+}
+
+export default async function siteSearchPlugin(fastify, options) {
+    const {authenticate, requireAdmin} = options.auth;
+
+    // -------------------------------------------------------------------------
+    // Public search endpoint
+    // -------------------------------------------------------------------------
+
+    fastify.get('/search', async (request, reply) => {
+        const settings = getPluginSettings('site-search');
+        const minLen = settings.minQueryLength ?? 2;
+        const maxResults = settings.maxResults ?? 10;
+
+        const q = (request.query.q || '').trim();
+        if (q.length < minLen) {
+            return reply.status(400).send({error: `Query must be at least ${minLen} characters`});
+        }
+
+        const pages = await listPages();
+        const words = q.toLowerCase().split(/\s+/).filter(Boolean);
+
+        const results = [];
+        for (const page of pages) {
+            // Filter out drafts and private pages
+            if (page.status === 'draft') continue;
+            if (page.visibility === 'private') continue;
+
+            const score = scorePage(page, q, words);
+            if (score === 0) continue;
+
+            results.push({
+                title: page.title || 'Untitled',
+                url: page.urlPath,
+                description: page.description || '',
+                tags: Array.isArray(page.tags) ? page.tags : [],
+                snippet: buildSnippet(page.content || '', q),
+                score
+            });
+        }
+
+        results.sort((a, b) => b.score - a.score);
+
+        return {results: results.slice(0, maxResults)};
+    });
+
+    // -------------------------------------------------------------------------
+    // Settings routes
+    // -------------------------------------------------------------------------
+
+    fastify.get('/settings', async () => {
+        return getPluginSettings('site-search');
+    });
+
+    fastify.put('/settings', {preHandler: [authenticate, requireAdmin]}, async (request) => {
+        const body = request.body || {};
+        savePluginState('site-search', {settings: body});
+        return {ok: true};
+    });
+}

package/plugins/site-search/plugin.json

@@ -0,0 +1,37 @@
+{
+  "name": "site-search",
+  "displayName": "Site Search",
+  "version": "1.0.0",
+  "description": "Full-text search for the public site. Search icon in navbar, Cmd+K shortcut, weighted results.",
+  "author": "Darryl Waterhouse",
+  "date": "2026-03-19",
+  "icon": "search",
+  "admin": {
+    "sidebar": [
+      {
+        "id": "site-search",
+        "text": "Site Search",
+        "icon": "search",
+        "url": "#/plugins/site-search",
+        "section": "#/plugins/site-search"
+      }
+    ],
+    "routes": [
+      {
+        "path": "/plugins/site-search",
+        "view": "plugin-site-search",
+        "title": "Site Search - Domma CMS"
+      }
+    ],
+    "views": {
+      "plugin-site-search": {
+        "entry": "site-search/admin/views/site-search.js",
+        "exportName": "siteSearchView"
+      }
+    }
+  },
+  "inject": {
+    "headLate": "public/inject-head.html",
+    "bodyEnd": "public/inject-body.html"
+  }
+}