domma-cms 0.10.0 → 0.12.0

package/config/site.json

@@ -1,27 +1,14 @@
 {
-  "title": "My Nice Little Super Blog!",
-  "tagline": "A nice little bloggy type thingy.",
-  "fontFamily": "Roboto",
-  "fontSize": 16,
-  "theme": "dreamy-light",
-  "autoTheme": {
-    "enabled": false,
-    "dayTheme": "charcoal-light",
-    "nightTheme": "charcoal-dark",
-    "dayStart": "07:00",
-    "nightStart": "19:00"
-  },
-  "adminTheme": "charcoal-dark",
-  "layoutOptions": {
-    "spacerSize": 40
-  },
+  "title": "My Bloggy Thing",
+  "tagline": "This is the Domma CMS Testbed",
+  "theme": "charcoal-dark",
   "seo": {
-    "defaultTitle": "My Nice Little Super Blog!",
+    "defaultTitle": "My Bloggy Thing",
     "titleSeparator": " | ",
     "defaultDescription": "A site built with Domma CMS"
   },
   "footer": {
-    "copyright": "© 2026 DCBW Consulting Ltd",
+    "copyright": "© My Site. All rights reserved.",
     "links": [
       {
         "text": "Privacy Policy",
@@ -30,59 +17,20 @@
       {
         "text": "Contact",
         "url": "/contact"
-      },
-      {
-        "text": "GDPR",
-        "url": "/gdpr"
       }
     ]
   },
-  "social": {
-    "twitter": "",
-    "facebook": "",
-    "instagram": "",
-    "linkedin": "",
-    "github": "https://github.com/pinpointzero73/",
-    "youtube": ""
-  },
+  "social": {},
   "smtp": {
-    "host": "192.168.1.27",
-    "port": 1025,
+    "host": "",
+    "port": 587,
     "user": "",
     "pass": "",
     "secure": false,
-    "fromAddress": "noreply@dwit.uk",
-    "fromName": "My Big Boss Website"
-  },
-  "backToTop": {
-    "enabled": true,
-    "scrollThreshold": 180,
-    "position": "bottom-right",
-    "offset": 16,
-    "bottomOffset": 16,
-    "label": "",
-    "smooth": true
-  },
-  "cookieConsent": {
-    "enabled": true,
-    "message": "We use cookies to enhance your browsing experience, serve personalised content, and analyse our traffic. By clicking \"Accept All\", you consent to our use of cookies.",
-    "acceptAllText": "Accept All",
-    "rejectAllText": "Reject All",
-    "customizeText": "Customize",
-    "savePreferencesText": "Save Preferences",
-    "privacyPolicyText": "Privacy Policy",
-    "privacyPolicyUrl": "/privacy-policy",
-    "cookiePolicyText": "Cookie Policy",
-    "cookiePolicyUrl": "",
-    "position": "bottom",
-    "layout": "bar",
-    "theme": "dark",
-    "showFunctional": true,
-    "showAnalytics": true,
-    "showMarketing": true,
-    "consentVersion": "1.0"
+    "fromAddress": "",
+    "fromName": ""
   },
   "adminBrand": {
-    "title": "Domma Admin"
+    "title": "Domma CMS"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domma-cms",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
   "type": "module",
   "main": "server/server.js",
@@ -27,6 +27,7 @@
   ],
   "scripts": {
     "build": "node scripts/build.js",
+    "create-plugin": "node scripts/create-plugin.js",
     "delete-users": "node -e \"import('fs').then(({readdirSync,rmSync})=>{const d='content/users';readdirSync(d).filter(f=>f.endsWith('.json')).forEach(f=>{rmSync(d+'/'+f);console.log('deleted',f)})})\"",
     "start": "node server/server.js",
     "pm2:start": "pm2 start ecosystem.config.cjs --env production",

package/plugins/_template/admin/templates/index.html

@@ -0,0 +1,17 @@
+<div class="view-header d-flex justify-content-between align-items-center mb-4">
+    <div>
+        <h1 class="view-title">PLUGIN_DISPLAY_NAME</h1>
+        <p class="view-subtitle text-muted">Manage PLUGIN_DISPLAY_NAME.</p>
+    </div>
+    <div class="d-flex gap-2">
+        <button id="btn-new-item" class="btn btn-primary">
+            <span data-icon="plus"></span> New Item
+        </button>
+    </div>
+</div>
+
+<div class="card">
+    <div class="card-body">
+        <div id="items-table"></div>
+    </div>
+</div>

package/plugins/_template/admin/views/index.js

@@ -0,0 +1,19 @@
+/**
+ * PLUGIN_DISPLAY_NAME — admin view.
+ * Route: #/plugins/PLUGIN_SLUG
+ */
+export const indexView = {
+    templateUrl: '/plugins/PLUGIN_SLUG/admin/templates/index.html',
+
+    async onMount($container) {
+        // Your view logic here.
+        // Available globals: $, _, M, D, S, H, F, E, I, T, R
+        //
+        // Fetch data:    const data = await H.get('/api/plugins/PLUGIN_SLUG/items');
+        // Show toast:    E.toast('Saved!', { type: 'success' });
+        // Confirm:       if (!await E.confirm('Are you sure?')) return;
+        // Create table:  T.create(el, { data, columns: [...] });
+        // Create form:   F.create({ fields }, defaults, { showSubmitButton: false }).renderTo(el);
+        I.scan();
+    }
+};

package/plugins/_template/config.js

@@ -0,0 +1,8 @@
+/**
+ * PLUGIN_DISPLAY_NAME plugin — default configuration.
+ * Merged with user overrides from config/plugins.json.
+ */
+export default {
+    // Add your config keys and defaults here.
+    // Example: itemsPerPage: 20
+};

package/plugins/_template/plugin.js

@@ -0,0 +1,23 @@
+/**
+ * PLUGIN_DISPLAY_NAME plugin — server-side routes and lifecycle hooks.
+ */
+
+export default async function plugin(fastify, options) {
+    const { authenticate, requireAdmin } = options.auth;
+    const BASE = `/api/plugins/PLUGIN_SLUG`;
+
+    // Add your API routes here.
+    // Example:
+    // fastify.get(`${BASE}/items`, { preHandler: [authenticate] }, async (request, reply) => {
+    //     return { items: [] };
+    // });
+}
+
+export async function onEnable({ fastify, services }) {
+    // Called when the plugin is enabled via admin.
+    // Create collections, pages, or forms here if needed.
+}
+
+export async function onDisable({ fastify, services }) {
+    // Called when the plugin is disabled via admin.
+}

package/plugins/_template/plugin.json

@@ -0,0 +1,34 @@
+{
+  "name": "PLUGIN_SLUG",
+  "displayName": "PLUGIN_DISPLAY_NAME",
+  "version": "1.0.0",
+  "description": "PLUGIN_DESCRIPTION",
+  "author": "PLUGIN_AUTHOR",
+  "date": "PLUGIN_DATE",
+  "icon": "box",
+  "admin": {
+    "css": ["admin/css/index.css"],
+    "sidebar": [
+      {
+        "id": "PLUGIN_SLUG",
+        "text": "PLUGIN_DISPLAY_NAME",
+        "icon": "box",
+        "url": "#/plugins/PLUGIN_SLUG",
+        "section": "#/plugins/PLUGIN_SLUG"
+      }
+    ],
+    "routes": [
+      {
+        "path": "/plugins/PLUGIN_SLUG",
+        "view": "plugin-PLUGIN_SLUG",
+        "title": "PLUGIN_DISPLAY_NAME - Domma CMS"
+      }
+    ],
+    "views": {
+      "plugin-PLUGIN_SLUG": {
+        "entry": "PLUGIN_SLUG/admin/views/index.js",
+        "exportName": "indexView"
+      }
+    }
+  }
+}

package/plugins/analytics/plugin.json

@@ -1,35 +1,45 @@
 {
   "name": "analytics",
-    "displayName": "Analytics",
-    "version": "1.0.0",
-    "description": "Basic page view analytics. Tracks hits per page using a simple JSON store.",
-    "author": "Darryl Waterhouse",
-    "date": "2026-03-01",
-    "icon": "chart-bar",
-    "admin": {
-        "sidebar": [
-            { "id": "analytics", "text": "Analytics", "icon": "chart-bar", "url": "#/plugins/analytics", "section": "#/plugins/analytics" }
-        ],
-        "routes": [
-            { "path": "/plugins/analytics", "view": "plugin-analytics", "title": "Analytics - Domma CMS" }
-        ],
-        "views": {
-            "plugin-analytics": {
-              "entry": "analytics/admin/views/analytics.js",
-                "exportName": "analyticsView"
-            }
-        }
-    },
-    "inject": {
-        "head": "public/inject-head.html",
-        "bodyEnd": "public/inject-body.html"
-    },
-    "scaffold": {
-        "reset": [
-            {
-                "path": "stats.json",
-                "content": "{}"
-            }
-        ]
+  "displayName": "Analytics",
+  "version": "1.0.0",
+  "description": "Basic page view analytics. Tracks hits per page using a simple JSON store.",
+  "author": "Darryl Waterhouse",
+  "date": "2026-03-01",
+  "icon": "chart-bar",
+  "admin": {
+    "sidebar": [
+      {
+        "id": "analytics",
+        "text": "Analytics",
+        "icon": "chart-bar",
+        "url": "#/plugins/analytics",
+        "section": "#/plugins/analytics"
+      }
+    ],
+    "routes": [
+      {
+        "path": "/plugins/analytics",
+        "view": "plugin-analytics",
+        "title": "Analytics - Domma CMS"
+      }
+    ],
+    "views": {
+      "plugin-analytics": {
+        "entry": "analytics/admin/views/analytics.js?v=80339cdc",
+        "exportName": "analyticsView"
+      }
     }
+  },
+  "inject": {
+    "head": "public/inject-head.html",
+    "bodyEnd": "public/inject-body.html"
+  },
+  "scaffold": {
+    "reset": [
+      {
+        "path": "stats.json",
+        "content": "{}"
+      }
+    ]
+  }
 }

package/plugins/blog/admin/templates/blog.html

@@ -0,0 +1,22 @@
+<div class="view-header d-flex align-items-center justify-content-between mb-4">
+  <h1 class="h3 mb-0">Blog Posts</h1>
+  <button id="btn-new-post" class="btn btn-primary">
+    <span data-icon="plus"></span> New Post
+  </button>
+</div>
+
+<div class="card mb-3">
+  <div class="card-body">
+    <div class="d-flex gap-2 flex-wrap">
+      <select id="filter-status" class="form-select" style="width:auto;">
+        <option value="">All statuses</option>
+        <option value="draft">Draft</option>
+        <option value="scheduled">Scheduled</option>
+        <option value="published">Published</option>
+      </select>
+      <input id="filter-search" type="text" class="form-control" style="width:200px;" placeholder="Search posts…">
+    </div>
+  </div>
+</div>
+
+<div id="posts-table"></div>

package/plugins/blog/admin/templates/categories.html

@@ -0,0 +1,7 @@
+<div class="view-header d-flex align-items-center justify-content-between mb-4">
+  <h1 class="h3 mb-0">Blog Categories</h1>
+  <button id="btn-new-category" class="btn btn-primary">
+    <span data-icon="plus"></span> New Category
+  </button>
+</div>
+<div id="categories-table"></div>

package/plugins/blog/admin/templates/comments.html

@@ -0,0 +1,11 @@
+<div class="view-header mb-4">
+  <h1 class="h3 mb-0">Blog Comments</h1>
+</div>
+
+<div class="tab-list mb-3">
+  <button class="tab-item active" data-tab="pending">Pending</button>
+  <button class="tab-item" data-tab="approved">Approved</button>
+  <button class="tab-item" data-tab="spam">Spam</button>
+</div>
+
+<div id="comments-table"></div>

package/plugins/blog/admin/templates/post-editor.html

@@ -0,0 +1,97 @@
+<div class="view-header d-flex align-items-center justify-content-between mb-4">
+  <h1 class="h3 mb-0" id="editor-title">New Post</h1>
+  <div class="d-flex gap-2">
+    <button id="btn-save-draft" class="btn btn-secondary">Save Draft</button>
+    <button id="btn-schedule" class="btn btn-warning" style="display:none;">Schedule</button>
+    <button id="btn-publish" class="btn btn-primary">Publish Now</button>
+  </div>
+</div>
+
+<div class="d-flex gap-4" style="align-items:flex-start;">
+  <!-- Main content area -->
+  <div style="flex:1; min-width:0;">
+    <div class="card mb-3">
+      <div class="card-body">
+        <div class="mb-3">
+          <label class="form-label fw-bold">Title</label>
+          <input type="text" id="post-title" class="form-control form-control-lg" placeholder="Post title…">
+        </div>
+        <div class="mb-3">
+          <label class="form-label">Slug</label>
+          <div class="d-flex gap-2 align-items-center">
+            <input type="text" id="post-slug" class="form-control font-monospace">
+            <label class="d-flex align-items-center gap-1 text-muted small" style="white-space:nowrap;">
+              <input type="checkbox" id="slug-auto"> Auto
+            </label>
+          </div>
+          <div id="slug-warning" class="text-warning small mt-1" style="display:none;">
+            ⚠ Changing slug breaks existing links
+          </div>
+        </div>
+        <div class="mb-3">
+          <label class="form-label">Excerpt</label>
+          <textarea id="post-excerpt" class="form-control" rows="2" placeholder="Short summary…"></textarea>
+        </div>
+        <div class="mb-3">
+          <label class="form-label">Content</label>
+          <textarea id="post-content" class="form-control font-monospace" rows="20" placeholder="Write in Markdown…"></textarea>
+        </div>
+      </div>
+    </div>
+
+    <!-- SEO accordion -->
+    <div class="card mb-3">
+      <div class="card-header" id="seo-toggle" style="cursor:pointer;">
+        SEO <span class="text-muted small">(click to expand)</span>
+      </div>
+      <div class="card-body" id="seo-panel" style="display:none;">
+        <div class="mb-3">
+          <label class="form-label">SEO Title</label>
+          <input type="text" id="seo-title" class="form-control" placeholder="Overrides page title">
+        </div>
+        <div class="mb-3">
+          <label class="form-label">SEO Description</label>
+          <textarea id="seo-description" class="form-control" rows="2" placeholder="Overrides excerpt for meta description"></textarea>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Sidebar -->
+  <div style="width:280px; flex-shrink:0;">
+    <div class="card mb-3">
+      <div class="card-header">Status</div>
+      <div class="card-body">
+        <div id="schedule-picker" style="display:none;" class="mb-3">
+          <label class="form-label">Scheduled for</label>
+          <input type="datetime-local" id="post-scheduled-at" class="form-control">
+        </div>
+        <span id="post-status-badge" class="badge bg-secondary">draft</span>
+      </div>
+    </div>
+
+    <div class="card mb-3">
+      <div class="card-header">Categories</div>
+      <div class="card-body" id="categories-checklist">
+        <p class="text-muted small">Loading…</p>
+      </div>
+    </div>
+
+    <div class="card mb-3">
+      <div class="card-header">Tags</div>
+      <div class="card-body">
+        <input type="text" id="post-tags" class="form-control" placeholder="tag1, tag2, …">
+        <div class="text-muted small mt-1">Comma-separated</div>
+      </div>
+    </div>
+
+    <div class="card mb-3">
+      <div class="card-header">Featured Image</div>
+      <div class="card-body">
+        <div id="featured-image-preview" class="mb-2"></div>
+        <button id="btn-pick-image" class="btn btn-sm btn-secondary">Pick Image</button>
+        <button id="btn-clear-image" class="btn btn-sm btn-outline-secondary" style="display:none;">Clear</button>
+      </div>
+    </div>
+  </div>
+</div>

package/plugins/blog/admin/templates/settings.html

@@ -0,0 +1,11 @@
+<div class="view-header mb-4">
+  <h1 class="h3 mb-0">Blog Settings</h1>
+</div>
+
+<div class="alert alert-warning mb-4">
+  Base path and posts-per-page changes require a server restart to take effect.
+</div>
+
+<div class="card" style="max-width:600px;">
+  <div class="card-body" id="settings-form"></div>
+</div>

package/plugins/blog/admin/views/blog.js

@@ -0,0 +1,183 @@
+/**
+ * Blog posts list view.
+ *
+ * @module blog/admin/views/blog
+ */
+
+function escapeHtml(s) {
+    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+
+const BASE = '/api/plugins/blog';
+
+const STATUS_BADGE = {
+    draft: 'badge-secondary',
+    scheduled: 'badge-warning',
+    published: 'badge-success'
+};
+
+export const blogView = {
+    templateUrl: '/plugins/blog/admin/templates/blog.html',
+
+    /**
+     * Mount the blog posts list view.
+     *
+     * @param {object} $container - Domma-wrapped container element
+     * @returns {Promise<void>}
+     */
+    async onMount($container) {
+        let allPosts = [];
+        let postsTable = null;
+
+        // ---------------------------------------------------------------
+        // Table
+        // ---------------------------------------------------------------
+
+        function buildTable(data) {
+            const tableEl = $container.find('#posts-table').get(0);
+            if (!tableEl) return;
+
+            if (postsTable) {
+                postsTable.setData(data);
+                return;
+            }
+
+            postsTable = T.create(tableEl, {
+                data,
+                columns: [
+                    {
+                        key: 'title',
+                        title: 'Title',
+                        sortable: true,
+                        render: (v, row) =>
+                            `<a href="#/plugins/blog/posts/${escapeHtml(row.id)}" style="font-weight:600;">${escapeHtml(v || 'Untitled')}</a>`
+                    },
+                    {
+                        key: 'status',
+                        title: 'Status',
+                        sortable: true,
+                        render: (v) => {
+                            const cls = STATUS_BADGE[v] || 'badge-secondary';
+                            return `<span class="badge ${cls}">${escapeHtml(v ?? 'draft')}</span>`;
+                        }
+                    },
+                    {
+                        key: 'authorId',
+                        title: 'Author',
+                        sortable: false,
+                        render: (v) => escapeHtml(v) || '—'
+                    },
+                    {
+                        key: 'publishedAt',
+                        title: 'Published',
+                        sortable: true,
+                        render: (v) => v
+                            ? `<span title="${escapeHtml(D(v).format('DD MMM YYYY HH:mm'))}">${escapeHtml(D(v).format('DD MMM YYYY'))}</span>`
+                            : '<span style="opacity:0.4;">—</span>'
+                    },
+                    {
+                        key: 'id',
+                        title: 'Actions',
+                        sortable: false,
+                        render: (id) =>
+                            `<div style="display:flex;gap:.4rem;">` +
+                            `<button class="btn btn-sm btn-outline post-edit-btn" data-id="${escapeHtml(id)}">` +
+                            `<span data-icon="edit" data-icon-size="14"></span> Edit</button>` +
+                            `<button class="btn btn-sm btn-danger post-delete-btn" data-id="${escapeHtml(id)}">` +
+                            `<span data-icon="trash" data-icon-size="14"></span> Delete</button>` +
+                            `</div>`
+                    }
+                ],
+                emptyMessage: 'No posts found.'
+            });
+
+            // Event delegation for action buttons
+            tableEl.addEventListener('click', async (e) => {
+                const editBtn = e.target.closest('.post-edit-btn');
+                const deleteBtn = e.target.closest('.post-delete-btn');
+
+                if (editBtn) {
+                    R.navigate('#/plugins/blog/posts/' + editBtn.dataset.id);
+                }
+
+                if (deleteBtn) {
+                    const id = deleteBtn.dataset.id;
+                    const post = allPosts.find((p) => p.id === id);
+                    const ok = await E.confirm(`Delete "${post?.title ?? 'this post'}"?`);
+                    if (!ok) return;
+                    try {
+                        await H.delete(`${BASE}/posts/${id}`);
+                        E.toast('Post deleted.', { type: 'success' });
+                        await reload();
+                    } catch {
+                        E.toast('Failed to delete post.', { type: 'error' });
+                    }
+                }
+            });
+
+            Domma.icons.scan();
+        }
+
+        // ---------------------------------------------------------------
+        // Filter
+        // ---------------------------------------------------------------
+
+        function applyFilters() {
+            const statusEl = $container.find('#filter-status').get(0);
+            const searchEl = $container.find('#filter-search').get(0);
+            const status = statusEl?.value ?? '';
+            const query = (searchEl?.value ?? '').toLowerCase().trim();
+
+            let filtered = allPosts;
+            if (status) filtered = filtered.filter((p) => p.status === status);
+            if (query) {
+                filtered = filtered.filter((p) =>
+                    (p.title ?? '').toLowerCase().includes(query) ||
+                    (p.excerpt ?? '').toLowerCase().includes(query)
+                );
+            }
+            buildTable(filtered);
+        }
+
+        // ---------------------------------------------------------------
+        // Load
+        // ---------------------------------------------------------------
+
+        async function reload() {
+            try {
+                const res = await H.get(`${BASE}/posts`);
+                if (res.error) throw new Error(res.error);
+                allPosts = res.data ?? [];
+            } catch {
+                allPosts = [];
+                E.toast('Failed to load posts.', { type: 'error' });
+            }
+            applyFilters();
+        }
+
+        // ---------------------------------------------------------------
+        // Event bindings
+        // ---------------------------------------------------------------
+
+        const newPostBtn = $container.find('#btn-new-post').get(0);
+        if (newPostBtn) newPostBtn.addEventListener('click', () => R.navigate('#/plugins/blog/posts/new'));
+
+        const filterStatus = $container.find('#filter-status').get(0);
+        if (filterStatus) filterStatus.addEventListener('change', applyFilters);
+
+        const filterSearch = $container.find('#filter-search').get(0);
+        if (filterSearch) {
+            let searchTimer = null;
+            filterSearch.addEventListener('input', () => {
+                clearTimeout(searchTimer);
+                searchTimer = setTimeout(applyFilters, 250);
+            });
+        }
+
+        // ---------------------------------------------------------------
+        // Initial load
+        // ---------------------------------------------------------------
+        await reload();
+        Domma.icons.scan();
+    }
+};