@crombolo/backoffice-host 0.41.1 → 0.43.1
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/NOTICE +9 -0
- package/package.json +3 -3
- package/plugin/addresses-dashboard.js +3 -2
- package/plugin/app-preview/umbraco-package.json +1 -1
- package/plugin/approvals-active.js +40 -0
- package/plugin/audit-dashboard.js +3 -2
- package/plugin/branding/localization-en.js +9 -3
- package/plugin/branding/sign-in.js +0 -31
- package/plugin/branding/theme-dark.css +19 -5
- package/plugin/branding/theme.css +41 -19
- package/plugin/breadcrumb.js +29 -0
- package/plugin/changes-dashboard.js +3 -2
- package/plugin/edit-conflicts.js +11 -21
- package/plugin/jobs-dashboard.js +3 -2
- package/plugin/localizations/umbraco-package.json +1 -1
- package/plugin/notifications-dialog.js +8 -35
- package/plugin/overview-dashboard.js +412 -0
- package/plugin/overview-format.js +71 -0
- package/plugin/seo/umbraco-package.json +1 -1
- package/plugin/settings-cards.js +189 -0
- package/plugin/settings-section.js +436 -0
- package/plugin/side-panel/host.js +7 -63
- package/plugin/side-panel/layout.js +0 -15
- package/plugin/sign-in/umbraco-package.json +1 -1
- package/plugin/tsx-editors.js +56 -164
- package/plugin/umbraco-package.json +26 -55
- package/plugin/workflow-client.js +3 -0
- package/plugin/workflow-designer.js +17 -2
- package/src/branding.ts +4 -0
- package/plugin/branding/branding.js +0 -188
- package/plugin/branding/client-credentials.js +0 -49
- package/plugin/branding/log-viewer-menu.js +0 -70
- package/plugin/branding/query-builder.js +0 -28
- package/plugin/settings-dashboard.js +0 -123
- package/plugin/welcome-dashboard.js +0 -103
|
@@ -1,188 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The two places the vendored client names the product in code rather than in a
|
|
3
|
-
* string table.
|
|
4
|
-
*
|
|
5
|
-
* `view.controller.js` builds the page title with a hardcoded suffix, which
|
|
6
|
-
* `vendor:backoffice` rebrands to Crombolo. The suffix should be the site's own
|
|
7
|
-
* name, which the shell states in `<meta name="application-name">` — so a site
|
|
8
|
-
* called something other than Crombolo gets its own name rather than ours.
|
|
9
|
-
*
|
|
10
|
-
* Not read from `document.title`, although the shell puts the name there too.
|
|
11
|
-
* This module loads after the client has started, and by then the client may
|
|
12
|
-
* have written a title of its own. Taking `Content | Crombolo` for the site's
|
|
13
|
-
* name makes every correction end in ` | Crombolo` again: the observer below
|
|
14
|
-
* then answers its own change, forever, and the page never gets its main thread
|
|
15
|
-
* back.
|
|
16
|
-
*/
|
|
17
|
-
const CLIENT_SUFFIX = ' | Crombolo'
|
|
18
|
-
|
|
19
|
-
/** The site's name as the shell stated it. */
|
|
20
|
-
export function brandName(doc = document) {
|
|
21
|
-
const stated = doc.querySelector('meta[name="application-name"]')?.getAttribute('content')
|
|
22
|
-
return stated?.trim() || 'Crombolo'
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* `title` with the client's suffix replaced by the site's name.
|
|
27
|
-
*
|
|
28
|
-
* A fixed point: its own output comes back unchanged, whatever the name is —
|
|
29
|
-
* including a name that itself ends in the client's suffix. That is what makes
|
|
30
|
-
* it safe to call from an observer of the very thing it writes.
|
|
31
|
-
*/
|
|
32
|
-
export function brandedTitle(title, brand) {
|
|
33
|
-
const branded = ` | ${brand}`
|
|
34
|
-
if (title.endsWith(branded) || !title.endsWith(CLIENT_SUFFIX)) return title
|
|
35
|
-
return `${title.slice(0, -CLIENT_SUFFIX.length)}${branded}`
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
/**
|
|
39
|
-
* The logo popover carries a link to umbraco.com, hardcoded in
|
|
40
|
-
* `backoffice-header-logo.element.js`. Its image is already served as crombolo's
|
|
41
|
-
* (see `graphics.ts`), so only the link is left.
|
|
42
|
-
*
|
|
43
|
-
* This reaches into a vendored element's shadow root, which is worth naming as
|
|
44
|
-
* the compromise it is: there is no extension point for the app shell's own
|
|
45
|
-
* chrome. It is written to do nothing at all if that element or its anchor is not
|
|
46
|
-
* what it was, so an upstream change costs a stale link and never an error.
|
|
47
|
-
*/
|
|
48
|
-
function deepQuery(selector, root = document) {
|
|
49
|
-
const direct = root.querySelector(selector)
|
|
50
|
-
if (direct) return direct
|
|
51
|
-
// The header logo lives inside the header's shadow root, so a plain
|
|
52
|
-
// `document.querySelector` cannot see it. Nothing here is reachable without
|
|
53
|
-
// walking through the roots.
|
|
54
|
-
for (const element of root.querySelectorAll('*')) {
|
|
55
|
-
if (!element.shadowRoot) continue
|
|
56
|
-
const found = deepQuery(selector, element.shadowRoot)
|
|
57
|
-
if (found) return found
|
|
58
|
-
}
|
|
59
|
-
return null
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
function correctLogoLink() {
|
|
63
|
-
const logo = deepQuery('umb-backoffice-header-logo')
|
|
64
|
-
const anchor = logo?.shadowRoot?.querySelector('a[href*="umbraco.com"]')
|
|
65
|
-
if (!anchor) return false
|
|
66
|
-
anchor.href = 'https://github.com/kineco-au/crombolo-cms'
|
|
67
|
-
anchor.textContent = 'Crombolo on GitHub'
|
|
68
|
-
const image = logo.shadowRoot.querySelector('img#logo')
|
|
69
|
-
if (image) image.alt = brandName()
|
|
70
|
-
return true
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
/** Where Umbraco's theme context keeps the choice, as the shells' early script reads it. */
|
|
74
|
-
const THEME_KEY = 'umb-theme-alias'
|
|
75
|
-
|
|
76
|
-
/** Whether a theme choice paints the back office dark: Dark, or Match my system on a dark computer. */
|
|
77
|
-
export function isDarkTheme(alias, prefersDark) {
|
|
78
|
-
return (
|
|
79
|
-
alias === 'Crombolo.Theme.Dark' ||
|
|
80
|
-
alias === 'umb-dark-theme' ||
|
|
81
|
-
(alias === 'Crombolo.Theme.System' && Boolean(prefersDark))
|
|
82
|
-
)
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
const GRAPHIC =
|
|
86
|
-
/(\/security\/back-office\/graphics\/)(logo|logo-alternative|login-logo|login-logo-alternative)(-dark)?$/
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* A logo's address for the theme: the cream-lettered `-dark` variant on a dark
|
|
90
|
-
* theme, the plain one otherwise. Anything that is not one of the logos comes
|
|
91
|
-
* back as it was.
|
|
92
|
-
*/
|
|
93
|
-
export function themedLogoUrl(src, dark) {
|
|
94
|
-
const match = GRAPHIC.exec(src ?? '')
|
|
95
|
-
if (!match) return src
|
|
96
|
-
return `${src.slice(0, match.index)}${match[1]}${match[2]}${dark ? '-dark' : ''}`
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
const prefersDark = () => {
|
|
100
|
-
try {
|
|
101
|
-
return window.matchMedia('(prefers-color-scheme: dark)').matches
|
|
102
|
-
} catch {
|
|
103
|
-
return false
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
const storedTheme = () => {
|
|
108
|
-
try {
|
|
109
|
-
return localStorage.getItem(THEME_KEY)
|
|
110
|
-
} catch {
|
|
111
|
-
return null
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
/**
|
|
116
|
-
* The header's logo, and the wordmark in its popover, in the theme's colours.
|
|
117
|
-
*
|
|
118
|
-
* `umb-app-logo` picks its graphic from Umbraco's own theme names, and the
|
|
119
|
-
* header pins it to the one drawn for an orange bar, so its cocoa lettering
|
|
120
|
-
* vanished on the dark header. Like the link above, this reaches into the
|
|
121
|
-
* vendored element and does nothing if it is not what it was.
|
|
122
|
-
*/
|
|
123
|
-
function applyThemedLogos() {
|
|
124
|
-
const dark = isDarkTheme(storedTheme(), prefersDark())
|
|
125
|
-
const header = deepQuery('umb-backoffice-header-logo')?.shadowRoot
|
|
126
|
-
const mark = header?.querySelector('umb-app-logo')?.shadowRoot?.querySelector('img')
|
|
127
|
-
if (!mark) return false
|
|
128
|
-
const src = mark.getAttribute('src')
|
|
129
|
-
const next = themedLogoUrl(src, dark)
|
|
130
|
-
if (next !== src) mark.setAttribute('src', next)
|
|
131
|
-
const popover = header.querySelector('img#logo')
|
|
132
|
-
if (popover) {
|
|
133
|
-
popover.dataset.lightSrc ??= popover.getAttribute('src') ?? ''
|
|
134
|
-
const wanted = dark
|
|
135
|
-
? next.replace(/graphics\/logo-dark$/, 'graphics/logo-alternative-dark')
|
|
136
|
-
: popover.dataset.lightSrc
|
|
137
|
-
if (popover.getAttribute('src') !== wanted) popover.setAttribute('src', wanted)
|
|
138
|
-
}
|
|
139
|
-
return true
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
/** Applies the logos now and on every change of theme: the menu, another tab, or the computer's. */
|
|
143
|
-
function followTheme() {
|
|
144
|
-
const apply = () => setTimeout(applyThemedLogos, 0)
|
|
145
|
-
// The theme context swaps the theme's stylesheet in the head when the choice changes.
|
|
146
|
-
new MutationObserver(apply).observe(document.head, { childList: true })
|
|
147
|
-
window.addEventListener('storage', (event) => {
|
|
148
|
-
if (event.key === THEME_KEY) apply()
|
|
149
|
-
})
|
|
150
|
-
try {
|
|
151
|
-
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', apply)
|
|
152
|
-
} catch {
|
|
153
|
-
// Without media queries, Match my system stays light.
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
export const onInit = () => {
|
|
158
|
-
const brand = brandName()
|
|
159
|
-
let themed = false
|
|
160
|
-
const logos = setInterval(() => {
|
|
161
|
-
if (applyThemedLogos() && !themed) {
|
|
162
|
-
themed = true
|
|
163
|
-
clearInterval(logos)
|
|
164
|
-
followTheme()
|
|
165
|
-
}
|
|
166
|
-
}, 250)
|
|
167
|
-
setTimeout(() => clearInterval(logos), 30_000)
|
|
168
|
-
const correct = () => {
|
|
169
|
-
const corrected = brandedTitle(document.title, brand)
|
|
170
|
-
if (corrected !== document.title) document.title = corrected
|
|
171
|
-
}
|
|
172
|
-
correct()
|
|
173
|
-
// The header renders after the app boots, and the popover's contents with it.
|
|
174
|
-
let tries = 0
|
|
175
|
-
const timer = setInterval(() => {
|
|
176
|
-
if (correctLogoLink() || ++tries > 40) clearInterval(timer)
|
|
177
|
-
}, 250)
|
|
178
|
-
const head = document.querySelector('head')
|
|
179
|
-
const title = document.querySelector('title')
|
|
180
|
-
if (!head || !title) return
|
|
181
|
-
// The element is replaced as well as retitled, so both are watched.
|
|
182
|
-
new MutationObserver(correct).observe(title, {
|
|
183
|
-
childList: true,
|
|
184
|
-
characterData: true,
|
|
185
|
-
subtree: true,
|
|
186
|
-
})
|
|
187
|
-
new MutationObserver(correct).observe(head, { childList: true })
|
|
188
|
-
}
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The prefix label in the Create client credential dialog.
|
|
3
|
-
*
|
|
4
|
-
* The dialog prints the required prefix in a decorative `prepend` beside the Id
|
|
5
|
-
* input, and submits the input's value whole — so an administrator reads that
|
|
6
|
-
* label and types the prefix themselves. It is hardcoded in the vendored element
|
|
7
|
-
* as a private field, and it names the prefix the server rejected as of
|
|
8
|
-
* migration 020, which makes a stale label a dialog nobody can complete.
|
|
9
|
-
*
|
|
10
|
-
* Corrected after the element's first render rather than in its template: the
|
|
11
|
-
* prepend is built inside a private method, so there is nothing to intercept
|
|
12
|
-
* further upstream.
|
|
13
|
-
*/
|
|
14
|
-
|
|
15
|
-
/** Must match `CLIENT_ID_PREFIX` in packages/server/src/adapters/users.ts. */
|
|
16
|
-
export const REQUIRED_PREFIX = 'crombolo-back-office-'
|
|
17
|
-
|
|
18
|
-
/** True for the vendored label, and false for anything a correction produced. */
|
|
19
|
-
export function needsCorrection(text) {
|
|
20
|
-
return typeof text === 'string' && text.trim() === 'umbraco-back-office-'
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
function correct(root) {
|
|
24
|
-
const prepend = root?.querySelector('.prepend')
|
|
25
|
-
if (prepend && needsCorrection(prepend.textContent)) prepend.textContent = REQUIRED_PREFIX
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
/**
|
|
29
|
-
* Wraps the element's own `firstUpdated`, which the vendored class defines and
|
|
30
|
-
* which runs once the prepend exists. Does nothing if it is not there, so an
|
|
31
|
-
* upstream change costs the correction and never an error.
|
|
32
|
-
*/
|
|
33
|
-
function patch(element) {
|
|
34
|
-
const proto = element?.prototype
|
|
35
|
-
const original = proto?.firstUpdated
|
|
36
|
-
if (typeof original !== 'function') return false
|
|
37
|
-
proto.firstUpdated = function firstUpdated(changed) {
|
|
38
|
-
original.call(this, changed)
|
|
39
|
-
correct(this.shadowRoot)
|
|
40
|
-
}
|
|
41
|
-
return true
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
export const onInit = () => {
|
|
45
|
-
customElements
|
|
46
|
-
.whenDefined('umb-create-user-client-credential-modal')
|
|
47
|
-
.then(patch)
|
|
48
|
-
.catch(() => {})
|
|
49
|
-
}
|
|
@@ -1,70 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The search menu on a log message, pointed at this project rather than at
|
|
3
|
-
* Umbraco's.
|
|
4
|
-
*
|
|
5
|
-
* `log-viewer-message.element.js` builds six items in `_getSearchMenuData()`,
|
|
6
|
-
* four of them Umbraco's: two that search the Umbraco forum — one under the
|
|
7
|
-
* Umbraco mark — and two that search Umbraco-CMS on GitHub by the line's
|
|
8
|
-
* `SourceContext`. The forum pair goes, because there is no crombolo forum to
|
|
9
|
-
* send anyone to and the item above it already puts the message into Google.
|
|
10
|
-
* The GitHub pair stays, repointed: searching the source and the issues by the
|
|
11
|
-
* type that logged a line is how you chase one down, it just has to be this
|
|
12
|
-
* CMS's source and issues.
|
|
13
|
-
*
|
|
14
|
-
* The array is rebuilt on every render by a method on the element's prototype,
|
|
15
|
-
* so the method is wrapped rather than the element replaced: the rest of the
|
|
16
|
-
* log viewer is what we want, and wrapping keeps the two items we leave alone —
|
|
17
|
-
* and anything upstream adds — exactly as they were.
|
|
18
|
-
*
|
|
19
|
-
* Items are matched on their **resolved** label rather than the key, because
|
|
20
|
-
* the key is not readable off the built array: `localize.term` returns the
|
|
21
|
-
* string. Resolving the same keys through the same controller matches in
|
|
22
|
-
* whatever language the editor is in.
|
|
23
|
-
*
|
|
24
|
-
* Patched rather than registered, because the menu is not an extension point.
|
|
25
|
-
*/
|
|
26
|
-
const TAG = 'umb-log-viewer-message'
|
|
27
|
-
export const REPOSITORY = 'https://github.com/kineco-au/crombolo-cms'
|
|
28
|
-
|
|
29
|
-
/** The forum pair, which has no equivalent here. */
|
|
30
|
-
export const DROPPED = ['logViewer_searchOurUmbraco', 'logViewer_searchOurUmbracoWithGoogle']
|
|
31
|
-
|
|
32
|
-
/** The GitHub pair, whose labels we keep and whose targets we replace. */
|
|
33
|
-
export const REPOINTED = {
|
|
34
|
-
logViewer_searchUmbracoSource: (query) => `${REPOSITORY}/search?q=${query}`,
|
|
35
|
-
logViewer_searchUmbracoIssues: (query) => `${REPOSITORY}/issues?q=${query}`,
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
/**
|
|
39
|
-
* `items` with Umbraco's forum entries gone and its GitHub entries aimed here.
|
|
40
|
-
*
|
|
41
|
-
* `term` resolves a dictionary key the way the element does, so this matches
|
|
42
|
-
* the labels in the editor's own language; `query` is the `SourceContext` the
|
|
43
|
-
* two surviving searches look for.
|
|
44
|
-
*/
|
|
45
|
-
export function rebrandSearchMenu(items, term, query) {
|
|
46
|
-
const dropped = new Set(DROPPED.map(term))
|
|
47
|
-
const repointed = new Map(
|
|
48
|
-
Object.entries(REPOINTED).map(([key, href]) => [term(key), () => href(query)]),
|
|
49
|
-
)
|
|
50
|
-
return items
|
|
51
|
-
.filter((item) => !dropped.has(item.label))
|
|
52
|
-
.map((item) => {
|
|
53
|
-
const href = repointed.get(item.label)
|
|
54
|
-
return href ? { ...item, href } : item
|
|
55
|
-
})
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
export const onInit = async () => {
|
|
59
|
-
// Registered with the Log Viewer section, so not defined until it is opened.
|
|
60
|
-
const element = await customElements.whenDefined(TAG)
|
|
61
|
-
const prototype = element.prototype
|
|
62
|
-
const original = prototype._getSearchMenuData
|
|
63
|
-
if (typeof original !== 'function') return
|
|
64
|
-
|
|
65
|
-
prototype._getSearchMenuData = function patched() {
|
|
66
|
-
const query =
|
|
67
|
-
this.properties?.find((property) => property.name === 'SourceContext')?.value ?? ''
|
|
68
|
-
return rebrandSearchMenu(original.call(this), (key) => this.localize.term(key), query)
|
|
69
|
-
}
|
|
70
|
-
}
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The template editor's query builder writes TypeScript, so it should not say
|
|
3
|
-
* it wrote C#.
|
|
4
|
-
*
|
|
5
|
-
* The modal hard-codes `language="C#"` on the code block it previews the
|
|
6
|
-
* snippet in (`query-builder-modal.element.js`). The element is vendored, so
|
|
7
|
-
* the label is corrected after each render rather than by replacing the modal:
|
|
8
|
-
* the rest of it — the pickers, the filters, the sample results — is exactly
|
|
9
|
-
* what we want, and a fork of it would be a fork to maintain.
|
|
10
|
-
*/
|
|
11
|
-
const TAG = 'umb-template-query-builder-modal'
|
|
12
|
-
const LANGUAGE = 'TypeScript'
|
|
13
|
-
|
|
14
|
-
export const onInit = async () => {
|
|
15
|
-
// The modal is registered lazily, so the class may not be defined until the
|
|
16
|
-
// editor opens it.
|
|
17
|
-
const element = await customElements.whenDefined(TAG)
|
|
18
|
-
const prototype = element.prototype
|
|
19
|
-
const updated = prototype.updated
|
|
20
|
-
prototype.updated = function patched(changed) {
|
|
21
|
-
updated?.call(this, changed)
|
|
22
|
-
const block = this.shadowRoot?.querySelector('umb-code-block')
|
|
23
|
-
if (block && block.getAttribute('language') !== LANGUAGE) {
|
|
24
|
-
block.setAttribute('language', LANGUAGE)
|
|
25
|
-
block.language = LANGUAGE
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
}
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The Settings dashboard, in place of Umbraco's.
|
|
3
|
-
*
|
|
4
|
-
* Its manifest declares `overwrites: ['Umb.Dashboard.SettingsWelcome']`, the same
|
|
5
|
-
* way the Welcome dashboard takes the place of the news one. What it replaces is
|
|
6
|
-
* marketing for Umbraco's own training and consultancy — accurate for Umbraco and
|
|
7
|
-
* misleading here, and not the sort of thing to fix by renaming, since the
|
|
8
|
-
* services it points at are real and are not this project's.
|
|
9
|
-
*
|
|
10
|
-
* What it says instead is the thing a person in Settings actually needs to know:
|
|
11
|
-
* that types are files, and that changing one here writes that file.
|
|
12
|
-
*/
|
|
13
|
-
// UmbLitElement, not plain LitElement: a dashboard is used as a controller host,
|
|
14
|
-
// and a plain element fails with `controllerHost.provideContext is not a function`.
|
|
15
|
-
import { css, html, nothing } from '@umbraco-cms/backoffice/external/lit'
|
|
16
|
-
import { UmbLitElement } from '@umbraco-cms/backoffice/lit-element'
|
|
17
|
-
|
|
18
|
-
/** Whether this site can send e-mail; the server answers with the reason. */
|
|
19
|
-
const emailStatus = async () => {
|
|
20
|
-
const href = document.querySelector('base')?.getAttribute('href') ?? '/umbraco/'
|
|
21
|
-
const response = await fetch(`${href.replace(/\/$/, '')}/crombolo/api/email`, {
|
|
22
|
-
credentials: 'include',
|
|
23
|
-
headers: { accept: 'application/json' },
|
|
24
|
-
})
|
|
25
|
-
if (!response.ok) throw new Error(`email responded ${response.status}`)
|
|
26
|
-
return response.json()
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
export default class CromboloSettingsDashboardElement extends UmbLitElement {
|
|
30
|
-
static properties = {
|
|
31
|
-
_email: { state: true },
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
connectedCallback() {
|
|
35
|
-
super.connectedCallback()
|
|
36
|
-
// A failure here leaves the section out rather than the dashboard broken:
|
|
37
|
-
// this is an explanation, not a control.
|
|
38
|
-
emailStatus().then(
|
|
39
|
-
(status) => {
|
|
40
|
-
this._email = status
|
|
41
|
-
},
|
|
42
|
-
() => {},
|
|
43
|
-
)
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
#email() {
|
|
47
|
-
const status = this._email
|
|
48
|
-
if (!status) return nothing
|
|
49
|
-
if (status.available)
|
|
50
|
-
return html`
|
|
51
|
-
<uui-box headline="E-mail">
|
|
52
|
-
<p>E-mail is sent through <strong>${status.provider}</strong>.</p>
|
|
53
|
-
</uui-box>
|
|
54
|
-
`
|
|
55
|
-
return html`
|
|
56
|
-
<uui-box headline="E-mail">
|
|
57
|
-
<p>${status.reason}</p>
|
|
58
|
-
${
|
|
59
|
-
status.affects.length > 0
|
|
60
|
-
? html`<p>Until one is configured, these are unavailable:</p>
|
|
61
|
-
<ul>
|
|
62
|
-
${status.affects.map((feature) => html`<li>${feature}</li>`)}
|
|
63
|
-
</ul>`
|
|
64
|
-
: nothing
|
|
65
|
-
}
|
|
66
|
-
</uui-box>
|
|
67
|
-
`
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
render() {
|
|
71
|
-
return html`
|
|
72
|
-
<uui-box headline="Settings">
|
|
73
|
-
<p>
|
|
74
|
-
Content types, data types and languages are <strong>files</strong>, in
|
|
75
|
-
<code>schema/</code>, written as TOML. The database is a view of them: what you change
|
|
76
|
-
here is written to the file, and the file is what a deploy and every other node reads.
|
|
77
|
-
</p>
|
|
78
|
-
<p>
|
|
79
|
-
That is why a type can be reviewed in a pull request, and why a schema change carries a
|
|
80
|
-
version — a change that converts existing content is a major, and the backoffice moves
|
|
81
|
-
the number for you.
|
|
82
|
-
</p>
|
|
83
|
-
<p class="links">
|
|
84
|
-
<a href="https://github.com/kineco-au/crombolo-cms#schema-as-code" target="_blank" rel="noopener">
|
|
85
|
-
Schema as code
|
|
86
|
-
</a>
|
|
87
|
-
<a href="https://github.com/kineco-au/crombolo-cms#schema-in-shared-storage" target="_blank" rel="noopener">
|
|
88
|
-
Schema in shared storage
|
|
89
|
-
</a>
|
|
90
|
-
<a href="https://github.com/kineco-au/crombolo-cms/issues" target="_blank" rel="noopener">
|
|
91
|
-
Report an issue
|
|
92
|
-
</a>
|
|
93
|
-
</p>
|
|
94
|
-
</uui-box>
|
|
95
|
-
${this.#email()}
|
|
96
|
-
`
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
static styles = css`
|
|
100
|
-
:host {
|
|
101
|
-
display: block;
|
|
102
|
-
padding: var(--uui-size-layout-1, 24px);
|
|
103
|
-
}
|
|
104
|
-
p {
|
|
105
|
-
max-width: 60ch;
|
|
106
|
-
line-height: 1.5;
|
|
107
|
-
}
|
|
108
|
-
.links {
|
|
109
|
-
display: flex;
|
|
110
|
-
gap: var(--uui-size-space-5, 18px);
|
|
111
|
-
flex-wrap: wrap;
|
|
112
|
-
}
|
|
113
|
-
uui-box + uui-box {
|
|
114
|
-
margin-top: var(--uui-size-layout-1, 24px);
|
|
115
|
-
}
|
|
116
|
-
ul {
|
|
117
|
-
max-width: 60ch;
|
|
118
|
-
line-height: 1.5;
|
|
119
|
-
}
|
|
120
|
-
`
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
customElements.define('crombolo-settings-dashboard', CromboloSettingsDashboardElement)
|
|
@@ -1,103 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The Welcome dashboard in the Content section. Its manifest declares
|
|
3
|
-
* `overwrites: ['Umb.Dashboard.UmbracoNews']`, which takes the place of
|
|
4
|
-
* Umbraco's news dashboard without mutating the registry while the backoffice
|
|
5
|
-
* is rendering — the hazard the TSX entry point documents.
|
|
6
|
-
*/
|
|
7
|
-
// UmbLitElement, not plain LitElement: a dashboard is used as a controller host,
|
|
8
|
-
// and a plain element fails with `controllerHost.provideContext is not a function`.
|
|
9
|
-
import { css, html } from '@umbraco-cms/backoffice/external/lit'
|
|
10
|
-
import { UmbLitElement } from '@umbraco-cms/backoffice/lit-element'
|
|
11
|
-
|
|
12
|
-
const STEPS = [
|
|
13
|
-
{
|
|
14
|
-
title: 'Model the content',
|
|
15
|
-
body: html`Open <strong>Settings → Content Types</strong> and describe a page: its
|
|
16
|
-
properties, its tabs, and which types may sit beneath it.`,
|
|
17
|
-
},
|
|
18
|
-
{
|
|
19
|
-
title: 'Write a template',
|
|
20
|
-
body: html`Templates are <strong>TSX</strong>, not Razor. A template is a file in
|
|
21
|
-
<code>components/</code> that default-exports a component and receives the page as
|
|
22
|
-
<code>model</code>; <code>export const layout = 'alias'</code> names its master.
|
|
23
|
-
The editor under Settings → Templates writes that shape for you.`,
|
|
24
|
-
},
|
|
25
|
-
{
|
|
26
|
-
title: 'Create and publish',
|
|
27
|
-
body: html`Back in <strong>Content</strong>, create a page from your content type, fill it
|
|
28
|
-
in and publish. Publishing is per culture, and the published version is what the
|
|
29
|
-
site renders — drafts stay invisible until you say otherwise.`,
|
|
30
|
-
},
|
|
31
|
-
{
|
|
32
|
-
title: 'Keep the schema in the repository',
|
|
33
|
-
body: html`Content types, data types and templates are also files:
|
|
34
|
-
<code>schema/*.toml</code>. <code>crombolo types sync</code> writes changes made in
|
|
35
|
-
the backoffice back out, and <code>crombolo types check</code> tells you whether a
|
|
36
|
-
database matches. Schema travels through Git, not a database export.`,
|
|
37
|
-
},
|
|
38
|
-
]
|
|
39
|
-
|
|
40
|
-
export default class CromboloWelcomeDashboardElement extends UmbLitElement {
|
|
41
|
-
render() {
|
|
42
|
-
return html`
|
|
43
|
-
<uui-box headline="Welcome to Crombolo">
|
|
44
|
-
<p class="lede">
|
|
45
|
-
Crombolo is a content management system that runs on
|
|
46
|
-
<strong>Bun and TypeScript</strong>: the server, the templates and the schema are
|
|
47
|
-
TypeScript, and the database is SQLite or Postgres.
|
|
48
|
-
</p>
|
|
49
|
-
<p class="lede">
|
|
50
|
-
There is no .NET anywhere in it: templates are TSX rather than Razor, and a
|
|
51
|
-
site's schema lives in TOML files beside its code.
|
|
52
|
-
</p>
|
|
53
|
-
</uui-box>
|
|
54
|
-
|
|
55
|
-
<uui-box headline="Getting started">
|
|
56
|
-
<ol>
|
|
57
|
-
${STEPS.map(
|
|
58
|
-
(step) => html`<li>
|
|
59
|
-
<h4>${step.title}</h4>
|
|
60
|
-
<p>${step.body}</p>
|
|
61
|
-
</li>`,
|
|
62
|
-
)}
|
|
63
|
-
</ol>
|
|
64
|
-
</uui-box>
|
|
65
|
-
|
|
66
|
-
<uui-box headline="Worth knowing">
|
|
67
|
-
<ul>
|
|
68
|
-
<li>
|
|
69
|
-
The <strong>Settings</strong> section holds templates, partial views,
|
|
70
|
-
stylesheets and scripts — all served from your site's folders.
|
|
71
|
-
</li>
|
|
72
|
-
<li>
|
|
73
|
-
<strong>Upgrade</strong>, also under Settings, reports anything a version
|
|
74
|
-
change needs from you before it will run.
|
|
75
|
-
</li>
|
|
76
|
-
<li>
|
|
77
|
-
The log viewer under Settings reads the server's own structured logs, so a
|
|
78
|
-
failed publish or a broken template is searchable rather than guessed at.
|
|
79
|
-
</li>
|
|
80
|
-
</ul>
|
|
81
|
-
</uui-box>
|
|
82
|
-
`
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
static styles = css`
|
|
86
|
-
:host { display: block; padding: var(--uui-size-layout-1); }
|
|
87
|
-
uui-box { margin-bottom: var(--uui-size-layout-1); }
|
|
88
|
-
.lede { max-width: 70ch; line-height: 1.6; }
|
|
89
|
-
ol { margin: 0; padding-left: var(--uui-size-layout-1); }
|
|
90
|
-
ol li { margin-bottom: var(--uui-size-space-5); max-width: 70ch; }
|
|
91
|
-
ol h4 { margin: 0 0 var(--uui-size-space-2); }
|
|
92
|
-
ol p { margin: 0; line-height: 1.6; }
|
|
93
|
-
ul { margin: 0; padding-left: var(--uui-size-layout-1); }
|
|
94
|
-
ul li { margin-bottom: var(--uui-size-space-3); max-width: 70ch; line-height: 1.6; }
|
|
95
|
-
code {
|
|
96
|
-
background: var(--uui-color-surface-alt);
|
|
97
|
-
padding: 0 var(--uui-size-space-1);
|
|
98
|
-
border-radius: var(--uui-border-radius);
|
|
99
|
-
}
|
|
100
|
-
`
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
customElements.define('crombolo-welcome-dashboard', CromboloWelcomeDashboardElement)
|