domma-cms 1.66.7 → 1.66.9

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.
Files changed (99) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/admin/js/app.js +2 -2
  3. package/admin/js/lib/chat-toast.js +2 -2
  4. package/admin/js/lib/notifications-arrange.js +1 -1
  5. package/admin/js/templates/contacts.html +1 -1
  6. package/admin/js/templates/docs/usage-shortcodes-components.html +366 -0
  7. package/admin/js/templates/docs/usage-shortcodes-content.html +550 -0
  8. package/admin/js/templates/docs/usage-shortcodes-data.html +469 -0
  9. package/admin/js/templates/docs/usage-shortcodes-effects.html +880 -0
  10. package/admin/js/templates/docs/usage-shortcodes-layout.html +732 -0
  11. package/admin/js/templates/docs/usage-shortcodes.html +82 -0
  12. package/admin/js/templates/documentation.html +20 -0
  13. package/admin/js/views/doc-pages.js +1 -1
  14. package/admin/js/views/index.js +1 -1
  15. package/package.json +1 -1
  16. package/plugins/_lib/admin/mail/body-menu.js +1 -1
  17. package/plugins/_lib/admin/mail/cms-host.js +1 -1
  18. package/plugins/_lib/admin/mail/compose-window.js +1 -1
  19. package/plugins/_lib/admin/mail/contacts.js +1 -1
  20. package/plugins/_lib/admin/mail/diagnostics-section.js +1 -1
  21. package/plugins/_lib/admin/mail/drag-drop.js +1 -1
  22. package/plugins/_lib/admin/mail/folder-tree.js +1 -1
  23. package/plugins/_lib/admin/mail/font-controls.js +1 -1
  24. package/plugins/_lib/admin/mail/fonts.js +1 -1
  25. package/plugins/_lib/admin/mail/host-context.js +1 -1
  26. package/plugins/_lib/admin/mail/identity.js +1 -1
  27. package/plugins/_lib/admin/mail/image-senders-section.js +1 -1
  28. package/plugins/_lib/admin/mail/keyboard.js +1 -1
  29. package/plugins/_lib/admin/mail/mail.html +1 -1
  30. package/plugins/_lib/admin/mail/message-actions.js +1 -1
  31. package/plugins/_lib/admin/mail/oauth-panel.js +1 -1
  32. package/plugins/_lib/admin/mail/panes.js +1 -1
  33. package/plugins/_lib/admin/mail/reader-kit.js +1 -1
  34. package/plugins/_lib/admin/mail/reader-runtime.js +1 -34
  35. package/plugins/_lib/admin/mail/reader-view.js +1 -1
  36. package/plugins/_lib/admin/mail/resizable.js +1 -1
  37. package/plugins/_lib/admin/mail/restore-spam.js +1 -1
  38. package/plugins/_lib/admin/mail/rules.js +1 -1
  39. package/plugins/_lib/admin/mail/scheduling.js +1 -1
  40. package/plugins/_lib/admin/mail/section-kit.js +1 -1
  41. package/plugins/_lib/admin/mail/security-note.js +1 -1
  42. package/plugins/_lib/admin/mail/settings-section.js +1 -1
  43. package/plugins/_lib/admin/mail/templates.js +1 -1
  44. package/plugins/_lib/admin/mail/threads.js +1 -1
  45. package/plugins/_lib/admin/mail/vacation.js +1 -1
  46. package/plugins/_lib/admin/mail/when-closed.js +1 -1
  47. package/plugins/_lib/admin/ui/dates.js +1 -1
  48. package/plugins/_lib/admin/ui/resizable.js +1 -1
  49. package/plugins/_lib/contacts/mailContact.js +1 -1
  50. package/plugins/_lib/contacts/model.js +1 -1
  51. package/plugins/_lib/domma-mail-contacts.lock.json +18 -18
  52. package/plugins/_lib/domma-mail.lock.json +80 -80
  53. package/plugins/_lib/mail/accountFileStore.js +1 -1
  54. package/plugins/_lib/mail/accountRepository.js +1 -1
  55. package/plugins/_lib/mail/accountRoutes.js +1 -1
  56. package/plugins/_lib/mail/bodyTokenProvider.js +1 -1
  57. package/plugins/_lib/mail/bodyTokens.js +1 -1
  58. package/plugins/_lib/mail/compose.js +1 -1
  59. package/plugins/_lib/mail/defaults.js +1 -1
  60. package/plugins/_lib/mail/envelope.js +1 -1
  61. package/plugins/_lib/mail/folderActions.js +1 -1
  62. package/plugins/_lib/mail/folderRuntime.js +1 -1
  63. package/plugins/_lib/mail/folders.js +1 -1
  64. package/plugins/_lib/mail/imapPoolRuntime.js +1 -1
  65. package/plugins/_lib/mail/mbox.js +1 -1
  66. package/plugins/_lib/mail/message-action.js +1 -1
  67. package/plugins/_lib/mail/messageSecurity.js +1 -1
  68. package/plugins/_lib/mail/messageSecurityProvider.js +1 -1
  69. package/plugins/_lib/mail/networkAddresses.js +1 -1
  70. package/plugins/_lib/mail/networkPolicy.js +1 -1
  71. package/plugins/_lib/mail/oauthAccounts.js +1 -1
  72. package/plugins/_lib/mail/oauthRouteRuntime.js +1 -1
  73. package/plugins/_lib/mail/oauthRuntime.js +1 -1
  74. package/plugins/_lib/mail/pollSchedule.js +1 -1
  75. package/plugins/_lib/mail/poller.js +1 -1
  76. package/plugins/_lib/mail/pollerRuntime.js +1 -1
  77. package/plugins/_lib/mail/priority.js +1 -1
  78. package/plugins/_lib/mail/publicMailbox.js +1 -1
  79. package/plugins/_lib/mail/readRuntime.js +1 -1
  80. package/plugins/_lib/mail/render.js +1 -1
  81. package/plugins/_lib/mail/ruleRunner.js +1 -1
  82. package/plugins/_lib/mail/schedulerRuntime.js +1 -1
  83. package/plugins/_lib/mail/secretProvider.js +1 -1
  84. package/plugins/_lib/mail/secretbox.js +1 -1
  85. package/plugins/_lib/mail/senderAuth.js +1 -1
  86. package/plugins/_lib/mail/sieve.js +1 -1
  87. package/plugins/_lib/mail/smtpService.js +1 -1
  88. package/plugins/_lib/mail/snoozeRuntime.js +1 -1
  89. package/plugins/_lib/mail/store.js +1 -1
  90. package/plugins/_lib/mail/subscriptions.js +1 -1
  91. package/plugins/_lib/mail/syncPlan.js +1 -1
  92. package/plugins/_lib/mail/syncRuntime.js +1 -1
  93. package/plugins/_lib/mail/syncSelection.js +1 -1
  94. package/plugins/_lib/mail/unreadBadge.js +1 -1
  95. package/plugins/_lib/mail/unsubscribe.js +1 -1
  96. package/plugins/_lib/mail/vacationRuntime.js +1 -1
  97. package/plugins/_lib/mail/write.js +1 -1
  98. package/server/server.js +5 -0
  99. package/server/services/docs.js +5 -0
