domma-cms 0.10.0 → 0.13.0

package/plugins/blog/admin/views/post-editor.js

@@ -0,0 +1,291 @@
+/**
+ * Blog post editor view — create and edit posts.
+ *
+ * @module blog/admin/views/post-editor
+ */
+
+function escapeHtml(s) {
+    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+
+function slugify(s) {
+    return String(s ?? '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+
+const BASE = '/api/plugins/blog';
+
+export const postEditorView = {
+    templateUrl: '/plugins/blog/admin/templates/post-editor.html',
+
+    /**
+     * Mount the post editor view.
+     *
+     * @param {object} $container - Domma-wrapped container element
+     * @returns {Promise<void>}
+     */
+    async onMount($container) {
+        // Resolve post id from router params
+        const id = R.current?.params?.id !== 'new' ? R.current?.params?.id : null;
+        const isEdit = Boolean(id);
+
+        let post = null;
+        let categories = [];
+        let selectedCategoryIds = [];
+
+        // ---------------------------------------------------------------
+        // Load data
+        // ---------------------------------------------------------------
+
+        try {
+            const [catsRes] = await Promise.all([
+                H.get(`${BASE}/categories`).catch(() => ({ data: [] }))
+            ]);
+            categories = catsRes.data ?? catsRes ?? [];
+        } catch {
+            categories = [];
+        }
+
+        if (isEdit) {
+            try {
+                const res = await H.get(`${BASE}/posts/${id}`);
+                if (res.error) throw new Error(res.error);
+                post = res.data ?? res;
+            } catch {
+                E.toast('Failed to load post.', { type: 'error' });
+                R.navigate('#/plugins/blog');
+                return;
+            }
+        }
+
+        // ---------------------------------------------------------------
+        // DOM refs
+        // ---------------------------------------------------------------
+
+        const titleEl       = $container.find('#editor-title').get(0);
+        const postTitleEl   = $container.find('#post-title').get(0);
+        const postSlugEl    = $container.find('#post-slug').get(0);
+        const slugAutoEl    = $container.find('#slug-auto').get(0);
+        const slugWarnEl    = $container.find('#slug-warning').get(0);
+        const excerptEl     = $container.find('#post-excerpt').get(0);
+        const contentEl     = $container.find('#post-content').get(0);
+        const tagsEl        = $container.find('#post-tags').get(0);
+        const seoTitleEl    = $container.find('#seo-title').get(0);
+        const seoDescEl     = $container.find('#seo-description').get(0);
+        const statusBadge   = $container.find('#post-status-badge').get(0);
+        const scheduleEl    = $container.find('#schedule-picker').get(0);
+        const schedAtEl     = $container.find('#post-scheduled-at').get(0);
+        const catsListEl    = $container.find('#categories-checklist').get(0);
+
+        // ---------------------------------------------------------------
+        // Populate
+        // ---------------------------------------------------------------
+
+        if (titleEl) titleEl.textContent = isEdit ? 'Edit Post' : 'New Post';
+
+        if (isEdit && post) {
+            if (postTitleEl) postTitleEl.value = post.title ?? '';
+            if (postSlugEl)  postSlugEl.value  = post.slug ?? '';
+            if (excerptEl)   excerptEl.value   = post.excerpt ?? '';
+            if (contentEl)   contentEl.value   = post.content ?? '';
+            if (tagsEl)      tagsEl.value      = Array.isArray(post.tags) ? post.tags.join(', ') : (post.tags ?? '');
+            if (seoTitleEl)  seoTitleEl.value  = post.seoTitle ?? '';
+            if (seoDescEl)   seoDescEl.value   = post.seoDescription ?? '';
+            if (statusBadge) statusBadge.textContent = post.status ?? 'draft';
+            selectedCategoryIds = Array.isArray(post.categoryIds) ? [...post.categoryIds] : [];
+        } else {
+            // New post: enable auto-slug by default
+            if (slugAutoEl) slugAutoEl.checked = true;
+        }
+
+        // Build categories checklist using DOM APIs (not innerHTML — interactive elements)
+        if (catsListEl) {
+            while (catsListEl.firstChild) catsListEl.removeChild(catsListEl.firstChild);
+
+            if (categories.length === 0) {
+                const p = document.createElement('p');
+                p.className = 'text-muted small';
+                p.textContent = 'No categories yet.';
+                catsListEl.appendChild(p);
+            } else {
+                categories.forEach((cat) => {
+                    const label = document.createElement('label');
+                    label.className = 'd-flex align-items-center gap-2 mb-2';
+                    label.style.cursor = 'pointer';
+
+                    const cb = document.createElement('input');
+                    cb.type = 'checkbox';
+                    cb.value = cat.id;
+                    cb.checked = selectedCategoryIds.includes(cat.id);
+                    cb.addEventListener('change', () => {
+                        if (cb.checked) {
+                            if (!selectedCategoryIds.includes(cat.id)) selectedCategoryIds.push(cat.id);
+                        } else {
+                            selectedCategoryIds = selectedCategoryIds.filter((x) => x !== cat.id);
+                        }
+                    });
+
+                    const span = document.createElement('span');
+                    span.textContent = cat.name ?? cat.slug ?? cat.id;
+
+                    label.appendChild(cb);
+                    label.appendChild(span);
+                    catsListEl.appendChild(label);
+                });
+            }
+        }
+
+        // ---------------------------------------------------------------
+        // Collect form values
+        // ---------------------------------------------------------------
+
+        function collectValues() {
+            return {
+                title: postTitleEl?.value?.trim() ?? '',
+                slug: postSlugEl?.value?.trim() ?? '',
+                excerpt: excerptEl?.value?.trim() ?? '',
+                content: contentEl?.value ?? '',
+                tags: (tagsEl?.value ?? '').split(',').map((t) => t.trim()).filter(Boolean),
+                categoryIds: selectedCategoryIds,
+                seoTitle: seoTitleEl?.value?.trim() ?? '',
+                seoDescription: seoDescEl?.value?.trim() ?? ''
+            };
+        }
+
+        // ---------------------------------------------------------------
+        // Save helpers
+        // ---------------------------------------------------------------
+
+        async function doSave(extra = {}) {
+            const body = { ...collectValues(), ...extra };
+            if (!body.title) {
+                E.toast('Title is required.', { type: 'error' });
+                return null;
+            }
+            try {
+                let saved;
+                if (isEdit) {
+                    const res = await H.put(`${BASE}/posts/${id}`, body);
+                    if (res.error) throw new Error(res.error);
+                    saved = res.data ?? res;
+                } else {
+                    const res = await H.post(`${BASE}/posts`, body);
+                    if (res.error) throw new Error(res.error);
+                    saved = res.data ?? res;
+                }
+                return saved;
+            } catch (err) {
+                E.toast(err?.message ?? 'Failed to save post.', { type: 'error' });
+                return null;
+            }
+        }
+
+        // ---------------------------------------------------------------
+        // Event bindings
+        // ---------------------------------------------------------------
+
+        // Auto-slug from title
+        if (postTitleEl) {
+            postTitleEl.addEventListener('input', () => {
+                if (slugAutoEl?.checked) {
+                    if (postSlugEl) postSlugEl.value = slugify(postTitleEl.value);
+                }
+            });
+        }
+
+        // Slug-auto checkbox
+        if (slugAutoEl) {
+            slugAutoEl.addEventListener('change', () => {
+                if (!slugAutoEl.checked && isEdit && post?.status === 'published') {
+                    if (slugWarnEl) slugWarnEl.style.display = '';
+                } else {
+                    if (slugWarnEl) slugWarnEl.style.display = 'none';
+                }
+                if (slugAutoEl.checked && postTitleEl) {
+                    if (postSlugEl) postSlugEl.value = slugify(postTitleEl.value);
+                }
+            });
+        }
+
+        // SEO panel toggle
+        const seoToggle = $container.find('#seo-toggle').get(0);
+        const seoPanel  = $container.find('#seo-panel').get(0);
+        if (seoToggle && seoPanel) {
+            seoToggle.addEventListener('click', () => {
+                seoPanel.style.display = seoPanel.style.display === 'none' ? '' : 'none';
+            });
+        }
+
+        // Save draft
+        const saveDraftBtn = $container.find('#btn-save-draft').get(0);
+        if (saveDraftBtn) {
+            saveDraftBtn.addEventListener('click', async () => {
+                const saved = await doSave({ status: 'draft' });
+                if (saved) {
+                    E.toast('Draft saved.', { type: 'success' });
+                    R.navigate('#/plugins/blog');
+                }
+            });
+        }
+
+        // Publish now
+        const publishBtn = $container.find('#btn-publish').get(0);
+        if (publishBtn) {
+            publishBtn.addEventListener('click', async () => {
+                const saved = await doSave();
+                if (!saved) return;
+                const savedId = saved.id ?? id;
+                try {
+                    const res = await H.post(`${BASE}/posts/${savedId}/publish`);
+                    if (res.error) throw new Error(res.error);
+                    E.toast('Post published.', { type: 'success' });
+                    R.navigate('#/plugins/blog');
+                } catch (err) {
+                    E.toast(err?.message ?? 'Failed to publish post.', { type: 'error' });
+                }
+            });
+        }
+
+        // Schedule
+        const scheduleBtn = $container.find('#btn-schedule').get(0);
+        if (scheduleBtn) {
+            scheduleBtn.style.display = '';
+            scheduleBtn.addEventListener('click', async () => {
+                // Toggle schedule picker visibility
+                if (scheduleEl) scheduleEl.style.display = scheduleEl.style.display === 'none' ? '' : 'none';
+
+                // If picker is now visible, wait for user to confirm
+                if (scheduleEl && scheduleEl.style.display !== 'none') return;
+
+                const publishedAt = schedAtEl?.value;
+                if (!publishedAt) {
+                    E.toast('Please select a scheduled date/time.', { type: 'error' });
+                    if (scheduleEl) scheduleEl.style.display = '';
+                    return;
+                }
+
+                const saved = await doSave();
+                if (!saved) return;
+                const savedId = saved.id ?? id;
+                try {
+                    const res = await H.post(`${BASE}/posts/${savedId}/schedule`, { publishedAt });
+                    if (res.error) throw new Error(res.error);
+                    E.toast('Post scheduled.', { type: 'success' });
+                    R.navigate('#/plugins/blog');
+                } catch (err) {
+                    E.toast(err?.message ?? 'Failed to schedule post.', { type: 'error' });
+                }
+            });
+        }
+
+        // Pick image (TBD)
+        const pickImageBtn = $container.find('#btn-pick-image').get(0);
+        if (pickImageBtn) {
+            pickImageBtn.addEventListener('click', () => {
+                console.log('media picker TBD');
+                E.toast('Media picker coming soon.', { type: 'info' });
+            });
+        }
+
+        Domma.icons.scan();
+    }
+};

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

@@ -0,0 +1,100 @@
+/**
+ * Blog settings admin view.
+ *
+ * @module blog/admin/views/settings
+ */
+
+const BASE = '/api/plugins/blog';
+
+export const settingsView = {
+    templateUrl: '/plugins/blog/admin/templates/settings.html',
+
+    /**
+     * Mount the blog settings view.
+     *
+     * @param {object} $container - Domma-wrapped container element
+     * @returns {Promise<void>}
+     */
+    async onMount($container) {
+        let settings = {};
+
+        // ---------------------------------------------------------------
+        // Load
+        // ---------------------------------------------------------------
+
+        try {
+            const res = await H.get(`${BASE}/settings`);
+            if (res.error) throw new Error(res.error);
+            settings = res.data ?? res ?? {};
+        } catch {
+            E.toast('Failed to load settings.', { type: 'error' });
+        }
+
+        // ---------------------------------------------------------------
+        // Render form using F.create
+        // ---------------------------------------------------------------
+
+        const formEl = $container.find('#settings-form').get(0);
+        if (!formEl) return;
+
+        F.create(formEl, {
+            blueprint: [
+                {
+                    key: 'basePath',
+                    label: 'Base path',
+                    type: 'text',
+                    placeholder: '/blog',
+                    value: settings.basePath ?? '/blog',
+                    hint: 'URL prefix for all blog pages (e.g. /blog).'
+                },
+                {
+                    key: 'postsPerPage',
+                    label: 'Posts per page',
+                    type: 'number',
+                    placeholder: '10',
+                    value: settings.postsPerPage ?? 10,
+                    hint: 'Number of posts shown per listing page.'
+                },
+                {
+                    key: 'commentsEnabled',
+                    label: 'Enable comments',
+                    type: 'toggle',
+                    value: settings.commentsEnabled ?? true,
+                    hint: 'Allow readers to submit comments on posts.'
+                },
+                {
+                    key: 'commentModeration',
+                    label: 'Moderate comments',
+                    type: 'toggle',
+                    value: settings.commentModeration ?? true,
+                    hint: 'Hold new comments for approval before they appear.'
+                },
+                {
+                    key: 'feedLength',
+                    label: 'RSS feed length',
+                    type: 'number',
+                    placeholder: '20',
+                    value: settings.feedLength ?? 20,
+                    hint: 'Maximum number of items in the RSS/Atom feed.'
+                }
+            ],
+            onSubmit: async (values) => {
+                try {
+                    const res = await H.put(`${BASE}/settings`, {
+                        basePath: values.basePath,
+                        postsPerPage: Number(values.postsPerPage) || 10,
+                        commentsEnabled: Boolean(values.commentsEnabled),
+                        commentModeration: Boolean(values.commentModeration),
+                        feedLength: Number(values.feedLength) || 20
+                    });
+                    if (res.error) throw new Error(res.error);
+                    E.toast('Settings saved.', { type: 'success' });
+                } catch (err) {
+                    E.toast(err?.message ?? 'Failed to save settings.', { type: 'error' });
+                }
+            }
+        });
+
+        Domma.icons.scan();
+    }
+};

package/plugins/blog/collections/categories/schema.json

@@ -0,0 +1,12 @@
+{
+  "name": "blog-categories",
+  "label": "Blog Categories",
+  "slug": "blog-categories",
+  "storage": { "adapter": "file" },
+  "fields": [
+    { "key": "name",        "label": "Name",        "type": "text",     "required": true },
+    { "key": "slug",        "label": "Slug",        "type": "text",     "required": true },
+    { "key": "description", "label": "Description", "type": "textarea", "required": false },
+    { "key": "parentId",    "label": "Parent",      "type": "text",     "required": false }
+  ]
+}

package/plugins/blog/collections/comments/schema.json

@@ -0,0 +1,16 @@
+{
+  "name": "blog-comments",
+  "label": "Blog Comments",
+  "slug": "blog-comments",
+  "storage": { "adapter": "file" },
+  "fields": [
+    { "key": "postId",      "label": "Post",         "type": "text",     "required": true },
+    { "key": "parentId",    "label": "Parent",       "type": "text",     "required": false },
+    { "key": "authorName",  "label": "Author Name",  "type": "text",     "required": true },
+    { "key": "authorEmail", "label": "Author Email", "type": "text",     "required": true },
+    { "key": "authorUrl",   "label": "Author URL",   "type": "text",     "required": false },
+    { "key": "body",        "label": "Body",         "type": "textarea", "required": true },
+    { "key": "status",      "label": "Status",       "type": "select",   "required": true, "options": ["pending", "approved", "rejected", "spam"] },
+    { "key": "createdAt",   "label": "Created At",   "type": "datetime", "required": false }
+  ]
+}

package/plugins/blog/collections/posts/schema.json

@@ -0,0 +1,19 @@
+{
+  "name": "blog-posts",
+  "label": "Blog Posts",
+  "slug": "blog-posts",
+  "storage": { "adapter": "file" },
+  "fields": [
+    { "key": "title",         "label": "Title",          "type": "text",     "required": true },
+    { "key": "slug",          "label": "Slug",           "type": "text",     "required": true },
+    { "key": "excerpt",       "label": "Excerpt",        "type": "textarea", "required": false },
+    { "key": "content",       "label": "Content",        "type": "markdown", "required": false },
+    { "key": "featuredImage", "label": "Featured Image", "type": "text",     "required": false },
+    { "key": "categories",    "label": "Categories",     "type": "array",    "required": false },
+    { "key": "tags",          "label": "Tags",           "type": "array",    "required": false },
+    { "key": "authorId",      "label": "Author",         "type": "text",     "required": true },
+    { "key": "status",        "label": "Status",         "type": "select",   "required": true, "options": ["draft", "scheduled", "published"] },
+    { "key": "publishedAt",   "label": "Published At",   "type": "datetime", "required": false },
+    { "key": "seo",           "label": "SEO",            "type": "object",   "required": false }
+  ]
+}

package/plugins/blog/config.js

@@ -0,0 +1,8 @@
+export default {
+    basePath:          '/blog',
+    postsPerPage:      10,
+    commentsEnabled:   false,
+    commentModeration: true,
+    feedLength:        20,
+    storage: { adapter: 'file' }
+};