domma-cms 1.31.0 → 1.32.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.
@@ -29,9 +29,11 @@ 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
+ | `advent-calendar` | paid (giftable) | 1.0.0 | A calendar of 1 to 31 doors, one opening each day: an advent calendar or a countdown to a launch or event. Behind each door a message, picture, link and a code (shared, unique from a list, or a single-use Shop code), never sent before its day; codes limited per visitor and per connection. |
32
33
  | `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. |
33
34
  | `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. |
34
35
  | `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. |
36
+ | `bingo` | paid (giftable) | 1.0.0 | Bingo for quiz nights, events and classrooms: 75-ball, 90-ball tickets, or word and picture cards. A caller screen with auto-draw and a projector view, players on their phones with server-dealt cards, claims checked against the real calls, and printable numbered cards with a checker. |
35
37
  | `blog` | free | 1.9.6 | Public-facing blog with posts, categories and comments - layouts and listings built from editable blocks. |
36
38
  | `blog-pro` | paid | 0.7.0 | Several blogs on one site, each with its own address, look and settings - dozens of layouts, self-hosted fonts, colours, page transitions, author pages, and privacy-first media: videos, audio, galleries, link cards and maps. |
37
39
  | `booking` | free | 1.6.3 | Let people book appointments with you or your team, and rooms or equipment, from a booking page on your site (`/booking`, or the `[booking /]` shortcode). Opening hours, days off, buffers and notice; confirmation and reminder emails with a link to move or cancel; a Diary in the admin; an online booking's call chat kept on the booking, and Add people during its call. Book straight from a contact or an email; bookings show in the Calendar. |
@@ -39,7 +41,7 @@ Code was treated as the truth. Where docs disagree with it, the disagreement is
39
41
  | `calendar` | paid | 1.15.4 | Events calendar - month, day and list views, online meetings as a video call on your site (with the call's chat kept, and Add people during the call), call anyone now from a contact or an email, all-day and recurring events, sharing with people and roles, RSVPs and an iCal feed. |
40
42
  | `campaigns-pro` | paid | 1.6.0 | Marketing campaigns, one paid Tool: compose a message, send it to Contacts groups (read live when it sends) or an audience of its own (shared with Surveys), from the site's sending or your own Email mailbox (small lists), schedule sends, attach an offer that closes by a date or a claim limit. Opens and clicks (cookieless), links tagged for Analytics, a linked Shop discount code, send a survey as a campaign, follow-up sequences, resend to non-openers, A/B subject tests, and a version-1 stats feed other Tools read. |
41
43
  | `contacts-pro` | paid | 0.13.0 | Contacts, with more to them: send a campaign to a group or the selected contacts (with Campaigns Pro), your own custom fields, birthdays and ages with the ones coming up and a reminder in the sidebar, and groups with their own emblem and colours. Share a contact, several, or a whole group with people or roles - to view, or to edit. Call a contact now on a video call on your site. Works over the same contacts as the built-in Tool, so nothing moves and nothing is lost. |
42
- | `crossword` | paid (giftable) | 1.5.0 | Crosswords on your site: type the answers and clues and the grid lays itself out (live preview, Another layout). Players type a name and race the server's clock, checks and wrong guesses cost time, fastest solvers on a leaderboard. 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. |
44
+ | `crossword` | paid (giftable) | 1.5.1 | Crosswords on your site: type the answers and clues and the grid lays itself out (live preview, Another layout). Players type a name and race the server's clock, checks and wrong guesses cost time, fastest solvers on a leaderboard. 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. |
43
45
  | `daily-word` | paid (giftable) | 1.3.0 | One hidden word a day, the same for everyone: six guesses, each letter marked right place, in the word or not; real words only (a bundled dictionary, switchable), an archive of past days, streaks, Share as coloured squares, a calendar of what is coming. Fewest guesses tops the day's board, then the fastest. |
44
46
  | `data-transfer` | paid | 1.3.3 | Move collections between file and MongoDB storage, back them up and restore them (all or some, merged or replaced) - keeping every entry's id - and clone them (cloned entries get new ids, so references stay unambiguous). Every restore and transfer takes a safety snapshot first. |
45
47
  | `docs` | paid | 2.13.1 | Document editor: Home and editor screens, sharing with Viewers/Editors, public links, import/export, send to page/blog/email, edit lock, Trash, version history, templates. PDF documents (2.13): a PDF kept as it is, shown in the browser's viewer, searchable inside, versioned on replace. |
@@ -47,31 +49,39 @@ Code was treated as the truth. Where docs disagree with it, the disagreement is
47
49
  | `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. |
