domma-cms 1.30.1 → 1.31.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/CLAUDE.md +17 -0
- package/admin/js/api.js +1 -1
- package/admin/js/lib/blocks-arrange.js +1 -1
- package/admin/js/lib/collection-editor-arrange.js +1 -1
- package/admin/js/lib/collection-entries-arrange.js +1 -1
- package/admin/js/lib/collections-arrange.js +1 -1
- package/admin/js/lib/list-tags-arrange.js +1 -1
- package/admin/js/lib/list-tags.js +9 -7
- package/admin/js/lib/pages-arrange.js +1 -1
- package/admin/js/templates/blocks.html +5 -3
- package/admin/js/templates/collections.html +12 -2
- package/admin/js/templates/pages.html +5 -3
- package/admin/js/views/blocks.js +5 -4
- package/admin/js/views/collection-editor.js +10 -4
- package/admin/js/views/collection-entries.js +2 -2
- package/admin/js/views/collections.js +6 -5
- package/admin/js/views/page-editor.js +1 -1
- package/admin/js/views/pages.js +4 -4
- package/docs/DommaFeatures.md +74 -2
- package/docs/api-reference.md +8 -6
- package/package.json +1 -1
- package/public/css/site.css +1 -1
- package/public/js/collection-browser.js +1 -1
- package/server/routes/api/blocks.js +12 -1
- package/server/routes/api/collections.js +9 -1
- package/server/routes/api/list-tags.js +35 -10
- package/server/routes/api/pages.js +16 -2
- package/server/services/collections.js +6 -0
- package/server/services/listTags.js +243 -47
- package/server/services/markdown.js +4 -0
- package/server/templates/page.html +2 -2
package/admin/js/views/pages.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{api as
|
|
1
|
+
import{api as g}from"../api.js";import{SHAPES as je,whileLoading as Be}from"../lib/loading.js";import{addBannerAction as ie}from"../lib/plugin-chrome.js";import{helpPopovers as re}from"../lib/help-popover.js";import{onceClosed as qe,openMenuAt as ce,settingsStore as Ie,sidebarCount as de,viewLifetime as Ke}from"../lib/tool-kit.js";import{filterByProject as ue,getProjectFromHash as He}from"../lib/project-context.js";import{arrangePages as Fe,checkPrune as Ue,normaliseSettings as pe,pageRow as _e,statusCounts as Oe,treeRows as Ve}from"../lib/pages-arrange.js";import{activeNote as ge,askManualTagName as ze,manualNames as We,openTagSettings as Ye,same as Ge,sharedTagFilter as Je,tagCounts as Qe,tagMenuItems as Xe,tagsOf as Ze}from"../lib/list-tags.js";const he=/^#\/(pages|projects\/[^/?#]+\/pages)\/?(\?.*)?$/,ve="#/pages",L="pages.prune.draft",et=`
|
|
2
2
|
<div class="pgx-row" data-path="{{urlPath}}" tabindex="0" data-bind-class="rowCls">
|
|
3
3
|
<span class="pgx-main"><strong>{{title}}</strong><small>{{meta}} <span class="pgx-tags">{{tagsText}}</span></small></span>
|
|
4
4
|
<span class="pgx-chips">
|
|
@@ -6,11 +6,11 @@ import{api as p}from"../api.js";import{SHAPES as Le,whileLoading as Ne}from"../l
|
|
|
6
6
|
<span class="pgx-chip is-tag" data-bind-hidden="!listTags" title="Tags">{{listTags}}</span>
|
|
7
7
|
<span class="pgx-chip is-info" data-bind-hidden="!project" title="Project">{{project}}</span>
|
|
8
8
|
<span class="pgx-chip" data-bind-hidden="!bundled" title="Shipped with the CMS">Bundled</span>
|
|
9
|
-
<span class="pgx-chip is-
|
|
9
|
+
<span class="pgx-chip is-tool" data-bind-hidden="!toolTag" title="Tool tag - added by the {{toolTag}} Tool, which manages this page"><span data-icon="package" data-icon-size="11"></span>{{toolTag}}</span>
|
|
10
10
|
<span class="pgx-chip" data-bind-class="statusCls">{{statusText}}</span>
|
|
11
11
|
</span>
|
|
12
12
|
<button type="button" class="pgx-kebab" aria-label="Actions for {{title}}" title="Actions">\u22EE</button>
|
|
13
|
-
</div>`,
|
|
13
|
+
</div>`,C=r=>String(r??"").replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""");function tt(r){const c=document.createElement("template");return c.innerHTML=r.trim(),c.content.firstElementChild}const me=Ie("pages.settings",pe),l=Ke(he),at=r=>`#/pages/edit${r}`;export const pagesView={templateUrl:"/admin/js/templates/pages.html",async onMount(r){l.reset();const c=r.get(0).querySelector(".pgx")||r.get(0),N=()=>he.test(location.hash)&&c.isConnected,u=He(),$=me.read(),s=M.observable([]),V=M.observable(0),z=M.observable(!0),R=M.observable(""),h=M.observable($.status),j=M.observable($.sort),w=M.observable($.mode),B=M.observable(""),W=Je($.tag),f=W.tag;l.add(W.dispose);const k=M.observable([]),b=M.observable({});l.add(M.effect(()=>me.write(pe({status:h.value,sort:j.value,mode:w.value}))));const P=M.observable([]);l.add(M.effect(()=>{P.value=Fe(s.value,{status:h.value,query:B.value,sort:j.value,tag:f.value,tools:b.value})}));const q=M.observable([]);l.add(M.effect(()=>{const e=b.value;q.value=P.value.map(t=>_e(t,Date.now(),e))}));const fe=M.computed(()=>Oe(s.value)),Y=M.computed(()=>!!f.value&&s.value.length>0&&!P.value.length),be=M.computed(()=>Y.value&&!B.value.trim()&&h.value==="all"?ge(f.value,0,"pages"):s.value.length?"No pages match.":"No pages yet - New page in the banner makes one."),ye=M.computed(()=>{const e=V.value;return!u||!e?"":`Showing only pages in ${u}. ${e} other page${e===1?" is":"s are"} filed elsewhere.`}),K=M.computed(()=>Qe(k.value,s.value,b.value)),we=M.computed(()=>ge(f.value,P.value.length,"pages")),G=e=>s.peek().find(t=>t.urlPath===e);async function ke(){try{const e=await Be(c.querySelector(".dm-loading-slot"),g.pages.list(),je.rows);if(!N())return;const t=Array.isArray(e)?e:[],a=u?ue(t,u):t;V.value=t.length-a.length,s.value=a,R.value="",await J()}catch(e){R.value=`Could not load the pages: ${e.message||e}`}finally{z.value=!1}}async function J(){try{const e=await g.listTags.load("pages");b.value=e.tools,k.value=e.tags}catch{}}async function Q(e,t){try{const a=await g.listTags.changeItem("pages",e.urlPath,t);s.value=s.peek().map(i=>i.urlPath===e.urlPath?{...i,adminTags:a}:i);const n=a.filter(i=>!k.peek().some(m=>Ge(m.name,i)));n.length&&(k.value=[...k.peek(),...n.map(i=>({name:i}))])}catch(a){E.toast(`Tags not saved: ${a.message||a}`,{type:"error"})}}async function Pe(){const e=await g.pages.list(),t=Array.isArray(e)?e:[];s.value=u?ue(t,u):t,await J()}const Me=()=>Ye({kind:"pages",noun:"pages",title:"Pages settings - tags",tags:K,tools:b,active:f,reload:Pe}),A=e=>{location.hash=at(e)},Ee=()=>{location.hash=u?`#/pages/new?project=${encodeURIComponent(u)}`:"#/pages/new"};async function Te(e){const t=e.plugin?`"${C(e.title||e.urlPath)}" is managed by the <strong>${C(e.plugin)}</strong> plugin - deleting it may stop that plugin working. Delete it anyway?`:`Delete the page at <strong>${C(e.urlPath)}</strong>? This cannot be undone.`;if(await E.confirm(t))try{await g.pages.delete(e.urlPath),E.toast("Page deleted.",{type:"success"}),s.value=s.peek().filter(a=>a.urlPath!==e.urlPath),de(ve)}catch(a){E.toast(`Not deleted: ${a.message||a}`,{type:"error"})}}async function xe(e){const t=new URL(e.urlPath,location.origin).href;try{await navigator.clipboard.writeText(t),E.toast("Address copied.",{type:"success",duration:2e3})}catch{E.toast(t,{type:"info",duration:8e3})}}async function H(e,t){if(e.status!==t)try{const a=await g.pages.get(e.urlPath);await g.pages.update(e.urlPath,{frontmatter:{status:t},body:a.content||""}),s.value=s.peek().map(n=>n.urlPath===e.urlPath?{...n,status:t}:n),E.toast(t==="published"?"Page published.":t==="review"?"Page moved to review.":"Page moved to drafts.",{type:"success"}),de(ve)}catch(a){E.toast(`Could not change page status: ${a.message||a}`,{type:"error"})}}let v=null;const F=new Set;let X=!1;function Z(e,t=null){const a=e.versionCount||0,n=M.observable(String(t?.keep??Math.min(5,a))),i=M.observable(!1),m=M.computed(()=>Ue(n.value,a)),se={keep:n,saving:i,err:M.computed(()=>m.value.error),summary:M.computed(()=>{const o=m.value;return o.error?"":o.deletes?`Deletes the ${o.deletes} oldest, keeps the newest ${Math.min(o.keep,a)}.`:"Nothing to delete - that keeps them all."}),cannot:M.computed(()=>i.value||!!m.value.error||m.value.deletes===0),intro:`${e.title||e.urlPath} has ${a} saved revision${a===1?"":"s"} - earlier versions you can compare with and restore from the editor's History.`},Ae=String(n.peek()),ne=()=>String(n.peek())!==Ae||!!t,d=E.slideover({title:`Trim revisions - ${C(e.title||e.urlPath)}`,size:"sm",position:"right"}),y=tt(`
|
|
14
14
|
<div class="pgx-form">
|
|
15
15
|
<p class="pgx-note" data-bind-text="intro"></p>
|
|
16
16
|
<div>
|
|
@@ -26,4 +26,4 @@ import{api as p}from"../api.js";import{SHAPES as Le,whileLoading as Ne}from"../l
|
|
|
26
26
|
<button type="button" class="btn btn-sm btn-danger" data-on-click="trim" data-bind-disabled="cannot.value">
|
|
27
27
|
<span data-icon="archive" data-icon-size="13"></span> Trim</button>
|
|
28
28
|
</div>
|
|
29
|
-
</div>`);async function
|
|
29
|
+
</div>`);async function oe(){if(!se.cannot.peek()){i.value=!0;try{const o=await g.versions.prune(e.urlPath,m.peek().keep);E.toast(`Removed ${o.deleted} revision${o.deleted===1?"":"s"}; kept ${o.kept}.`,{type:"success"}),s.value=s.peek().map(x=>x.urlPath===e.urlPath?{...x,versionCount:o.kept}:x),_=!0,d.close()}catch(o){E.toast(o.message||"Could not trim the revisions.",{type:"error"})}finally{i.value=!1}}}d.element.appendChild(y);const De=re(y),Le=M.applyBindings(se,y,{methods:{trim:oe,cancel:()=>d.close()}}),Ne=o=>{o.key==="Enter"&&o.target.id==="pgx-f-keep"&&(o.preventDefault(),oe())};y.addEventListener("keydown",Ne);const le={path:e.urlPath,dirty:ne,values:()=>({keep:n.peek()})};v=le,F.add(d),qe(d,()=>{Le.dispose(),De(),F.delete(d),v===le&&(v=null)});const Re=d.close.bind(d);let _=!1,O=!1;d.close=async o=>{if(!_&&o!==!0&&!X&&ne()){if(O)return;O=!0;const x=await E.confirm("Discard the change you have not applied?");if(O=!1,!x)return}return _=!0,Re()},I.scan(y),d.open(),y.querySelector("#pgx-f-keep")?.select()}function Se(e){const t=G(e);if(!t)return[];const a=t.versionCount||0;return[{header:t.title||t.urlPath},{label:"Edit",icon:"edit",action:()=>A(t.urlPath)},{label:t.status==="published"?"View on the site":"Preview (draft)",icon:"external-link",action:()=>window.open(t.urlPath,"_blank","noopener")},{label:"Copy address",icon:"copy",action:()=>xe(t)},{label:"Transition",icon:"circle",submenu:[{label:"Published",disabled:t.status==="published",action:()=>H(t,"published")},{label:"Draft",disabled:t.status==="draft",action:()=>H(t,"draft")},{label:"Review",disabled:t.status==="review",action:()=>H(t,"review")}]},{type:"divider"},...Xe({all:We(K.peek()),current:Ze(t),change:n=>Q(t,n),newTag:async()=>{const n=await ze(K.peek(),b.peek());n&&await Q(t,{add:[n]})}}),{type:"divider"},{label:a?`Trim revisions (${a})\u2026`:"No revisions to trim",icon:"archive",disabled:!a,action:()=>Z(t)},{type:"divider"},{label:"Delete\u2026",icon:"trash",danger:!0,action:()=>Te(t)}]}const p=c.querySelector(".pgx-list");p.innerHTML=et;const Ce=M.applyBindings({pages:s,loading:z,loadError:R,status:h,sort:j,mode:w,query:B,rows:q,counts:fe,emptyText:be,projectNote:ye,tagNote:we,tagEmpty:Y},c,{methods:{showAllTags:()=>{f.value=""},showAll:()=>{h.value="all"},showPublished:()=>{h.value="published"},showDrafts:()=>{h.value="draft"},showList:()=>{w.value="list"},showTree:()=>{w.value="tree"}}});l.add(()=>Ce.dispose()),l.add(re(c,{position:"bottom"})),l.add(M.effect(()=>{q.value,requestAnimationFrame(()=>{p.isConnected&&I.scan(p)})}));const U=c.querySelector(".pgx-tree");let D=null;l.add(M.effect(()=>{const e=w.value==="tree",t=e?Ve(P.value):null;try{D?.destroy?.()}catch{}D=null,U.replaceChildren(),!(!e||!t.length)&&(D=E.treeView(U,{data:t,idKey:"id",parentKey:"parent_id",labelKey:"name",iconKey:"icon",expandedByDefault:!0,onSelect:a=>A(a)}),I.scan(U))})),l.add(()=>{try{D?.destroy?.()}catch{}});const $e=E.contextMenu(p,{cursor:"glyph",match:".pgx-row",inherit:!1,density:"compact",items:e=>Se(e.dataset.path)});l.add(()=>$e?.destroy?.());const ee=e=>{const t=e.target.closest(".pgx-row");if(!t)return;const a=e.target.closest(".pgx-kebab");if(a){ce(a);return}A(t.dataset.path)},te=e=>{const t=e.target.closest(".pgx-row");t&&(e.key==="F10"&&e.shiftKey?(e.preventDefault(),ce(t)):e.key==="Enter"&&e.target===t&&A(t.dataset.path))};p.addEventListener("click",ee),p.addEventListener("keydown",te),l.add(()=>{p.removeEventListener("click",ee),p.removeEventListener("keydown",te)}),ie(r,{id:"pages-settings",icon:"settings",title:"Pages settings - tags",onClick:Me}),ie(r,{id:"pages-new",icon:"plus",title:"New page",onClick:Ee});const ae=e=>{v?.dirty()&&(e.preventDefault(),e.returnValue="")};if(window.addEventListener("beforeunload",ae),l.add(()=>window.removeEventListener("beforeunload",ae)),l.add(()=>{if(v?.dirty())try{S.set(L,{path:v.path,values:v.values(),at:new Date().toISOString()})}catch{}X=!0,[...F].forEach(e=>{try{e.close(!0)}catch{}})}),I.scan(c),await ke(),!N())return;let T=null;try{T=S.get(L)}catch{}if(T?.path&&T.values){try{S.remove?S.remove(L):S.set(L,null)}catch{}const e=G(T.path);e&&(e.versionCount||0)>0&&await E.confirm(`You left trimming the revisions of "${C(e.title||e.urlPath)}" unfinished. Pick up where you left off?`)&&N()&&Z(e,T.values)}}};
|
package/docs/DommaFeatures.md
CHANGED
|
@@ -29,6 +29,7 @@ Code was treated as the truth. Where docs disagree with it, the disagreement is
|
|
|
29
29
|
|
|
30
30
|
| Plugin | Tier | Version | In one line |
|
|
31
31
|
|---|---|---|---|
|
|
32
|
+
| `anagram` | paid (giftable) | 1.0.0 | Word puzzles against the clock: unscramble the letters (any other real word of the same letters counts too) or climb a word ladder one letter at a time. Random rounds each go, or a daily set everyone shares. Skip and hints for a time penalty, leaderboards, personal best, Share, export and import. |
|
|
32
33
|
| `analytics-pro` | paid | 2.3.4 | Visitors, visits and page views: where visitors came from (sources, campaigns, channels, country and city by GeoIP), IP addresses, each visit's pages in order, devices and browsers, busiest times and a live view. Cookieless. Several display styles, CSV/JSON export and a printable report. |
|
|
33
34
|
| `backup-pro` | paid | 0.1.4 | A site's own view of the backups Domma keeps of it: how they stand, every backup, Back up now, restore of the whole site or chosen collections, pages or media after a safety backup, downloads without secrets, and Activity - every backup, restore and change, including Domma's own, named and never hidden. Needs a site run by Domma. |
|
|
34
35
|
| `blog` | free | 1.9.6 | Public-facing blog with posts, categories and comments - layouts and listings built from editable blocks. |
|
|
@@ -46,22 +47,29 @@ Code was treated as the truth. Where docs disagree with it, the disagreement is
|
|
|
46
47
|
| `email-pro` | paid | 0.13.0 | Full mail (and Campaigns Pro's "send from my mailbox"): read, write, send and search, over a synchronised store. Search, threads, rules, scheduled sends, snooze and vacation replies need MongoDB; without it, reading, filing and sending still work. |
|
|
47
48
|
| `feedback` | free | 1.1.4 | Tell Domma what is broken, missing or good - straight from your admin - and see what became of it: seen, planned, in progress, done, with Domma's reply. |
|
|
48
49
|
| `garage` | paid | 1.4.3 | UK vehicle management with DVLA API lookup, save vehicles, and search history. |
|
|
50
|
+
| `hangman` | paid (giftable) | 1.0.0 | Guess the hidden word or phrase letter by letter before the drawing is finished - a stick figure, or balloons that pop for family sites. Random rounds or the same words for everyone each day; hints, leaderboards, personal best, Share, export and import. |
|
|
49
51
|
| `invoice` | paid | 1.7.1 | Invoices and quotes. Issuer profiles, receivers importable from Contacts, line items, optional VAT, payments, archiving, CSV/Excel export, and a print-ready invoice you can email or download as a PDF. Quotes with a validity date and an emailed accept link - the client accepts or declines online, and one click turns an accepted quote into a draft invoice. Self-billing too: invoices raised on a supplier's behalf, marked and numbered their own way, with agreement review reminders. |
|
|
52
|
+
| `jigsaw` | paid (giftable) | 1.0.0 | Any picture in Media becomes a jigsaw: Easy, Medium, Hard or your own size, classic or square pieces, optional turned pieces and a ghost picture. Drag, tap or use the keyboard; the server keeps the clock and where each piece goes. Fastest leaderboard, hints, export and import. |
|
|
50
53
|
| `job-board` | paid | 2.0.0 | Job board with three kinds of account - companies, their agents and candidates - sign-up for each (companies when opened, approved by staff), credits that pay for publishing a role (Stripe, staff gifts, company-to-agent), IR35 on every contract, candidate bios, work history and preferences, agents onboarding and messaging their candidates, interviews, notes and reviews - every record scoped to who may see it. |
|
|
51
54
|
| `mail-reader` | free | 1.2.7 | Read-only IMAP mailbox reader. Connects to a standard IMAP server and reads mail without ever writing to it. |
|
|
55
|
+
| `memory-pairs` | paid (giftable) | 1.0.0 | Turn two cards over at a time to find the pairs: the same picture twice, a picture and its words, or two texts (term and meaning). 4 to 24 pairs, a fresh shuffle each go kept on the server. Fewest moves wins, then fastest; hints, personal best, Share, export and import. |
|
|
52
56
|
| `messages` | paid | 1.7.2 | Internal user-to-user and group messaging with real-time delivery and video calls (what is typed in a call lands in the conversation; ring another team member into a call) - conversations you can archive, mark unread and search, drafts kept per conversation, attachments, and an unread badge in the sidebar. |
|
|
53
57
|
| `mongodb-adapter` | paid | 1.0.2 | Provision a dedicated MongoDB database per site. Credentials are managed centrally by the manager. |
|
|
54
58
|
| `onboard-pro` | paid | 1.0.1 | Onboarding journeys, one paid Tool: read/form/details/manual steps, a personal link per person, signature steps through Docs Pro, admin-approved account steps (never an administrator), due dates, automatic nudges and auto-enrolment from a contact group, countersigned steps, waive-with-a-reason, and a funnel showing where people stop. |
|
|
59
|
+
| `personality-quiz` | paid (giftable) | 1.0.0 | "Which one are you?" quizzes with no wrong answers: 2-8 outcomes, each with a picture and a button to an offer or page. Optional lead capture (an email before the result, with consent, into Contacts if you like), a Leads screen with CSV, and stats on every answer. |
|
|
60
|
+
| `predictions` | paid (giftable) | 1.0.0 | A predictions league that runs for weeks: rounds of fixtures (predict the score) and questions (pick the answer). Predictions lock at kick-off; you enter results and the table works itself out, with movement arrows, jokers and optional approval for new members. |
|
|
61
|
+
| `prize-wheel` | paid (giftable) | 1.0.0 | Spin to win: a prize wheel or a scratch card with 3-12 prizes, each with its own chance and stock. Rewards are a message, a code, a unique code from your list, or a single-use Shop discount code from Shopping Cart Pro. Entry by email with consent, spins per person, a daily cap; the server picks every prize. |
|
|
55
62
|
| `quiz` | paid (giftable) | 1.5.0 | Timed quizzes on your site: one or several right answers, true or false, or a typed answer, marked by the server so answers never reach the browser early. Name-only players, leaderboards by day, week, month and all time. Hints for a time penalty, personal best and Share, animations, export and import. Test it from the Tool - a test go never reaches the board. Rotation (a new quiz every day or week from a queue, off by default) and fresh quizzes from Domma for review. |
|
|
56
63
|
| `security` | free | 1.1.3 | Keeps a Domma CMS site safe: a health check of what is weak and how to fix it, sign-in lockout after repeated wrong passwords, password rules, a log of every sign-in, and blocking of the scanners that probe every site for WordPress, .env files and the like. |
|
|
57
64
|
| `security-pro` | paid | 1.3.2 | Everything in Security, plus two-factor sign-in (authenticator apps, recovery codes, required per role), a firewall that bans scanners for longer each time they return, per-route rate limits, country rules for the admin, breached-password checks and every signed-in session in one place. |
|
|
58
65
|
| `seo-pro` | paid | 0.6.2 | More for SEO: Google Search Console in the admin (with your own Google client) - searches, clicks, positions and where to win more; structured data for rich results (FAQ, how-to, product, event, local business); links worth adding between pages, pages competing for one search, readability, near duplicates and image checks; every title and description in one grid, and moving an old site's addresses across as redirects; a not-found log with one-click redirects; a scheduled check of every link; SEO history and notices. Adds to SEO, which is built into Domma CMS (0.90 and later). |
|
|
59
66
|
| `sheets` | paid | 0.4.1 | A spreadsheet in your admin: workbooks with formulas, sorting and filters; import CSV, JSON or Excel, export CSV or Excel, print. Feed a sheet live from Contacts, collections, forms, Surveys, Campaigns, Analytics or the Shop - rows kept even if the source goes away. |
|
|
60
67
|
| `shopping-cart` | free | 1.6.1 | Sell from your site: products with options, stock and pictures, a storefront and a cart that follows shoppers from page to page, and checkout with Stripe, PayPal or payment offline. Orders to fulfil in the sidebar, refunds from the order. |
|
|
61
|
-
| `shopping-cart-pro` | paid | 0.
|
|
68
|
+
| `shopping-cart-pro` | paid | 0.3.2 | More for the Shop: discount codes (other Tools such as Prize Wheel can make single-use ones), shipping zones with rates by weight or order value, tax by country and class, branded order emails from confirmation to dispatch, and Insights - takings by week, best sellers, repeat customers and abandoned checkouts you can nudge. Adds to the free Shopping Cart; a lapsed licence leaves the Cart and every order just as they were. |
|
|
62
69
|
| `social-media-pro` | paid | 0.4.0 | How the site looks when it is shared, and posting it: share cards per page for Facebook, X, LinkedIn, WhatsApp and Slack with previews; a share image drawn for every page that has none, in the site's colours; share and follow buttons; posting to Bluesky, Mastodon and LinkedIn (through the site's own LinkedIn app, with a reminder before its 60-day sign-in runs out) - now, scheduled, or drafted automatically for every new blog post or page - with links tagged for Analytics and the posts on the Calendar; and LinkedIn conversions - chosen forms reported to LinkedIn's Conversions API when a visitor who accepted marketing cookies sends one. Sold with SEO Pro. |
|
|
63
70
|
| `surveys` | paid | 1.5.1 | Targeted surveys over the Forms engine: shared audiences, tokenised invites, reminders, and per-survey statistics. |
|
|
64
71
|
| `theme-roller` | paid | 1.1.3 | Make your own themes: start from any built-in theme, change its colours, fonts, spacing and borders with a live preview, and save it. Saved themes join the built-in ones everywhere a theme is chosen - the site, the admin, day and night, a region of a page. Needs Domma CMS 0.73 or later to use them. |
|
|
72
|
+
| `treasure-hunt` | paid (giftable) | 1.0.0 | Hide 2-30 tokens across your pages and send visitors looking for them, in any order or one clue at a time. A progress chip follows players from page to page; finishers get a prize message and a code (one for all, or a unique code each). First-to-finish or fastest leaderboard. |
|
|
65
73
|
| `waypoint-pro` | paid | 1.3.1 | Plan and track work: projects with their own workflows, issues on a board or in a list, a backlog planned into sprints with a burndown, and comments, mentions and watchers that tell the right people. |
|
|
66
74
|
| `word-search` | paid (giftable) | 1.2.0 | Word searches on your site: type up to 40 words and the server lays out the letter grid (across, down, diagonal, backwards too if you like). Players drag, tap or use the keyboard to mark each word against the clock; wrong marks cost time, fastest full solve wins. Hints, personal best, Share, animations, export and import. |
|
|
67
75
|
|
|
@@ -1460,7 +1468,7 @@ Domma CMS is extended by plugins: self-contained folders under `plugins/<slug>/`
|
|
|
1460
1468
|
- **Current register (marketplace, 24 plugins)** - versions in the [catalogue table](#marketplace-catalogue).
|
|
1461
1469
|
- Free (6, shipped with the engine): `blog`, `booking`, `feedback`, `mail-reader`, `security`, `shopping-cart`.
|
|
1462
1470
|
- Paid (21): `analytics-pro`, `blog-pro`, `booking-pro`, `calendar`, `contacts-pro`, `data-transfer`, `docs`, `docs-pro`, `email-pro`, `garage`, `invoice`, `job-board`, `messages`, `mongodb-adapter`, `security-pro`, `seo-pro`, `shopping-cart-pro`, `social-media-pro`, `surveys`, `theme-roller`, `waypoint-pro`.
|
|
1463
|
-
- Paid and giftable (
|
|
1471
|
+
- Paid and giftable (12, the Games): `quiz`, `crossword`, `word-search`, `daily-word`, `personality-quiz`, `hangman`, `anagram`, `jigsaw`, `memory-pairs`, `treasure-hunt`, `prize-wheel`, `predictions`.
|
|
1464
1472
|
- **Free-and-Pro pairs** - A Pro edition declares `supersedes` on its free sibling, so only one runs: Blog Pro → Blog, Email Pro → Mail Reader, Security Pro → Security, Contacts Pro → Contacts (built-in Tool takeover). Shopping Cart Pro and SEO Pro instead `requires` their free base (`shopping-cart`, the `seo` Tool).
|
|
1465
1473
|
- **MongoDB-dependent plugins** - Email Pro ("Requires MongoDB" in its description), Data Transfer (moves collections between file and MongoDB storage) and MongoDB Adapter (managed-only: reads a `config/connections.json` the manager writes during provisioning). There is no manifest field for a Mongo requirement - it is stated only in the description text. Core already supports Mongo storage for free via `storage: {adapter: "mongodb"}` in a schema.
|
|
1466
1474
|
- Where: design spec "Managed-only plugins"
|
|
@@ -2510,6 +2518,68 @@ All four share the engine's games library (`plugins/_lib/games`: plays, tokens,
|
|
|
2510
2518
|
- **Rotation** (Quiz 1.5.0, Crossword 1.5.0, Word Search 1.2.0; engine 1.10.0) - **off by default**. A game can be **Queued** (never shown to the public until its turn). **Rotate** Off / Every day / Every week (a weekday), in a Rotation card above each list: at the site's midnight the next queued game opens and the last one rotation opened closes into an archive - still playable, its plays (`archive: true`) never on a board, place or goes-per-name. Idempotent: `lastRotatedDay` in the Tool's `data/rotation.json`, plus a check that no game was already opened by rotation that day, so a restart at 00:00:30 never rotates twice; a one-minute timer in the Tool, no cron. An empty queue leaves today's game up. Drag to reorder the queue; take one out. `[quiz rotate /]` (and `[crossword rotate]`, `[word-search rotate]`) shows today's game with the earlier ones below; `[<game>-leaderboard rotate /]` today's board. Notices `queue-low` (under three days queued) and `queue-empty`. Engine: `plugins/_lib/games/rotation.js` (pure rules + runner), `rotation-http.js` (`GET/PUT /rotation`, `PUT /queue`, `POST /approve`, `POST /unqueue`, `GET /content/status`, `GET /public/rotation`), `_lib/public/games/rotation.js`, `_lib/admin/games/rotation.js`; tests `tests/plugins/games-rotation.test.js`.
|
|
2511
2519
|
- **Fresh games from Domma** (the Manager's Games content, off by default per site) - quizzes, crosswords and word searches written by Claude (Haiku) on the site's theme (or one picked at random each night when it has none) arrive through `POST /import` with `{source: 'domma-content', status}` as **drafts marked From Domma** (or queued, with the site's auto-publish), and the admins get a `content-ready` notice. The Rotation card's **Show only these** and **Approve all**; Approve / Take out of the queue in each row's menu. Daily Word 1.3.0: **Top up** on a word set (off by default) takes common words picked by the Manager (no Claude, never repeated within two years) into `pending` for **Approve all** / **Discard** in the editor or the list's menu (`POST /content/words`, `POST /sets/:id/pending`). Only while the Tool asks for it: Rotate on, or a set with Top up.
|
|
2512
2520
|
|
|
2521
|
+
### More Games: Personality Quiz, Hangman, Anagram, Jigsaw, Memory Pairs, Treasure Hunt, Prize Wheel, Predictions
|
|
2522
|
+
|
|
2523
|
+
Tier: paid and giftable, closed source · Version: 1.0.0 each (2026-10-29) · Needs: Domma CMS 1.10.0 (the shared games library) · Sidebar: Tools > Games · Permissions: one each in the Games group (See / Manage). Each is its own Tool in `dcms-marketplace/plugins/<slug>/` with a user guide (`docs/guide.md`, in the admin Documentation), test plays from the Tool, export and import (`domma-<slug>` version 1, arriving as drafts), animations from `_lib/public/games/motion.*` (never under reduced motion) and all UI in domma-reactive. None joins `[games-leaderboards]` or rotation yet.
|
|
2524
|
+
|
|
2525
|
+
#### Personality Quiz (`personality-quiz`)
|
|
2526
|
+
|
|
2527
|
+
- "Which one are you?" quizzes with no wrong answers: 2-8 outcomes (description, picture, optional button to an offer or page) and single-choice questions whose answers give points to outcomes; ties go to the outcome higher in the list (drag to reorder).
|
|
2528
|
+
- The editor warns of an outcome no answer can reach; the server works out the result, and the points never reach the browser.
|
|
2529
|
+
- One question at a time with progress, Back and keys 1-8; name off, optional or required; Share gives the outcome title only.
|
|
2530
|
+
- Leads (per quiz, off by default): an email before the result, required or skippable, with a consent box worded Tool-wide (settings cog); consenting leads can go into Contacts. Leads screen with CSV; Stats with completion rate, outcome bars and each question's answer split.
|
|
2531
|
+
- `[personality-quiz id="..." /]`; notifications `new-lead` and `daily-summary` (both off by default); sidebar badge for new leads.
|
|
2532
|
+
|
|
2533
|
+
#### Hangman (`hangman`)
|
|
2534
|
+
|
|
2535
|
+
- Guess a hidden word or phrase letter by letter; spaces, hyphens and apostrophes are shown and never guessed. Words a go 1-20, wrong guesses 4-10, time limit, hints (one letter for a time penalty).
|
|
2536
|
+
- Random mode (the server draws each go's round) or Daily (the same words for everyone each day, one go per name per day; a played day's words cannot change).
|
|
2537
|
+
- The server holds the words: players get only blanks, and each word once it has ended. Board: words solved, then fewest wrong guesses, then time.
|
|
2538
|
+
- Drawing (settings cog): Classic stick figure, or Balloons that pop for family and children's sites.
|
|
2539
|
+
- `[hangman id="..." board="show|hide|only" /]`, `[hangman-leaderboard id="..." /]`; notices `top-score` (random games) and `running-low` (daily, 7 days or fewer left).
|
|
2540
|
+
|
|
2541
|
+
#### Anagram (`anagram`)
|
|
2542
|
+
|
|
2543
|
+
- Anagram rounds: the server scrambles each word (never the word itself, never a blocked word); any other real word of the same letters counts unless "Only the listed word counts" is on. Word list (ENABLE, 3-8 letters) on the server only.
|
|
2544
|
+
- Word ladders (3-6 letters): start to end one letter a step, each step a real word; every pair is measured on save and pairs with no ladder are refused. Score: rounds solved, then steps over the shortest, then time.
|
|
2545
|
+
- Random rounds each go, or daily (same rounds for everyone, one go a name a day, a board per day). Skip and hints with penalties, time limit, tap or type tiles, Shuffle.
|
|
2546
|
+
- `[anagram id="..." /]`, `[anagram-leaderboard id="..." /]`; notices `fastest` and `running-low`.
|
|
2547
|
+
|
|
2548
|
+
#### Jigsaw (`jigsaw`)
|
|
2549
|
+
|
|
2550
|
+
- Any picture in Media: Easy / Medium / Hard (rows and columns from the picture's shape) or 3x3 to 12x12; classic pieces (seeded tabs and blanks, New cuts) or square; optional turned pieces and a ghost picture. Live preview in the editor.
|
|
2551
|
+
- The server cuts each play's pieces into a shuffled, masked WebP sprite (sharp) under opaque ids, so a piece's place is revealed only once it is placed; drops are capped per piece.
|
|
2552
|
+
- Drag (mouse or touch), tap then tap, or keyboard (Tab, arrows, Enter, R); full screen; fits a 390px phone. Optional wrong-piece seconds, time limit, hints.
|
|
2553
|
+
- `[jigsaw id="..." /]`, `[jigsaw-leaderboard id="..." /]`; notices `fastest` and `picture-missing`.
|
|
2554
|
+
|
|
2555
|
+
#### Memory Pairs (`memory-pairs`)
|
|
2556
|
+
|
|
2557
|
+
- Pairs: the same picture twice, a picture and its words, or two texts; 4 to 24 pairs. Card backs in the site colour, a pattern or a picture.
|
|
2558
|
+
- The server deals a fresh shuffle per play and sends a card's face only when it is turned over; at most two unmatched cards are up. Fewest moves wins, then time.
|
|
2559
|
+
- 3D card flip (instant for reduced motion), keyboard and touch, hints (peek one pair), time limit.
|
|
2560
|
+
- `[memory-pairs id="..." /]`, `[memory-pairs-leaderboard id="..." /]`; notices `fastest` and `perfect` (off by default).
|
|
2561
|
+
|
|
2562
|
+
#### Treasure Hunt (`treasure-hunt`)
|
|
2563
|
+
|
|
2564
|
+
- 2-30 tokens, each with its own `[treasure-token hunt="..." token="..." /]` to paste into a page; the editor shows which pages and blocks hold each token and warns of any placed nowhere.
|
|
2565
|
+
- Any order, or in order (one clue at a time; a token found early says "not yet"). Tokens show only while the hunt is open or to a player of it; no public route lists them.
|
|
2566
|
+
- A progress chip follows players page to page (corner and on/off in the settings cog). Prize message, optional link, and a code: one for all or a unique code each from a pasted list, never handed out twice.
|
|
2567
|
+
- `[treasure-hunt hunt="..." /]`, `[treasure-hunt-leaderboard hunt="..." /]` (first to finish or fastest); finishers CSV; notices `finished` and `codes-low`.
|
|
2568
|
+
|
|
2569
|
+
#### Prize Wheel (`prize-wheel`)
|
|
2570
|
+
|
|
2571
|
+
- A wheel or a scratch card with 3-12 prizes, each with a chance, a stock and a reward: nothing, a message, a shared code, a unique code from a pasted list, or a single-use Shopping Cart Pro discount code (percent or amount, minimum spend, days it lasts) made through Cart Pro's codes door (0.3.2), so it works at checkout at once.
|
|
2572
|
+
- The server draws every prize (crypto random, weighted, stock and codes checked in one lock) before the wheel turns; a prize that has run out is never drawn.
|
|
2573
|
+
- Entry by email with consent (worded in the settings cog), optional name, spins per email a day or ever, a soft per-browser limit, a daily cap, opens and closes; winners can be emailed their code.
|
|
2574
|
+
- Entries screen (Cart Pro codes used or not, Redeemed ticks, CSV), test spins that use no stock. `[prize-wheel id="..." /]`; notices `winner` (off by default) and `stock-low`.
|
|
2575
|
+
|
|
2576
|
+
#### Predictions (`predictions`)
|
|
2577
|
+
|
|
2578
|
+
- A league of rounds: fixtures (predict the score) and questions (2-8 answers). Paste a week of fixtures at once ("Home v Away, 2026-11-01 15:00"). Predictions lock at kick-off or the round deadline, kept by the server; nobody sees anyone else's picks before then.
|
|
2579
|
+
- Members join with a unique name, optional email and a sign-in code shown once (and emailed) for other devices; optional approval. Only hashes of keys and codes are stored.
|
|
2580
|
+
- Results a round at a time; points and the table are worked out afresh from every result (exact score, right result, optional goal difference bonus, question points, jokers that double a round), with movement arrows. Void items.
|
|
2581
|
+
- `[predictions league="..." /]`, `[predictions-table league="..." round="..." /]`; badge for results waiting; notices `results-due` and `new-member`.
|
|
2582
|
+
|
|
2513
2583
|
### Other plugin directories
|
|
2514
2584
|
|
|
2515
2585
|
No other directories exist in `dcms-marketplace/plugins/` beyond the plugins above and `_lib`. `_lib` is not a plugin (skipped by plugin discovery): it holds the shared mail core used by Mail Reader and Email Pro, plus shared `dataStore.js` and `schemaSync.js`.
|
|
@@ -2609,6 +2679,8 @@ Later changes to these features are in the CHANGELOG (for example 0.92.1: row-le
|
|
|
2609
2679
|
|
|
2610
2680
|
### Plugins & the Marketplace platform
|
|
2611
2681
|
|
|
2682
|
+
- A Halloween or Christmas page: a Treasure Hunt across five pages with a Prize Wheel at the end, and a Personality Quiz collecting leads.
|
|
2683
|
+
- A football club's season: a Predictions league with a week of fixtures pasted in, and the table on the home page.
|
|
2612
2684
|
- A games page: a Daily Word set with a month of answers, a Word Search and a Quiz on one page, with `[games-leaderboards]` below them; hints with a penalty, and moving a game to another site with Export and Import.
|
|
2613
2685
|
- A page that never needs editing: queue a week of quizzes, switch Rotate on, put `[quiz rotate /]` on the page, and approve Domma's fresh quizzes as they arrive.
|
|
2614
2686
|
- Gifting a Tool from the Manager: gift a Game for 30 days, extend it, make it for good, and end it.
|
package/docs/api-reference.md
CHANGED
|
@@ -444,15 +444,17 @@ Delete a page.
|
|
|
444
444
|
|
|
445
445
|
## List tags (`/api/list-tags/:kind`)
|
|
446
446
|
|
|
447
|
-
Admin-only tags that link pages or
|
|
447
|
+
Admin-only tags that link pages, blocks or collections together, so the admin lists can be narrowed to one tag. `:kind` is `pages`, `blocks` or `collections`. A page stores its tags as `adminTags` in its frontmatter and a block in `meta.adminTags`; a collection's are kept in `config/list-tags.json` as `collectionTags: {slug: [tags]}` (never in its `schema.json`, which presets rewrite on boot), and come back as `adminTags` on each row of `GET /api/collections`. The names are kept in `config/list-tags.json` too. Nothing on the public site reads them. Every change applies only to the items the caller's projects allow. Pages and blocks need the `pages` permission; collections need `collections` (read to list, update to change).
|
|
448
|
+
|
|
449
|
+
**Tool tags.** Everything a Tool owns wears that Tool's name as a tag, worked out on each request and never stored: a collection's `plugin` (and the built-in Notes, Todo and Contacts collections), a block's `meta.plugin`, a page's frontmatter `plugin`. The name is the plugin manifest's `displayName` (or the built-in Tool's name), else the slug in title case. They come back with `tool: true`; they cannot be added, renamed or deleted, and no manual tag may take a Tool tag's name (400).
|
|
448
450
|
|
|
449
451
|
| Method | Path | Body | Auth |
|
|
450
452
|
|--------|------|------|------|
|
|
451
|
-
| GET | `/api/list-tags/:kind` | - |
|
|
452
|
-
| POST | `/api/list-tags/:kind` | `{name}` |
|
|
453
|
-
| PUT | `/api/list-tags/:kind/item` | `{id, tags}`
|
|
454
|
-
| POST | `/api/list-tags/:kind/rename` | `{from, to}` |
|
|
455
|
-
| POST | `/api/list-tags/:kind/delete` | `{name}` |
|
|
453
|
+
| GET | `/api/list-tags/:kind` | - | read - `{tags: [{name, count, tool?}], tools: {slug: displayName}}` |
|
|
454
|
+
| POST | `/api/list-tags/:kind` | `{name}` | update - creates a tag |
|
|
455
|
+
| PUT | `/api/list-tags/:kind/item` | `{id, tags}` or `{id, add, remove}` | update - `id` is the page's urlPath, the block's name or the collection's slug; adds no page revision |
|
|
456
|
+
| POST | `/api/list-tags/:kind/rename` | `{from, to}` | update - `{name, changed}`; renaming onto an existing tag merges the two |
|
|
457
|
+
| POST | `/api/list-tags/:kind/delete` | `{name}` | update - `{changed}`; the items stay |
|
|
456
458
|
|
|
457
459
|
---
|
|
458
460
|
|