domma-cms 1.66.8 → 1.66.10
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 +14 -0
- package/admin/css/admin.css +1 -1
- package/admin/js/app.js +2 -2
- package/admin/js/lib/page-editor-reference.js +1 -1
- package/admin/js/templates/docs/usage-shortcodes-components.html +366 -0
- package/admin/js/templates/docs/usage-shortcodes-content.html +550 -0
- package/admin/js/templates/docs/usage-shortcodes-data.html +469 -0
- package/admin/js/templates/docs/usage-shortcodes-effects.html +897 -0
- package/admin/js/templates/docs/usage-shortcodes-layout.html +732 -0
- package/admin/js/templates/docs/usage-shortcodes.html +82 -0
- package/admin/js/templates/documentation.html +20 -0
- package/admin/js/templates/effects.html +1 -1
- package/admin/js/views/doc-pages.js +1 -1
- package/admin/js/views/index.js +1 -1
- package/docs/markdown-shortcodes.md +15 -10
- package/package.json +1 -1
- package/public/css/site.css +1 -1
- package/public/js/effects.js +1 -1
- package/server/server.js +5 -0
- package/server/services/docs.js +5 -0
- package/server/services/markdown.js +104 -34
- package/server/templates/page.html +2 -2
|
@@ -12,6 +12,88 @@
|
|
|
12
12
|
<p><strong>Syntax:</strong> <code>[shortcode attribute="value"]</code> (self-closing: <code>[shortcode
|
|
13
13
|
/]</code>) and <code>[/shortcode]</code> for paired tags.</p>
|
|
14
14
|
|
|
15
|
+
<p><strong>Every shortcode has a section of its own</strong>, with an example to copy and all of its
|
|
16
|
+
attributes, in these five chapters:</p>
|
|
17
|
+
<table class="table table-sm">
|
|
18
|
+
<thead>
|
|
19
|
+
<tr>
|
|
20
|
+
<th>Chapter</th>
|
|
21
|
+
<th>Shortcodes</th>
|
|
22
|
+
</tr>
|
|
23
|
+
</thead>
|
|
24
|
+
<tbody>
|
|
25
|
+
<tr>
|
|
26
|
+
<td><a href="#/docs/usage/shortcodes-layout">Layout shortcodes</a></td>
|
|
27
|
+
<td><code>[background]</code> <code>[grid]</code> <code>[row]</code> <code>[col]</code> <code>[center]</code> <code>[spacer]</code> <code>[card]</code> <code>[box]</code> <code>[hero]</code> <code>[slideover]</code> <code>[contents]</code> <code>[navbar]</code></td>
|
|
28
|
+
</tr>
|
|
29
|
+
<tr>
|
|
30
|
+
<td><a href="#/docs/usage/shortcodes-components">Component shortcodes</a></td>
|
|
31
|
+
<td><code>[tabs]</code> <code>[accordion]</code> <code>[carousel]</code> <code>[timeline]</code> <code>[listgroup]</code> <code>[table]</code> <code>[banner]</code> <code>[countdown]</code></td>
|
|
32
|
+
</tr>
|
|
33
|
+
<tr>
|
|
34
|
+
<td><a href="#/docs/usage/shortcodes-content">Content shortcodes</a></td>
|
|
35
|
+
<td><code>[text]</code> <code>[badge]</code> <code>[icon]</code> <code>[image]</code> <code>[button]</code> <code>[link]</code> <code>[embed]</code> <code>[map]</code> <code>[demo]</code> <code>[theme-switcher]</code> <code>[menu]</code></td>
|
|
36
|
+
</tr>
|
|
37
|
+
<tr>
|
|
38
|
+
<td><a href="#/docs/usage/shortcodes-data">Data shortcodes</a></td>
|
|
39
|
+
<td><code>[collection]</code> <code>[view]</code> <code>[block]</code> <code>[component]</code> <code>[form]</code> <code>[cta]</code> <code>[dconfig]</code></td>
|
|
40
|
+
</tr>
|
|
41
|
+
<tr>
|
|
42
|
+
<td><a href="#/docs/usage/shortcodes-effects">Effect shortcodes</a></td>
|
|
43
|
+
<td><code>[reveal]</code> <code>[breathe]</code> <code>[pulse]</code> <code>[shake]</code> <code>[animate]</code> <code>[scribe]</code> <code>[scramble]</code> <code>[counter]</code> <code>[ripple]</code> <code>[twinkle]</code> <code>[ambient]</code> <code>[ticker-tape]</code> <code>[butterflies]</code> <code>[strobe]</code> <code>[firework]</code> <code>[fireworks]</code> <code>[celebrate]</code> and the named celebrations (<code>[christmas /]</code>, <code>[easter /]</code> and the rest)</td>
|
|
44
|
+
</tr>
|
|
45
|
+
</tbody>
|
|
46
|
+
</table>
|
|
47
|
+
<p>Tools add shortcodes of their own (the Blog's <code>[blog-list]</code>, for example); each Tool's
|
|
48
|
+
guide lists them. The rest of this page is an overview, with the longer guides to cards,
|
|
49
|
+
collections and celebrations.</p>
|
|
50
|
+
|
|
51
|
+
<h3 id="expiry">Showing a shortcode for a limited time</h3>
|
|
52
|
+
<p>Every shortcode takes these optional attributes. When any limit you set is reached, the shortcode
|
|
53
|
+
and what is inside it are hidden from that visitor.</p>
|
|
54
|
+
<pre><code>[banner expires-at="2026-12-31T23:59:00Z"]Offer ends this year.[/banner]
|
|
55
|
+
[card expire-after="60" expire-scope="ip"]Shown for an hour after the first view.[/card]
|
|
56
|
+
[text expire-views="1" expire-scope="session"]Shown once in this browser session.[/text]</code></pre>
|
|
57
|
+
<table class="table table-sm">
|
|
58
|
+
<thead>
|
|
59
|
+
<tr>
|
|
60
|
+
<th>Attribute</th>
|
|
61
|
+
<th>What it does</th>
|
|
62
|
+
</tr>
|
|
63
|
+
</thead>
|
|
64
|
+
<tbody>
|
|
65
|
+
<tr>
|
|
66
|
+
<td><code>expires-at</code></td>
|
|
67
|
+
<td>Hidden from this date and time on. Write it with its time zone: <code>2026-12-31T23:59:00Z</code></td>
|
|
68
|
+
</tr>
|
|
69
|
+
<tr>
|
|
70
|
+
<td><code>expire-after</code></td>
|
|
71
|
+
<td>Hidden this many minutes after the visitor first saw it</td>
|
|
72
|
+
</tr>
|
|
73
|
+
<tr>
|
|
74
|
+
<td><code>expire-views</code></td>
|
|
75
|
+
<td>Hidden after the visitor has seen it this many times</td>
|
|
76
|
+
</tr>
|
|
77
|
+
<tr>
|
|
78
|
+
<td><code>expire-scope</code></td>
|
|
79
|
+
<td>How a visitor is counted: <code>ip</code> (by their address, the default) or <code>session</code> (by their browser session)</td>
|
|
80
|
+
</tr>
|
|
81
|
+
<tr>
|
|
82
|
+
<td><code>expire-session</code></td>
|
|
83
|
+
<td><code>true</code> shows it once per browser session</td>
|
|
84
|
+
</tr>
|
|
85
|
+
<tr>
|
|
86
|
+
<td><code>expire-ip</code></td>
|
|
87
|
+
<td>Shown only to these addresses or ranges, comma separated</td>
|
|
88
|
+
</tr>
|
|
89
|
+
<tr>
|
|
90
|
+
<td><code>expiry-id</code></td>
|
|
91
|
+
<td>A name for the counter, so it carries on counting if you move the shortcode within the page</td>
|
|
92
|
+
</tr>
|
|
93
|
+
</tbody>
|
|
94
|
+
</table>
|
|
95
|
+
<p>The editor's preview ignores these limits and does not use up views.</p>
|
|
96
|
+
|
|
15
97
|
<h3>Layout</h3>
|
|
16
98
|
<table class="table table-sm">
|
|
17
99
|
<thead>
|
|
@@ -46,6 +46,26 @@
|
|
|
46
46
|
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="code"></span> Shortcodes</h3>
|
|
47
47
|
<p class="text-muted" style="margin-bottom:0;">Every in-page shortcode, including [collection] and effects.</p></div>
|
|
48
48
|
</a>
|
|
49
|
+
<a href="#/docs/usage/shortcodes-layout" class="card" style="text-decoration:none;display:block;">
|
|
50
|
+
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="layout"></span> Layout shortcodes</h3>
|
|
51
|
+
<p class="text-muted" style="margin-bottom:0;">Backgrounds, grids, rows, cards, boxes, heroes and slideovers - one section each.</p></div>
|
|
52
|
+
</a>
|
|
53
|
+
<a href="#/docs/usage/shortcodes-components" class="card" style="text-decoration:none;display:block;">
|
|
54
|
+
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="layers"></span> Component shortcodes</h3>
|
|
55
|
+
<p class="text-muted" style="margin-bottom:0;">Tabs, accordions, carousels, timelines, lists, tables, banners and countdowns.</p></div>
|
|
56
|
+
</a>
|
|
57
|
+
<a href="#/docs/usage/shortcodes-content" class="card" style="text-decoration:none;display:block;">
|
|
58
|
+
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="type"></span> Content shortcodes</h3>
|
|
59
|
+
<p class="text-muted" style="margin-bottom:0;">Text, badges, icons, pictures, buttons, links, embeds, maps and menus.</p></div>
|
|
60
|
+
</a>
|
|
61
|
+
<a href="#/docs/usage/shortcodes-data" class="card" style="text-decoration:none;display:block;">
|
|
62
|
+
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="database"></span> Data shortcodes</h3>
|
|
63
|
+
<p class="text-muted" style="margin-bottom:0;">Collections, views, blocks, components, forms and action buttons on a page.</p></div>
|
|
64
|
+
</a>
|
|
65
|
+
<a href="#/docs/usage/shortcodes-effects" class="card" style="text-decoration:none;display:block;">
|
|
66
|
+
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="sparkles"></span> Effect shortcodes</h3>
|
|
67
|
+
<p class="text-muted" style="margin-bottom:0;">Reveal, typewriter text, counters, sparkles, light beams and celebrations.</p></div>
|
|
68
|
+
</a>
|
|
49
69
|
<a href="#/docs/usage/dconfig" class="card" style="text-decoration:none;display:block;">
|
|
50
70
|
<div class="card-body"><h3 style="margin-top:0;"><span data-icon="settings"></span> DConfig</h3>
|
|
51
71
|
<p class="text-muted" style="margin-bottom:0;">Declarative click handlers and class toggles per page.</p></div>
|
|
@@ -386,7 +386,7 @@ Your text appears letter by letter.
|
|
|
386
386
|
<h3 class="mb-2">Scramble</h3>
|
|
387
387
|
<p class="text-muted mb-2">Reveals text through a character-scramble animation. Great for tech/data
|
|
388
388
|
aesthetics.</p>
|
|
389
|
-
<pre class="code-block mb-3">[scramble speed="50" loop="
|
|
389
|
+
<pre class="code-block mb-3">[scramble speed="50" loop loop-delay="2000"]
|
|
390
390
|
Scrambled reveal text.
|
|
391
391
|
[/scramble]</pre>
|
|
392
392
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{mountScaffolder as
|
|
1
|
+
import{mountScaffolder as c}from"../lib/crud-tutorial.js";function t(o,s){return{templateUrl:`/admin/js/templates/docs/${o}.html`,async onMount(e){typeof s=="function"&&s(e),Domma.icons.scan(),Domma.syntax.scan()}}}export const docViews={tutorialCrud:t("tutorial-crud",o=>{const s=o.find("#tutorial-scaffolder-mount").get(0);s&&c(s,null,null)}),tutorialPlugin:t("tutorial-plugin"),tutorialEditor:t("tutorial-editor"),tutorialForms:t("tutorial-forms"),componentsReference:t("components-reference"),componentsHowto:t("components-howto"),componentsWalkthrough:t("components-walkthrough"),componentsRules:t("components-rules")};const a=["pages","media","navigation","dconfig","shortcodes","site-settings","plugins","users-roles","views","actions","cta-shortcode","editions","collections","blocks","tools","dashboard","search-engines","launchers","chat","shortcodes-layout","shortcodes-components","shortcodes-content","shortcodes-data","shortcodes-effects"],i=["authentication","pages","settings","layouts","navigation","media","users","plugins","collections","views","actions","forms","scaffold","external","content","builder"],n=o=>o.split("-").map(s=>s.charAt(0).toUpperCase()+s.slice(1)).join("");for(const o of a)docViews["usage"+n(o)]=t(`usage-${o}`);for(const o of i)docViews["apiRef"+n(o)]=t(`api-${o}`);
|
package/admin/js/views/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
const i={templateUrl:"",async onMount(){location.hash="#/menus"}};export const viewLoaders={projects:()=>import("./projects.js").then(e=>e.projectsView),projectDetail:()=>import("./project-detail.js").then(e=>e.projectDetailView),projectSettings:()=>import("./project-settings.js").then(e=>e.projectSettingsView),apiTokens:()=>import("./api-tokens.js").then(e=>e.apiTokensView),apiEndpoints:()=>import("./api-endpoints.js").then(e=>e.apiEndpointsView),apiEndpointEditor:()=>import("./api-endpoint-editor.js").then(e=>e.apiEndpointEditorView),dashboard:()=>import("./dashboard.js").then(e=>e.dashboardView),dashboards:()=>import("./dashboards.js").then(e=>e.dashboardsView),pages:()=>import("./pages.js").then(e=>e.pagesView),pageEditor:()=>import("./page-editor.js").then(e=>e.pageEditorView),appearance:()=>import("./appearance.js").then(e=>e.appearanceView),footer:()=>import("./footer.js").then(e=>e.footerView),settings:()=>import("./settings.js").then(e=>e.settingsView),theme:()=>import("./theme.js").then(e=>e.themeView),layouts:()=>import("./layouts.js").then(e=>e.layoutsView),media:()=>import("./media.js").then(e=>e.mediaView),login:()=>import("./login.js").then(e=>e.loginView),users:()=>import("./users.js").then(e=>e.usersView),userEditor:()=>import("./user-editor.js").then(e=>e.userEditorView),plugins:()=>import("./plugins.js").then(e=>e.pluginsView),pluginCode:()=>import("./plugin-code.js").then(e=>e.pluginCodeView),documentation:()=>import("./documentation.js").then(e=>e.documentationView),tutorials:()=>import("./tutorials.js").then(e=>e.tutorialsView),apiReference:()=>import("./api-reference.js").then(e=>e.apiReferenceView),collections:()=>import("./collections.js").then(e=>e.collectionsView),collectionEditor:()=>import("./collection-editor.js").then(e=>e.collectionEditorView),collectionEntries:()=>import("./collection-entries.js").then(e=>e.collectionEntriesView),forms:()=>import("./forms.js").then(e=>e.formsView),formEditor:()=>import("./form-editor.js").then(e=>e.formEditorView),formSubmissions:()=>import("./form-submissions.js").then(e=>e.formSubmissionsView),viewsList:()=>import("./views-list.js").then(e=>e.viewsListView),viewEditor:()=>import("./view-editor.js").then(e=>e.viewEditorView),viewPreview:()=>import("./view-preview.js").then(e=>e.viewPreviewView),actionsList:()=>import("./actions-list.js").then(e=>e.actionsListView),actionEditor:()=>import("./action-editor.js").then(e=>e.actionEditorView),proDocs:()=>import("./pro-docs.js").then(e=>e.proDocsView),blocks:()=>import("./blocks.js").then(e=>e.blocksView),components:()=>import("./components.js").then(e=>e.componentsView),myProfile:()=>import("./my-profile.js").then(e=>e.myProfileView),roles:()=>import("./roles.js").then(e=>e.rolesView),roleEditor:()=>import("./role-editor.js").then(e=>e.roleEditorView),effects:()=>import("./effects.js").then(e=>e.effectsView),search:()=>import("./search.js").then(e=>e.searchView),contentApi:()=>import("./content-api.js").then(e=>e.contentApiView),notes:()=>import("./notes.js").then(e=>e.notesView),chats:()=>import("./chats.js").then(e=>e.chatsView),chatKnowledge:()=>import("./chat-knowledge.js").then(e=>e.chatKnowledgeView),aiAssistChats:()=>import("./chats.js").then(e=>e.chatsView),aiAssistKnowledge:()=>import("./chat-knowledge.js").then(e=>e.chatKnowledgeView),aiAssistSettings:()=>import("./ai-assist-settings.js").then(e=>e.aiAssistSettingsView),aiAssistBuilders:()=>import("./ai-assist-builders.js").then(e=>e.aiAssistBuildersView),todo:()=>import("./todo.js").then(e=>e.todoView),calculator:()=>import("../lib/calculator.js").then(e=>e.calculatorView),analytics:()=>import("./analytics.js").then(e=>e.analyticsView),seo:()=>import("./seo.js").then(e=>e.seoView),wordpressImport:()=>import("./wordpress-import.js").then(e=>e.wordpressImportView),contacts:()=>import("./contacts.js").then(e=>e.contactsView),callNew:()=>import("./call-new.js").then(e=>e.callNewView),notifications:()=>import("./notifications.js").then(e=>e.notificationsView),menus:()=>import("./menus.js").then(e=>e.menusView),contextMenus:()=>import("./context-menus.js").then(e=>e.contextMenusView),launchers:()=>import("./launchers.js").then(e=>e.launchersView),contextMenuEditor:()=>import("./context-menu-editor.js").then(e=>e.contextMenuEditorView),menuEditor:()=>import("./menu-editor.js").then(e=>e.menuEditorView),menuLocations:()=>import("./menu-locations.js").then(e=>e.menuLocationsView),menusRedirect:async()=>i,pluginGuides:()=>import("./plugin-guides.js").then(e=>e.pluginGuidesView),pluginGuide:()=>import("./plugin-guides.js").then(e=>e.pluginGuideView)};for(const e of["tutorialCrud","tutorialPlugin","tutorialEditor","tutorialForms","componentsReference","componentsHowto","componentsWalkthrough","componentsRules","usagePages","usageMedia","usageNavigation","usageDconfig","usageShortcodes","usageSiteSettings","usagePlugins","usageUsersRoles","usageViews","usageActions","usageCtaShortcode","usageEditions","usageCollections","usageBlocks","usageTools","usageDashboard","usageSearchEngines","usageLaunchers","usageChat","apiRefAuthentication","apiRefPages","apiRefSettings","apiRefLayouts","apiRefNavigation","apiRefMedia","apiRefUsers","apiRefPlugins","apiRefCollections","apiRefViews","apiRefActions","apiRefForms","apiRefScaffold","apiRefExternal","apiRefContent","apiRefBuilder"])viewLoaders[e]=()=>import("./doc-pages.js").then(t=>t.docViews[e]);
|
|
1
|
+
const i={templateUrl:"",async onMount(){location.hash="#/menus"}};export const viewLoaders={projects:()=>import("./projects.js").then(e=>e.projectsView),projectDetail:()=>import("./project-detail.js").then(e=>e.projectDetailView),projectSettings:()=>import("./project-settings.js").then(e=>e.projectSettingsView),apiTokens:()=>import("./api-tokens.js").then(e=>e.apiTokensView),apiEndpoints:()=>import("./api-endpoints.js").then(e=>e.apiEndpointsView),apiEndpointEditor:()=>import("./api-endpoint-editor.js").then(e=>e.apiEndpointEditorView),dashboard:()=>import("./dashboard.js").then(e=>e.dashboardView),dashboards:()=>import("./dashboards.js").then(e=>e.dashboardsView),pages:()=>import("./pages.js").then(e=>e.pagesView),pageEditor:()=>import("./page-editor.js").then(e=>e.pageEditorView),appearance:()=>import("./appearance.js").then(e=>e.appearanceView),footer:()=>import("./footer.js").then(e=>e.footerView),settings:()=>import("./settings.js").then(e=>e.settingsView),theme:()=>import("./theme.js").then(e=>e.themeView),layouts:()=>import("./layouts.js").then(e=>e.layoutsView),media:()=>import("./media.js").then(e=>e.mediaView),login:()=>import("./login.js").then(e=>e.loginView),users:()=>import("./users.js").then(e=>e.usersView),userEditor:()=>import("./user-editor.js").then(e=>e.userEditorView),plugins:()=>import("./plugins.js").then(e=>e.pluginsView),pluginCode:()=>import("./plugin-code.js").then(e=>e.pluginCodeView),documentation:()=>import("./documentation.js").then(e=>e.documentationView),tutorials:()=>import("./tutorials.js").then(e=>e.tutorialsView),apiReference:()=>import("./api-reference.js").then(e=>e.apiReferenceView),collections:()=>import("./collections.js").then(e=>e.collectionsView),collectionEditor:()=>import("./collection-editor.js").then(e=>e.collectionEditorView),collectionEntries:()=>import("./collection-entries.js").then(e=>e.collectionEntriesView),forms:()=>import("./forms.js").then(e=>e.formsView),formEditor:()=>import("./form-editor.js").then(e=>e.formEditorView),formSubmissions:()=>import("./form-submissions.js").then(e=>e.formSubmissionsView),viewsList:()=>import("./views-list.js").then(e=>e.viewsListView),viewEditor:()=>import("./view-editor.js").then(e=>e.viewEditorView),viewPreview:()=>import("./view-preview.js").then(e=>e.viewPreviewView),actionsList:()=>import("./actions-list.js").then(e=>e.actionsListView),actionEditor:()=>import("./action-editor.js").then(e=>e.actionEditorView),proDocs:()=>import("./pro-docs.js").then(e=>e.proDocsView),blocks:()=>import("./blocks.js").then(e=>e.blocksView),components:()=>import("./components.js").then(e=>e.componentsView),myProfile:()=>import("./my-profile.js").then(e=>e.myProfileView),roles:()=>import("./roles.js").then(e=>e.rolesView),roleEditor:()=>import("./role-editor.js").then(e=>e.roleEditorView),effects:()=>import("./effects.js").then(e=>e.effectsView),search:()=>import("./search.js").then(e=>e.searchView),contentApi:()=>import("./content-api.js").then(e=>e.contentApiView),notes:()=>import("./notes.js").then(e=>e.notesView),chats:()=>import("./chats.js").then(e=>e.chatsView),chatKnowledge:()=>import("./chat-knowledge.js").then(e=>e.chatKnowledgeView),aiAssistChats:()=>import("./chats.js").then(e=>e.chatsView),aiAssistKnowledge:()=>import("./chat-knowledge.js").then(e=>e.chatKnowledgeView),aiAssistSettings:()=>import("./ai-assist-settings.js").then(e=>e.aiAssistSettingsView),aiAssistBuilders:()=>import("./ai-assist-builders.js").then(e=>e.aiAssistBuildersView),todo:()=>import("./todo.js").then(e=>e.todoView),calculator:()=>import("../lib/calculator.js").then(e=>e.calculatorView),analytics:()=>import("./analytics.js").then(e=>e.analyticsView),seo:()=>import("./seo.js").then(e=>e.seoView),wordpressImport:()=>import("./wordpress-import.js").then(e=>e.wordpressImportView),contacts:()=>import("./contacts.js").then(e=>e.contactsView),callNew:()=>import("./call-new.js").then(e=>e.callNewView),notifications:()=>import("./notifications.js").then(e=>e.notificationsView),menus:()=>import("./menus.js").then(e=>e.menusView),contextMenus:()=>import("./context-menus.js").then(e=>e.contextMenusView),launchers:()=>import("./launchers.js").then(e=>e.launchersView),contextMenuEditor:()=>import("./context-menu-editor.js").then(e=>e.contextMenuEditorView),menuEditor:()=>import("./menu-editor.js").then(e=>e.menuEditorView),menuLocations:()=>import("./menu-locations.js").then(e=>e.menuLocationsView),menusRedirect:async()=>i,pluginGuides:()=>import("./plugin-guides.js").then(e=>e.pluginGuidesView),pluginGuide:()=>import("./plugin-guides.js").then(e=>e.pluginGuideView)};for(const e of["tutorialCrud","tutorialPlugin","tutorialEditor","tutorialForms","componentsReference","componentsHowto","componentsWalkthrough","componentsRules","usagePages","usageMedia","usageNavigation","usageDconfig","usageShortcodes","usageSiteSettings","usagePlugins","usageUsersRoles","usageViews","usageActions","usageCtaShortcode","usageEditions","usageCollections","usageBlocks","usageTools","usageDashboard","usageSearchEngines","usageLaunchers","usageChat","usageShortcodesLayout","usageShortcodesComponents","usageShortcodesContent","usageShortcodesData","usageShortcodesEffects","apiRefAuthentication","apiRefPages","apiRefSettings","apiRefLayouts","apiRefNavigation","apiRefMedia","apiRefUsers","apiRefPlugins","apiRefCollections","apiRefViews","apiRefActions","apiRefForms","apiRefScaffold","apiRefExternal","apiRefContent","apiRefBuilder"])viewLoaders[e]=()=>import("./doc-pages.js").then(t=>t.docViews[e]);
|
|
@@ -247,8 +247,8 @@ with either, so pick a lighter or darker shade for body text. Anything else in `
|
|
|
247
247
|
text, links, code and footer on it.
|
|
248
248
|
|
|
249
249
|
A header is never drawn: `title`, `subtitle`, `icon`, `image` and `layout` are ignored. Effects that go on a
|
|
250
|
-
`[card]` (`reveal`, `pulse`, …) go on a `[box]` too. A `[card]` can sit inside a `[box]
|
|
251
|
-
`[card]
|
|
250
|
+
`[card]` (`reveal`, `pulse`, …) go on a `[box]` too. A `[card]` can sit inside a `[box]`, a `[box]` inside a
|
|
251
|
+
`[card]`, and a `[box]` inside another `[box]`. `rounded="xs"` is also available on `[card]`.
|
|
252
252
|
|
|
253
253
|
---
|
|
254
254
|
|
|
@@ -562,7 +562,7 @@ The following shortcodes are also available in page Markdown:
|
|
|
562
562
|
```
|
|
563
563
|
|
|
564
564
|
Attributes on `[tabs]`: `style` (`"pills"`, `"bordered"`, or default underline), `align` (`"center"` or `"right"`),
|
|
565
|
-
`fade
|
|
565
|
+
`id`. Panels always fade in - Domma's tabs do it themselves, so there is no switch for it.
|
|
566
566
|
Attributes on `[tab]`: `title`, `icon` (Domma icon name shown before the title).
|
|
567
567
|
|
|
568
568
|
---
|
|
@@ -754,9 +754,10 @@ The site will be read-only on **Sunday** from 8am.
|
|
|
754
754
|
| `class` | Extra CSS classes on the banner |
|
|
755
755
|
|
|
756
756
|
`[banner]` also accepts injected effects (`reveal`, `pulse`, `shake`, `ambient`, `animate`) - see
|
|
757
|
-
[Effect injection](#effect-injection). It is processed late (after `[card]` and `[grid]`),
|
|
758
|
-
|
|
759
|
-
|
|
757
|
+
[Effect injection](#effect-injection). It is processed late (after `[card]` and `[grid]`), when a container has already turned
|
|
758
|
+
its body into HTML, so the opening tag's attributes are put aside before the containers run (`holdBannerTags()`) and
|
|
759
|
+
given back at the banner stage. A banner can therefore sit inside a card, box, column, tab, accordion item or
|
|
760
|
+
slideover. A `[banner]` tag that appears later (from a plugin shortcode, say) is read as written, without that help.
|
|
760
761
|
|
|
761
762
|
---
|
|
762
763
|
|
|
@@ -1706,9 +1707,9 @@ The following shortcodes are provided by the built-in Effects system.
|
|
|
1706
1707
|
| `[pulse]...[/pulse]` | Repeating scale pulse |
|
|
1707
1708
|
| `[shake]...[/shake]` | One-shot shake |
|
|
1708
1709
|
| `[scribe speed="50"]...[/scribe]` | Typewriter - simple mode (text typed letter by letter) |
|
|
1709
|
-
| `[scramble]...[/scramble]`
|
|
1710
|
+
| `[scramble speed loop loop-delay]...[/scramble]` | Character-scramble reveal; `loop` replays it after `loop-delay` ms (default 2000) |
|
|
1710
1711
|
| `[counter to="100" /]` | Animated number counter (self-closing) |
|
|
1711
|
-
| `[ripple]...[/ripple]`
|
|
1712
|
+
| `[ripple colour duration opacity]...[/ripple]` | Click-triggered ripple; `opacity` (0-1) is how strong it starts |
|
|
1712
1713
|
| `[twinkle count="50"]...[/twinkle]` | Particle/star overlay |
|
|
1713
1714
|
| `[ticker-tape palette="festive" /]` | Falling ticker-tape strips - self-closing for full-page, wrapping form for container-scoped |
|
|
1714
1715
|
| `[butterflies palette="meadow" /]` | Flapping butterflies wander and rise - self-closing for full-page, wrapping form for container-scoped |
|
|
@@ -1862,6 +1863,10 @@ Fast, file-based and friendly.
|
|
|
1862
1863
|
[button href="/contact" pulse]Get in touch[/button]
|
|
1863
1864
|
```
|
|
1864
1865
|
|
|
1866
|
+
`animate` and `ambient` are CSS only. As switches they emit the same classes as their tags
|
|
1867
|
+
(`animate-type="zoom-in"` gives `animate-zoom-in`; `ambient-type="wave"` gives `bg-ambient-wave`) rather than a
|
|
1868
|
+
`dm-fx-*` class, and with no type they default to `fade-in` and `aurora`.
|
|
1869
|
+
|
|
1865
1870
|
| Host tag | Effects that can be injected |
|
|
1866
1871
|
|---|---|
|
|
1867
1872
|
| `[card]`, `[box]` | `reveal`, `breathe`, `pulse`, `shake`, `twinkle`, `ambient`, `animate`, `ripple` |
|
|
@@ -1920,8 +1925,8 @@ Container tags render their own bodies as they go: effect wrappers, `[tabs]`, `[
|
|
|
1920
1925
|
`[text]`, `[button]`, `[link]`, `[cta]`) and `[grid]`/`[card]` over their body before Markdown, so those work inside
|
|
1921
1926
|
all of them. `[center]` leaves its body as Markdown for the later stages, so anything processed after it works
|
|
1922
1927
|
inside it. Tags processed before a container (components, collections, views, blocks, menus) are already HTML by
|
|
1923
|
-
the time the container sees them, so they can be nested anywhere. `[banner]` runs after `[card]` and `[grid]`,
|
|
1924
|
-
|
|
1928
|
+
the time the container sees them, so they can be nested anywhere. `[banner]` runs after `[card]` and `[grid]`, but
|
|
1929
|
+
its attributes are held aside before they run, so it nests inside them too. Do not nest `[slideover]` inside another `[slideover]`. Cards, boxes, grids, rows, columns and background sections support balanced nesting.
|
|
1925
1930
|
|
|
1926
1931
|
### Optional Christmas elf scenes
|
|
1927
1932
|
|