48
50
  | `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. |
49
51
  | `garage` | paid | 1.4.3 | UK vehicle management with DVLA API lookup, save vehicles, and search history. |
52
+ | `group-four` | paid (giftable) | 1.0.0 | Sixteen tiles hide four groups of four: pick four, a wrong guess costs a mistake, a close call says so. Single puzzles or a daily set with streaks and an archive; the server holds the groups. |
50
53
  | `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. |
54
+ | `higher-lower` | paid (giftable) | 1.0.0 | Is the next one higher or lower? A deck of items with numbers (prices, years, counts, percents), filled by hand, pasted, from CSV or from the Shop's prices. The server reveals each number only after the guess; longest streak wins. |
51
55
  | `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. |
56
+ | `jigsaw` | paid (giftable) | 1.0.1 | 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. |
53
57
  | `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. |
54
58
  | `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. |
59
+ | `map-guess` | paid (giftable) | 1.0.0 | Drop a pin where each photo was taken: on the built-in world map or your own map picture (town, venue, campus) with a scale. Points by distance; every photo is stripped of GPS and other details, and answers stay on the server until the guess. |
60
+ | `memory-pairs` | paid (giftable) | 1.0.1 | 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. |
56
61
  | `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. |
57
62
  | `mongodb-adapter` | paid | 1.0.2 | Provision a dedicated MongoDB database per site. Credentials are managed centrally by the manager. |
58
63
  | `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
64
  | `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. |
65
+ | `picture-reveal` | paid (giftable) | 1.0.0 | Guess the picture as it slowly appears - pixelated, blurred, zoomed in or under tiles. Fewer stages used, more points; forgiving answers. The server draws every stage, so the picture never reaches the browser before it is guessed. |
60
66
  | `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. |
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. |
67
+ | `prize-wheel` | paid (giftable) | 1.0.1 | 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. |
68
+ | `quiz` | paid (giftable) | 1.6.1 | 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. |
69
+ | `scratch-card` | paid (giftable) | 1.0.0 | Instant-win scratch cards, the partner to Prize Wheel: prizes with odds and stock, codes (shared, unique, or single-use Shop codes), a reveal or match-three card, email and consent capture. The server draws at the deal; the result arrives as the card is scratched. |
63
70
  | `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. |
64
71
  | `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. |
65
72
  | `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). |
66
73
  | `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. |
67
74
  | `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. |
68
75
  | `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. |
76
+ | `sliding-puzzle` | paid (giftable) | 1.0.0 | The tile-sliding puzzle, 3x3 to 6x6, numbers or a Media picture. Same board for everyone, a new board each go, or a daily puzzle; every move checked by the server. Fewest moves or fastest time wins. |
69
77
  | `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. |
70
78
  | `surveys` | paid | 1.5.1 | Targeted surveys over the Forms engine: shared audiences, tokenised invites, reminders, and per-survey statistics. |
79
+ | `sweepstake` | paid (giftable) | 1.0.0 | Office, pub and club sweepstakes for any event: picks, entry fee and prizes, entrants by name with paid ticks, and one recorded, repeatable draw revealed live on the page, then who has what and the money. |
71
80
  | `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. |
81
+ | `timeline` | paid (giftable) | 1.0.0 | Put events in date order: all at once (Sort) or one at a time into a growing timeline with lives (Place). Years, months or full dates, BC too; dates stay on the server until a card is placed. Shortcode `[timeline-game]`. |
82
+ | `treasure-hunt` | paid (giftable) | 1.0.1 | 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. |
73
83
  | `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. |
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. |
84
+ | `word-search` | paid (giftable) | 1.2.1 | 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. |
75
85
 
76
86
  Versions are read from `dcms-marketplace/plugins/*/plugin.json` (every plugin folder except `_lib`).
77
87
 
