domma-cms 1.78.0 → 1.79.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 +6 -0
- package/admin/js/templates/docs/usage-site-settings.html +29 -1
- package/docs/DommaFeatures.md +62 -54
- package/docs/plans/2026-11-19-brand-kit-design.md +58 -0
- package/package.json +1 -1
- package/plugins/_lib/admin/mail/attach-arrange.js +176 -0
- package/plugins/_lib/admin/mail/body-menu.js +1 -1
- package/plugins/_lib/admin/mail/cms-attach.js +268 -0
- package/plugins/_lib/admin/mail/cms-host.js +10 -3
- package/plugins/_lib/admin/mail/compose-window.js +37 -1
- package/plugins/_lib/admin/mail/contacts.js +1 -1
- package/plugins/_lib/admin/mail/diagnostics-section.js +1 -1
- package/plugins/_lib/admin/mail/drag-drop.js +1 -1
- package/plugins/_lib/admin/mail/folder-tree.js +1 -1
- package/plugins/_lib/admin/mail/font-controls.js +1 -1
- package/plugins/_lib/admin/mail/fonts.js +1 -1
- package/plugins/_lib/admin/mail/host-context.js +1 -1
- package/plugins/_lib/admin/mail/identity.js +1 -1
- package/plugins/_lib/admin/mail/image-senders-section.js +1 -1
- package/plugins/_lib/admin/mail/keyboard.js +1 -1
- package/plugins/_lib/admin/mail/mail.html +1 -1
- package/plugins/_lib/admin/mail/message-actions.js +1 -1
- package/plugins/_lib/admin/mail/oauth-panel.js +1 -1
- package/plugins/_lib/admin/mail/panes.js +1 -1
- package/plugins/_lib/admin/mail/reader-kit.js +1 -1
- package/plugins/_lib/admin/mail/reader-runtime.js +1 -1
- package/plugins/_lib/admin/mail/reader-view.js +1 -1
- package/plugins/_lib/admin/mail/resizable.js +1 -1
- package/plugins/_lib/admin/mail/restore-spam.js +1 -1
- package/plugins/_lib/admin/mail/rules.js +1 -1
- package/plugins/_lib/admin/mail/scheduling.js +1 -1
- package/plugins/_lib/admin/mail/section-kit.js +1 -1
- package/plugins/_lib/admin/mail/security-note.js +1 -1
- package/plugins/_lib/admin/mail/settings-section.js +1 -1
- package/plugins/_lib/admin/mail/templates.js +1 -1
- package/plugins/_lib/admin/mail/threads.js +1 -1
- package/plugins/_lib/admin/mail/vacation.js +1 -1
- package/plugins/_lib/admin/mail/when-closed.js +1 -1
- package/plugins/_lib/admin/ui/dates.js +1 -1
- package/plugins/_lib/admin/ui/resizable.js +1 -1
- package/plugins/_lib/admin/ui/rich-field.js +1 -1
- package/plugins/_lib/domma-mail.lock.json +85 -83
- package/plugins/_lib/mail/accountFileStore.js +1 -1
- package/plugins/_lib/mail/accountRepository.js +1 -1
- package/plugins/_lib/mail/accountRoutes.js +1 -1
- package/plugins/_lib/mail/bodyTokenProvider.js +1 -1
- package/plugins/_lib/mail/bodyTokens.js +1 -1
- package/plugins/_lib/mail/compose.js +1 -1
- package/plugins/_lib/mail/defaults.js +1 -1
- package/plugins/_lib/mail/envelope.js +1 -1
- package/plugins/_lib/mail/folderActions.js +1 -1
- package/plugins/_lib/mail/folderRuntime.js +1 -1
- package/plugins/_lib/mail/folders.js +1 -1
- package/plugins/_lib/mail/imapPoolRuntime.js +1 -1
- package/plugins/_lib/mail/mbox.js +1 -1
- package/plugins/_lib/mail/message-action.js +1 -1
- package/plugins/_lib/mail/messageSecurity.js +1 -1
- package/plugins/_lib/mail/messageSecurityProvider.js +1 -1
- package/plugins/_lib/mail/networkAddresses.js +1 -1
- package/plugins/_lib/mail/networkPolicy.js +1 -1
- package/plugins/_lib/mail/oauthAccounts.js +1 -1
- package/plugins/_lib/mail/oauthRouteRuntime.js +1 -1
- package/plugins/_lib/mail/oauthRuntime.js +1 -1
- package/plugins/_lib/mail/pollSchedule.js +1 -1
- package/plugins/_lib/mail/poller.js +1 -1
- package/plugins/_lib/mail/pollerRuntime.js +1 -1
- package/plugins/_lib/mail/priority.js +1 -1
- package/plugins/_lib/mail/publicMailbox.js +1 -1
- package/plugins/_lib/mail/readRuntime.js +1 -1
- package/plugins/_lib/mail/render.js +1 -1
- package/plugins/_lib/mail/ruleRunner.js +1 -1
- package/plugins/_lib/mail/schedulerRuntime.js +1 -1
- package/plugins/_lib/mail/secretProvider.js +1 -1
- package/plugins/_lib/mail/secretbox.js +1 -1
- package/plugins/_lib/mail/senderAuth.js +1 -1
- package/plugins/_lib/mail/sieve.js +1 -1
- package/plugins/_lib/mail/smtpService.js +1 -1
- package/plugins/_lib/mail/snoozeRuntime.js +1 -1
- package/plugins/_lib/mail/store.js +1 -1
- package/plugins/_lib/mail/subscriptions.js +1 -1
- package/plugins/_lib/mail/syncPlan.js +1 -1
- package/plugins/_lib/mail/syncRuntime.js +1 -1
- package/plugins/_lib/mail/syncSelection.js +1 -1
- package/plugins/_lib/mail/unreadBadge.js +1 -1
- package/plugins/_lib/mail/unsubscribe.js +1 -1
- package/plugins/_lib/mail/vacationRuntime.js +1 -1
- package/plugins/_lib/mail/write.js +1 -1
- package/plugins/_lib/public/rich-text.mjs +1 -1
- package/plugins/_lib/rich-text.js +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [1.79.0] - 2026-11-19
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- **Email: attach from Media and the File Store** (Domma Mail core 0.36.0). The compose window has From Media and From File Store buttons; the chosen files are attached like any other. With Media Pro off, From Media lists only the top level. Files count against the mailbox's attachment limit.
|
|
8
|
+
|
|
3
9
|
## [1.78.0] - 2026-11-19
|
|
4
10
|
|
|
5
11
|
### Added
|
|
@@ -45,7 +45,9 @@
|
|
|
45
45
|
<tr>
|
|
46
46
|
<td>SMTP</td>
|
|
47
47
|
<td>The SMTP server the site sends mail through (form notifications, password resets,
|
|
48
|
-
action emails). Without it, "Forgot your password?" cannot send a link
|
|
48
|
+
action emails). Without it, "Forgot your password?" cannot send a link. Above it,
|
|
49
|
+
<strong>Email identity</strong> sets how your automated emails look - see
|
|
50
|
+
<a href="#email-identity">Email identity</a> below.</td>
|
|
49
51
|
</tr>
|
|
50
52
|
<tr>
|
|
51
53
|
<td>Cookie consent</td>
|
|
@@ -67,6 +69,32 @@
|
|
|
67
69
|
</tbody>
|
|
68
70
|
</table>
|
|
69
71
|
|
|
72
|
+
<h3 id="email-identity">Email identity</h3>
|
|
73
|
+
<p>Every email the site sends by itself - account invitations and password resets, form
|
|
74
|
+
notifications, booking and order emails, invoices, survey invitations, Tool notifications and
|
|
75
|
+
more - goes out in one tidy layout: your name and logo at the top, a short label saying what
|
|
76
|
+
kind of email it is, buttons in your colour, and a footer with your support address and a link
|
|
77
|
+
to your site. Each one also has a plain-text version for mail programs that want it.</p>
|
|
78
|
+
<p>It uses your site's brand from the <strong>Branding</strong> tab. To give email its own look,
|
|
79
|
+
fill in <strong>Site Settings > SMTP > Email identity</strong>:</p>
|
|
80
|
+
<ul>
|
|
81
|
+
<li><strong>Email brand name</strong> - the name at the top and in the footer (empty: the site
|
|
82
|
+
name).</li>
|
|
83
|
+
<li><strong>Email logo</strong> - choose a PNG or JPEG from Media. Many mail programs do not
|
|
84
|
+
show SVG pictures, so an SVG site logo is replaced by your name.</li>
|
|
85
|
+
<li><strong>Accent colour</strong> - the line along the top and the buttons, as a six-digit
|
|
86
|
+
colour such as <code>#2563eb</code>. Text on buttons turns black or white to stay
|
|
87
|
+
readable.</li>
|
|
88
|
+
<li><strong>Support email</strong> - shown in the footer (empty: the site's contact
|
|
89
|
+
email).</li>
|
|
90
|
+
<li><strong>Email footer</strong> - a line of contact details or a short sign-off.</li>
|
|
91
|
+
</ul>
|
|
92
|
+
<p>Save, then use the <strong>Email preview gallery</strong> to see each kind of email with
|
|
93
|
+
sample details, and send yourself a test. Previewing sends nothing.</p>
|
|
94
|
+
<p>Mail you write yourself - in Email, or a campaign you designed - is never changed. An email
|
|
95
|
+
already sent in one of your Email Pro brandings (an invoice in a brand, say) keeps that brand
|
|
96
|
+
and is not wrapped again.</p>
|
|
97
|
+
|
|
70
98
|
<h3>Appearance</h3>
|
|
71
99
|
<p><a href="#/appearance">Content > Appearance</a> is an innate tool with Favicon,
|
|
72
100
|
Navigation (Back to top and Go to bottom), Breadcrumbs, Reduced Motion and Search tabs.
|
package/docs/DommaFeatures.md
CHANGED
|
@@ -30,60 +30,60 @@ Code was treated as the truth. Where docs disagree with it, the disagreement is
|
|
|
30
30
|
| Plugin | Tier | Version | In one line |
|
|
31
31
|
|---|---|---|---|
|
|
32
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. |
|
|
33
|
-
| `ai-site-builder` | paid (hosted sites only, in the Pro plan) | 0.
|
|
34
|
-
| `ai-tool-builder` | paid (hosted sites only, £59 a month) | 0.
|
|
35
|
-
| `anagram` | paid (giftable) | 1.
|
|
36
|
-
| `analytics-pro` | paid | 2.
|
|
37
|
-
| `backup-pro` | paid | 0.
|
|
33
|
+
| `ai-site-builder` | paid (hosted sites only, in the Pro plan) | 0.8.2 | Site Builder - "Dot": build and change a site by asking in plain words, with the site's own pages, blocks, menus, forms, collections and theme; every change a draft to preview, publish or undo. Never on self-hosted sites. |
|
|
34
|
+
| `ai-tool-builder` | paid (hosted sites only, £59 a month) | 0.3.3 | Tool Builder - "Daisy": describe a Tool and it is written, checked on a test copy of a site, shown as a picture, then reviewed by a person at Domma before it reaches the site. Never a copy of a Tool Domma has. Never on self-hosted sites. |
|
|
35
|
+
| `anagram` | paid (giftable) | 1.1.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. |
|
|
36
|
+
| `analytics-pro` | paid | 2.4.1 | 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. |
|
|
37
|
+
| `backup-pro` | paid | 0.2.0 | 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. |
|
|
38
38
|
| `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. |
|
|
39
|
-
| `blog` | free | 1.
|
|
40
|
-
| `blog-pro` | paid | 0.
|
|
41
|
-
| `calendar` | paid | 2.
|
|
42
|
-
| `campaigns-pro` | paid | 1.13.
|
|
43
|
-
| `media-pro` | paid | 0.
|
|
44
|
-
| `contacts-pro` | paid | 0.
|
|
45
|
-
| `crossword` | paid (giftable) | 1.
|
|
46
|
-
| `daily-word` | paid (giftable) | 1.
|
|
47
|
-
| `data-transfer` | paid | 1.
|
|
48
|
-
| `docs` | paid | 2.
|
|
49
|
-
| `docs-pro` | paid | 0.15.
|
|
50
|
-
| `email-pro` | paid | 0.
|
|
39
|
+
| `blog` | free | 1.11.0 | Public-facing blog with posts, categories and comments - layouts and listings built from editable blocks. |
|
|
40
|
+
| `blog-pro` | paid | 0.9.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. |
|
|
41
|
+
| `calendar` | paid | 2.4.2 | Events, appointments, availability and Google Calendar in one Tool. Includes the former Booking and Booking Pro features: classes, waiting lists, repeat bookings, linked staff and rooms, booking questions and online appointments. |
|
|
42
|
+
| `campaigns-pro` | paid | 1.13.2 | 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. A check before sending, and with AI Assist: subject line ideas, a first draft from a brief, Rewrite (keeping every placeholder) and themes from the replies to a mailbox campaign. |
|
|
43
|
+
| `media-pro` | paid | 0.5.0 | Media, properly organised: folders inside folders, choose from them anywhere, and move or rename anything without breaking a page. Select several, see where each file is used, find what is unused or duplicated, shrink big pictures, alt text and credits with each file, Trash, and a whole folder as a gallery. Works on the same files as the built-in Tool. |
|
|
44
|
+
| `contacts-pro` | paid | 0.15.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. |
|
|
45
|
+
| `crossword` | paid (giftable) | 1.6.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. |
|
|
46
|
+
| `daily-word` | paid (giftable) | 1.4.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. |
|
|
47
|
+
| `data-transfer` | paid | 1.4.0 | 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. |
|
|
48
|
+
| `docs` | paid | 2.15.0 | 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. |
|
|
49
|
+
| `docs-pro` | paid | 0.15.1 | Domma Spaces (publish a Docs folder at `/spaces` with a Kindle-style reader), Cloud copies (Google Drive, OneDrive, Dropbox, S3), Signatures (emailed signing links, typed or drawn, signed copy with a certificate page; 0.10: boxes placed on a PDF document's pages, the signed PDF stamped with pdf-lib), PDF tools (0.11: fill the PDF's own form, annotate, pages) and protected public links (expiry date, password). With AI Assist, Summarise this document puts a summary and key points at the top. Adds to Docs. |
|
|
50
|
+
| `email-pro` | paid | 0.23.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. With AI Assist: summarise a conversation, suggest a reply, draft from a few words and rewrite, with personal details taken out first. |
|
|
51
51
|
| `feedback` | free | 1.4.0 | 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. On the Domma server, AI Assist groups the inbox into themes. |
|
|
52
|
-
| `garage` | paid | 1.
|
|
53
|
-
| `group-four` | paid (giftable) | 1.
|
|
54
|
-
| `hangman` | paid (giftable) | 1.
|
|
55
|
-
| `higher-lower` | paid (giftable) | 1.
|
|
56
|
-
| `invoice` | paid | 1.
|
|
57
|
-
| `jigsaw` | paid (giftable) | 1.0
|
|
58
|
-
| `job-board` | paid | 2.
|
|
59
|
-
| `mail-reader` | free | 1.2.
|
|
60
|
-
| `map-guess` | paid (giftable) | 1.
|
|
61
|
-
| `memory-pairs` | paid (giftable) | 1.0
|
|
62
|
-
| `messages` | paid | 1.
|
|
63
|
-
| `mongodb-adapter` | paid | 1.0
|
|
64
|
-
| `onboard-pro` | paid | 1.
|
|
65
|
-
| `personality-quiz` | paid (giftable) | 1.
|
|
66
|
-
| `picture-reveal` | paid (giftable) | 1.
|
|
67
|
-
| `predictions` | paid (giftable) | 1.0.
|
|
68
|
-
| `prize-wheel` | paid (giftable) | 1.0.
|
|
69
|
-
| `quiz` | paid (giftable) | 1.
|
|
70
|
-
| `scratch-card` | paid (giftable) | 1.0.
|
|
71
|
-
| `security` | free | 1.
|
|
72
|
-
| `security-pro` | paid | 1.3
|
|
73
|
-
| `seo-pro` | paid | 0.9.
|
|
74
|
-
| `sheets` | paid | 0.
|
|
75
|
-
| `shopping-cart` | free | 1.
|
|
76
|
-
| `shopping-cart-pro` | paid | 0.3.
|
|
77
|
-
| `sliding-puzzle` | paid (giftable) | 1.
|
|
78
|
-
| `social-media-pro` | paid | 0.
|
|
52
|
+
| `garage` | paid | 1.6.0 | UK vehicle management with DVLA API lookup, save vehicles, and search history. |
|
|
53
|
+
| `group-four` | paid (giftable) | 1.1.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. |
|
|
54
|
+
| `hangman` | paid (giftable) | 1.1.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. |
|
|
55
|
+
| `higher-lower` | paid (giftable) | 1.1.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. |
|
|
56
|
+
| `invoice` | paid | 1.10.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. |
|
|
57
|
+
| `jigsaw` | paid (giftable) | 1.1.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. |
|
|
58
|
+
| `job-board` | paid | 2.23.1 | 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. |
|
|
59
|
+
| `mail-reader` | free | 1.2.9 | Read-only IMAP mailbox reader. Connects to a standard IMAP server and reads mail without ever writing to it. |
|
|
60
|
+
| `map-guess` | paid (giftable) | 1.1.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. |
|
|
61
|
+
| `memory-pairs` | paid (giftable) | 1.1.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. |
|
|
62
|
+
| `messages` | paid | 1.9.0 | 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. |
|
|
63
|
+
| `mongodb-adapter` | paid | 1.1.0 | Provision a dedicated MongoDB database per site. Credentials are managed centrally by the manager. |
|
|
64
|
+
| `onboard-pro` | paid | 1.1.3 | 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. |
|
|
65
|
+
| `personality-quiz` | paid (giftable) | 1.1.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. |
|
|
66
|
+
| `picture-reveal` | paid (giftable) | 1.1.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. |
|
|
67
|
+
| `predictions` | paid (giftable) | 1.0.1 | 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. |
|
|
68
|
+
| `prize-wheel` | paid (giftable) | 1.0.2 | 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. |
|
|
69
|
+
| `quiz` | paid (giftable) | 1.7.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. |
|
|
70
|
+
| `scratch-card` | paid (giftable) | 1.0.1 | 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. |
|
|
71
|
+
| `security` | free | 1.2.2 | 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. |
|
|
72
|
+
| `security-pro` | paid | 1.4.3 | 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. |
|
|
73
|
+
| `seo-pro` | paid | 0.9.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. With AI Assist: suggested titles, descriptions and focus keyphrases in Bulk, Fill from the page for rich results, and Make simpler for hard-going sentences. Adds to SEO, which is built into Domma CMS (0.90 and later). |
|
|
74
|
+
| `sheets` | paid | 0.6.0 | 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. |
|
|
75
|
+
| `shopping-cart` | free | 1.8.0 | 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. |
|
|
76
|
+
| `shopping-cart-pro` | paid | 0.3.4 | 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. |
|
|
77
|
+
| `sliding-puzzle` | paid (giftable) | 1.1.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. |
|
|
78
|
+
| `social-media-pro` | paid | 0.5.2 | 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. |
|
|
79
79
|
| `support` | free | 1.3.0 | Help from Domma in the admin: Domma's email, phone and hours always to hand, and a request as a conversation with the Domma team, urgent ones first. On the Domma server, AI Assist summarises a request, suggests a reply and groups waiting requests into themes. |
|
|
80
|
-
| `surveys` | paid | 1.19.
|
|
80
|
+
| `surveys` | paid | 1.19.2 | Targeted surveys over the Forms engine: shared audiences and Contacts groups, tokenised invites, reminders, NPS, star, smiley and number scales, quiz mode with scores, closing rules, and Results with charts, filters, Live refresh, a printable PDF report and (with AI Assist) themed summaries of free-text answers. |
|
|
81
81
|
| `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. |
|
|
82
|
-
| `theme-roller` | paid | 1.
|
|
83
|
-
| `timeline` | paid (giftable) | 1.
|
|
84
|
-
| `treasure-hunt` | paid (giftable) | 1.0
|
|
85
|
-
| `waypoint-pro` | paid | 1.
|
|
86
|
-
| `word-search` | paid (giftable) | 1.
|
|
82
|
+
| `theme-roller` | paid | 1.3.0 | 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. |
|
|
83
|
+
| `timeline` | paid (giftable) | 1.1.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]`. |
|
|
84
|
+
| `treasure-hunt` | paid (giftable) | 1.1.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. |
|
|
85
|
+
| `waypoint-pro` | paid | 1.5.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. |
|
|
86
|
+
| `word-search` | paid (giftable) | 1.3.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. |
|
|
87
87
|
|
|
88
88
|
Versions are read from `dcms-marketplace/plugins/*/plugin.json` (every plugin folder except `_lib`).
|
|
89
89
|
|
|
@@ -1439,6 +1439,8 @@ The four Tools below were plugins until 0.67.0 and are now part of the CMS. They
|
|
|
1439
1439
|
- **Activity** - open alerts, jobs across the fleet, fleet history (nightly switch, off-site, store checks). **Settings** - off-site copy (B2, S3, SFTP, restic REST; write-only credentials), quick and full store checks, the password-custody reminder, what site owners are told.
|
|
1440
1440
|
- **Site owners always know** - every backup, failure, restore (before and after, with the admin's name and reason), download, restore test and settings change reaches the site's admins as a notification and the site's permanent backup history.
|
|
1441
1441
|
Where: domma-cms-manager `plugins/site-manager/admin/views/panel-backups.js`, `backups-overview.js`, `backups-activity.js`, `backups-settings.js`, `admin/lib/backup-site.js`, pure part `admin/lib/backups.js` (+ test); guide `plugins/site-manager/docs/backups.md` (Documentation > Plugins > Site Manager > Backups); routes `services/backupRoutes.js`; the service `tools/domma-backup/`; plan `dcms-marketplace/docs/backup-pro-plan.md`. Since: manager 2026-09-28.
|
|
1442
|
+
- **The Manager's own emails in the shared look** - sign-up welcomes (self-run and Domma Managed), gift and discount codes, Customer Registration notices, licence and store emails (keys, renewals, "My licences" links), licence expiry and switch-off alerts and new-site alerts use the same email frame as a site's own mail, branded from the Manager's Site Settings (set **SMTP > Email identity > Email brand name**, else it shows the Manager's site title). Labels: Your account, A gift for you, An offer for you, Your licence. Branding never stops an email: on an older engine it goes out plain.
|
|
1443
|
+
Where: domma-cms-manager `plugins/site-manager/services/brandedMail.js`, `customer-registration/services/emailService.js`, `site-manager/services/notificationService.js` - Since: manager 0.37.83.
|
|
1442
1444
|
- **Multi-tenant** - Multi-tenancy is not built in. `docs/MultiTenant.md` is a design note that weighs three approaches: one process per tenant, directory-scoped tenants in a single process, and MongoDB-native tenancy. It recommends one process per tenant, which is how the manager fleet runs today, with one CMS process per site behind a proxy.
|
|
1443
1445
|
|
|
1444
1446
|
### Networking, email and CORS
|
|
@@ -1451,6 +1453,8 @@ The four Tools below were plugins until 0.67.0 and are now part of the CMS. They
|
|
|
1451
1453
|
Where: `server/services/publicCors.js`.
|
|
1452
1454
|
- **Email service** - A Nodemailer transport built from the SMTP settings in `site.json`, used for form emails, password resets and notices. With no SMTP host set, mail goes to a throwaway Ethereal test inbox, which reports success but delivers to nobody. The CMS makes this visible in Settings, in health checks and with an "Email not set up" notification. New sites ship with an SMTP host, defaulting to a local mail server on port 25 or taken from the environment.
|
|
1453
1455
|
Where: `server/services/email.js`, `bin/lib/smtp-defaults.js`, `POST /api/settings/test-email` - Since: 0.55.0.
|
|
1456
|
+
- **One email look for every automated email** - Account invitations, password resets and security alerts, form notifications, automations, call invites, bookings and calendar mail, order and account emails from the Shop, invoices and quotes, Support, Docs and signing, Waypoint, Job Board, Surveys, Onboard, Campaigns layouts, Ecards, prize and game emails, SEO reports and Wiki updates all go out in one shared, mobile-friendly frame: the site's name and logo at the top, a label for the kind of email (Your account, Bookings, Your order...), an accent line and buttons in the site's colour, and a footer with the support address and a link to the site. Every email keeps a full plain-text version. It inherits the public brand (Site Settings > Branding); **Site Settings > SMTP > Email identity** overrides it for email only - brand name, logo (PNG or JPEG; an SVG site logo falls back to the name), accent colour, support email and a footer line. The **Email preview gallery** beside it shows each kind with sample data and can send a test. Mail people write themselves (Email, Campaigns content) is never wrapped; an email already in one of Email Pro's brandings (an invoice sent in a brand) is not framed twice.
|
|
1457
|
+
Where: `server/services/emailBrand.js` (`brandEmail`, `emailBrand`, `EMAIL_FAMILIES`), `sendEmail(transport, {branding: {family}})` in `server/services/email.js`, `server/services/emailExamples.js`, Settings > SMTP - Since: 1.78.0.
|
|
1454
1458
|
|
|
1455
1459
|
---
|
|
1456
1460
|
|
|
@@ -2068,7 +2072,7 @@ Tier: paid (closed source) · Version: 0.15.0 · Requires: Domma CMS 1.67.2+ (`m
|
|
|
2068
2072
|
|
|
2069
2073
|
### Email (`email-pro`)
|
|
2070
2074
|
|
|
2071
|
-
Tier: paid (closed source) · Version: 0.
|
|
2075
|
+
Tier: paid (closed source) · Version: 0.23.0 · Requires: MongoDB for the message store's extras (without it reading, starring, moving, deleting, folders and sending still work; search, conversations, rules, undo send, send later, snooze and the away message need MongoDB and say so); npm `imapflow` ^2.0.5, `mailparser` ^3.9.28, `nodemailer` 8.0.5; `minCmsVersion` 1.34.0 (Contacts switch-off handling core 0.88) · Uses: `contacts` (recipient suggestions and group expansion in compose; Add sender to contacts) · Supersedes: `mail-reader`
|
|
2072
2076
|
|
|
2073
2077
|
A full email client in the admin: connect your own IMAP mailboxes, read, write, send, search and file mail. Chosen folders are mirrored (envelopes and flags, never bodies) into MongoDB so big mailboxes open instantly, and on top come identities, templates, rules, an away responder, undo send, send later, snooze, threads and one-click hand-off of messages into the CMS.
|
|
2074
2078
|
|
|
@@ -2093,7 +2097,8 @@ A full email client in the admin: connect your own IMAP mailboxes, read, write,
|
|
|
2093
2097
|
- **Replies for Campaigns Pro (0.18.0)**: Campaigns Pro can summarise the replies to a campaign sent from the mailbox - Email finds them in that mailbox's inbox by the Message-IDs they answer and hands over only their words and dates, never who wrote them; out-of-office answers are left out and nothing is marked read or moved.
|
|
2094
2098
|
- Keyboard shortcuts: j/k or arrows to move, Enter open, u read/unread, s star, r reply, Shift+R or a reply all, f forward, c compose, `/` search, x select, Shift+A select all, `!` spam, `#` or Delete delete, Esc, `?` help.
|
|
2095
2099
|
- Sidebar badge (`/unread`): unread in Inbox (counted from the store).
|
|
2096
|
-
- **Branding (
|
|
2100
|
+
- **Branding (0.19.0; identities and compose pills 0.20.0, Preview 0.21.0, drafts keep it 0.21.1)**: Settings > **Branding** keeps up to 20 personal brandings - header artwork (width, position, description, strapline, header background), a backdrop (solid colour, 15 gradients - Surveys' 8 plus Midnight, Navy, Teal, Sand, Rose gold, Charcoal and Aurora - a pattern, or a picture darkened and blurred on the server), font (safe fonts and Google web fonts with named fallbacks) and weight, text/accent/message colours, and a footer (plain, an accent band, or an overlay on the backdrop) with photo, name, role, company, return email, phone, website, up to four links, address and small print. Pictures come from Media, the File Store or an upload (resized, metadata stripped, served publicly at an unguessable address). Which branding a message gets: chosen in the compose window, else the first To recipient's address, domain or Contacts company, else the sender's (per identity), else the general default. New messages get the full design (600px fluid tables, a solid colour under every gradient/picture for Outlook); replies and forwards only the contact line. Branded on Send, before Undo/Send later. The compose window's Branding row uses the core `extensions.compose` hook (domma-mail compose window); older cores brand automatically with no picker. Routes `/api/plugins/email-pro/branding*`.
|
|
2101
|
+
- **Away replies are branded (0.23.0, engine 1.78.0 / Domma Mail core 0.35.0)**: an automatic away reply goes out in your branding as any reply does - a rule for the sender's address, domain or company, else the mailbox's identity brand, else your default - in the compact reply form (no full card). Pictures use the site's Site URL. A brand that cannot be drawn sends the reply plain; without Email Pro (Mail Reader) away replies are unchanged. The engine's responder calls `brandAway({account, draft})` on `globalThis[Symbol.for('domma.email-pro')]` (`plugins/_lib/mail/vacationRunner.js`).
|
|
2097
2102
|
- Notifications to the mailbox owner only: `email-pro:mailbox` (warning after 5 failed checks in a row; resolved when a check works) and `email-pro:sending` (a scheduled/undo-send message that failed).
|
|
2098
2103
|
- Permission `email` (read = Use: add own mailboxes, read and send) granted to `admin`.
|
|
2099
2104
|
|
|
@@ -2154,7 +2159,7 @@ UK vehicle lookups from the admin: type a registration and the DVLA returns make
|
|
|
2154
2159
|
|
|
2155
2160
|
### Invoices (`invoice`)
|
|
2156
2161
|
|
|
2157
|
-
Tier: paid (closed source) · Version: 1.
|
|
2162
|
+
Tier: paid (closed source) · Version: 1.10.1 · Requires: no MongoDB; optional `puppeteer-core` + Chrome/Chromium (`CHROME_BIN`) for PDF; SMTP for sending; no `minCmsVersion` declared (notifications need core 0.80+) · Uses: `contacts` (import receivers and pick email recipients from Contacts)
|
|
2158
2163
|
|
|
2159
2164
|
An invoice generator for sole traders and small businesses: issuer profiles with bank details, receivers (importable from Contacts), line items with optional VAT, automatic numbering, payments and balances, overdue tracking, a print-ready A4 invoice in three styles, PDF download and emailing with the PDF attached, and CSV/Excel export.
|
|
2160
2165
|
|
|
@@ -2175,7 +2180,8 @@ An invoice generator for sole traders and small businesses: issuer profiles with
|
|
|
2175
2180
|
- Notifications: `invoice:overdue` (daily 08:00 and at boot, one per overdue invoice; resolved by payment, cancel, archive or new due date) and `invoice:payments` (payment recorded; off by default).
|
|
2176
2181
|
- Access: admins only (`requireAdmin`); no permission keys; no per-user scoping.
|
|
2177
2182
|
- **Quotes and self-billing (1.7.0)** - Quotes in their own Q- sequence with a validity date (expiry derived on read, like overdue); Send emails an accept link - the client reviews the quote online and accepts by typing their name or declines with a reason, single decision, admin notified; Convert turns an accepted quote into a draft invoice once, with the two linked both ways. A cross-plugin registry (`Symbol.for('domma.invoice')`: createInvoice/createQuote/recordPayment) for Booking Pro and other Tools. Self-billing: mark a receiver as a self-billing supplier (agreement + review dates, reminder when review passes) and raise SB-numbered invoices printed with the roles swapped and marked SELF-BILLING.
|
|
2178
|
-
- **Email brandings (
|
|
2183
|
+
- **Email brandings (1.10.0)**: with Email Pro, an issuer can have a **Brand** and Settings > Branding a **Default brand**, chosen from the signed-in person's Email brandings. The covering email of an invoice or quote is wrapped in it (header, colours, fonts, footer - the same renderer as Email's Send) with the issuer's name, email, phone, website, address and VAT number as the footer card; the Send dialog has Branding pills (Automatic / each brand / None) and a **Preview**. Printouts and PDFs take the brand's font and, on Classic and Modern, its accent colour; Minimal takes only the font; logo = the issuer's own, else the brand's header picture, else the house logo; self-billed invoices never. An email with no PDF (the invoice inline) is not wrapped. Without Email Pro nothing changes. Email Pro exposes `list`/`render`/`look` on `globalThis[Symbol.for('domma.email-pro')].branding`; routes `GET /api/plugins/invoice/branding`, `POST /api/plugins/invoice/{invoices,quotes}/:id/send-preview`.
|
|
2184
|
+
- **The shared email look (1.10.1, engine 1.78.0)**: an invoice or quote email with no Email brand goes out in the site's shared email look (Site Settings > SMTP > Email identity); one in an Email brand is never framed twice. The Send dialog's Preview shows the same frame as the email that goes out.
|
|
2179
2185
|
|
|
2180
2186
|
**Where:** Admin sidebar "Invoices" -> Invoices (`#/plugins/invoice`), Quotes, Issuers, Receivers; settings via the banner cog.
|
|
2181
2187
|
|
|
@@ -2836,6 +2842,8 @@ Later changes to these features are in the CHANGELOG (for example 0.92.1: row-le
|
|
|
2836
2842
|
### Content, authoring and the public site
|
|
2837
2843
|
|
|
2838
2844
|
- Build your first page: create, write Markdown, preview in split and Live Preview at mobile width, publish.
|
|
2845
|
+
- Make every email look like you: set the Email identity (name, PNG logo, accent, support address, footer) under Site Settings > SMTP, walk the preview gallery, send yourself a test, then see a password reset and a form notification in the same look.
|
|
2846
|
+
- Branded away replies: give a mailbox's identity a brand in Email Pro, switch on an away message, and send yourself a message to see the compact branded reply.
|
|
2839
2847
|
- Leaving Wix: copy the live site with Import a site, read the preview's notes (thin pages, unreadable addresses), import to a staging site, check the redirects from `/post/...`, then move the domain.
|
|
2840
2848
|
- Leaving Squarespace: export the WordPress-format file, import it before closing the account, and rebuild what Squarespace leaves out.
|
|
2841
2849
|
- Keep every old link working: bring the old site's own redirects across with Import a site (paste Squarespace's URL mappings, upload a Redirection export or the .htaccess file), read the skipped ones in the preview, then check them in SEO › Redirects.
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Brand Kit - one site-wide brand (design, not built)
|
|
2
|
+
|
|
3
|
+
Status: agreed design, 2026-11-19 (decisions below). Nothing here is implemented yet.
|
|
4
|
+
|
|
5
|
+
## The problem
|
|
6
|
+
|
|
7
|
+
A site's identity is kept in at least six places today, each with its own copy of the name, logo and colour:
|
|
8
|
+
|
|
9
|
+
| Where | What it holds | Used by |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| `site.json` `brand` (Site Settings > Branding) | public name, logo / icon, link | navbar, favicon fallback, SEO organisation, OG images |
|
|
12
|
+
| `site.json` `adminBrand` | admin name, logo (light/dark), icon | admin top bar, sign-in screens |
|
|
13
|
+
| Theme / Theme Roller | colours, fonts (tokens) | the public site and the admin |
|
|
14
|
+
| `site.json` `emailBrand` (Site Settings > SMTP > Email identity, CMS 1.78.0) | email name, raster logo, accent, support email, footer | every automated email (`server/services/emailBrand.js`) |
|
|
15
|
+
| Email Pro brandings (per person) | header artwork, backdrop, font, colours, footer; identities hold contact cards | Email's Send, away replies, Invoices |
|
|
16
|
+
| Tool-private looks | Surveys layouts, Campaigns layouts, Job Board `email-look.js`, Invoice house logo, chat `accent`/`avatar`, Social Media Pro OG designs, Ecards | each Tool alone |
|
|
17
|
+
|
|
18
|
+
An owner who changes their logo or colour has to find every one of these. Tools add their own "brand" fields because there is nothing to read.
|
|
19
|
+
|
|
20
|
+
## The idea
|
|
21
|
+
|
|
22
|
+
One **Brand Kit** per site in core: **Site Settings > Brand Kit** (rename of the Branding tab; one place).
|
|
23
|
+
|
|
24
|
+
- **Name**: display name, legal name, short name.
|
|
25
|
+
- **Logos**: primary (light / dark), mark (square, for favicons and avatars), and an email-safe raster copy made automatically from an SVG (sharp, PNG at 2x). This removes the "SVG falls back to the name" rule in email.
|
|
26
|
+
- **Colours**: accent and its ink, plus up to four named colours. They are not theme tokens: the theme never follows the Kit.
|
|
27
|
+
- **Type**: heading and body font (safe font + optional Google font, the same list Email Pro uses).
|
|
28
|
+
- **Contact**: support email, phone, address, website, company number / VAT, social links.
|
|
29
|
+
- **Small print**: a footer line and legal text.
|
|
30
|
+
|
|
31
|
+
Stored as `site.json` `brandKit`; `brand`, `emailBrand` and the admin fallbacks are read through it (migrated once, old keys kept as overrides).
|
|
32
|
+
|
|
33
|
+
**One reader for everyone**: `server/services/brandKit.js` exports `siteBrand()` (cleaned, absolute URLs) and publishes it to plugins through `hooks.brandKit()` plus `GET /api/brand-kit` (public fields only). Tools stop keeping their own copies and read this instead.
|
|
34
|
+
|
|
35
|
+
## How it fits with what exists
|
|
36
|
+
|
|
37
|
+
- **Automated emails**: `emailBrand()` reads the Kit. The SMTP tab's Email identity becomes "Email overrides" (empty by default).
|
|
38
|
+
- **Email Pro**: the Kit appears as a built-in, read-only branding called **Site** at the top of every person's list. Resolution order becomes chosen, then rule, then identity, then personal default, then **Site**. Personal brandings stay as they are and sit on top. Invoices, and any Tool using the registry `.branding`, get the Site brand when no one picked one.
|
|
39
|
+
- **Website**: Theme Roller can start a new theme from the Kit when asked (it never changes an existing one), and the navbar brand, favicon, sign-in page (`fix/login-branding`), Della's launcher accent/avatar and Social Media Pro's OG images default to it.
|
|
40
|
+
- **Documents**: invoice and quote printouts and PDFs, Docs Pro exports and Spaces, Surveys pages and Ecards take the Kit's logo, font and accent unless the Tool's own setting says otherwise.
|
|
41
|
+
- **Manager**: dcm shows each site's Kit on its site panel (read through the fleet API), and the Manager's own Kit is the Domma brand used by its emails (`brandedMail.js`).
|
|
42
|
+
|
|
43
|
+
Rule kept from Email Pro: **brand is the look, identity is the data**. The Kit is the site's look plus the site's own identity card; people's identities (Email Pro) keep their personal cards.
|
|
44
|
+
|
|
45
|
+
## Phases
|
|
46
|
+
|
|
47
|
+
1. **Core Brand Kit** (domma-cms): data, migration from `brand`/`emailBrand`, the settings section (domma-reactive, help popovers, Needs attention for a missing raster logo), `siteBrand()`, `hooks.brandKit()`, `/api/brand-kit`; `emailBrand()` reads it. Docs and DommaFeatures. *Smallest useful step.*
|
|
48
|
+
2. **Site brand in Email Pro**: a read-only "Site" branding drawn from the Kit; the new fallback in `resolveBranding()`; Invoices default to it; **Use as site brand** in the branding editor.
|
|
49
|
+
3. **Website and sign-in**: navbar/favicon/login/chat/OG defaults; Theme Roller can start a new theme from the Kit when asked (the Kit never changes a theme).
|
|
50
|
+
4. **Tools**: Job Board drops `email-look.js` for the shared look; Surveys, Campaigns, Ecards, Docs Pro and Invoice print take the Kit's name, logo and contact details by default (their own designs and overrides stay).
|
|
51
|
+
5. **Manager**: Kit on the site panel; the Domma Kit for the Manager's own emails.
|
|
52
|
+
|
|
53
|
+
## Decisions (Darryl, 2026-11-19)
|
|
54
|
+
|
|
55
|
+
- **Free core.** The Brand Kit is part of every site. The read-only "Site" branding inside Email Pro is part of Email Pro.
|
|
56
|
+
- **Never touch the theme.** Changing the Kit does not change the site or admin theme, and does not offer to. Theme Roller may still *start* a new theme from the Kit when the owner asks (phase 3).
|
|
57
|
+
- **Tool-private looks:** Job Board's `email-look.js` goes (it duplicates the shared look; Job Board reads the Kit). Surveys and Campaigns layouts stay as designs, taking the Kit's name, logo and contact details by default.
|
|
58
|
+
- **"Use as site brand"**: yes. An Email Pro branding's editor offers **Use as site brand**, copying its logo, colours, font and footer into the Kit (after a confirm; the Kit does not stay linked to it).
|
package/package.json
CHANGED
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
// Source: @domma-mail/core 0.36.0, packages/core/src/admin/mail/attach-arrange.js.
|
|
2
|
+
// Update with domma-mail/scripts/sync-cms.mjs; edit the shared source.
|
|
3
|
+
/**
|
|
4
|
+
* Attachments from somewhere other than this computer: the pure part.
|
|
5
|
+
*
|
|
6
|
+
* The compose window can be given "attachment sources" by its host (the CMS offers Media and the File Store).
|
|
7
|
+
* A source is trusted to open its own chooser, but what comes back is checked here before it is attached, and
|
|
8
|
+
* the lists a chooser shows are shaped here so the screen only ever draws plain records.
|
|
9
|
+
*
|
|
10
|
+
* @module _lib/admin/mail/attach-arrange
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
/** The most files one visit to a chooser may add. */
|
|
14
|
+
export const MAX_PICK = 25;
|
|
15
|
+
const BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
|
|
16
|
+
|
|
17
|
+
/** Bytes a base64 string decodes to. */
|
|
18
|
+
export function base64Bytes(content) {
|
|
19
|
+
const text = String(content ?? '');
|
|
20
|
+
if (!text) return 0;
|
|
21
|
+
const pad = text.endsWith('==') ? 2 : text.endsWith('=') ? 1 : 0;
|
|
22
|
+
return Math.max(0, Math.floor(text.length * 3 / 4) - pad);
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** A file name fit to put on an attachment: no folders, no control characters, never empty. */
|
|
26
|
+
export function safeName(name) {
|
|
27
|
+
// Controls go, and so do the direction overrides that can make "exe.png" read as "gnp.exe".
|
|
28
|
+
const base = String(name ?? '').split(/[\\/]/).pop().replace(/[\x00-\x1f\x7f-\x9f\u2028\u2029]/g, ' ')
|
|
29
|
+
.replace(/[\u200e\u200f\u202a-\u202e\u2066-\u2069]/g, '').replace(/\s+/g, ' ').trim();
|
|
30
|
+
return (base === '.' || base === '..' ? '' : base).slice(0, 200) || 'attachment';
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** A content type as a header value, or the catch-all. */
|
|
34
|
+
export function safeType(type) {
|
|
35
|
+
const text = String(type ?? '').split(';')[0].trim().toLowerCase();
|
|
36
|
+
return /^[a-z0-9][a-z0-9!#$&^_.+-]{0,60}\/[a-z0-9][a-z0-9!#$&^_.+-]{0,90}$/.test(text) ? text : 'application/octet-stream';
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* What a source handed back, as attachments: only well-formed ones, with the size worked out from the content
|
|
41
|
+
* itself rather than taken on trust.
|
|
42
|
+
*
|
|
43
|
+
* @param {unknown} items
|
|
44
|
+
* @returns {Array<{filename: string, contentType: string, content: string, bytes: number}>}
|
|
45
|
+
*/
|
|
46
|
+
export function cleanPicked(items, {max = MAX_PICK} = {}) {
|
|
47
|
+
const out = [];
|
|
48
|
+
for (const item of Array.isArray(items) ? items : []) {
|
|
49
|
+
if (!item || typeof item !== 'object' || typeof item.content !== 'string') continue;
|
|
50
|
+
// An empty file is a file: '' is its content.
|
|
51
|
+
if (item.content.length % 4 !== 0 || !BASE64.test(item.content)) continue;
|
|
52
|
+
out.push({filename: safeName(item.filename), contentType: safeType(item.contentType), content: item.content, bytes: base64Bytes(item.content)});
|
|
53
|
+
if (out.length === max) break;
|
|
54
|
+
}
|
|
55
|
+
return out;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** The sources a host offers, checked: an id, a short label and a function. */
|
|
59
|
+
export function cleanSources(list) {
|
|
60
|
+
const seen = new Set();
|
|
61
|
+
const out = [];
|
|
62
|
+
for (const s of Array.isArray(list) ? list : []) {
|
|
63
|
+
const id = String(s?.id ?? '');
|
|
64
|
+
if (!/^[a-z][a-z0-9-]{0,30}$/.test(id) || seen.has(id) || typeof s.pick !== 'function') continue;
|
|
65
|
+
const label = String(s.label ?? '').replace(/\s+/g, ' ').trim().slice(0, 40);
|
|
66
|
+
if (!label) continue;
|
|
67
|
+
seen.add(id);
|
|
68
|
+
out.push({id, label, title: String(s.title ?? label).replace(/\s+/g, ' ').trim().slice(0, 120), pick: s.pick});
|
|
69
|
+
if (out.length === 6) break;
|
|
70
|
+
}
|
|
71
|
+
return out;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** 1536 -> "1.5 KB". */
|
|
75
|
+
export function formatSize(bytes) {
|
|
76
|
+
const n = Number(bytes) || 0;
|
|
77
|
+
if (n < 1024) return `${n} B`;
|
|
78
|
+
if (n < 1024 * 1024) return `${(n / 1024).toFixed(n < 10 * 1024 ? 1 : 0)} KB`;
|
|
79
|
+
return `${(n / 1024 / 1024).toFixed(1)} MB`;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* A Media address as a path on this site (`/media/...`), or '' for anything else. The chooser fetches only
|
|
84
|
+
* these: an address from a list is data, and must not be able to send the browser somewhere else.
|
|
85
|
+
*/
|
|
86
|
+
export function mediaPath(url, origin = 'https://site.invalid') {
|
|
87
|
+
let u;
|
|
88
|
+
try { u = new URL(String(url ?? ''), origin); } catch { return ''; }
|
|
89
|
+
if (u.origin !== new URL(origin).origin || !u.pathname.startsWith('/media/') || u.pathname.includes('//')) return '';
|
|
90
|
+
// An encoded slash, backslash or null has no business in a file's address.
|
|
91
|
+
if (/%2f|%5c|%00/i.test(u.pathname)) return '';
|
|
92
|
+
return u.pathname;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** A size from a list: never negative, never not a number. */
|
|
96
|
+
const sizeOf = (v) => Math.max(0, Number(v) || 0);
|
|
97
|
+
const dirOf = (path) => (path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '');
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* Media, as the chooser's records. Takes the built-in list (an array of top-level files) or Media Pro's library
|
|
101
|
+
* (`{files, folders}`, where a file has a `path` inside its folders).
|
|
102
|
+
*
|
|
103
|
+
* @returns {{files: Array<{id, name, folder, size, url}>, folders: string[]}}
|
|
104
|
+
*/
|
|
105
|
+
export function mediaEntries(payload, origin) {
|
|
106
|
+
const raw = Array.isArray(payload) ? payload : Array.isArray(payload?.files) ? payload.files : [];
|
|
107
|
+
const files = [];
|
|
108
|
+
const folders = new Set();
|
|
109
|
+
for (const f of raw.slice(0, 20000)) {
|
|
110
|
+
if (!f || typeof f !== 'object') continue;
|
|
111
|
+
const path = String(f.path ?? f.name ?? '').replace(/^\/+/, '');
|
|
112
|
+
// The address is made here from the path, each part encoded: a list's own `url` is not, and a name with
|
|
113
|
+
// a `#`, `?` or `%` in it would otherwise be fetched as some other file.
|
|
114
|
+
const url = mediaPath(`/media/${path.split('/').map(encodeURIComponent).join('/')}`, origin);
|
|
115
|
+
if (!path || !url) continue;
|
|
116
|
+
const folder = dirOf(path);
|
|
117
|
+
files.push({id: `m:${path}`, name: path.split('/').pop(), folder, size: sizeOf(f.size), url});
|
|
118
|
+
}
|
|
119
|
+
const add = (path) => { for (let p = String(path || ''); p; p = dirOf(p)) folders.add(p); };
|
|
120
|
+
for (const f of files) add(f.folder);
|
|
121
|
+
for (const d of Array.isArray(payload?.folders) ? payload.folders.slice(0, 5000) : []) add(typeof d === 'string' ? d : d?.path);
|
|
122
|
+
return {files: files.sort((a, b) => a.name.localeCompare(b.name)), folders: [...folders].sort((a, b) => a.localeCompare(b))};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* One screen of Media: the folders directly inside `folder` and its files - or, when searching, every file whose
|
|
127
|
+
* name matches, wherever it is.
|
|
128
|
+
*/
|
|
129
|
+
export function mediaView({files, folders}, {folder = '', query = ''} = {}) {
|
|
130
|
+
const q = String(query).trim().toLowerCase();
|
|
131
|
+
if (q) return {folders: [], files: files.filter(f => f.name.toLowerCase().includes(q)).map(f => ({...f, where: f.folder || 'Top level'}))};
|
|
132
|
+
return {
|
|
133
|
+
folders: folders.filter(p => dirOf(p) === folder).map(p => ({id: p, name: p.split('/').pop()})),
|
|
134
|
+
files: files.filter(f => f.folder === folder).map(f => ({...f, where: ''}))
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** The way back up from a Media folder: [{id: '', name: 'Media'}, {id: 'a', name: 'a'}, ...]. */
|
|
139
|
+
export function mediaCrumbs(folder) {
|
|
140
|
+
const out = [{id: '', name: 'Media'}];
|
|
141
|
+
let at = '';
|
|
142
|
+
for (const part of String(folder || '').split('/').filter(Boolean)) { at = at ? `${at}/${part}` : part; out.push({id: at, name: part}); }
|
|
143
|
+
return out;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/** The File Store's answer to "what is here", as the chooser's records. */
|
|
147
|
+
export function storeView(payload, {place = 'mine'} = {}) {
|
|
148
|
+
const p = payload && typeof payload === 'object' ? payload : {};
|
|
149
|
+
const text = (v, max) => String(v ?? '').slice(0, max);
|
|
150
|
+
const id = (v) => (/^[0-9a-f]{24}$/.test(String(v)) ? String(v) : '');
|
|
151
|
+
return {
|
|
152
|
+
folders: (Array.isArray(p.folders) ? p.folders : []).filter(f => id(f?.id)).map(f => ({id: f.id, name: text(f.name, 200)})),
|
|
153
|
+
files: (Array.isArray(p.files) ? p.files : []).filter(f => id(f?.id)).map(f => ({id: `f:${f.id}`, fileId: f.id, name: text(f.name, 200), size: sizeOf(f.size),
|
|
154
|
+
where: text(f.path, 300) || (place === 'shared' ? text(f.owner?.name ?? f.owner, 80) : '')})),
|
|
155
|
+
crumbs: [{id: '', name: place === 'shared' ? 'Shared with me' : 'My files'}, ...(Array.isArray(p.crumbs) ? p.crumbs : []).filter(c => id(c?.id)).map(c => ({id: c.id, name: text(c.name, 200)}))]
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* The line under a chooser's list, and whether Attach may be pressed.
|
|
161
|
+
*
|
|
162
|
+
* @param {Array<{size: number}>} chosen
|
|
163
|
+
* @param {number} room - bytes left in the message before its limit (Infinity when unknown)
|
|
164
|
+
*/
|
|
165
|
+
export function choiceSummary(chosen, room = Infinity) {
|
|
166
|
+
const n = chosen.length;
|
|
167
|
+
const total = chosen.reduce((sum, f) => sum + sizeOf(f.size), 0);
|
|
168
|
+
if (!n) return {text: 'Tick the files to attach.', ok: false, over: false};
|
|
169
|
+
const many = n > MAX_PICK;
|
|
170
|
+
const over = Number.isFinite(room) && total > room;
|
|
171
|
+
const base = `${n} file${n === 1 ? '' : 's'}, ${formatSize(total)}`;
|
|
172
|
+
return {
|
|
173
|
+
text: many ? `${base}. No more than ${MAX_PICK} at a time.` : over ? `${base} - more than the ${formatSize(Math.max(0, room))} this message has room for.` : base,
|
|
174
|
+
ok: !many && !over, over: over || many
|
|
175
|
+
};
|
|
176
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// Source: @domma-mail/core 0.
|
|
1
|
+
// Source: @domma-mail/core 0.36.0, packages/core/src/admin/mail/body-menu.js.
|
|
2
2
|
// Update with domma-mail/scripts/sync-cms.mjs; edit the shared source.
|
|
3
3
|
/**
|
|
4
4
|
* The reading pane's right-click menu - the pure parts.
|