@@ -0,0 +1,550 @@
1
+ <div class="view-header">
2
+ <h1><span data-icon="type"></span> Content shortcodes</h1>
3
+ <a href="#/docs/usage/shortcodes" class="btn btn-ghost btn-sm"><span data-icon="arrow-left"></span> Shortcodes</a>
4
+ </div>
5
+
6
+ <div class="row">
7
+ <div class="col-12">
8
+ <div class="docs-body">
9
+
10
+ <p>These shortcodes put things on a page: styled words, badges, icons, pictures, buttons, links, videos, maps and menus. Each one has its own section below, with an example to copy and every attribute it takes.</p>
11
+ <p>The small ones - text, badge, icon, picture, button and link - can be written in the middle of a sentence and inside any container (cards, grids, tabs, accordions, slideovers).</p>
12
+ <h3 id="sc-text"><code>text</code> - styled words</h3>
13
+ <p>Styles a few words: their size, weight, colour, or a gradient that shines.</p>
14
+ <pre><code>[text size=&quot;xl&quot; bold color=&quot;primary&quot;]Styled text[/text]
15
+ [text gradient=&quot;sunset&quot; shine=&quot;sweep&quot;]Words painted in a gradient[/text]
16
+ ## [text words]A headline that rises word by word[/text]
17
+ </code></pre>
18
+ <table class="table table-sm">
19
+ <thead>
20
+ <tr>
21
+ <th>Attribute</th>
22
+ <th>What it does</th>
23
+ </tr>
24
+ </thead>
25
+ <tbody><tr>
26
+ <td><code>size</code></td>
27
+ <td><code>xs</code>, <code>sm</code>, <code>base</code>, <code>lg</code>, <code>xl</code>, <code>2xl</code>, <code>3xl</code>, <code>4xl</code>, or a size such as <code>1.5em</code></td>
28
+ </tr>
29
+ <tr>
30
+ <td><code>point-size</code></td>
31
+ <td>A size in points, such as <code>14</code></td>
32
+ </tr>
33
+ <tr>
34
+ <td><code>weight</code></td>
35
+ <td><code>thin</code>, <code>light</code>, <code>normal</code>, <code>medium</code>, <code>semibold</code>, <code>bold</code>, <code>extrabold</code> or <code>black</code></td>
36
+ </tr>
37
+ <tr>
38
+ <td><code>bold</code>, <code>italic</code></td>
39
+ <td>Switches</td>
40
+ </tr>
41
+ <tr>
42
+ <td><code>color</code> (or <code>colour</code>)</td>
43
+ <td>A theme name (<code>primary</code>, <code>secondary</code>, <code>muted</code>, <code>danger</code>, <code>success</code>, <code>warning</code>, <code>info</code>) or any CSS colour</td>
44
+ </tr>
45
+ <tr>
46
+ <td><code>font</code></td>
47
+ <td>A font by name: <code>Georgia</code>, <code>Arial</code>, <code>Verdana</code>, <code>Courier New</code>, <code>Times New Roman</code>, <code>Trebuchet MS</code>, and web fonts such as <code>Roboto</code>, <code>Inter</code>, <code>Open Sans</code>, <code>Lato</code>, <code>Nunito</code> and <code>Poppins</code>. The editor&#39;s form lists them all</td>
48
+ </tr>
49
+ <tr>
50
+ <td><code>transform</code></td>
51
+ <td><code>upper</code>, <code>lower</code>, <code>capitalize</code> or <code>none</code></td>
52
+ </tr>
53
+ <tr>
54
+ <td><code>decoration</code></td>
55
+ <td><code>underline</code>, <code>line-through</code> or <code>none</code></td>
56
+ </tr>
57
+ <tr>
58
+ <td><code>spacing</code></td>
59
+ <td>Space between letters: <code>tight</code>, <code>normal</code>, <code>wide</code>, <code>wider</code>, or a value such as <code>0.1em</code></td>
60
+ </tr>
61
+ <tr>
62
+ <td><code>align</code></td>
63
+ <td><code>left</code>, <code>center</code>, <code>right</code> or <code>justify</code>. The text then takes a line of its own</td>
64
+ </tr>
65
+ <tr>
66
+ <td><code>gradient</code></td>
67
+ <td>Paints the words in a gradient: <code>brand</code>, <code>sunset</code>, <code>ocean</code>, <code>forest</code>, <code>fire</code>, <code>candy</code>, <code>newspaper</code>, <code>grey-fire</code>, <code>ice</code>, <code>summer</code>, <code>autumn</code>, <code>spring</code>, <code>winter</code>, <code>aurora</code>, <code>twilight</code>, <code>rose-gold</code>, <code>copper</code>, <code>amethyst</code>, <code>lagoon</code>, <code>cherry</code>, <code>lavender</code>, <code>midnight</code>, or two hex colours: <code>#f26b3a,#8b5cf6</code></td>
68
+ </tr>
69
+ <tr>
70
+ <td><code>shine</code></td>
71
+ <td>With a gradient: <code>hover</code> (a highlight follows the pointer) or <code>sweep</code> (it crosses every few seconds)</td>
72
+ </tr>
73
+ <tr>
74
+ <td><code>light-up</code></td>
75
+ <td>Switch: the text starts dim and lights up word by word as the page scrolls</td>
76
+ </tr>
77
+ <tr>
78
+ <td><code>words</code></td>
79
+ <td>Switch: the text rises into view word by word</td>
80
+ </tr>
81
+ <tr>
82
+ <td><code>style</code></td>
83
+ <td>Your own CSS, added to the rest</td>
84
+ </tr>
85
+ <tr>
86
+ <td><code>class</code>, <code>id</code></td>
87
+ <td>Your own CSS class or id</td>
88
+ </tr>
89
+ </tbody></table>
90
+ <p>Good to know:</p>
91
+ <ul>
92
+ <li><code>[text]</code> tags nest, so a gradient phrase can sit inside a headline that rises word by word.</li>
93
+ <li>Movement is switched off for visitors whose device asks for reduced motion; they see the text whole.</li>
94
+ <li>In the editor: select words, right-click and choose <strong>Wrap selection in… &gt; Highlight text</strong>. Right-click an existing <code>[text]</code> tag for one-click changes or <strong>Edit Text…</strong>.</li>
95
+ </ul>
96
+ <h3 id="sc-badge"><code>badge</code> - a small label</h3>
97
+ <p>A small coloured label, in a sentence or beside a heading.</p>
98
+ <pre><code>[badge variant=&quot;success&quot;]New[/badge]
99
+ [badge variant=&quot;danger&quot; outline pill]Deprecated[/badge]
100
+ [badge variant=&quot;primary&quot; pill /]
101
+ </code></pre>
102
+ <table class="table table-sm">
103
+ <thead>
104
+ <tr>
105
+ <th>Attribute</th>
106
+ <th>What it does</th>
107
+ </tr>
108
+ </thead>
109
+ <tbody><tr>
110
+ <td><code>variant</code></td>
111
+ <td>The colour: <code>primary</code>, <code>secondary</code>, <code>success</code>, <code>danger</code>, <code>warning</code>, <code>info</code>, <code>light</code> or <code>dark</code></td>
112
+ </tr>
113
+ <tr>
114
+ <td><code>pill</code></td>
115
+ <td>Switch: fully rounded ends</td>
116
+ </tr>
117
+ <tr>
118
+ <td><code>outline</code></td>
119
+ <td>Switch: an outline instead of a filled label</td>
120
+ </tr>
121
+ <tr>
122
+ <td><code>size</code></td>
123
+ <td><code>small</code> or <code>large</code></td>
124
+ </tr>
125
+ </tbody></table>
126
+ <p>The self-closing form, with no text, draws a coloured dot.</p>
127
+ <h3 id="sc-icon"><code>icon</code> - an icon</h3>
128
+ <p>One icon from the site&#39;s icon set, in line with the text.</p>
129
+ <pre><code>[icon name=&quot;arrow-right&quot; /]
130
+ [icon name=&quot;star&quot; size=&quot;24&quot; color=&quot;#f59e0b&quot; /]
131
+ </code></pre>
132
+ <table class="table table-sm">
133
+ <thead>
134
+ <tr>
135
+ <th>Attribute</th>
136
+ <th>What it does</th>
137
+ </tr>
138
+ </thead>
139
+ <tbody><tr>
140
+ <td><code>name</code></td>
141
+ <td>Which icon. Required</td>
142
+ </tr>
143
+ <tr>
144
+ <td><code>size</code></td>
145
+ <td>Its size in pixels</td>
146
+ </tr>
147
+ <tr>
148
+ <td><code>color</code></td>
149
+ <td>Its colour</td>
150
+ </tr>
151
+ <tr>
152
+ <td><code>class</code></td>
153
+ <td>Your own CSS class</td>
154
+ </tr>
155
+ </tbody></table>
156
+ <h3 id="sc-image"><code>image</code> - a picture with options</h3>
157
+ <p>A picture with options: size, alignment, corners, a border, a shadow, a caption, and a click to see it full size. Use it instead of a plain Markdown picture when you need any of those - above all for screenshots whose small text cannot be read at page size.</p>
158
+ <pre><code>[image src=&quot;/media/settings.png&quot; alt=&quot;The settings screen&quot; caption=&quot;Settings&quot; zoom /]
159
+ [image src=&quot;/media/team.jpg&quot; alt=&quot;The team&quot; align=&quot;float-right&quot; width=&quot;300&quot; /]
160
+ [image src=&quot;/media/step-1.png&quot; alt=&quot;Step 1&quot; width=&quot;480&quot; align=&quot;center&quot; zoom group=&quot;tour&quot; shadow=&quot;md&quot; radius=&quot;md&quot; /]
161
+ [image src=&quot;/media/logo.png&quot; alt=&quot;Home&quot; link=&quot;/&quot; /]
162
+ </code></pre>
163
+ <table class="table table-sm">
164
+ <thead>
165
+ <tr>
166
+ <th>Attribute</th>
167
+ <th>What it does</th>
168
+ </tr>
169
+ </thead>
170
+ <tbody><tr>
171
+ <td><code>src</code></td>
172
+ <td>The picture: a <code>/media/…</code> path or a web address. Required</td>
173
+ </tr>
174
+ <tr>
175
+ <td><code>alt</code></td>
176
+ <td>What the picture shows, for screen readers and search engines</td>
177
+ </tr>
178
+ <tr>
179
+ <td><code>caption</code></td>
180
+ <td>Words under the picture, also shown in the zoom view</td>
181
+ </tr>
182
+ <tr>
183
+ <td><code>title</code></td>
184
+ <td>Words shown when the pointer rests on the picture</td>
185
+ </tr>
186
+ <tr>
187
+ <td><code>width</code></td>
188
+ <td>Its width: <code>480</code> (pixels), <code>60%</code>, <code>30rem</code>. Without it, the picture&#39;s own size, never wider than the column</td>
189
+ </tr>
190
+ <tr>
191
+ <td><code>max-width</code></td>
192
+ <td>A limit on the width</td>
193
+ </tr>
194
+ <tr>
195
+ <td><code>height</code></td>
196
+ <td>A set height; the picture is cropped to fill it</td>
197
+ </tr>
198
+ <tr>
199
+ <td><code>fit</code></td>
200
+ <td>With a height: <code>cover</code> (crop to fill, the default), <code>contain</code>, <code>fill</code>, <code>none</code> or <code>scale-down</code></td>
201
+ </tr>
202
+ <tr>
203
+ <td><code>align</code></td>
204
+ <td><code>left</code> (default), <code>center</code>, <code>right</code>, or <code>float-left</code> / <code>float-right</code> to let text wrap around it</td>
205
+ </tr>
206
+ <tr>
207
+ <td><code>radius</code></td>
208
+ <td>Rounded corners: <code>sm</code>, <code>md</code>, <code>lg</code>, <code>full</code>, or a length</td>
209
+ </tr>
210
+ <tr>
211
+ <td><code>border</code></td>
212
+ <td>Switch: a thin border</td>
213
+ </tr>
214
+ <tr>
215
+ <td><code>shadow</code></td>
216
+ <td><code>sm</code>, <code>md</code> or <code>lg</code></td>
217
+ </tr>
218
+ <tr>
219
+ <td><code>zoom</code></td>
220
+ <td>Switch: a click opens the picture full size</td>
221
+ </tr>
222
+ <tr>
223
+ <td><code>zoom-src</code></td>
224
+ <td>A larger file to show in the zoom view</td>
225
+ </tr>
226
+ <tr>
227
+ <td><code>group</code></td>
228
+ <td>Zoomable pictures with the same group name can be stepped through with arrows</td>
229
+ </tr>
230
+ <tr>
231
+ <td><code>link</code></td>
232
+ <td>Where a click on the picture goes. A linked picture does not zoom</td>
233
+ </tr>
234
+ <tr>
235
+ <td><code>target</code></td>
236
+ <td><code>_blank</code> opens the link in a new tab</td>
237
+ </tr>
238
+ <tr>
239
+ <td><code>loading</code></td>
240
+ <td><code>lazy</code> (default) or <code>eager</code> for a picture at the very top of a page</td>
241
+ </tr>
242
+ <tr>
243
+ <td><code>class</code>, <code>id</code></td>
244
+ <td>Your own CSS class or id</td>
245
+ </tr>
246
+ </tbody></table>
247
+ <p>Good to know:</p>
248
+ <ul>
249
+ <li>On a line of its own, the picture shows its caption underneath. In the middle of a sentence it is an inline picture, and the caption shows only in the zoom view.</li>
250
+ <li>In the zoom view, click to go to actual size, drag to move around, and press Esc to close.</li>
251
+ <li>In the editor, <strong>Insert &gt; Image</strong> picks from Media and opens these settings; right-click a tag and choose <strong>Edit Image…</strong> to change them.</li>
252
+ </ul>
253
+ <h3 id="sc-button"><code>button</code> - a link that looks like a button</h3>
254
+ <p>A link that looks like a button.</p>
255
+ <pre><code>[button href=&quot;/contact&quot; variant=&quot;primary&quot;]Get in touch[/button]
256
+ [button href=&quot;/download&quot; variant=&quot;success&quot; icon=&quot;download&quot; size=&quot;sm&quot; label=&quot;Download&quot; /]
257
+ [button href=&quot;https://example.com&quot; variant=&quot;outline&quot; target=&quot;_blank&quot;]Visit site[/button]
258
+ </code></pre>
259
+ <table class="table table-sm">
260
+ <thead>
261
+ <tr>
262
+ <th>Attribute</th>
263
+ <th>What it does</th>
264
+ </tr>
265
+ </thead>
266
+ <tbody><tr>
267
+ <td><code>href</code></td>
268
+ <td>Where the button goes</td>
269
+ </tr>
270
+ <tr>
271
+ <td><code>label</code></td>
272
+ <td>The words on the button, for the self-closing form. In the paired form, the words go between the tags</td>
273
+ </tr>
274
+ <tr>
275
+ <td><code>variant</code></td>
276
+ <td><code>primary</code> (default), <code>secondary</code>, <code>success</code>, <code>danger</code>, <code>warning</code>, <code>info</code>, <code>outline</code>, <code>ghost</code>, <code>link</code>, <code>outline-success</code>, <code>outline-danger</code>, <code>outline-warning</code> or <code>outline-info</code></td>
277
+ </tr>
278
+ <tr>
279
+ <td><code>size</code></td>
280
+ <td><code>sm</code> or <code>lg</code></td>
281
+ </tr>
282
+ <tr>
283
+ <td><code>icon</code></td>
284
+ <td>An icon before the words</td>
285
+ </tr>
286
+ <tr>
287
+ <td><code>icon-after</code></td>
288
+ <td>An icon after the words</td>
289
+ </tr>
290
+ <tr>
291
+ <td><code>target</code></td>
292
+ <td><code>_blank</code> opens in a new tab</td>
293
+ </tr>
294
+ <tr>
295
+ <td><code>class</code>, <code>id</code></td>
296
+ <td>Your own CSS class or id</td>
297
+ </tr>
298
+ </tbody></table>
299
+ <p>A button takes the effects <code>breathe</code>, <code>pulse</code>, <code>shake</code> and <code>ripple</code> as switches: <code>[button href=&quot;/contact&quot; pulse]Get in touch[/button]</code>.</p>
300
+ <p>To make a button that runs an Action rather than opening a page, use <code>[cta]</code> - see <a href="#/docs/usage/shortcodes-data">Data shortcodes</a>.</p>
301
+ <h3 id="sc-link"><code>link</code> - a link with extras</h3>
302
+ <p>A text link with extras: an icon, a new tab, your own class. For an ordinary link, plain Markdown - <code>[words](/address)</code> - is simpler.</p>
303
+ <pre><code>[link href=&quot;/about&quot;]About us[/link]
304
+ [link href=&quot;https://example.com&quot; target=&quot;_blank&quot; icon-after=&quot;external-link&quot;]Visit site[/link]
305
+ [link href=&quot;/about&quot; icon=&quot;arrow-right&quot; label=&quot;About us&quot; /]
306
+ </code></pre>
307
+ <table class="table table-sm">
308
+ <thead>
309
+ <tr>
310
+ <th>Attribute</th>
311
+ <th>What it does</th>
312
+ </tr>
313
+ </thead>
314
+ <tbody><tr>
315
+ <td><code>href</code></td>
316
+ <td>Where the link goes</td>
317
+ </tr>
318
+ <tr>
319
+ <td><code>label</code></td>
320
+ <td>The words, for the self-closing form</td>
321
+ </tr>
322
+ <tr>
323
+ <td><code>target</code></td>
324
+ <td><code>_blank</code> opens in a new tab</td>
325
+ </tr>
326
+ <tr>
327
+ <td><code>icon</code></td>
328
+ <td>An icon before the words</td>
329
+ </tr>
330
+ <tr>
331
+ <td><code>icon-after</code></td>
332
+ <td>An icon after the words</td>
333
+ </tr>
334
+ <tr>
335
+ <td><code>class</code>, <code>id</code></td>
336
+ <td>Your own CSS class or id</td>
337
+ </tr>
338
+ </tbody></table>
339
+ <h3 id="sc-embed"><code>embed</code> - a video or another website</h3>
340
+ <p>A video, or a page from another website, shown in a frame.</p>
341
+ <pre><code>[embed url=&quot;https://youtu.be/dQw4w9WgXcQ&quot; /]
342
+ [embed url=&quot;/media/showreel.mp4&quot; ratio=&quot;16:9&quot; title=&quot;Our showreel&quot; /]
343
+ [embed url=&quot;/media/hero.mp4&quot; autoplay muted loop /]
344
+ </code></pre>
345
+ <table class="table table-sm">
346
+ <thead>
347
+ <tr>
348
+ <th>Attribute</th>
349
+ <th>What it does</th>
350
+ </tr>
351
+ </thead>
352
+ <tbody><tr>
353
+ <td><code>url</code></td>
354
+ <td>A YouTube or Vimeo link, a video file from Media (<code>.mp4</code>, <code>.webm</code>, <code>.ogg</code>), or another web address. Required</td>
355
+ </tr>
356
+ <tr>
357
+ <td><code>ratio</code></td>
358
+ <td>The frame&#39;s shape: <code>16:9</code> (default), <code>4:3</code>, <code>1:1</code>, <code>21:9</code>, <code>9:16</code>, <code>3:4</code>, or any <code>width:height</code></td>
359
+ </tr>
360
+ <tr>
361
+ <td><code>title</code></td>
362
+ <td>A caption under the frame, also read out by screen readers</td>
363
+ </tr>
364
+ <tr>
365
+ <td><code>width</code></td>
366
+ <td>A limit on the width, in pixels or percent</td>
367
+ </tr>
368
+ <tr>
369
+ <td><code>align</code></td>
370
+ <td><code>left</code>, <code>center</code> or <code>right</code>, when a width is set</td>
371
+ </tr>
372
+ <tr>
373
+ <td><code>autoplay</code></td>
374
+ <td>Switch: start playing straight away (the video is muted, as browsers require)</td>
375
+ </tr>
376
+ <tr>
377
+ <td><code>loop</code></td>
378
+ <td>Switch: play again when it ends</td>
379
+ </tr>
380
+ <tr>
381
+ <td><code>muted</code></td>
382
+ <td>Switch: start with the sound off</td>
383
+ </tr>
384
+ </tbody></table>
385
+ <p>Good to know:</p>
386
+ <ul>
387
+ <li>YouTube and Vimeo are always allowed. YouTube videos play through its privacy-friendly player (<code>youtube-nocookie.com</code>).</li>
388
+ <li>Any other website has to be on the site&#39;s list of allowed hosts first; until it is, the page shows a &quot;not allowed&quot; notice in place of the frame. On a self-hosted site the list is <code>config/embeds.json</code>.</li>
389
+ <li>In the editor, <strong>Insert &gt; Embed</strong> has a field for the address and a picker for videos in Media.</li>
390
+ </ul>
391
+ <h3 id="sc-map"><code>map</code> - a map of one place</h3>
392
+ <p>A Google Map of one place.</p>
393
+ <pre><code>[map postcode=&quot;SW1A 2AA&quot; zoom=&quot;15&quot; caption=&quot;Visit us&quot; /]
394
+ [map pin=&quot;51.5034,-0.1276&quot; zoom=&quot;14&quot; ratio=&quot;4:3&quot; width=&quot;640&quot; align=&quot;center&quot; /]
395
+ </code></pre>
396
+ <table class="table table-sm">
397
+ <thead>
398
+ <tr>
399
+ <th>Attribute</th>
400
+ <th>What it does</th>
401
+ </tr>
402
+ </thead>
403
+ <tbody><tr>
404
+ <td><code>postcode</code></td>
405
+ <td>The place, by postcode</td>
406
+ </tr>
407
+ <tr>
408
+ <td><code>address</code></td>
409
+ <td>The place, by address</td>
410
+ </tr>
411
+ <tr>
412
+ <td><code>pin</code></td>
413
+ <td>The place, as <code>latitude,longitude</code></td>
414
+ </tr>
415
+ <tr>
416
+ <td><code>lat</code>, <code>lon</code> (or <code>lng</code>)</td>
417
+ <td>The place, as two separate numbers</td>
418
+ </tr>
419
+ <tr>
420
+ <td><code>zoom</code></td>
421
+ <td>1 (the world) to 20 (a building). Default 14</td>
422
+ </tr>
423
+ <tr>
424
+ <td><code>ratio</code></td>
425
+ <td>The map&#39;s shape: <code>16:9</code> (default), <code>4:3</code>, <code>1:1</code> or <code>21:9</code></td>
426
+ </tr>
427
+ <tr>
428
+ <td><code>width</code></td>
429
+ <td>A limit on the width, in pixels or percent</td>
430
+ </tr>
431
+ <tr>
432
+ <td><code>align</code></td>
433
+ <td><code>left</code>, <code>center</code> or <code>right</code></td>
434
+ </tr>
435
+ <tr>
436
+ <td><code>caption</code> (or <code>title</code>)</td>
437
+ <td>Words under the map</td>
438
+ </tr>
439
+ </tbody></table>
440
+ <p>Give one of <code>postcode</code>, <code>address</code>, <code>pin</code>, or <code>lat</code> with <code>lon</code>.</p>
441
+ <h3 id="sc-demo"><code>demo</code> - a demo page in a frame</h3>
442
+ <p>Shows a demo page kept on this site inside a frame.</p>
443
+ <pre><code>[demo src=&quot;elements/accordion&quot; /]
444
+ [demo src=&quot;effects/ambient&quot; height=&quot;600px&quot; title=&quot;Ambient effect&quot; /]
445
+ </code></pre>
446
+ <table class="table table-sm">
447
+ <thead>
448
+ <tr>
449
+ <th>Attribute</th>
450
+ <th>What it does</th>
451
+ </tr>
452
+ </thead>
453
+ <tbody><tr>
454
+ <td><code>src</code></td>
455
+ <td>The demo&#39;s path, without <code>.html</code>. Required</td>
456
+ </tr>
457
+ <tr>
458
+ <td><code>height</code></td>
459
+ <td>The frame&#39;s height (default <code>500px</code>)</td>
460
+ </tr>
461
+ <tr>
462
+ <td><code>title</code></td>
463
+ <td>A caption bar above the frame</td>
464
+ </tr>
465
+ <tr>
466
+ <td><code>base</code></td>
467
+ <td>The folder the demos are in (default <code>/public/demos</code>)</td>
468
+ </tr>
469
+ </tbody></table>
470
+ <p>Only pages on this site can be shown. For a page from another website, use <code>[embed]</code>.</p>
471
+ <h3 id="sc-theme-switcher"><code>theme-switcher</code> - the theme dots</h3>
472
+ <p>The row of dots that lets a visitor change the site&#39;s theme, placed where you want it.</p>
473
+ <pre><code>[theme-switcher /]
474
+ [theme-switcher position=&quot;bottom-left&quot; offset-x=&quot;24&quot; offset-y=&quot;24&quot; /]
475
+ [theme-switcher themes=&quot;charcoal-dark,charcoal-light&quot; /]
476
+ </code></pre>
477
+ <table class="table table-sm">
478
+ <thead>
479
+ <tr>
480
+ <th>Attribute</th>
481
+ <th>What it does</th>
482
+ </tr>
483
+ </thead>
484
+ <tbody><tr>
485
+ <td><code>position</code></td>
486
+ <td><code>inline</code> (where the tag is written, the default) or pinned to the window: <code>top-left</code>, <code>top-right</code>, <code>left-center</code>, <code>right-center</code>, <code>bottom-left</code>, <code>bottom-right</code></td>
487
+ </tr>
488
+ <tr>
489
+ <td><code>offset-x</code>, <code>offset-y</code></td>
490
+ <td>When pinned: the distance from the window&#39;s edges in pixels (default 32)</td>
491
+ </tr>
492
+ <tr>
493
+ <td><code>themes</code></td>
494
+ <td>A comma-separated list of themes to offer, from those chosen under <strong>Theme &gt; Theme switcher</strong></td>
495
+ </tr>
496
+ </tbody></table>
497
+ <p>On its page it takes the place of the site&#39;s floating switcher, so a page never shows two.</p>
498
+ <h3 id="sc-menu"><code>menu</code> - a menu inside a page</h3>
499
+ <p>Shows one of the site&#39;s menus inside a page - a list of legal pages, for example, or the footer links.</p>
500
+ <pre><code>[menu slug=&quot;legal&quot; /]
501
+ [menu location=&quot;footer-primary&quot; /]
502
+ [menu slug=&quot;main&quot; orientation=&quot;horizontal&quot; depth=&quot;1&quot; /]
503
+ </code></pre>
504
+ <table class="table table-sm">
505
+ <thead>
506
+ <tr>
507
+ <th>Attribute</th>
508
+ <th>What it does</th>
509
+ </tr>
510
+ </thead>
511
+ <tbody><tr>
512
+ <td><code>slug</code></td>
513
+ <td>Which menu, by its name</td>
514
+ </tr>
515
+ <tr>
516
+ <td><code>location</code></td>
517
+ <td>Or: whichever menu is assigned to this place (<code>navbar</code>, <code>footer-primary</code>, <code>footer-legal</code>)</td>
518
+ </tr>
519
+ <tr>
520
+ <td><code>orientation</code></td>
521
+ <td><code>horizontal</code> or <code>vertical</code>, for this placement only</td>
522
+ </tr>
523
+ <tr>
524
+ <td><code>depth</code></td>
525
+ <td>How many levels to show. <code>1</code> shows the top level only</td>
526
+ </tr>
527
+ <tr>
528
+ <td><code>variant</code></td>
529
+ <td>A different look for this placement</td>
530
+ </tr>
531
+ <tr>
532
+ <td><code>float</code></td>
533
+ <td><code>no</code> shows the menu in the page even when it floats elsewhere</td>
534
+ </tr>
535
+ <tr>
536
+ <td><code>class</code></td>
537
+ <td>Your own CSS class</td>
538
+ </tr>
539
+ </tbody></table>
540
+ <p>Good to know:</p>
541
+ <ul>
542
+ <li>Give <code>slug</code> or <code>location</code>, one or the other.</li>
543
+ <li>A visitor sees only the items they are allowed to see.</li>
544
+ <li>The page being read is highlighted, with the menu&#39;s own highlight effect.</li>
545
+ <li>Menus are made and edited under <strong>Menus</strong> in the sidebar - see <a href="#/docs/usage/navigation">Navigation</a>.</li>
546
+ </ul>
547
+
548
+ </div>
549
+ </div>
550
+ </div>