@@ -1468,7 +1478,7 @@ Domma CMS is extended by plugins: self-contained folders under `plugins/<slug>/`
1468
1478
  - **Current register (marketplace, 24 plugins)** - versions in the [catalogue table](#marketplace-catalogue).
1469
1479
  - Free (6, shipped with the engine): `blog`, `booking`, `feedback`, `mail-reader`, `security`, `shopping-cart`.
1470
1480
  - 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`.
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`.
1481
+ - Paid and giftable (22, the Games): `quiz`, `crossword`, `word-search`, `daily-word`, `personality-quiz`, `hangman`, `anagram`, `jigsaw`, `memory-pairs`, `treasure-hunt`, `prize-wheel`, `predictions`, `advent-calendar`, `scratch-card`, `timeline`, `picture-reveal`, `group-four`, `higher-lower`, `bingo`, `sliding-puzzle`, `map-guess`, `sweepstake`.
1472
1482
  - **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).
1473
1483
  - **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.
1474
1484
  - Where: design spec "Managed-only plugins"
@@ -2580,6 +2590,73 @@ Tier: paid and giftable, closed source · Version: 1.0.0 each (2026-10-29) · Ne
2580
2590
  - 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
2591
  - `[predictions league="..." /]`, `[predictions-table league="..." round="..." /]`; badge for results waiting; notices `results-due` and `new-member`.
2582
2592
 
2593
+ ### Ten more Games: Advent Calendar, Scratch Card, Timeline, Picture Reveal, Group Four, Higher or Lower, Bingo, Sliding Puzzle, Map Guess, Sweepstake
2594
+
2595
+ Tier: paid and giftable, closed source · Version: 1.0.0 each (2026-11-01) · Needs: Domma CMS 1.10.0 · Sidebar: Tools > Games · Permissions: one each in the Games group (See / Manage; anything that holds answers needs Manage). Built the same way as the eight before them: own Tool in `dcms-marketplace/plugins/<slug>/`, user guide in the admin Documentation, test plays, export and import (`domma-<slug>` version 1, as drafts, nothing derived carried over), motion from `_lib/public/games/motion.*`, domma-reactive throughout, goes-per-name checked and started in one turn per game and name. None joins `[games-leaderboards]` or rotation yet. The same release fixes Prize Wheel 1.0.1 (spins a day per connection, salted daily key, default 20) and Jigsaw 1.0.1 (the goes-per-name race).
2596
+
2597
+ #### Advent Calendar (`advent-calendar`)
2598
+
2599
+ - 1 to 31 doors, one opening each midnight (site time) from a start day: an advent calendar or a countdown. Doors in order or shuffled; classic doors, baubles or gift tags in theme colours; catch-up on or off; no name (a browser key) or a name first.
2600
+ - Behind a door: heading, Markdown message (cleaned on the server), Media picture, link, a link to another Game's page, and a code - shared, unique from a pasted list, or a single-use Shopping Cart Pro code (the door still opens without Cart Pro).
2601
+ - The server never sends a door before its day. One code per visitor per door, and at most N per connection per door per day (settings cog, default 3; only a salted hash is kept). The editor warns on code doors that ask for no name.
2602
+ - Admin: door-by-door editor with live preview, Preview as day N (records nothing, TEST codes), Opens (per door, codes given and left, CSV). `[advent-calendar id="..." /]`; notices `daily-summary` (off by default) and `codes-low`; badge: doors running low on codes.
2603
+
2604
+ #### Scratch Card (`scratch-card`)
2605
+
2606
+ - Prize Wheel's model as a card: prizes and "no win" rows with odds and stock; a message, shared code, unique code or single-use Cart Pro code; email, name and consent capture; limits per email, browser and day; winner emails.
2607
+ - Reveal a message, or match three of nine symbols (laid out on the server for the prize drawn; a losing grid never has three alike). Cover colour, finish, picture, words, reveal-at percentage; confetti on a win.
2608
+ - The server draws and takes the stock under the lock at the deal and sends only a key; the result goes out when scratching starts. Cards a day per connection (default 20). A Shop code made for a deal that then fails is taken back.
2609
+ - `[scratch-card id="..." /]`; notices `winner` (off by default) and `stock-low`; badge: prizes running low.
2610
+
2611
+ #### Timeline (`timeline`)
2612
+
2613
+ - Events with a title, a date (year, month and year, or full date; BC too), optional words and picture; paste "1969 - The first Moon landing" lines. Sort (every card at once; points for right places plus the longest run) or Place (one at a time; a wrong place costs a life).
2614
+ - The server deals N events a go in a fresh shuffle under random ids and keeps every date; each card carries its own copy of the event, so later edits never change old results. Show dates as placed (the result marks the player's own order right or wrong), at the end (the full answer), or never.
2615
+ - Drag by mouse or finger, or keyboard (Space, arrows, Space), announced. The editor warns when a picture's address looks like it holds a year.
2616
+ - `[timeline-game id="..." /]`, `[timeline-game-leaderboard id="..." /]` (plain `[timeline]` stays the CMS's own display); notices `top` and `perfect`.
2617
+
2618
+ #### Picture Reveal (`picture-reveal`)
2619
+
2620
+ - A round of up to 30 Media pictures, each with an answer and other accepted answers (case, accents, punctuation and a leading "the" ignored; typo setting). Pixelated, blurred, zoomed (with a focus point) or tiles; 2-8 stages, points by stage, time as tiebreak.
2621
+ - The server draws every stage with sharp onto a fixed 800x600 canvas, metadata stripped, through a per-play route; the whole picture only after it is guessed or given up. Each play keeps its own copy of its pictures and answers, so swapping pictures never reaches an old play.
2622
+ - `[picture-reveal id="..." /]`, `[picture-reveal-leaderboard id="..." /]`; notices `top-score` and `picture-missing`.
2623
+
2624
+ #### Group Four (`group-four`)
2625
+
2626
+ - Sixteen tiles, four groups of four, each with a name and a difficulty (Gentle, Steady, Tricky, Devious - renamable in the cog, theme colours). Mistakes allowed, a close-call hint, shuffle.
2627
+ - Single puzzles, or a daily set (same deal for everyone, streaks, archive, calendar for Manage, played days locked; each set's tile order comes from a secret key on the server). A failed single puzzle shows only the groups found.
2628
+ - `[group-four id="..." /]`, `[group-four-leaderboard id="..." /]`; notices `top-score` and `running-low`; Share as difficulty digits.
2629
+
2630
+ #### Higher or Lower (`higher-lower`)
2631
+
2632
+ - A deck of named numbers shown as pounds, a year (BC too), a count, a percent or plain, with words after; by hand, pasted lines, CSV in and out, or "Fill from the shop" (Shopping Cart products in pounds, read only).
2633
+ - The server deals each go and reveals a number only after the guess; pictures by random key. Lives 1-5, equal numbers rule, seconds per guess (the reveal pause is added to the next card's clock).
2634
+ - `[higher-lower id="..." /]`, `[higher-lower-leaderboard id="..." /]`; notice `best-streak`.
2635
+
2636
+ #### Bingo (`bingo`)
2637
+
2638
+ - 75-ball, 90-ball UK tickets, or word and picture cards (enough items that cards differ). Live: caller in the admin (draw, auto-draw, undo, new game, projector view), players join on phones and get a server-dealt card; line, two lines and full house claims checked against the real calls in arrival order. Calls are picked at the moment they are made.
2639
+ - Late joiners: calls made before a player joined are crossed through and never count for their claims, or late joining is refused (per game). A take-back bumps a revision so phones reload the calls. Prizes cannot change once calling has started.
2640
+ - Paper: up to 500 numbered unique cards, a print window and a card checker. `[bingo id="..." /]`, `[bingo-caller id="..." /]`; notice `claim`; badge: games being called (live dot).
2641
+
2642
+ #### Sliding Puzzle (`sliding-puzzle`)
2643
+
2644
+ - 3x3 to 6x6, numbers or a Media picture (corner numbers, Peek). Same board for everyone, a new board each go, or a daily puzzle from a secret on the server; always solvable, never nearly solved.
2645
+ - Every move is checked against the server's board; only a board the server solved finishes a play. Only plays on the current board count. Fewest moves then time, or the other way round.
2646
+ - `[sliding-puzzle id="..." /]`, `[sliding-puzzle-leaderboard id="..." /]`; notices `best` and `picture-missing`.
2647
+
2648
+ #### Map Guess (`map-guess`)
2649
+
2650
+ - Photos drawn from a pool; players drop a pin; up to 1,000 points a photo by distance (three curves). Built-in world map (Natural Earth, public domain; great-circle distance) or the admin's own map picture with a scale (typed or measured by two clicks; a positive scale is required).
2651
+ - Every photo and map is re-encoded with GPS and all metadata removed; photos live in the Tool (`data/images`, a content path) and reach the player only through the play. Answers never before the guess. Pan, pinch, wheel and keyboard.
2652
+ - `[map-guess id="..." /]`, `[map-guess-leaderboard id="..." /]`; notice `top-score`.
2653
+
2654
+ #### Sweepstake (`sweepstake`)
2655
+
2656
+ - Picks (paste or a ready-made list; group, odds, emoji or picture), entry fee and currency (shown, never taken), up to 10 prizes (% of pot, fixed, or not money). Entrants by name on the page (60 joins per 10 minutes per connection) or added by the organiser; paid ticks.
2657
+ - One draw by the server from a 32-byte random seed, recorded with the names as they were and repeatable; renames after the draw are shown publicly; resets need a reason and every earlier draw stays on the page. Uneven numbers: picks each, leftovers undrawn or dealt again, shared picks or a waiting list.
2658
+ - `[sweepstake id="..." /]`, `[sweepstake-table id="..." /]`; notices `draw-done`, `winner-set`, `ready-to-draw`; badge: unpaid entrants.
2659
+
2583
2660
  ### Other plugin directories
2584
2661
 
2585
2662
  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`.
@@ -2680,6 +2757,8 @@ Later changes to these features are in the CHANGELOG (for example 0.92.1: row-le
2680
2757
  ### Plugins & the Marketplace platform
2681
2758
 
2682
2759
  - A Halloween or Christmas page: a Treasure Hunt across five pages with a Prize Wheel at the end, and a Personality Quiz collecting leads.
2760
+ - A Christmas countdown: an Advent Calendar of 24 doors with a Shop code behind some, and a Scratch Card on the last day.
2761
+ - A quiz night: Bingo on the projector with `[bingo-caller]`, players on their phones, and a Sweepstake for the big match.
2683
2762
  - A football club's season: a Predictions league with a week of fixtures pasted in, and the table on the home page.
2684
2763
  - 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.
2685
2764
  - 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.
@@ -4,7 +4,7 @@ Domma CMS extends standard Markdown with shortcodes - special tags you write in
4
4
 
5
5
  All shortcode attributes accept single or double quotes, and bare flags (e.g. `hover`, `dismissible`) are allowed.
6
6
  Most shortcodes are skipped inside fenced code blocks and inline code, so you can show shortcode syntax on a page
7
- (`[block]` / block short tags and `[banner]` are the exceptions - they are expanded even inside code).
7
+ (`[banner]` is the exception - it is expanded even inside code).
8
8
 
9
9
  ## Expiring any shortcode
10
10
 
@@ -1328,6 +1328,27 @@ action directly is the action's own `access` (its roles and `rowLevel`), so give
1328
1328
 
1329
1329
  ---
1330
1330
 
1331
+ ### Custom Block slots
1332
+
1333
+ Custom Blocks can declare `<slot>Fallback Markdown</slot>` for their default
1334
+ content, and `<slot name="footer"></slot>` for named content. Parameters such
1335
+ as `{{heading}}` remain separate and unchanged. Call the block with paired tags:
1336
+
1337
+ ```text
1338
+ [domma-block-cushion-card heading="Your heading"]
1339
+ **Body content**, built-in shortcodes, plugin shortcodes and other blocks.
1340
+ [slot name="footer"]
1341
+ [button url="/contact"]Contact us[/button]
1342
+ [/slot]
1343
+ [/domma-block-cushion-card]
1344
+ ```
1345
+
1346
+ The generic `[block template="name"]...[/block]` form also works. Existing
1347
+ self-closing calls remain valid and use a slotted template's fallbacks.
1348
+ Slots render through the full CMS pipeline, carry collection/view cache tags,
1349
+ viewer-specific flags and component dependencies, and keep code examples and
1350
+ collection values inert. Maximum nesting is 24 levels and 500 expansions.
1351
+
1331
1352
  ### `[block]`
1332
1353
 
1333
1354
  Renders a single block template with static inline data. Use this for one-off content where creating a full Collection
@@ -1,6 +1,6 @@
1
1
  # Domma block library
2
2
 
3
- Sixteen free, editable Custom Blocks come with every Domma CMS site. There is
3
+ Seventeen free, editable Custom Blocks come with every Domma CMS site. There is
4
4
  no extra licence or plugin to install. Search for `domma-block-` in **Blocks**
5
5
  or in the editor's **Add block** menu. Each block includes its own scoped CSS,
6
6
  a copyable example and documented parameters.
@@ -201,3 +201,72 @@ contact strip or branded header around the existing navigation. They are a
201
201
  proposed extension, not part of this library change. Replacing the full navigation
202
202
  would also need to retain mobile controls, keyboard access and the visitor's
203
203
  current-page indication.
204
+
205
+
206
+ ## Cushion card and rich content slots
207
+
208
+ `domma-block-cushion-card` has a soft outer rim and an inset panel. `heading`
209
+ and `icon` remain ordinary parameters. The default slot holds its content;
210
+ `footer` is a named slot. Both accept Markdown, built-in shortcodes, plugin
211
+ shortcodes and nested Custom Blocks.
212
+
213
+ ```text
214
+ [domma-block-cushion-card heading="Made for you" icon="sparkles"]
215
+ Write **formatted content**, add images, or insert other blocks here.
216
+ [slot name="footer"]
217
+ [button url="/contact"]Get in touch[/button]
218
+ [/slot]
219
+ [/domma-block-cushion-card]
220
+ ```
221
+
222
+ A template declares slots with `<slot>Fallback content</slot>` and
223
+ `<slot name="footer">Optional fallback</slot>`. Slot names and parameter
224
+ names are separate. Slot content is rendered once through the normal CMS
225
+ pipeline and sanitised. Code examples remain literal, and collection values
226
+ remain data. Nesting is limited to 24 levels and 500 block expansions per
227
+ render. Existing self-closing blocks and escaped/raw parameters keep working.
228
+ Self-closing calls to slotted blocks use their fallback content.
229
+
230
+ In the page editor, Add block inserts slot scaffolding. The shortcode insert
231
+ form offers a separate content field for each slot.
232
+
233
+ ## Block packs
234
+
235
+ Open the package action in **Blocks** to create a versioned pack from selected
236
+ blocks, export a `.dmblockpack.json` file, import one into the local catalogue,
237
+ and preview an installation. Importing a file only adds it to the catalogue.
238
+ Installation is a separate, reviewed action. Site settings permissions govern
239
+ catalogue access and changes.
240
+
241
+ The bundled **Domma cards** pack includes the cushion, service, pricing,
242
+ profile and testimonial designs. Packs carry HTML, CSS, a stable ID, title,
243
+ version and compatibility requirements. Select local media when assembling a
244
+ pack to include its raster images or webfonts. The pack rewrites those HTML/CSS
245
+ references to versioned media URLs at installation, retaining older files for
246
+ rollback. Each asset can be up to 1 MB, within the pack's 2 MB total limit.
247
+ Remote media and formats such as SVG remain URL references. Asset packs use
248
+ schema 2 and are refused by sites without bundled media support. A pack
249
+ can declare `requires.cms` (a minimum CMS version), `requires.slots: 1`, and
250
+ `requires.plugins` (installed plugin slugs).
251
+
252
+ Published versions are immutable: use a new version for changes. Preview lists
253
+ creates, updates, removals, local conflicts and compatibility problems. Apply
254
+ requires the preview's token; a site changed since preview must be reviewed
255
+ again. Matching existing blocks can be adopted without changing their content.
256
+ Different existing blocks and blocks owned by another pack are never replaced.
257
+ Local edits or deletions prevent pack updates and rollback. Duplicate a block
258
+ before customising it to keep the managed original updatable.
259
+
260
+ Installations record history and snapshots for rollback. Rollback also checks
261
+ for local edits before restoring blocks. Pack files exclude site project tags
262
+ and runtime configuration. Pack catalogue, installation records and snapshots
263
+ live under `content/block-packs/` and should be included in site backups.
264
+
265
+ DCM's **Site Manager > Block packs** uses the same catalogue and adds sharing
266
+ with selected managed sites. Preview checks every selected site before apply.
267
+ Results report each site's success or failure; running sites restart briefly
268
+ to refresh cached pages. No fleet deployment happens merely by publishing a
269
+ pack. DCM can also roll back a pack on one selected site.
270
+
271
+ The existing Card builder and its shortcodes remain available. Designs can be
272
+ moved into packs incrementally without rewriting existing pages.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "domma-cms",
3
- "version": "1.31.0",
3
+ "version": "1.32.0",
4
4
  "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
5
5
  "type": "module",
6
6
  "main": "server/server.js",
@@ -94,5 +94,11 @@
94
94
  "category": "trust",
95
95
  "description": "A responsive row of up to four organisation logos.",
96
96
  "example": "[domma-block-logos header=\"Who we work with\" image1=\"/media/partner-logo.svg\" alt1=\"Partner name\" /]"
97
+ },
98
+ {
99
+ "name": "domma-block-cushion-card",
100
+ "category": "cards",
101
+ "description": "A softly rounded card with a raised rim and inset panel.",
102
+ "example": "[domma-block-cushion-card heading=\"Make yourself at home\" /]"
97
103
  }
98
104
  ]
@@ -0,0 +1,30 @@
1
+ .db-cushion {
2
+ display: flex;
3
+ padding: 5px;
4
+ border: 1px solid var(--dm-border, #dedee3);
5
+ border-radius: 30px;
6
+ background: var(--dm-card-bg, var(--dm-bg, #fff));
7
+ box-shadow: inset 0 1px 0 rgb(255 255 255 / .6), 0 2px 5px rgb(0 0 0 / .07);
8
+ color: var(--dm-text, #202127);
9
+ box-sizing: border-box;
10
+ }
11
+ .db-cushion-panel {
12
+ flex: 1;
13
+ box-sizing: border-box;
14
+ border: 1px solid var(--dm-border, #dedee3);
15
+ border-radius: 24px;
16
+ padding: clamp(1rem, 3vw, 1.65rem);
17
+ background: color-mix(in srgb, var(--dm-text, #202127) 4%, var(--dm-bg, #fff));
18
+ }
19
+ .db-cushion-header { display: flex; align-items: center; gap: .7rem; }
20
+ .db-cushion-header h3 { margin: 0; font: inherit; font-size: 1.15rem; font-weight: 650; }
21
+ .db-cushion-header h3:empty, .db-cushion-header [data-icon=""] { display: none; }
22
+ .db-cushion-header:has(h3:empty):has([data-icon=""]) { display: none; }
23
+ .db-cushion-body { line-height: 1.65; }
24
+ .db-cushion-body > :last-child { margin-bottom: 0; }
25
+ .db-cushion-footer:empty { display: none; }
26
+ .db-cushion-footer:not(:empty) { margin-top: 1.1rem; padding-top: 1rem; border-top: 1px solid var(--dm-border, #dedee3); }
27
+ @supports (corner-shape: squircle) {
28
+ .db-cushion { corner-shape: squircle; border-radius: 50px; }
29
+ .db-cushion-panel { corner-shape: squircle; border-radius: 44px; }
30
+ }
@@ -0,0 +1,11 @@
1
+ <!--
2
+ domma-block-cushion-card - A softly rounded card with a raised rim and inset panel.
3
+
4
+ Parameters:
5
+ heading - Card heading
6
+ icon - Optional Domma icon name
7
+
8
+ Example:
9
+ [domma-block-cushion-card heading="Make yourself at home" /]
10
+ -->
11
+ <article class="db-cushion"><div class="db-cushion-panel"><header class="db-cushion-header"><span data-icon="{{icon}}" aria-hidden="true"></span><h3>{{heading}}</h3></header><div class="db-cushion-body"><slot>Add your content here.</slot></div><footer class="db-cushion-footer"><slot name="footer"></slot></footer></div></article>
@@ -0,0 +1,7 @@
1
+ {
2
+ "bundled": true,
3
+ "adminTags": [
4
+ "domma-blocks",
5
+ "cards"
6
+ ]
7
+ }
@@ -0,0 +1,55 @@
1
+ import {authenticate, requirePermission} from '../../middleware/auth.js';
2
+ import {createBlockPackStore} from '../../services/block-packs.js';
3
+ import {invalidateTags} from '../../services/cache/index.js';
4
+
5
+ /** Catalogue administration requires site settings access, not just page editing. */
6
+ export function blockPackRoutes(fastify) {
7
+ const store = createBlockPackStore();
8
+ const read = {preHandler:[authenticate,requirePermission('settings','read')]};
9
+ const write = {preHandler:[authenticate,requirePermission('settings','update')]};
10
+ const upload = {...write,bodyLimit:2_100_000};
11
+ fastify.get('/block-packs',read,()=>store.list());
12
+ fastify.post('/block-packs',upload,request=>store.publish(request.body));
13
+ fastify.post('/block-packs/assemble',write,async (request,reply)=>{
14
+ if(request.body?.media?.length) {
15
+ await requirePermission('media','read')(request,reply);
16
+ if(reply.sent)return reply;
17
+ }
18
+ const {getBlock} = await import('../../services/blocks.js');
19
+ const {canSeeArtefact} = await import('../../services/projects.js');
20
+ if(Array.isArray(request.body?.names)) for(const name of request.body.names) {
21
+ let found;
22
+ try { found = await getBlock(name); }
23
+ catch { throw Object.assign(new Error(`Block not found: ${String(name).slice(0, 80)}`),{statusCode:404}); }
24
+ if(!canSeeArtefact(request.user,found)) throw Object.assign(new Error('Access denied for this project.'),{statusCode:403});
25
+ }
26
+ return store.assemble(request.body);
27
+ });
28
+ fastify.get('/block-packs/:id/:version/export',read,async(request,reply)=>{
29
+ const pack = await store.published(request.params.id,request.params.version);
30
+ reply.header('Content-Disposition',`attachment; filename="${pack.id}-${pack.version}.dmblockpack.json"`);
31
+ return pack;
32
+ });
33
+ fastify.post('/block-packs/:id/:version/preview',write,async request=>store.preview(await store.published(request.params.id,request.params.version)));
34
+ fastify.post('/block-packs/:id/:version/install',write,async (request,reply)=>{
35
+ const pack = await store.published(request.params.id,request.params.version);
36
+ // A pack with pictures adds them to Media, so it needs what an upload needs.
37
+ if(pack.assets?.length) {
38
+ await requirePermission('media','create')(request,reply);
39
+ if(reply.sent)return reply;
40
+ }
41
+ const result = await store.install(pack,request.body?.token);
42
+ await invalidateTags(result.changes.map(c=>`block:${c.name}`));
43
+ return result;
44
+ });
45
+ fastify.get('/block-packs/:id/history',read,request=>store.history(request.params.id));
46
+ fastify.post('/block-packs/:id/rollback',write,async request=>{
47
+ const catalogue = await store.list();
48
+ const result = await store.rollback(request.params.id);
49
+ // Blocks removed by a previous version can reappear during rollback.
50
+ const names = catalogue.find(p=>p.id===request.params.id)?.blocks || [];
51
+ const {listBlocks} = await import('../../services/blocks.js');
52
+ await invalidateTags([...new Set([...names,...(await listBlocks()).map(b=>b.name)])].map(n=>`block:${n}`));
53
+ return result;
54
+ });
55
+ }
@@ -12,6 +12,8 @@
12
12
  * DELETE /api/blocks/:name - delete block
13
13
  */
14
14
  import fs from 'fs/promises';
15
+ import {blockPackRoutes} from './block-packs.js';
16
+ import {blockSlots} from '../../services/block-slots.js';
15
17
  import path from 'path';
16
18
  import {authenticate, requirePermission} from '../../middleware/auth.js';
17
19
  import {deleteBlock, getBlock, listBlocks, saveBlock} from '../../services/blocks.js';
@@ -211,6 +213,7 @@ export function blocksBadge(blocks = []) {
211
213
  const BUNDLE_FORMAT = 1;
212
214
 
213
215
  export async function blocksRoutes(fastify) {
216
+ blockPackRoutes(fastify);
214
217
  const canRead = {preHandler: [authenticate, requirePermission('pages', 'read')]};
215
218
  const canUpdate = {preHandler: [authenticate, requirePermission('pages', 'update')]};
216
219
  const canDelete = {preHandler: [authenticate, requirePermission('pages', 'delete')]};
@@ -229,7 +232,7 @@ export async function blocksRoutes(fastify) {
229
232
  try { full = await getBlock(b.name); } catch { /* skip */ }
230
233
  if (!canSeeArtefact(user, full)) continue;
231
234
  out.push({...b, hasCss: Boolean(full?.css), cssSize: full?.css?.length || 0, ...blockDoc(full?.content, b.name),
232
- fields: blockFields(full?.content), shortTag: isShortTag(b.name)});
235
+ slots: blockSlots(full?.content), fields: blockFields(full?.content), shortTag: isShortTag(b.name)});
233
236
  }
234
237
  return out;
235
238
  }
@@ -0,0 +1,6 @@
1
+ /** Schema 2 adds portable, versioned raster images and webfonts to block packs. */
2
+ export const PACK_ASSET_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,99}\.(?:png|jpe?g|gif|webp|avif|ico|bmp|tiff?|woff2?)$/i;
3
+ export const PACK_MEDIA_RE = /\.(?:png|jpe?g|gif|webp|avif|ico|bmp|tiff?|woff2?)$/i;
4
+ export function packAssetFilename(pack, name) {
5
+ return `pack-${pack.id}-${pack.version}-${name}`;
6
+ }