@endora-commerce/mod-cms 0.108.0 → 0.109.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/README.md +1 -0
- package/dist/admin/api/cms-client.d.ts +19 -3
- package/dist/admin/api/cms-client.d.ts.map +1 -1
- package/dist/admin/api/cms-client.js +23 -2
- package/dist/admin/api/cms-client.js.map +1 -1
- package/dist/admin/components/AdminCatalogPreviewProvider.d.ts.map +1 -1
- package/dist/admin/components/AdminCatalogPreviewProvider.js +51 -0
- package/dist/admin/components/AdminCatalogPreviewProvider.js.map +1 -1
- package/dist/admin/components/BackgroundFields.d.ts +16 -0
- package/dist/admin/components/BackgroundFields.d.ts.map +1 -1
- package/dist/admin/components/BackgroundFields.js +58 -11
- package/dist/admin/components/BackgroundFields.js.map +1 -1
- package/dist/admin/components/BrandFontFields.d.ts +17 -0
- package/dist/admin/components/BrandFontFields.d.ts.map +1 -0
- package/dist/admin/components/BrandFontFields.js +39 -0
- package/dist/admin/components/BrandFontFields.js.map +1 -0
- package/dist/admin/components/BrandPreview.d.ts +29 -0
- package/dist/admin/components/BrandPreview.d.ts.map +1 -0
- package/dist/admin/components/BrandPreview.js +130 -0
- package/dist/admin/components/BrandPreview.js.map +1 -0
- package/dist/admin/components/CarouselAddSlideMenu.d.ts +5 -0
- package/dist/admin/components/CarouselAddSlideMenu.d.ts.map +1 -0
- package/dist/admin/components/CarouselAddSlideMenu.js +84 -0
- package/dist/admin/components/CarouselAddSlideMenu.js.map +1 -0
- package/dist/admin/components/CarouselFields.d.ts +6 -0
- package/dist/admin/components/CarouselFields.d.ts.map +1 -0
- package/dist/admin/components/CarouselFields.js +55 -0
- package/dist/admin/components/CarouselFields.js.map +1 -0
- package/dist/admin/components/ContentSliderActionBarExtras.d.ts.map +1 -1
- package/dist/admin/components/ContentSliderActionBarExtras.js +13 -6
- package/dist/admin/components/ContentSliderActionBarExtras.js.map +1 -1
- package/dist/admin/components/HeroFields.d.ts +47 -0
- package/dist/admin/components/HeroFields.d.ts.map +1 -0
- package/dist/admin/components/HeroFields.js +92 -0
- package/dist/admin/components/HeroFields.js.map +1 -0
- package/dist/admin/components/ListingFields.d.ts +6 -0
- package/dist/admin/components/ListingFields.d.ts.map +1 -0
- package/dist/admin/components/ListingFields.js +54 -0
- package/dist/admin/components/ListingFields.js.map +1 -0
- package/dist/admin/components/NewsletterSignupFields.d.ts +18 -0
- package/dist/admin/components/NewsletterSignupFields.d.ts.map +1 -0
- package/dist/admin/components/NewsletterSignupFields.js +38 -0
- package/dist/admin/components/NewsletterSignupFields.js.map +1 -0
- package/dist/admin/components/PageBuilderActionBar.d.ts.map +1 -1
- package/dist/admin/components/PageBuilderActionBar.js +1 -6
- package/dist/admin/components/PageBuilderActionBar.js.map +1 -1
- package/dist/admin/components/PageBuilderEditor.d.ts +43 -2
- package/dist/admin/components/PageBuilderEditor.d.ts.map +1 -1
- package/dist/admin/components/PageBuilderEditor.js +207 -121
- package/dist/admin/components/PageBuilderEditor.js.map +1 -1
- package/dist/admin/components/PageNavigationFields.d.ts +6 -0
- package/dist/admin/components/PageNavigationFields.d.ts.map +1 -0
- package/dist/admin/components/PageNavigationFields.js +29 -0
- package/dist/admin/components/PageNavigationFields.js.map +1 -0
- package/dist/admin/components/PreviewBrandTokens.d.ts +25 -0
- package/dist/admin/components/PreviewBrandTokens.d.ts.map +1 -0
- package/dist/admin/components/PreviewBrandTokens.js +68 -0
- package/dist/admin/components/PreviewBrandTokens.js.map +1 -0
- package/dist/admin/components/SectionBlockFields.d.ts +44 -0
- package/dist/admin/components/SectionBlockFields.d.ts.map +1 -0
- package/dist/admin/components/SectionBlockFields.js +114 -0
- package/dist/admin/components/SectionBlockFields.js.map +1 -0
- package/dist/admin/components/SectionPresetsPanel.d.ts +11 -0
- package/dist/admin/components/SectionPresetsPanel.d.ts.map +1 -0
- package/dist/admin/components/SectionPresetsPanel.js +82 -0
- package/dist/admin/components/SectionPresetsPanel.js.map +1 -0
- package/dist/admin/components/SliderPreviewActionBarExtras.d.ts +1 -1
- package/dist/admin/components/SliderPreviewActionBarExtras.d.ts.map +1 -1
- package/dist/admin/components/SliderPreviewActionBarExtras.js +1 -5
- package/dist/admin/components/SliderPreviewActionBarExtras.js.map +1 -1
- package/dist/admin/components/admin-catalog-preview-map.d.ts +9 -0
- package/dist/admin/components/admin-catalog-preview-map.d.ts.map +1 -1
- package/dist/admin/components/admin-catalog-preview-map.js +10 -0
- package/dist/admin/components/admin-catalog-preview-map.js.map +1 -1
- package/dist/admin/components/page-builder-i18n.d.ts +24 -2
- package/dist/admin/components/page-builder-i18n.d.ts.map +1 -1
- package/dist/admin/components/page-builder-i18n.js +102 -9
- package/dist/admin/components/page-builder-i18n.js.map +1 -1
- package/dist/admin/editors/PageEditor.d.ts.map +1 -1
- package/dist/admin/editors/PageEditor.js +270 -38
- package/dist/admin/editors/PageEditor.js.map +1 -1
- package/dist/admin/index.d.ts +1 -1
- package/dist/admin/index.d.ts.map +1 -1
- package/dist/admin/index.js +21 -1
- package/dist/admin/index.js.map +1 -1
- package/dist/admin/pages/BrandPage.d.ts +19 -0
- package/dist/admin/pages/BrandPage.d.ts.map +1 -0
- package/dist/admin/pages/BrandPage.js +316 -0
- package/dist/admin/pages/BrandPage.js.map +1 -0
- package/dist/admin/pages/PagesListPage.d.ts.map +1 -1
- package/dist/admin/pages/PagesListPage.js +4 -1
- package/dist/admin/pages/PagesListPage.js.map +1 -1
- package/dist/backend/cli/block-names.d.ts +2 -1
- package/dist/backend/cli/block-names.d.ts.map +1 -1
- package/dist/backend/cli/block-names.js.map +1 -1
- package/dist/backend/entities/cms-brand-tokens.entity.d.ts +20 -0
- package/dist/backend/entities/cms-brand-tokens.entity.d.ts.map +1 -0
- package/dist/backend/entities/cms-brand-tokens.entity.js +57 -0
- package/dist/backend/entities/cms-brand-tokens.entity.js.map +1 -0
- package/dist/backend/entities/cms-page.entity.d.ts +32 -1
- package/dist/backend/entities/cms-page.entity.d.ts.map +1 -1
- package/dist/backend/entities/cms-page.entity.js +63 -0
- package/dist/backend/entities/cms-page.entity.js.map +1 -1
- package/dist/backend/index.d.ts +5 -1
- package/dist/backend/index.d.ts.map +1 -1
- package/dist/backend/index.js +78 -8
- package/dist/backend/index.js.map +1 -1
- package/dist/backend/plugin.d.ts +16 -2
- package/dist/backend/plugin.d.ts.map +1 -1
- package/dist/backend/plugin.js +20 -1
- package/dist/backend/plugin.js.map +1 -1
- package/dist/backend/routes.admin.d.ts +2 -0
- package/dist/backend/routes.admin.d.ts.map +1 -1
- package/dist/backend/routes.admin.js +39 -4
- package/dist/backend/routes.admin.js.map +1 -1
- package/dist/backend/routes.storefront.d.ts +24 -1
- package/dist/backend/routes.storefront.d.ts.map +1 -1
- package/dist/backend/routes.storefront.js +55 -2
- package/dist/backend/routes.storefront.js.map +1 -1
- package/dist/backend/services/anchor-guard.d.ts +10 -0
- package/dist/backend/services/anchor-guard.d.ts.map +1 -0
- package/dist/backend/services/anchor-guard.js +132 -0
- package/dist/backend/services/anchor-guard.js.map +1 -0
- package/dist/backend/services/asset-references.d.ts.map +1 -1
- package/dist/backend/services/asset-references.js +46 -30
- package/dist/backend/services/asset-references.js.map +1 -1
- package/dist/backend/services/brand-tokens-service.d.ts +84 -0
- package/dist/backend/services/brand-tokens-service.d.ts.map +1 -0
- package/dist/backend/services/brand-tokens-service.js +159 -0
- package/dist/backend/services/brand-tokens-service.js.map +1 -0
- package/dist/backend/services/channel-language-prefixes.d.ts +11 -0
- package/dist/backend/services/channel-language-prefixes.d.ts.map +1 -0
- package/dist/backend/services/channel-language-prefixes.js +24 -0
- package/dist/backend/services/channel-language-prefixes.js.map +1 -0
- package/dist/backend/services/cms-block-service.d.ts.map +1 -1
- package/dist/backend/services/cms-block-service.js +3 -0
- package/dist/backend/services/cms-block-service.js.map +1 -1
- package/dist/backend/services/cms-cache.d.ts +10 -0
- package/dist/backend/services/cms-cache.d.ts.map +1 -1
- package/dist/backend/services/cms-cache.js +9 -0
- package/dist/backend/services/cms-cache.js.map +1 -1
- package/dist/backend/services/cms-content-invalidator.d.ts +13 -4
- package/dist/backend/services/cms-content-invalidator.d.ts.map +1 -1
- package/dist/backend/services/cms-content-invalidator.js +13 -6
- package/dist/backend/services/cms-content-invalidator.js.map +1 -1
- package/dist/backend/services/cms-page-read-port.d.ts +6 -1
- package/dist/backend/services/cms-page-read-port.d.ts.map +1 -1
- package/dist/backend/services/cms-page-read-port.js +27 -0
- package/dist/backend/services/cms-page-read-port.js.map +1 -1
- package/dist/backend/services/cms-page-service.d.ts +72 -1
- package/dist/backend/services/cms-page-service.d.ts.map +1 -1
- package/dist/backend/services/cms-page-service.js +317 -17
- package/dist/backend/services/cms-page-service.js.map +1 -1
- package/dist/backend/services/cms-template-service.d.ts.map +1 -1
- package/dist/backend/services/cms-template-service.js +3 -0
- package/dist/backend/services/cms-template-service.js.map +1 -1
- package/dist/backend/services/contact-form/contact-form-mail.d.ts +22 -0
- package/dist/backend/services/contact-form/contact-form-mail.d.ts.map +1 -0
- package/dist/backend/services/contact-form/contact-form-mail.js +64 -0
- package/dist/backend/services/contact-form/contact-form-mail.js.map +1 -0
- package/dist/backend/services/contact-form/contact-form.service.d.ts +35 -0
- package/dist/backend/services/contact-form/contact-form.service.d.ts.map +1 -0
- package/dist/backend/services/contact-form/contact-form.service.js +75 -0
- package/dist/backend/services/contact-form/contact-form.service.js.map +1 -0
- package/dist/backend/services/contact-form/recipients-validator.d.ts +8 -0
- package/dist/backend/services/contact-form/recipients-validator.d.ts.map +1 -0
- package/dist/backend/services/contact-form/recipients-validator.js +23 -0
- package/dist/backend/services/contact-form/recipients-validator.js.map +1 -0
- package/dist/backend/services/content-tree-walker.d.ts +12 -0
- package/dist/backend/services/content-tree-walker.d.ts.map +1 -1
- package/dist/backend/services/content-tree-walker.js +40 -0
- package/dist/backend/services/content-tree-walker.js.map +1 -1
- package/dist/backend/services/page-builder-registry.d.ts +11 -2
- package/dist/backend/services/page-builder-registry.d.ts.map +1 -1
- package/dist/backend/services/page-builder-registry.js +10 -1
- package/dist/backend/services/page-builder-registry.js.map +1 -1
- package/dist/backend/services/page-paths.d.ts +87 -0
- package/dist/backend/services/page-paths.d.ts.map +1 -0
- package/dist/backend/services/page-paths.js +177 -0
- package/dist/backend/services/page-paths.js.map +1 -0
- package/dist/backend/services/storefront-resolver.d.ts +53 -2
- package/dist/backend/services/storefront-resolver.d.ts.map +1 -1
- package/dist/backend/services/storefront-resolver.js +313 -22
- package/dist/backend/services/storefront-resolver.js.map +1 -1
- package/dist/backend/services/translation/extract.d.ts.map +1 -1
- package/dist/backend/services/translation/extract.js +9 -1
- package/dist/backend/services/translation/extract.js.map +1 -1
- package/dist/manifest.d.ts +13 -1
- package/dist/manifest.d.ts.map +1 -1
- package/dist/manifest.js +592 -73
- package/dist/manifest.js.map +1 -1
- package/dist/migrations/20261022T163218_cms_brand_tokens.d.ts +24 -0
- package/dist/migrations/20261022T163218_cms_brand_tokens.d.ts.map +1 -0
- package/dist/migrations/20261022T163218_cms_brand_tokens.js +38 -0
- package/dist/migrations/20261022T163218_cms_brand_tokens.js.map +1 -0
- package/dist/migrations/20261023T052237_cms_page_tree_and_share.d.ts +24 -0
- package/dist/migrations/20261023T052237_cms_page_tree_and_share.d.ts.map +1 -0
- package/dist/migrations/20261023T052237_cms_page_tree_and_share.js +51 -0
- package/dist/migrations/20261023T052237_cms_page_tree_and_share.js.map +1 -0
- package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.d.ts +16 -0
- package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.d.ts.map +1 -0
- package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.js +20 -0
- package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.js.map +1 -0
- package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.d.ts +14 -0
- package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.d.ts.map +1 -0
- package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.js +18 -0
- package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.js.map +1 -0
- package/dist/migrations/20261029T131218_cms_page_translations.d.ts +15 -0
- package/dist/migrations/20261029T131218_cms_page_translations.d.ts.map +1 -0
- package/dist/migrations/20261029T131218_cms_page_translations.js +19 -0
- package/dist/migrations/20261029T131218_cms_page_translations.js.map +1 -0
- package/dist/migrations/index.d.ts +6 -1
- package/dist/migrations/index.d.ts.map +1 -1
- package/dist/migrations/index.js +11 -1
- package/dist/migrations/index.js.map +1 -1
- package/docs/cms/brand.md +310 -0
- package/docs/cms/contact-form.md +161 -0
- package/docs/cms/extending-page-builder.md +210 -15
- package/docs/cms/index.md +1232 -39
- package/docs/cms/page-navigation.md +83 -0
- package/i18n/en.json +2758 -22
- package/i18n/pl.json +2758 -22
- package/package.json +18 -16
- package/dist/admin/components/ButtonLinkFields.d.ts +0 -6
- package/dist/admin/components/ButtonLinkFields.d.ts.map +0 -1
- package/dist/admin/components/ButtonLinkFields.js +0 -127
- package/dist/admin/components/ButtonLinkFields.js.map +0 -1
package/docs/cms/index.md
CHANGED
|
@@ -44,34 +44,1201 @@ The same `content` JSONB is scanned by the **Assets Library reference registry**
|
|
|
44
44
|
|
|
45
45
|
## Page Builder authoring
|
|
46
46
|
|
|
47
|
-
The Page Builder is built on **Puck** (`@puckeditor/core`)
|
|
48
|
-
in
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
|
62
|
-
|
|
|
63
|
-
| `
|
|
64
|
-
| `
|
|
65
|
-
| `
|
|
66
|
-
| `
|
|
67
|
-
| `
|
|
68
|
-
| `
|
|
69
|
-
| `
|
|
70
|
-
| `
|
|
71
|
-
| `
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
47
|
+
The Page Builder is built on **Puck** (`@puckeditor/core`). Its blocks are
|
|
48
|
+
declared in the manifests of the modules that own them and are drawn by
|
|
49
|
+
`@endora-commerce/cms-components`, both in the admin canvas and on the
|
|
50
|
+
storefront, so the preview and the published page match. Colours, fonts,
|
|
51
|
+
the type scale, buttons and spacing come from the brand settings, edited once
|
|
52
|
+
on the [Brand](./brand.md) screen.
|
|
53
|
+
|
|
54
|
+
### Blocks
|
|
55
|
+
|
|
56
|
+
A page is built as a stack of **Sections**: `cms.Section` is the one block
|
|
57
|
+
that carries the [section settings](#section-settings) described below, and
|
|
58
|
+
it holds any other blocks. Feature 163 (page builder for marketing pages)
|
|
59
|
+
added, reshaped and removed blocks; the last column says what changed.
|
|
60
|
+
|
|
61
|
+
| Block | Palette label | What it is, and what changed |
|
|
62
|
+
| --- | --- | --- |
|
|
63
|
+
| `cms.Section` | Section | **New.** A band of the page with its own anchor, colour scheme, background, spacing, width, content position and entrance reveal, holding any blocks. It stands only at the top level of a page, or in a Section group. |
|
|
64
|
+
| `cms.SectionGroup` | Section group | **New.** Holds Sections and paints one colour scheme, background and decorative backdrop behind all of them, with no seam between them; optional space above and below and an anchor. It stands only at the top level of a page. See [Section groups](#section-groups). |
|
|
65
|
+
| `cms.Row` | Row | Columns layout container. Unchanged. |
|
|
66
|
+
| `cms.Column` | Column | A column inside a Row. **Extended** with **Distribute blocks vertically** (from the top, which is the default, center, to the bottom, space between, or the last block to the bottom); a block placed in a column can take another **Order in the column** per breakpoint, and the column itself another **Order in the row**: see [Columns: distribution and order](#columns-distribution-and-order). A column can also span rows of its Row and start at a given column or row per breakpoint: see [Columns: placement in the row's grid](#columns-placement-in-the-rows-grid). |
|
|
67
|
+
| `cms.Heading` | Heading | **Reshaped.** The text is inline rich text (bold, italic, link, three highlight styles, an icon from the icon catalog: see [Icons in headings and captions](#icons-in-headings-and-captions)). The semantic level (`h1`–`h6` or a paragraph) is chosen apart from the visual size, which is a type-scale token. Font, size, weight, style and line height stay available as **Custom** overrides in an "Advanced" group. |
|
|
68
|
+
| `cms.Text` | Simple Text | Body text with typography controls; it reads the brand tokens as defaults. **Extended** with a maximum text width per breakpoint (narrow, medium, wide or Custom px; none by default), which follows the text's alignment. |
|
|
69
|
+
| `cms.RichContent` | Rich Content | TipTap rich text. **Extended** with collapsible "read more" text, a check-mark list, links shown as buttons, heading anchors, visually hidden headings, the three highlight styles and a maximum text width per breakpoint. Its headings follow the brand's type scale once one is set (see [Rich-text headings and the type scale](#rich-text-headings-and-the-type-scale)). An image in the text takes a **Width** in px or %, an **Alignment** (left, center, right) and **In the line of text**, which sets it inside a sentence (a logo, a small avatar group); the same applies to every rich body of the other blocks. In the admin, **Image source** picks the image from the **Asset library** (its alternative text is filled in when the asset has one and the field is still empty) or takes a **URL**. |
|
|
70
|
+
| `cms.Button` | Button | **Reshaped.** One button described by a style (`primary`, `secondary`, `light`, `dark`), a fill (`solid`, `outline`, `text`), a size, an optional icon (before, after, or icon only), colour overrides and a link. Today's `ghost` variant is the `text` fill. |
|
|
71
|
+
| `cms.Image` | Image | **Extended.** A **Mobile image** shown below the tablet width, an **Aspect ratio** per breakpoint (Responsive tab; a preset or a custom `w:h`, the image's own ratio by default), an **Overlay** (solid or gradient, with direction and strength) and an optional **Caption** below or beside the image — an image with a sentence next to it, such as a small avatar group. **Full width** is the existing Width option; inside a Section with the **Bleed** width the image reaches the window's edges. The image is loaded lazily; with a ratio its space is reserved before it loads. With none of these set it looks as before. |
|
|
72
|
+
| `cms.Icons`, `cms.Social`, `cms.Spacer` | Icons, Social, Spacer / Divider | Unchanged. |
|
|
73
|
+
| `cms.Hero` | Hero / CTA banner | **Reshaped.** Media (solid colour, gradient, image with a mobile alternative, or self-hosted video with a poster and a **Video aspect ratio** per breakpoint for a video above the text, 16:9 by default) behind or above the text; eyebrow, title, subheading and statement, each with its own level and size; rich body text; up to six buttons; social proof (image and caption); **Overlay (darkens the background media)**, minimum height, alignment and an optional entrance reveal; the overlay's **Type** is none, solid or gradient, and only the settings that type uses are shown (the strength for solid and gradient, the direction for a gradient). **Elements: order and spacing** puts the eyebrow, title, subheading, statement, text, buttons and social proof in any order (unlisted ones follow in the default order), and each listed element can take a **Space after** it (a spacing size or a **Custom** px value); left on **Default**, an element keeps **Space between items**, or the default spacing when that is not set. **Media width: Full window width** lets an image or video reach the window's edges while the text stays in the hero. A video's mobile alternative is a library video, or a **Mobile video URL** with the URL source. **Poster source** sets where both stills come from: the **Asset library** (**Poster image**, **Mobile poster image**) or **URL** (**Poster URL**, **Mobile poster URL**); the mobile poster is the still shown before the mobile video plays, so a video of another shape is not shown cropped. The title takes a **Title weight** and a **Title max width** per breakpoint: see [Headings: weight and width](#headings-weight-and-width). |
|
|
74
|
+
| `cms.MediaText` | Media and text | **New.** Image or video (from the Assets Library or, with **Video source: URL**, by address, each with an optional mobile video shown below the tablet width, and with a **Video aspect ratio** per breakpoint, 16:9 by default) beside text, with side, mobile order, column split, vertical alignment, feature items with icons, buttons, a footnote, and repeated rows that can alternate sides. A video takes an optional **Mobile poster image** or **Mobile poster URL** for the mobile video. **Item title size** (a type-scale size or **Custom (px)**, per breakpoint) and **Item title weight** (300–800) restyle every feature item's title; left on **Default**, the titles stay 16 px semibold. |
|
|
75
|
+
| `cms.BackgroundPanel` | Background image panel | **New.** An image with a text panel on one side. To take it edge to edge, put it in a Section with the **Bleed** or **Full** width. **Transparent text box** (off by default) leaves the text panel without its scheme background, so the image shows through behind the text; choose the scheme so the text reads on the image. |
|
|
76
|
+
| `cms.CtaCard` | Call-to-action card | **New.** A boxed call to action in its own colour scheme, with a list, buttons, an optional image and the brand's decorative backdrop. |
|
|
77
|
+
| `cms.Statement` | Statement | **New.** A large statement or quote, optionally over an image that fills the block, with an optional word-by-word reveal and a maximum text width per breakpoint. A Section with the **Bleed** width takes it edge to edge. |
|
|
78
|
+
| `cms.LinkList` | Link list | **New.** Rows of title, description and button, with an optional divider. |
|
|
79
|
+
| `cms.FeatureList` | Feature list | **Reshaped.** Columns per breakpoint, uploaded SVG icons that take the text colour, rich item text, an optional image below the grid. |
|
|
80
|
+
| `cms.Stats` | Stats | **Reshaped.** Key figures with an optional heading and image. |
|
|
81
|
+
| `cms.Testimonial` | Testimonial | **Reshaped.** Adds an image and an image-overlay layout; the card layout is the default. |
|
|
82
|
+
| `cms.Video` | Video | **Extended.** **Source: Embed** (YouTube, Vimeo or a page URL, as before: the **Video URL** and the **Provider**) or **Video file**. For a file, **File source** sets where the video and its optional mobile version (shown below the tablet width) come from: the **Asset library** (**Video file**, **Mobile video file**) or **URL** (**Video URL**, **Mobile video URL**); **Poster source** does the same for the **Poster image** and **Mobile poster image**, or the **Poster URL** and **Mobile poster URL**. Only the fields of the chosen sources are shown. A video saved before the sources existed opens on the source its values imply — a URL with no library file is the URL source — and plays as before: with no source chosen, a library file or image wins over a URL. The **Aspect ratio** takes every preset and a custom `w:h`, per breakpoint (Responsive tab). A file loads nothing until it plays; with **Autoplay** it plays muted, only while on screen and never for a visitor who prefers reduced motion; otherwise the visitor starts it with its controls. **Rounded corners** (none, small, medium, large) round the player's frame; the default, medium, is the 8 px it always had. An autoplaying file is always muted, so **Muted** is offered only for a file that does not autoplay. |
|
|
83
|
+
| `cms.LogoStrip`, `cms.Map`, `cms.SimpleTable` | Logo strip, Map, Table | Unchanged. |
|
|
84
|
+
| `cms.AnnouncementBar` | Announcement bar | Unchanged. |
|
|
85
|
+
| `cms.ContentSlider` | Carousel | **Reshaped** into the one carousel: a header (heading, lead, button), slides per view per breakpoint (1–8, in steps of 0.25), slide or fade effect, arrow placement per breakpoint, an arrow style, shape, size and colour, dots, bleed to the viewport edge, optional autoplay. The same items can be laid out as a grid of columns per breakpoint, and an optional filter bar shows only the items with one tag. The slides per view are CSS, so the server and the browser render the same layout. See [Carousels: controls, grid and filter](#carousels-controls-grid-and-filter). |
|
|
86
|
+
| `cms.CarouselImage`, `cms.CarouselSplit`, `cms.LinkTile`, `cms.DownloadTile` | Carousel image, Carousel split slide, Link tile, Download tile | **New** carousel items, offered only inside a carousel. Each item, and a free-content slide, carries optional tags for the carousel's filter. A carousel image's caption over the image can sit on a scrim (a gradient from its edge or an even tint). A link tile's image ratio can differ per breakpoint. A carousel image takes **Image – rounded corners** (and its caption **Caption – rounded corners**), a link tile **Rounded corners** (none, small, medium, large; medium, 8 px, by default). A carousel image's caption, and a link tile's title and label, take a size per breakpoint and a font; a link tile's label is a text link with an arrow, a button or hidden. A download tile is a single download link to an Assets Library file; when the file is gone, customers see nothing and the preview shows a warning. |
|
|
87
|
+
| `cms.Tabs`, `cms.Accordion` | Tabs, Accordion | **Reshaped.** Each panel holds blocks instead of one HTML text, every panel is in the server-rendered HTML, and keyboard navigation follows the WAI-ARIA patterns. Tabs gain an animated panel change (fade or slide) and a tab bar look: the bar's background and border (a capsule around pills), the active and other tabs' colours, a hover colour for the other tabs, a **Tab size** per breakpoint (small, medium or large; medium when not set), and the **Space below the tab bar** (a spacing size or a **Custom** px value, per breakpoint; 12 px when not set). A panel in columns is a Row inside it: see [Tabs: a panel in columns](#tabs-a-panel-in-columns). **Tabs that do not fit** either wrap onto more lines (the default) or stay in one line that scrolls sideways inside the block, snapping to a tab; the page itself never scrolls sideways, and the keyboard works the same in both. Accordion item titles can be headings (H2–H6, the trigger inside the heading) with a size from the type scale; by default they are not headings and keep their look. |
|
|
88
|
+
| `cms.NewsletterSignup` | External newsletter form | Kept as the form that posts to **any external endpoint** (`actionUrl`). Gained an optional consent checkbox. The platform's own newsletter sign-up is the `newsletter.Signup` block below. |
|
|
89
|
+
| `cms.ContactFormEmbed`, `cms.RawHtml`, `cms.RawJs`, `cms.InsertBlock` | Contact / form embed, Raw HTML, Raw JS, Insert Block | Unchanged. `InsertBlock` embeds a Block by `code`; a Section in an embed placed at the top level of a page renders as a section. |
|
|
90
|
+
| `cms.InsertTemplate` | Insert Template | Legacy: kept for existing trees and **not** in the drawer palette. Prefer Save as / Apply template. |
|
|
91
|
+
| ~~`cms.ImageSlider`~~ | — | **Removed.** Use the Carousel with **Carousel image** items, which carry every caption option the image slider had. |
|
|
92
|
+
|
|
93
|
+
Blocks owned by other modules appear in the same palette while their module is
|
|
94
|
+
present:
|
|
95
|
+
|
|
96
|
+
| Block | Owner | What changed |
|
|
97
|
+
| --- | --- | --- |
|
|
98
|
+
| `blog.LatestPosts` | `blog` | **New.** The newest published posts of the channel, as a carousel or a grid. |
|
|
99
|
+
| `newsletter.Signup` | `newsletter` | **New.** Subscribes through the newsletter module, with optional topics and a required consent checkbox; works without JavaScript. |
|
|
100
|
+
| `catalog.ProductGrid`, `catalog.ProductSlider` | `catalog` | **Reshaped.** A header, a card variant (including a `showcase` card with a short summary), a "more" link label and a footer button; the slider takes the carousel options. |
|
|
101
|
+
|
|
102
|
+
**An empty listing shows nothing.** A product grid, product slider, category grid,
|
|
103
|
+
category list or latest posts block that finds nothing to show (no product in its
|
|
104
|
+
category, no post yet) leaves no trace on the storefront: no box, no heading, no
|
|
105
|
+
sentence. In the editor its preview still says why it is empty.
|
|
106
|
+
|
|
107
|
+
### Content saved before a block changed shape
|
|
108
|
+
|
|
109
|
+
A reshaped block keeps every option it had: the option-parity test
|
|
110
|
+
(`packages/cms-components/src/components/option-parity.test.ts`) maps each
|
|
111
|
+
field the block had before the reshape to its new counterpart. Stored content
|
|
112
|
+
is not migrated in the database, and it does not need to be:
|
|
113
|
+
|
|
114
|
+
- **A reshaped block renders stored content as before.** Each reshaped block
|
|
115
|
+
carries a mapping from its earlier props (`heroFromLegacy`,
|
|
116
|
+
`headingFromLegacy`, `buttonFromLegacy`, `contentSliderFromLegacy`, and so on)
|
|
117
|
+
that runs when it renders. When an editor opens the page, the editor converts
|
|
118
|
+
the block to the new shape, and the next save stores it. A stored tab or
|
|
119
|
+
accordion panel written as HTML keeps rendering as that HTML until the page is
|
|
120
|
+
opened, when it moves into the panel as a **Rich Content** block.
|
|
121
|
+
- **A hero's spacing list moves into its element list.** A hero saved with
|
|
122
|
+
**Space after an element** keeps its spaces on the storefront. When the page is
|
|
123
|
+
opened, each space moves to its element in **Elements: order and spacing**,
|
|
124
|
+
which then lists every element in the order shown — nothing moves on the page.
|
|
125
|
+
- **A removed block degrades to the missing-block placeholder.** A stored
|
|
126
|
+
`cms.ImageSlider` renders nothing for customers, the rest of the page renders
|
|
127
|
+
normally, and the editor shows the placeholder where it was. Rebuild it as a
|
|
128
|
+
Carousel.
|
|
129
|
+
|
|
130
|
+
### Section settings
|
|
131
|
+
|
|
132
|
+
The **Section** block (`cms.Section`) carries the section settings — anchor,
|
|
133
|
+
colour scheme, background, spacing, width, content position and an entrance
|
|
134
|
+
reveal — and a slot that holds any other blocks. Each setting is a field of
|
|
135
|
+
its own. Width, Space above, Space below, Content position and Overlap with the
|
|
136
|
+
previous section are set per breakpoint on the editor's **Responsive** tab: choose Base (mobile), Tablet or Desktop in
|
|
137
|
+
its **Scope settings** and edit the value for that breakpoint, as on a Row. The
|
|
138
|
+
other settings are on the **General** tab, with the anchor and the entrance
|
|
139
|
+
reveal last. No other block carries section settings; a block outside a
|
|
140
|
+
Section renders exactly as it does on its own.
|
|
141
|
+
|
|
142
|
+
A Section stands only at the **top level** of a page, or in a
|
|
143
|
+
[Section group](#section-groups). Every other slot — a row's columns, a tab or
|
|
144
|
+
accordion panel, a carousel slide, another Section — refuses it, and the
|
|
145
|
+
editor undoes a drop into one. A Section embedded with
|
|
146
|
+
`InsertBlock` at the top level of a page renders as a section. With nothing
|
|
147
|
+
set, a Section is neutral: no colour, the contained width and the `l` spacing.
|
|
148
|
+
|
|
149
|
+
| Setting | Options |
|
|
150
|
+
| --- | --- |
|
|
151
|
+
| Anchor | A fragment name such as `contact`, so that `/page#contact` scrolls to the section. See [Anchors](#anchors). |
|
|
152
|
+
| Color scheme | Inherit, Light, Muted, Dark. The scheme sets the text, heading, link, border and button colours of every block inside the section. |
|
|
153
|
+
| Background | None, solid colour, gradient, image or video. An image takes an optional mobile image, a focal position, a **size** (Cover, the default; Contain, the whole image; Natural size; or a width in px or %) and a **repeat** (none, the default; tile; across; down); a video takes a poster and an optional mobile video. An overlay (solid or gradient, with direction and strength) can sit above the media. On the dark scheme, **Decorative backdrop** paints the brand's decorative image; with it switched on, **Backdrop size**, **Backdrop repeat** and **Backdrop position** set how it is drawn (Cover from the top centre, not repeated, until changed). A size in px keeps the image or backdrop that size on every screen width. With a mobile image or mobile video, **Mobile image or video shown on** sets where it gives way to the desktop one: **Phones (below 768 px)**, the default, or **Phones and tablets (below 1024 px)**. |
|
|
154
|
+
| Space above / Space below | Responsive tab. A step of the brand spacing scale (`none`, `xs`, `s`, `m`, `l`, `xl`, `xxl`) or a pixel value, per breakpoint; a breakpoint left on **Inherit** takes the one below it. Spacing is padding, so two adjacent dark sections touch and read as one dark area. |
|
|
155
|
+
| Width | Responsive tab. Contained, Wide, Full, Viewport (the full viewport wide and at least the full viewport tall), Bleed (content to the edges) or Custom, which shows **Custom max width (px)**: one maximum width in pixels. Set it per breakpoint for a section that is, say, **Bleed** on phones (a box edge to edge) and **Contained** from the desktop up; a width chosen once applies at every breakpoint, as before. A Custom width wider than the page container widens the section beyond the container, centred, up to the window less the page's side margin; narrower than the container, it stays inside it. |
|
|
156
|
+
| Content width | Shown with Full, Viewport or Bleed: the background keeps that extent and the content sits in the page container, the wide frame, to the edges or in a custom max width. A dark band across the whole screen with its content in the container is **Bleed** with content width **Page container**; only **Viewport** also makes the section the full screen tall. Left unset, the width's own content frame applies. |
|
|
157
|
+
| Content position | Responsive tab. Top, Middle or Bottom, per breakpoint: where the content sits when the section is taller than it, as a Viewport section is. |
|
|
158
|
+
| Overlap with the previous section | Responsive tab. A step of the brand spacing scale or a pixel value, per breakpoint; **None** until set. The section's content moves up by that much over the bottom of the section before it and is drawn above that section's background, while this section's own background stays in place, for example an image that rises into a dark band of features. Keep it within the previous section's space below, or its content is covered. The first block of a page overlaps nothing. In the editor the content is not moved, so the previous section stays easy to select; a hatched band at the top of the section shows how far it will overlap on the previewed breakpoint. |
|
|
159
|
+
| Entrance reveal | None or fade-up, optionally on desktop only. See [Motion](#motion). |
|
|
160
|
+
|
|
161
|
+
A newsletter sign-up inside a Section with an anchor brings the visitor back
|
|
162
|
+
to that anchor after a sign-up without JavaScript.
|
|
163
|
+
|
|
164
|
+
**An empty Section takes no space.** When none of a Section's blocks shows
|
|
165
|
+
anything on the page — a news list with no posts yet, a product list with no
|
|
166
|
+
products, or blocks hidden on that breakpoint with **Hide on** — the published
|
|
167
|
+
Section drops its space above and below (and its overlap and minimum height),
|
|
168
|
+
so the page shows no blank band. A Section with a background image or video
|
|
169
|
+
keeps its size, since the media is its content. The editor always shows the
|
|
170
|
+
Section with its space, so you can drop blocks into it. Browsers without
|
|
171
|
+
support for the CSS `:has()` selector (older than 2023) show the empty space
|
|
172
|
+
as before.
|
|
173
|
+
|
|
174
|
+
### Section groups
|
|
175
|
+
|
|
176
|
+
A **Section group** (`cms.SectionGroup`) holds a run of Sections and paints
|
|
177
|
+
one background behind all of them. Use it when several adjacent Sections share
|
|
178
|
+
a dark band with the brand's decorative backdrop: on separate Sections each one
|
|
179
|
+
paints its own copy of the backdrop from its own top, so a hard edge shows at
|
|
180
|
+
every boundary; in a group the backdrop is painted once, from the group's top,
|
|
181
|
+
and runs on behind every Section in it.
|
|
182
|
+
|
|
183
|
+
A group stands only at the **top level** of a page, and its slot accepts
|
|
184
|
+
**Sections only**: the editor undoes a drop of any other block into it, and of
|
|
185
|
+
a group into any slot. Its settings:
|
|
186
|
+
|
|
187
|
+
| Setting | Options |
|
|
188
|
+
| --- | --- |
|
|
189
|
+
| Color scheme | Inherit, Light, Muted, Dark. The Sections in the group take this scheme unless they set their own. |
|
|
190
|
+
| Background | The same choices as a Section's: none, solid colour, gradient, image or video, with the overlay, and on the dark scheme **Decorative backdrop**. It is painted once, across the full window width, behind all the group's Sections. |
|
|
191
|
+
| Space above / Space below | Responsive tab. A step of the brand spacing scale or a pixel value, per breakpoint; **None** until set, since the Sections carry their own spacing. |
|
|
192
|
+
| Anchor | A fragment name for the whole group, as a Section's. |
|
|
193
|
+
|
|
194
|
+
While the group paints — it has a scheme or a background — a Section in it
|
|
195
|
+
with no background of its own and the group's scheme (or **Inherit**) is
|
|
196
|
+
transparent, so the group's background shows through it. A Section that sets
|
|
197
|
+
a background, a decorative backdrop or another scheme paints it as usual, for
|
|
198
|
+
example a light band inside a dark group. With neither a scheme nor a
|
|
199
|
+
background, the group paints nothing and its Sections look as they would
|
|
200
|
+
without it.
|
|
201
|
+
|
|
202
|
+
Inside a group a Section keeps everything else: its width, spacing, content
|
|
203
|
+
width, anchor and overlap. The first Section of a group can overlap the block
|
|
204
|
+
before the group (the group's own space above is covered first); the first
|
|
205
|
+
Section of a group that opens the page overlaps nothing. An empty Section in a
|
|
206
|
+
group takes no space, as anywhere, and a group none of whose Sections shows
|
|
207
|
+
anything drops its own space above and below too. A group stored inside
|
|
208
|
+
another block (which the editor refuses) renders its Sections' content only.
|
|
209
|
+
|
|
210
|
+
### Colour schemes
|
|
211
|
+
|
|
212
|
+
The three schemes — light, muted and dark — are defined once on the
|
|
213
|
+
[Brand](./brand.md) screen. A section with a scheme renders
|
|
214
|
+
`data-cmsb-scheme="light|muted|dark"`, which rebinds the scheme variables
|
|
215
|
+
(`--cmsb-fg`, `--cmsb-bg`, `--cmsb-fg-muted`, `--cmsb-border`,
|
|
216
|
+
`--cmsb-link`) for everything inside it. Colour fields in the blocks also
|
|
217
|
+
accept a brand colour: the colour picker lists **Brand colors** first and
|
|
218
|
+
stores a token such as `token:primary`, which follows later brand changes.
|
|
219
|
+
A hex value stays available as an override.
|
|
220
|
+
|
|
221
|
+
Inside a section with a scheme, the blocks' secondary text — feature
|
|
222
|
+
descriptions, product SKUs and stock, category counts, an inactive or active
|
|
223
|
+
tab — takes the scheme's muted or main text colour, so it stays legible on the
|
|
224
|
+
dark scheme. The light grey behind a link tile's or a carousel image's picture
|
|
225
|
+
gives way to the section's own background, so artwork with a transparent
|
|
226
|
+
background shows no light card on a dark section; an item with no image yet
|
|
227
|
+
shows a faint tint of the scheme's text colour instead. A bordered product
|
|
228
|
+
card takes the scheme's background and border, and an active pill tab inverts
|
|
229
|
+
the scheme's colours. Outside a section with a scheme, all of these look as
|
|
230
|
+
they did before.
|
|
231
|
+
|
|
232
|
+
### Anchors
|
|
233
|
+
|
|
234
|
+
A Section's anchor and a heading anchor in Rich Content become element ids,
|
|
235
|
+
and a button, a rich-text link or a link field of the **In-page anchor** kind
|
|
236
|
+
can target them. The editor normalises what is typed — lower case, ASCII,
|
|
237
|
+
hyphens, a leading letter, at most 64 characters — so `Contact Us!` becomes
|
|
238
|
+
`contact-us` and `9x` becomes `a-9x`. The link field lists the anchors on the
|
|
239
|
+
current canvas: the anchors of its top-level Sections and Section groups, and
|
|
240
|
+
of the Sections inside a group.
|
|
241
|
+
|
|
242
|
+
Saving page, block or template content is refused with `422` when an anchor
|
|
243
|
+
breaks one of two rules, checked per language tree:
|
|
244
|
+
|
|
245
|
+
| Error | When |
|
|
246
|
+
| --- | --- |
|
|
247
|
+
| `CMS_DUPLICATE_ANCHOR` (`details.anchor`) | The same anchor is used twice in one language's content. A section anchor and a heading anchor conflict with each other; the same anchor in two languages is allowed. |
|
|
248
|
+
| `CMS_RESERVED_ANCHOR` (`details.anchor`) | The anchor is an id the storefront layout already uses: `main-content`, `cmsb`, `cmsb-header-offset`, `b2b-locale`, `b2b-currency`, `ga-gtag-src`, `ga-gtag-init`, `gtm-init`. |
|
|
249
|
+
|
|
250
|
+
The reserved list is `RESERVED_ANCHORS` in
|
|
251
|
+
`packages/contracts/src/page-builder-values.ts`, re-exported by the storefront
|
|
252
|
+
as `storefront/app/reserved-anchors.ts`. Only the anchors of top-level
|
|
253
|
+
Sections, of top-level Section groups and of the Sections inside a group
|
|
254
|
+
count, because only they render an id. A
|
|
255
|
+
refused save writes nothing and records no audit entry. The storefront
|
|
256
|
+
offsets the scroll target by its sticky header
|
|
257
|
+
(`scroll-margin-top: var(--cmsb-header-offset)`).
|
|
258
|
+
|
|
259
|
+
### Section presets
|
|
260
|
+
|
|
261
|
+
The block drawer offers ready-made sections — hero, media and text,
|
|
262
|
+
call-to-action card, downloads, feature grid and statement — assembled from
|
|
263
|
+
the blocks above with neutral placeholder copy in the editor's language.
|
|
264
|
+
Each preset is a Section holding its block. Inserting one adds it at the top
|
|
265
|
+
level, after the selected block's top-level Section or at the end of the page,
|
|
266
|
+
without replacing the canvas; when the selected block is in a Section of a
|
|
267
|
+
Section group, the preset goes into that group, after its Section; everything in it is then edited like any other block. The presets
|
|
268
|
+
are code (`packages/cms-components/src/editor/section-presets.ts`), versioned
|
|
269
|
+
with the blocks they build, and their copy is in the `cms` bundle under
|
|
270
|
+
`presets.*`.
|
|
271
|
+
|
|
272
|
+
### Parent page and breadcrumbs
|
|
273
|
+
|
|
274
|
+
The page editor's **Breadcrumbs** card sets:
|
|
275
|
+
|
|
276
|
+
- **Parent page** — the page shown before this one in the breadcrumb trail.
|
|
277
|
+
It changes the page's address only with the option below. A page cannot be its own parent or
|
|
278
|
+
be placed under one of its subpages, and the tree is at most eight levels
|
|
279
|
+
deep; a refused choice answers `422 CMS_PAGE_PARENT_CYCLE`. Deleting the
|
|
280
|
+
parent clears the field on its children.
|
|
281
|
+
- **Include the parent page's path in the address** — off by default, so a
|
|
282
|
+
page keeps its flat `/<slug>`. On, the page is served under its parent's
|
|
283
|
+
address: `/<parent path>/<slug>`. The parent's own address follows the same
|
|
284
|
+
rule, so a tree whose lower pages all opt in gives addresses such as
|
|
285
|
+
`/services/consulting/workshops`. See *Nested page
|
|
286
|
+
addresses* below.
|
|
287
|
+
- **Show breadcrumbs** — on by default.
|
|
288
|
+
- **Breadcrumb color scheme** — light (the default, which paints nothing),
|
|
289
|
+
muted or dark. On muted and dark the links take the scheme's muted text
|
|
290
|
+
colour (its text colour on hover) and the current page its text colour.
|
|
291
|
+
- **Show the breadcrumbs over the first section** — off by default. On, the
|
|
292
|
+
trail lies over the top of the page's first section (a hero, for example)
|
|
293
|
+
instead of in a band above it, and nothing on the page moves down: no band is
|
|
294
|
+
painted, and the trail keeps the brand's page container and side margin.
|
|
295
|
+
Choose the **dark** scheme for a light trail on a dark image. The first
|
|
296
|
+
section is not padded for the trail automatically — give it enough top
|
|
297
|
+
padding (its **Space above**, or the hero's own) so the trail does not cover
|
|
298
|
+
its content.
|
|
299
|
+
|
|
300
|
+
The storefront renders *Home › ancestors › page*. Every crumb is labelled with
|
|
301
|
+
the page's **name** — the current page's and each ancestor's alike (until
|
|
302
|
+
2026-10-27 an ancestor showed its meta title instead). An ancestor that is not
|
|
303
|
+
published in the request's sales channel is shown as plain text, not as a
|
|
304
|
+
link, and its slug never leaks across channels. The trail sits in the brand's
|
|
305
|
+
page container and side margin, so it lines up with the page content. On the
|
|
306
|
+
muted or dark scheme the painted band holds its own space below the trail, so
|
|
307
|
+
a dark first section follows it with no light strip in between. The trail's
|
|
308
|
+
`BreadcrumbList` structured data uses absolute URLs. The fields are
|
|
309
|
+
stored on `cms_pages` (`parent_page_id`, `breadcrumbs_visible`,
|
|
310
|
+
`breadcrumbs_scheme`, `breadcrumbs_overlay`, `share_image_asset_id`) and are
|
|
311
|
+
part of the `cms_page.update` audit entry.
|
|
312
|
+
|
|
313
|
+
### Nested page addresses
|
|
314
|
+
|
|
315
|
+
A page's **public path** is its own slug, or — when **Include the parent
|
|
316
|
+
page's path in the address** is on (`parentPathInUrl`, stored as
|
|
317
|
+
`cms_pages.parent_path_in_url`) — its parent's public path, a `/` and its
|
|
318
|
+
slug. The path is computed when the page is read, per sales channel, from the
|
|
319
|
+
slug each channel serves a page under; it is never stored. So:
|
|
320
|
+
|
|
321
|
+
- **Renaming or moving a parent moves every nested page below it.** The old
|
|
322
|
+
address stops answering; there is no automatic redirect from it.
|
|
323
|
+
- **The page's own slug keeps answering**, with a permanent (308) redirect to
|
|
324
|
+
its path, so links made before the option was switched on keep working.
|
|
325
|
+
- **A parent the channel does not serve** leaves the page at its own slug in
|
|
326
|
+
that channel.
|
|
327
|
+
- **Two pages cannot share an address in one channel.** A save that would
|
|
328
|
+
give a page — or a nested page below it — an address another page already
|
|
329
|
+
has is refused with `409 CMS_SLUG_CONFLICT`, and nothing is written.
|
|
330
|
+
- The first segment of a nested address is the top page's slug, which the
|
|
331
|
+
reserved-segment rule already checks, so a nested page cannot shadow a
|
|
332
|
+
storefront route such as `/p/…`, `/c/…`, `/cart` or `/account`.
|
|
333
|
+
|
|
334
|
+
The page editor shows the resulting address under **Public address**. The
|
|
335
|
+
storefront's breadcrumb links, canonical link, `og:url` and sitemap use the
|
|
336
|
+
path, and a Page Builder link to a page is rendered at the page's path in the
|
|
337
|
+
request's channel.
|
|
338
|
+
|
|
339
|
+
### Name, slug and description per language
|
|
340
|
+
|
|
341
|
+
A page's **Name**, **Slug** and **Description** in the *Page metadata* card
|
|
342
|
+
are its defaults. The **Language version** card gives each language of the
|
|
343
|
+
page its own name, slug and description, next to that language's meta title,
|
|
344
|
+
meta description and meta keywords. A field left empty uses the page's own
|
|
345
|
+
value, which the card shows greyed out as a hint. The card edits the language
|
|
346
|
+
the canvas shows: the language tabs in the card and above the canvas switch
|
|
347
|
+
both. While a language's slug has not been typed, it follows that language's
|
|
348
|
+
name, as a new page's slug follows its name.
|
|
349
|
+
|
|
350
|
+
The overrides are stored in `cms_pages.translations`
|
|
351
|
+
(`{ "<lang>": { "name", "slug", "description" } }`, `{}` for a page that
|
|
352
|
+
overrides nothing) and are part of the `cms_page.update` audit entry. An
|
|
353
|
+
override counts only while the page has its language: removing a language
|
|
354
|
+
from the page keeps its overrides stored but unused, and adding the language
|
|
355
|
+
back brings them back. The API refuses an override of a language the page does
|
|
356
|
+
not have with `400 CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE`.
|
|
357
|
+
|
|
358
|
+
On the storefront:
|
|
359
|
+
|
|
360
|
+
- **Each language is served at its own slug** — and, for a nested page, at its
|
|
361
|
+
ancestors' slugs in that language, under that language's path prefix, as a
|
|
362
|
+
product's address is: `/pl/o-nas` in Polish, `/en/about-us` in English (`/o-nas`
|
|
363
|
+
when the channel does not prefix its default language — see *Sales channels*).
|
|
364
|
+
- **A page is found by its slug in any of its languages**, and by its own slug,
|
|
365
|
+
and served in the visitor's language. When the address asked for is not the
|
|
366
|
+
page's address in that language — a visitor switched language on the page —
|
|
367
|
+
the storefront answers a permanent (308) redirect to the right one.
|
|
368
|
+
- **Two pages cannot share an address in one channel and one language.** The
|
|
369
|
+
same slug may be one page's in Polish and another page's in English. A save
|
|
370
|
+
that breaks this is refused with `409 CMS_SLUG_CONFLICT` (`details.language`
|
|
371
|
+
names the language) and nothing is written.
|
|
372
|
+
- The page's name in the served language is its title fallback and its crumb in
|
|
373
|
+
every breadcrumb trail, and a Page Builder link to a page is rendered at the
|
|
374
|
+
page's address in the served language.
|
|
375
|
+
- The canonical link is the served language's address; every language is a
|
|
376
|
+
`hreflang` alternate, and the sitemap lists every language's address with
|
|
377
|
+
the others as alternates. The reserved-segment rule checks every language's
|
|
378
|
+
slug.
|
|
379
|
+
|
|
380
|
+
The description is the page's internal note and is not shown on the storefront.
|
|
381
|
+
The page list's search finds a page by its name or slug in any language.
|
|
382
|
+
|
|
383
|
+
### Sharing image and search metadata
|
|
384
|
+
|
|
385
|
+
The page editor's **Sharing** card picks a **Sharing image** from the Assets
|
|
386
|
+
Library — about 1200 × 630 px suits most networks. Without one, the page uses
|
|
387
|
+
the setting `cms.default_share_image_asset_id` (**Settings → Page Builder →
|
|
388
|
+
Default sharing image**, settable per sales channel). Only public assets are
|
|
389
|
+
published. An asset used as a sharing image cannot be deleted
|
|
390
|
+
(`409 ASSET_REFERENCED`).
|
|
391
|
+
|
|
392
|
+
The storefront then emits, for a CMS page and for a CMS-backed home page:
|
|
393
|
+
|
|
394
|
+
- `og:image` and `twitter:card` `summary_large_image` when an image exists
|
|
395
|
+
(`summary` otherwise);
|
|
396
|
+
- `og:locale` for the served language and `og:locale:alternate` for the
|
|
397
|
+
page's other languages that have content. A CMS page also has `hreflang`
|
|
398
|
+
links, one per language, because each language has its own address (see
|
|
399
|
+
*Name, slug and description per language*). The CMS-backed home page has
|
|
400
|
+
none: `/` serves every language;
|
|
401
|
+
- `Organization` structured data with the shop logo and social profiles from
|
|
402
|
+
the Settings module (`shop.logo_asset_id`, `shop.social_profiles`).
|
|
403
|
+
|
|
404
|
+
### Headings: weight and width
|
|
405
|
+
|
|
406
|
+
A block's heading keeps the look of its size until you choose otherwise. Two
|
|
407
|
+
options change it:
|
|
408
|
+
|
|
409
|
+
- **Heading weight**: **Default** (the size's own weight, as before) or a
|
|
410
|
+
weight from Light (300) to Extra bold (800).
|
|
411
|
+
- **Heading max width**, per breakpoint on the Responsive tab: **None (full
|
|
412
|
+
width)** by default, **Narrow**, **Medium**, **Wide** (about 36, 48 and
|
|
413
|
+
60 rem) or **Custom (px)**. A long heading then wraps at that width; in a
|
|
414
|
+
centred block it stays centred.
|
|
415
|
+
|
|
416
|
+
Both are on the media-and-text block, the background image panel, the
|
|
417
|
+
call-to-action card, the link list, the feature list, the stats, and the
|
|
418
|
+
header of the carousel, the product grid and slider, and the latest posts.
|
|
419
|
+
The statement takes the weight only: its **Max text width** already holds the
|
|
420
|
+
heading and the text. On the hero the same pair is **Title weight** and
|
|
421
|
+
**Title max width**.
|
|
422
|
+
|
|
423
|
+
Smaller texts take a weight too: the feature list's **Title weight** (every
|
|
424
|
+
item title), a carousel image's **Caption weight**, a link tile's **Title
|
|
425
|
+
weight** and **Label weight**, and the product listings' **Card title
|
|
426
|
+
weight** (the product name on every card). **Default** keeps each one's look.
|
|
427
|
+
|
|
428
|
+
The carousel and the product card read the brand's **body font**, as the other
|
|
429
|
+
blocks' texts do: the filter bar, the header's lead and the cards' texts follow
|
|
430
|
+
the brand screen. With no brand font set they keep the page's font.
|
|
431
|
+
|
|
432
|
+
### Icons in headings and captions
|
|
433
|
+
|
|
434
|
+
Every text edited as inline rich text — a heading, a block's title, a carousel
|
|
435
|
+
image's caption — can hold an icon from the same icon catalog the feature list
|
|
436
|
+
and the icon block use. Place the cursor, choose **Insert icon** in the text's
|
|
437
|
+
toolbar and pick an icon; search by name. The icon sits on the line of text, at
|
|
438
|
+
the text's size and in its colour (inside a gradient highlight it takes the
|
|
439
|
+
accent colour), and is removed like a character.
|
|
440
|
+
|
|
441
|
+
In the same dialog, before picking the icon, **Icon size** sets its size:
|
|
442
|
+
**Text size (1 em)**, the default; **Relative to the text (em)**, from 0.5 to 3
|
|
443
|
+
times the text's size, so the icon scales with the heading on every screen; or
|
|
444
|
+
**Fixed (px)**, from 8 to 200 pixels. **Vertical offset (em)** raises the icon
|
|
445
|
+
(a positive value, up to 1) or lowers it (a negative value, down to −1), in
|
|
446
|
+
units of the text's size; left empty, the icon sits on the line as before. To
|
|
447
|
+
change an icon already in the text, select it (for example with the arrow
|
|
448
|
+
keys) and choose **Edit icon**: the dialog opens with its values, **Apply**
|
|
449
|
+
keeps the icon and writes the new size and offset, and picking another icon
|
|
450
|
+
replaces it.
|
|
451
|
+
|
|
452
|
+
The icon is decoration: it is hidden from screen readers, so the heading is
|
|
453
|
+
read by its words alone, and it is not sent for translation — a translated
|
|
454
|
+
heading keeps it where the translation puts it.
|
|
455
|
+
|
|
456
|
+
### Rich-text headings and the type scale
|
|
457
|
+
|
|
458
|
+
Headings written inside rich text — a Rich Content block and the text of the
|
|
459
|
+
media-and-text block, the call-to-action card, the hero, the feature list and
|
|
460
|
+
the other blocks with a rich body — follow the **type scale** of the
|
|
461
|
+
[brand settings](./brand.md): a Heading 4 in the text takes the Heading 4 size
|
|
462
|
+
(mobile and desktop), line height, weight and letter spacing. Until a type scale
|
|
463
|
+
is set for a heading level, headings of that level keep their look as before.
|
|
464
|
+
|
|
465
|
+
### Text sizes, line heights and spacing in blocks
|
|
466
|
+
|
|
467
|
+
The smaller texts of the content blocks take their own look, each option empty
|
|
468
|
+
or on **Default** until you choose otherwise, so a block already on a page keeps
|
|
469
|
+
its look. Three rules hold for every block:
|
|
470
|
+
|
|
471
|
+
- **A size is a step of the type scale or Custom (px).** A step (**Body**,
|
|
472
|
+
**Lead**, **Heading 4** …) brings the brand's line height, weight and letter
|
|
473
|
+
spacing of that step with it, at every breakpoint — so a text set to **Body**
|
|
474
|
+
looks like body text everywhere. Sizes are set per breakpoint on the
|
|
475
|
+
**Responsive** tab.
|
|
476
|
+
- **A line height is offered with a Custom (px) size only.** A step already has
|
|
477
|
+
its own; a line height (a multiple of the size, for example 1.5) applies only
|
|
478
|
+
at a breakpoint whose size is Custom (px).
|
|
479
|
+
- **A weight is one value for every breakpoint.** It wins over the step's own
|
|
480
|
+
weight. A weight saved per breakpoint by an earlier version of these options
|
|
481
|
+
is read as its desktop value, else its base value.
|
|
482
|
+
|
|
483
|
+
Spaces inside a block are one step of the brand spacing scale (**None**,
|
|
484
|
+
**XS** … **XXL**), not a pixel value per element; a step has its own phone and
|
|
485
|
+
desktop size, so it follows the breakpoints and the brand.
|
|
486
|
+
|
|
487
|
+
- **Feature list**: **Text size**, **Text weight** and **Text line height** for
|
|
488
|
+
every item's text (by default a small, muted line); **Title line height**
|
|
489
|
+
with a Custom title size; **Space inside each item** — the space after the
|
|
490
|
+
icon, below the title and between the paragraphs. **Icon position: Beside
|
|
491
|
+
the title** puts the icon at the start of the title, and the title and the
|
|
492
|
+
text hang beside it: a wrapped line starts under the text, not under the
|
|
493
|
+
icon.
|
|
494
|
+
- **Hero**: the subheading and the statement take a **weight**, a **line
|
|
495
|
+
height** (with a Custom size) and a **max width**, like the title; the text
|
|
496
|
+
takes a **Text size** (16 px by default), **weight**, **line height** and
|
|
497
|
+
**max width**. The hero has one **Text color** for all its texts; the eyebrow
|
|
498
|
+
may take its own **Eyebrow color** as an accent. **Space between items**
|
|
499
|
+
offers **Custom (px)**. With media **Above the content**, **Space below the
|
|
500
|
+
media** sets the space between the image or video and the texts (none by
|
|
501
|
+
default). The social-proof image keeps its 40 px height.
|
|
502
|
+
- **Statement**: **Heading line height** (with a Custom heading size), and the
|
|
503
|
+
supporting text's **size**, **weight** and **line height**. Over a background
|
|
504
|
+
image, **Minimum height** (**Default** is 60 % of the screen's height; also
|
|
505
|
+
half, three quarters, the full screen, **Auto** or **Custom (px)**).
|
|
506
|
+
- **Stats**: the labels' **size** and **weight** (their colour is the scheme's
|
|
507
|
+
muted text; **Value color** stays the figures' accent). Beside an image, from
|
|
508
|
+
the tablet up, **Layout (image – figures)** places the image and the figures
|
|
509
|
+
on 12 columns (see *Layouts on 12 columns* below), and **Figures vertical
|
|
510
|
+
position**: **Center** (default), **Top**, **Bottom** or **Spread over the
|
|
511
|
+
image height**.
|
|
512
|
+
- **Link list**: **Row title size** and **Row title weight**.
|
|
513
|
+
- **Call-to-action card**: **Rounded corners** (**Default** keeps today's) and
|
|
514
|
+
**Image inset**: the card's padding by default, **None** (the image reaches
|
|
515
|
+
the card's edges) or **Custom (px)**, one value for every breakpoint.
|
|
516
|
+
- **Media and text**: **Side by side from** the tablet (768 px, default) or the
|
|
517
|
+
desktop (1024 px); below it the media and the text stack, in the **Order on
|
|
518
|
+
mobile**.
|
|
519
|
+
- **Rich content**: **Text size** and **Text weight** for the whole text; its
|
|
520
|
+
lists follow them.
|
|
521
|
+
- **Row**: **Space between rows (px)** is set per breakpoint; one value saved
|
|
522
|
+
before applies at every width.
|
|
523
|
+
|
|
524
|
+
In any rich text, the toolbar's **Text size** sizes the selected words with a
|
|
525
|
+
step of the type scale, and **List marker** chooses the markers of a bulleted
|
|
526
|
+
list: **Disc** (default), **Check mark**, **Chevron** or **None**. The page and
|
|
527
|
+
the editor render both the same. Words sized in pixels by an earlier version of
|
|
528
|
+
the toolbar keep their size until a step is chosen for them. A check mark is
|
|
529
|
+
drawn in the brand's primary colour and a chevron in the text's colour; a
|
|
530
|
+
block's **List marker color** (Rich content, Media and text) gives both
|
|
531
|
+
markers a colour of their own, for example white ticks on a dark Section.
|
|
532
|
+
|
|
533
|
+
A **Simple Text** block takes bold, italic, links and highlights: its text is
|
|
534
|
+
edited like a heading's. A text saved before keeps its plain text until it is
|
|
535
|
+
edited.
|
|
536
|
+
|
|
537
|
+
A heading that starts with an icon can hang its text beside the icon:
|
|
538
|
+
**Hanging indent after a leading icon** keeps a wrapped line under the text,
|
|
539
|
+
which starts 0.35 em after the icon.
|
|
540
|
+
|
|
541
|
+
#### Layouts on 12 columns
|
|
542
|
+
|
|
543
|
+
Media and its text side by side — the **Carousel split slide**, **Stats**
|
|
544
|
+
beside an image and the **Call-to-action card** with an image — take a
|
|
545
|
+
**Layout** from the side-by-side width up: **Default** (two equal halves, as
|
|
546
|
+
before) or a preset of columns of 12, named media first — **6 – 6**, **7 – 5**,
|
|
547
|
+
**5 – 7**, **8 – 4**, **4 – 8**, and **5 – 1 – 6** or **6 – 1 – 5** with a
|
|
548
|
+
column between (not on the card). With the media on the right the layout is
|
|
549
|
+
mirrored. **Advanced layout (columns of 12)** shows the widths in columns, the
|
|
550
|
+
columns between and **Columns aligned to** instead, and they win over the
|
|
551
|
+
preset while the switch is on; widths saved before the switch existed open with
|
|
552
|
+
it on. **Media and text** keeps its **Split (media – text)** as the layout and
|
|
553
|
+
offers the same switch for its widths in columns of 12.
|
|
554
|
+
|
|
555
|
+
A **gradient highlight** that wraps onto several lines is one gradient across
|
|
556
|
+
the whole phrase: each line continues it rather than starting it again.
|
|
557
|
+
|
|
558
|
+
### Carousels: controls, grid and filter
|
|
559
|
+
|
|
560
|
+
The options below are on the Carousel; the arrow placement, style,
|
|
561
|
+
alignment and the loop apply to the product slider and the latest posts
|
|
562
|
+
carousel as well.
|
|
563
|
+
|
|
564
|
+
| Option | Where | What it does |
|
|
565
|
+
| --- | --- | --- |
|
|
566
|
+
| **Arrow placement** | Responsive tab | Below the slides, in the header or over the slides, chosen per breakpoint. For example, arrows in the header on desktop and below the slides on a phone. |
|
|
567
|
+
| **Arrow style**, **shape**, **size**, **colour** | Controls (General tab) | Style: the default light circle, an outline or a solid fill. Shape: round or square. Size: 32, 36 (default) or 44 px. Colour: a brand colour or a hex value, used for the outline and icon, or as the fill. With nothing chosen the arrows look as before. |
|
|
568
|
+
| **Arrow icon** | Controls (General tab) | **Chevron** (default, as before) or **Arrow**, a drawn arrow from the icon catalog. The buttons, their names for screen readers and their style options stay the same. |
|
|
569
|
+
| **Next arrow style** | Controls (General tab) | **Same as the arrow style** (default), or a style of its own for the next arrow: for example an outline previous arrow beside a solid next one. Shape, size and colour stay shared. |
|
|
570
|
+
| **Controls alignment** | Responsive tab | Where the arrows and dots below the slides sit, per breakpoint: **Center** (default), **At the start**, **At the end**, **Spread out**, or **Arrows at both ends** with the dots centred between them. Only the position changes: the keyboard order stays previous, dots, next. |
|
|
571
|
+
| **Align the controls to** | General tab | **The content edge** (default) or **The first slide**: the arrows and dots below the slides line up with the first slide instead of the content. With **Bleed past the content edge**, the controls then end where the first slide ends rather than at the content's edge. Arrows in the header or over the slides do not move. |
|
|
572
|
+
| **Loop at the ends** | General tab | **Yes** (default, as before): the previous arrow on the first slide goes to the last one, and the next arrow on the last slide back to the first. **No**: the carousel stops at its ends, and the arrow that cannot go further is disabled — a screen reader announces it as unavailable and the Tab key skips it; if it had the keyboard focus, the focus moves to the other arrow. Autoplay then stops on the last slide. |
|
|
573
|
+
| **Disabled arrow look (no loop)** | Controls (General tab) | How an arrow disabled at an end looks: **Dimmed** (default), **Light outline (dark backgrounds)** — a transparent arrow with a faint white outline — or **Color**, an outline in the **Disabled arrow color** (a brand colour or a hex value). |
|
|
574
|
+
| **Layout** | General tab | **Carousel** (default) or **Grid**. A grid shows every item in **Columns** per breakpoint (1–6, set on the Responsive tab), with no arrows, dots or autoplay. Every item kind works in both. |
|
|
575
|
+
| **Filter** | General tab | **Show a filter bar**, the **“All” label** (left empty, the page language's word is shown) and the **tags to filter by**, each with the label visitors see. **Bar style**: **Pills** (default) or **Underlined tabs**, a line under the bar with the chosen tag underlined. **Bar alignment**: **Left** (default), **Center** or **Right**. **Buttons that do not fit**: **Wrap onto more lines** (default) or **Scroll in one line**. |
|
|
576
|
+
|
|
577
|
+
To filter, give each item its **Tags** (comma-separated, for example
|
|
578
|
+
`offices, retail`) and list the same tags in the carousel's filter. Tags are
|
|
579
|
+
compared without regard to case or surrounding spaces. Only the labels are
|
|
580
|
+
translated; the tags stay as they are.
|
|
581
|
+
|
|
582
|
+
The filter bar is a row of toggle buttons that wraps on a narrow screen; with
|
|
583
|
+
**Scroll in one line** it stays one line that the visitor swipes sideways
|
|
584
|
+
instead, snapping to a button, and a button reached with the keys or tapped
|
|
585
|
+
scrolls into view without pushing the page sideways. The
|
|
586
|
+
keyboard moves between the buttons with the arrow keys, Home and End, and a
|
|
587
|
+
screen reader hears how many items are shown after each change. Filtering
|
|
588
|
+
happens in the browser only: every item is in the server-rendered HTML, so a
|
|
589
|
+
search engine and a visitor without JavaScript see them all.
|
|
590
|
+
|
|
591
|
+
A carousel image's **Caption scrim** darkens the image behind a caption placed
|
|
592
|
+
over it, for legibility on a busy photo: a gradient from the caption's edge,
|
|
593
|
+
or an even tint, at a strength of 0–90 %. With a scrim, the caption drops its
|
|
594
|
+
own dark box unless you gave it a background colour.
|
|
595
|
+
|
|
596
|
+
A carousel image's **Caption size** and a link tile's **Title size** and
|
|
597
|
+
**Label size** are a type-scale size (Small, Body, Lead, Heading 1–6, Display)
|
|
598
|
+
or a **Custom (px)** value, chosen per breakpoint on the Responsive tab;
|
|
599
|
+
**Caption font**, **Title font** and **Label font** pick the brand's heading
|
|
600
|
+
or body font, and **Caption weight**, **Title weight** and **Label weight** a
|
|
601
|
+
weight from 300 to 800. Left on **Default**, the caption stays 14 px semibold
|
|
602
|
+
and the title 18 px semibold, as before. A link tile's **Label style** is a **Text
|
|
603
|
+
link with an arrow** (default), a **Button** in the primary button's look, or
|
|
604
|
+
**None**; the whole tile stays a single link either way.
|
|
605
|
+
|
|
606
|
+
A carousel image's **Caption hover color** and a link tile's **Title hover
|
|
607
|
+
color** and **Label hover color** (a brand colour or a hex value) change that
|
|
608
|
+
text's colour while the pointer is over the item or the item has the keyboard
|
|
609
|
+
focus, with a short fade between the two colours — at once for a visitor who
|
|
610
|
+
prefers reduced motion. The label colour applies to the text-link label; a
|
|
611
|
+
label shown as a button keeps the button's own hover look. Left empty, the
|
|
612
|
+
text keeps its colour.
|
|
613
|
+
|
|
614
|
+
A link tile's **Title color** and **Label color** (a brand colour or a hex
|
|
615
|
+
value) set the colour of its title and of its text-link label at rest, so a
|
|
616
|
+
hover colour has a colour to change from — for example a grey title that turns
|
|
617
|
+
white on hover. A label shown as a button keeps the button's colours. Left
|
|
618
|
+
empty, the title and the label keep their usual colours.
|
|
619
|
+
|
|
620
|
+
Both colours are set per breakpoint on the **Responsive** tab, so a tile can
|
|
621
|
+
rest in one colour on phones and tablets and in another on desktop — for
|
|
622
|
+
example a white title over the image on narrow screens and a dark one under it
|
|
623
|
+
on wide screens. A colour set for one breakpoint applies from that breakpoint
|
|
624
|
+
up until a wider one has its own; a breakpoint below the first one with a
|
|
625
|
+
colour keeps the usual colour. A colour set before this option existed is the
|
|
626
|
+
colour of every breakpoint, as before. A hover colour still wins on hover.
|
|
627
|
+
|
|
628
|
+
A carousel image's **Caption weight** and a link tile's **Title weight** and
|
|
629
|
+
**Label weight** are set per breakpoint on the **Responsive** tab too, so a
|
|
630
|
+
tile title can be regular on phones and tablets and medium on desktop. A weight
|
|
631
|
+
set for one breakpoint applies from that breakpoint up until a wider one has
|
|
632
|
+
its own; a breakpoint below the first one with a weight, or left on
|
|
633
|
+
**Default**, keeps the usual weight. A weight set before this option existed is
|
|
634
|
+
the weight of every breakpoint, as before.
|
|
635
|
+
|
|
636
|
+
### Carousel controls, buttons, download tiles and image cards: look options
|
|
637
|
+
|
|
638
|
+
Every option below is unset by default, and a page saved before them looks as
|
|
639
|
+
it did.
|
|
640
|
+
|
|
641
|
+
**Carousel controls** (the Carousel, the product slider and the latest posts
|
|
642
|
+
carousel, under **Controls**):
|
|
643
|
+
|
|
644
|
+
| Option | What it does |
|
|
645
|
+
| --- | --- |
|
|
646
|
+
| **Arrow icon color (solid style)** | The glyph of a **Solid** arrow (or a solid next arrow), white by default — so a white solid arrow can carry a black icon. Shown once an arrow style is Solid. |
|
|
647
|
+
| **Hide the arrows on**, **Hide the dots on** | The breakpoints (mobile, tablet, desktop) where the arrows or the dots are not shown, for example arrows only from the desktop up while phones and tablets swipe. A row of controls left with nothing to show there is removed, so it leaves no gap. |
|
|
648
|
+
|
|
649
|
+
The dots follow the colour scheme: in a dark Section the current dot is the
|
|
650
|
+
scheme's light text colour over faint dots, so it stays visibly current.
|
|
651
|
+
|
|
652
|
+
Arrows placed **In the header** show even when the carousel has no heading:
|
|
653
|
+
the header then holds only the arrows, at its end, as beside a heading. The
|
|
654
|
+
Carousel's **Arrow placement** also offers **Inside each split slide (under
|
|
655
|
+
its text)**: every **Carousel split slide** shows the arrows and dots at the
|
|
656
|
+
end of its text column, and only the slide on screen has working controls (the
|
|
657
|
+
others are hidden from the keyboard and screen readers). Like the other
|
|
658
|
+
placements it is chosen per breakpoint, for example below the slides on a
|
|
659
|
+
phone and under the text from the tablet up. A carousel whose items are not
|
|
660
|
+
split slides keeps its controls below the slides there. Free-content slides
|
|
661
|
+
(**Slide**) cannot hold the controls.
|
|
662
|
+
|
|
663
|
+
The product slider's and product grid's **Button below the products** takes a
|
|
664
|
+
**Button alignment**: **Left** (default), **Center** or **Right**.
|
|
665
|
+
|
|
666
|
+
**Button** (`cms.Button`):
|
|
667
|
+
|
|
668
|
+
- Its **Outline** fill is filled with the Section's background, as the
|
|
669
|
+
`secondary` button it replaced was. **Transparent outline fill** lets the
|
|
670
|
+
background show through instead (offered with an outline fill).
|
|
671
|
+
- **Border color** replaces the fill's border colour, for example a grey ring
|
|
672
|
+
around an icon-only outline button. An **Icon only** button is as large as
|
|
673
|
+
its **Size** option (small, medium or large, from the brand's button heights).
|
|
674
|
+
|
|
675
|
+
**Download tile**: **Card color scheme** (as the Section, light, muted or
|
|
676
|
+
dark), **Card background**, **Card border** (on by default), **Rounded
|
|
677
|
+
corners**, **Card padding** (a step of the spacing scale), **Title size** (a
|
|
678
|
+
step of the type scale or **Custom (px)**, per breakpoint) and **Show the file
|
|
679
|
+
type** (on by default). **Image on hover** is the default **Faint tint** or
|
|
680
|
+
**Full image with a dark gradient**, the text turning white over it. **Link
|
|
681
|
+
look** is the default **Text label** or a 48 px **Round icon button** at the
|
|
682
|
+
bottom end, ringed in the text colour; its label is still read by screen
|
|
683
|
+
readers. With the round icon button, **Icon button size** is **Small** (48 px,
|
|
684
|
+
as before), **Medium** (72 px) or **Large** (112 px), and **Icon button style**
|
|
685
|
+
is **Outline** (the ring, as before) or **Filled**: a disc in the text colour
|
|
686
|
+
with the icon in the card's background colour. The whole tile stays one download link, and tiles in a carousel row
|
|
687
|
+
keep equal heights.
|
|
688
|
+
|
|
689
|
+
**Carousel image**: a **Read-more label** (for example "Read more") shown over
|
|
690
|
+
the image in a corner of its own — **Read-more label placement**, bottom right
|
|
691
|
+
by default — apart from the caption, with an optional **Read-more label
|
|
692
|
+
icon**. It is 14 px semibold, 12 px from its corner, takes the caption's text
|
|
693
|
+
colour when one is set and is part of the item's link.
|
|
694
|
+
|
|
695
|
+
**Image** caption: **Caption placement** is chosen per breakpoint (for example
|
|
696
|
+
below the image on phones and beside it from the tablet up), and the caption
|
|
697
|
+
takes a **Caption size** (a step of the type scale or **Custom (px)**) and a
|
|
698
|
+
**Caption alignment** per breakpoint; it keeps the scheme's muted text colour.
|
|
699
|
+
|
|
700
|
+
### Buttons in blocks, hero texts, download tiles and image captions: more options
|
|
701
|
+
|
|
702
|
+
Every option below is unset by default, and a page saved before them looks as
|
|
703
|
+
it did.
|
|
704
|
+
|
|
705
|
+
**Buttons inside blocks** — a Hero's buttons, a card's or a panel's, a
|
|
706
|
+
section or listing header's button, the buttons of Media and text — take the
|
|
707
|
+
look options the **Button** block has: **Transparent outline fill** and
|
|
708
|
+
**Border color**. An icon-only button can also be a **Pill** instead of a
|
|
709
|
+
**Circle** (**Icon-only button shape**), 1.15 times as wide as it is tall — for
|
|
710
|
+
example a "scroll down" control slightly wider than tall. The Button block
|
|
711
|
+
offers the pill too; its other look options stay where they were.
|
|
712
|
+
|
|
713
|
+
**Hero**:
|
|
714
|
+
|
|
715
|
+
- **Title line height** per breakpoint, with a Custom title size. The hero's
|
|
716
|
+
**Text color** colours all its texts; **Eyebrow color** gives the eyebrow an
|
|
717
|
+
accent of its own.
|
|
718
|
+
- The eyebrow can serve as a label above the body: **Eyebrow size** (a step of
|
|
719
|
+
the type scale or **Custom (px)**, per breakpoint, with an **Eyebrow line
|
|
720
|
+
height** for a Custom size) and **Eyebrow in capitals** (on by default)
|
|
721
|
+
switched off for a label in its own case. Put it where it belongs and set the
|
|
722
|
+
space after it in **Elements: order and spacing**, as for any element.
|
|
723
|
+
- The **Social proof** caption: **Social proof caption placement** beside the
|
|
724
|
+
image (default) or below it, per breakpoint — for example below on phones and
|
|
725
|
+
beside from the tablet up —, and a **Custom social proof caption max width
|
|
726
|
+
(px)** per breakpoint. It keeps the small, muted text.
|
|
727
|
+
|
|
728
|
+
**Download tile**:
|
|
729
|
+
|
|
730
|
+
- **Links to** a file (default) or **A page or URL**: the tile then takes a
|
|
731
|
+
**Link** (a page, a product, a category, a file or a URL) instead of a file,
|
|
732
|
+
has no file-type badge, and its round icon button points onwards. A tile
|
|
733
|
+
whose link leads nowhere is not shown to customers; the editor shows a
|
|
734
|
+
warning in its place.
|
|
735
|
+
- **Custom minimum height (px)**, one value for every breakpoint (180 px by
|
|
736
|
+
default).
|
|
737
|
+
- A Custom title size now applies from the tablet up as well (it was read on
|
|
738
|
+
phones only).
|
|
739
|
+
|
|
740
|
+
**Carousel image**: a caption on the same edge as the read-more label — both
|
|
741
|
+
at the bottom, or both at the top — now sits above the label's line instead of
|
|
742
|
+
sharing it, so the two never overlap on a narrow card.
|
|
743
|
+
|
|
744
|
+
**Image** caption: **Custom caption max width (px)**, per breakpoint. A
|
|
745
|
+
caption placed below the image on phones and
|
|
746
|
+
beside it from a wider breakpoint now gets a column of its own there, beside an
|
|
747
|
+
image of a set width, instead of being squeezed into the image's width.
|
|
748
|
+
|
|
749
|
+
An inline heading left empty — a Heading block, a Media and text heading, a
|
|
750
|
+
Hero's title — writes no empty heading element on the page; a Heading block
|
|
751
|
+
keeps its spacing.
|
|
752
|
+
|
|
753
|
+
### Tabs: a panel in columns
|
|
754
|
+
|
|
755
|
+
A tab's panel holds blocks, so a panel laid out in columns is a **Row** placed in
|
|
756
|
+
it; no dedicated layout is needed. For example, a panel with a short text on the
|
|
757
|
+
left, an image in the middle and a text with a button on the right:
|
|
758
|
+
|
|
759
|
+
1. Select the Tabs block and open the tab in the sidebar; drop a **Row** into its
|
|
760
|
+
**Panel** and pick **3 columns**.
|
|
761
|
+
2. Set each **Column**'s width on the Responsive tab, for example 3, 5 and 4 of
|
|
762
|
+
12 on desktop and 12 each on a phone, where the columns then stack.
|
|
763
|
+
3. Fill the columns: a Heading and an Image with a caption (the social-proof
|
|
764
|
+
line) in the first, an Image in the second, a Rich Content text and a Button
|
|
765
|
+
in the third.
|
|
766
|
+
|
|
767
|
+
A panel accepts any block except a Column on its own (columns live in a Row),
|
|
768
|
+
another Tabs or Accordion block, and a Section. Every panel, with its columns,
|
|
769
|
+
is in the server-rendered HTML. The **Space below the tab bar** sets the gap
|
|
770
|
+
between the bar and the panel.
|
|
771
|
+
|
|
772
|
+
On a phone, many tabs wrap onto two or more lines. Set **Tabs that do not fit**
|
|
773
|
+
to **Scroll in one line** to keep a single line that the visitor swipes
|
|
774
|
+
sideways instead; the bar snaps to a tab, a tab reached with the arrow keys or
|
|
775
|
+
chosen with a tap scrolls into view, and nothing wider than the screen pushes
|
|
776
|
+
the page sideways.
|
|
777
|
+
|
|
778
|
+
The **Tab size** is set per breakpoint on the Responsive tab: for example small
|
|
779
|
+
pills on a phone and medium ones from a tablet up. With one size for every
|
|
780
|
+
breakpoint the tabs look as they did with the size in the tab bar's look.
|
|
781
|
+
|
|
782
|
+
**Tab background on hover** and **Tab text on hover** (in the tab bar's look,
|
|
783
|
+
a brand colour or a hex) colour a tab that is not selected while the pointer is
|
|
784
|
+
over it, with a short colour transition; on a touch screen nothing sticks after
|
|
785
|
+
a tap. Left unset, the tabs do not change on hover, as before.
|
|
786
|
+
|
|
787
|
+
The **Panel change** is **Instant** by default. **Fade** crossfades: the
|
|
788
|
+
panel going out fades away over the one coming in, and the block's height
|
|
789
|
+
follows smoothly from one panel to the other. **Slide** adds a short sideways
|
|
790
|
+
shift in the direction of travel (a tab further on comes in from the end side).
|
|
791
|
+
Every panel stays in the server-rendered HTML; while the outgoing panel is
|
|
792
|
+
still fading it cannot be focused or read by a screen reader, and the arrow
|
|
793
|
+
keys, Home and End work as with an instant change. Visitors who ask their
|
|
794
|
+
system for reduced motion get the instant change.
|
|
795
|
+
|
|
796
|
+
### Columns: distribution and order
|
|
797
|
+
|
|
798
|
+
A column that is taller than its blocks (the Row stretches its columns to the
|
|
799
|
+
tallest one, which is its default vertical alignment) can spread them with
|
|
800
|
+
**Distribute blocks vertically**:
|
|
801
|
+
|
|
802
|
+
| Option | Effect |
|
|
803
|
+
| --- | --- |
|
|
804
|
+
| From the top | Today's stack, the default. |
|
|
805
|
+
| Center | The blocks sit together in the middle of the column. |
|
|
806
|
+
| To the bottom | The blocks sit together at the bottom. |
|
|
807
|
+
| Space between | The first block at the top, the last at the bottom, the others spread evenly. |
|
|
808
|
+
| Last block to the bottom | The blocks stack from the top and the last one goes to the bottom, for example a social-proof line under a text. |
|
|
809
|
+
|
|
810
|
+
A block inside a column can also take another place on a given screen size,
|
|
811
|
+
without a second copy hidden with **Hide on**: select the block and, on the
|
|
812
|
+
Responsive tab, set **Order in the column** for that breakpoint — **First**,
|
|
813
|
+
**Last**, or **Position 1** to **Position 6** (blocks left **As placed** come
|
|
814
|
+
before numbered ones). A breakpoint with no value of its own takes the one
|
|
815
|
+
below it. For example, a social-proof image first in its column on desktop and
|
|
816
|
+
last on a phone: **Last** on the base breakpoint, **First** on desktop.
|
|
817
|
+
|
|
818
|
+
The order changes what the visitor **sees**, not the page's structure: a screen
|
|
819
|
+
reader still reads the blocks, and the Tab key still moves through them, in
|
|
820
|
+
the order they are placed in the editor. Reorder only where both orders make
|
|
821
|
+
sense. The editor canvas also keeps the placed order, so dragging blocks works
|
|
822
|
+
on what the outline shows; the published page shows the order per breakpoint.
|
|
823
|
+
In a column where a distribution
|
|
824
|
+
or an order is set, the blocks are laid out as a flex column, so the vertical
|
|
825
|
+
margins of two neighbouring blocks add up instead of overlapping.
|
|
826
|
+
|
|
827
|
+
A whole column can move the same way inside its Row: select the **Column** and,
|
|
828
|
+
on the Responsive tab, set **Order in the row** for a breakpoint, with the same
|
|
829
|
+
choices. For example, in a Row of two columns that stack on a phone, the second
|
|
830
|
+
column first on a phone and in its place on desktop: **First** on the base
|
|
831
|
+
breakpoint, **As placed** on desktop. As with blocks, only what the visitor
|
|
832
|
+
sees moves — a screen reader and the Tab key follow the columns in the order
|
|
833
|
+
they are placed — and the editor canvas keeps the placed order.
|
|
834
|
+
|
|
835
|
+
### Columns: placement in the row's grid
|
|
836
|
+
|
|
837
|
+
A Row lays its columns out on a grid of twelve tracks; **Width** says how many
|
|
838
|
+
tracks a column takes. On the Responsive tab, a **Column** can also be placed on
|
|
839
|
+
that grid per breakpoint:
|
|
840
|
+
|
|
841
|
+
| Option | Values | Effect |
|
|
842
|
+
| --- | --- | --- |
|
|
843
|
+
| **Height in rows** | 1 row (default) to 4 rows | The column spans that many rows of the Row, so the columns next to it can stack beside it. |
|
|
844
|
+
| **Start at column** | Next free place (default), 1 to 12 | The track the column starts at. A start that would push the column past the twelfth track at that breakpoint's width is moved left so the column fits. |
|
|
845
|
+
| **Start at row** | Next free place (default), 1 to 4 | The row the column starts at. |
|
|
846
|
+
|
|
847
|
+
A breakpoint with no value of its own takes the one below it. As soon as one
|
|
848
|
+
column of a Row is placed, that Row fills the free places of its grid in order
|
|
849
|
+
(dense packing), so a column given only a start column takes the first free row
|
|
850
|
+
of that track. A column left at one row and the next free place on every
|
|
851
|
+
breakpoint renders exactly as before.
|
|
852
|
+
|
|
853
|
+
For example, a side column with a short item at its bottom next to two tall
|
|
854
|
+
columns, which stack one under another on a phone. Add four columns, each
|
|
855
|
+
**Width** 12 on the base breakpoint and 4 on desktop, in the order they should
|
|
856
|
+
be read: **A** (the top of the side column), **B**, **C** and **D** (the item
|
|
857
|
+
under A). Then, on desktop only, set **Height in rows** to 2 rows on B and C, and
|
|
858
|
+
**Start at column** 1 (optionally **Start at row** 2) on D. On desktop, A and D
|
|
859
|
+
share the first track and B and C span both rows; on a phone, A, B, C and D
|
|
860
|
+
stack in that order. D exists once: no second copy is hidden per breakpoint.
|
|
861
|
+
|
|
862
|
+
As with the order, the placement changes what the visitor **sees**, not the
|
|
863
|
+
page's structure: a screen reader and the Tab key follow the columns in the
|
|
864
|
+
order they are placed in the editor, so place them in an order that also reads
|
|
865
|
+
well. The editor canvas keeps the placed order and the widths, without the
|
|
866
|
+
placement, so dragging columns works on what the outline shows; the published
|
|
867
|
+
page shows the placement per breakpoint.
|
|
868
|
+
|
|
869
|
+
### Columns: a background wider than the column
|
|
870
|
+
|
|
871
|
+
A Column's **Background outset (px)**, on the **Responsive** tab, makes its box
|
|
872
|
+
— its background, border and shadow — reach that many pixels past the column
|
|
873
|
+
on each side, while the column's content stays where it was: a grey box a
|
|
874
|
+
little wider than the text column beside it. Set it per breakpoint, for example
|
|
875
|
+
**0** on phones, where the column already spans the screen, and **24** from the
|
|
876
|
+
desktop up. Left at 0 (the default) the box is as wide as the column. The
|
|
877
|
+
outset reaches into the gap between the columns and past the Row's edge, so
|
|
878
|
+
keep it within the space around the column. The column box's own **Outer
|
|
879
|
+
spacing** at the sides still applies on top of the outset, at every
|
|
880
|
+
breakpoint — a breakpoint whose outset is 0 shows the box with its own margins.
|
|
881
|
+
|
|
882
|
+
### Mobile images: phones only, or phones and tablets
|
|
883
|
+
|
|
884
|
+
An image with a **Mobile image** — the **Image** block, a Hero, a Media and
|
|
885
|
+
text block, any block whose image field offers one — shows the mobile image on
|
|
886
|
+
phones and the main image from the tablet width up (768 px). **Mobile image
|
|
887
|
+
shown on** (offered once a mobile image is set) moves that switch to the
|
|
888
|
+
desktop width: **Phones and tablets (below 1024 px)** keeps the mobile art on
|
|
889
|
+
tablets too, for a tall image that suits a tablet better than the wide desktop
|
|
890
|
+
one. A Section's or Section group's background has the same setting, **Mobile
|
|
891
|
+
image or video shown on**, for its mobile image or mobile video. Left at
|
|
892
|
+
**Phones (below 768 px)** nothing is stored and the image switches as before.
|
|
893
|
+
|
|
894
|
+
### Split slides, carousel controls and block spacing
|
|
895
|
+
|
|
896
|
+
Every option below is empty or off by default, and a page saved before them
|
|
897
|
+
looks as it did. Options marked *per breakpoint* are set on the **Responsive**
|
|
898
|
+
tab; a breakpoint without its own value takes the one below it, and a
|
|
899
|
+
breakpoint no value reaches keeps the block's own look.
|
|
900
|
+
|
|
901
|
+
**Carousel split slide**:
|
|
902
|
+
|
|
903
|
+
- **Side by side from** the tablet (768 px, default) or the desktop (1024 px);
|
|
904
|
+
below it the media and the text stack, media first.
|
|
905
|
+
- **Layout (media – text)** on 12 columns from the side-by-side width up (see
|
|
906
|
+
*Layouts on 12 columns*); **Default** keeps two equal halves.
|
|
907
|
+
- **Rounded corners** of the media (8 px by default; **None** for square).
|
|
908
|
+
- **Title size** and **Text size**, *per breakpoint*, each with a line height
|
|
909
|
+
for a Custom size, and a **Title weight** and a **Text weight**.
|
|
910
|
+
- **Hanging indent after a leading icon**: a title that starts with an icon
|
|
911
|
+
(a check mark, for example) hangs beside it, so a wrapped line starts under
|
|
912
|
+
the text.
|
|
913
|
+
|
|
914
|
+
**Carousel controls** (the Carousel, the product slider and the latest posts
|
|
915
|
+
carousel):
|
|
916
|
+
|
|
917
|
+
- **Controls alignment** also offers **Dots at the start, arrows at the end**.
|
|
918
|
+
Chosen, the alignment applies to the controls inside a split slide too (left
|
|
919
|
+
unset, those start at the text's left edge).
|
|
920
|
+
- **Keep the arrows when all slides fit** (under **Controls**): when every
|
|
921
|
+
slide is already on screen the arrows stay, both disabled, and the dots are
|
|
922
|
+
hidden; off, the controls disappear as before. Kept arrows are not dimmed:
|
|
923
|
+
they rest on the colour scheme's background with its border and muted text
|
|
924
|
+
colour, so they stay readable on a light, muted or dark Section and over a
|
|
925
|
+
slide. A chosen **Disabled arrow look** — **Light outline** or **Color** — is
|
|
926
|
+
used instead, and is offered for this case on a looping carousel too.
|
|
927
|
+
|
|
928
|
+
**Media and text**: **Text size** for every row's text, *per breakpoint*, with
|
|
929
|
+
a **Text line height** for a Custom size; **Space between the heading and the
|
|
930
|
+
paragraphs** and **Space between media and text when stacked**, each a step of
|
|
931
|
+
the spacing scale. Each of **More rows** has its own **Vertical alignment**;
|
|
932
|
+
**Same as the block** (or empty) follows the block's.
|
|
933
|
+
|
|
934
|
+
**Background image panel**: **Layout on mobile** — **Image and text stacked**
|
|
935
|
+
(default) or **Text over the image**, which keeps the mobile image at its own
|
|
936
|
+
height (a tall mobile image keeps its shape) with the text over its top or
|
|
937
|
+
bottom, by **Text on mobile**.
|
|
938
|
+
|
|
939
|
+
**Feature list**: **Space between rows (px)**, *per breakpoint*, apart from the
|
|
940
|
+
gap, which then spaces the columns only; **Line height of lists in the text**,
|
|
941
|
+
*per breakpoint*, with a Custom text size.
|
|
942
|
+
|
|
943
|
+
**Call-to-action card**: **Card padding**, a step of the spacing scale (an
|
|
944
|
+
image inset is measured from it), and with an image a **Layout (image – text)**
|
|
945
|
+
from the tablet up (half the card by default; see *Layouts on 12 columns*).
|
|
946
|
+
|
|
947
|
+
**Stats**: **Label line height**, *per breakpoint*, with a Custom label size.
|
|
948
|
+
|
|
949
|
+
**Link list**: **Divider after the last row**, offered while **Divider between
|
|
950
|
+
rows** is on.
|
|
951
|
+
|
|
952
|
+
### Stacking breakpoints, column layouts and more text options
|
|
953
|
+
|
|
954
|
+
As above, every option below is empty by default, a page saved before them
|
|
955
|
+
looks as it did, and options marked *per breakpoint* are set on the
|
|
956
|
+
**Responsive** tab.
|
|
957
|
+
|
|
958
|
+
**Hero**: a social-proof caption placed **Below the image** always starts a
|
|
959
|
+
line of its own, also with a **Custom social proof caption max width (px)**
|
|
960
|
+
narrow enough to fit beside the image.
|
|
961
|
+
|
|
962
|
+
**Media and text**:
|
|
963
|
+
|
|
964
|
+
- With **Advanced layout (columns of 12)**, **Media width** and **Text width**
|
|
965
|
+
in columns of 12 and the **Columns between the media and the text**, from the
|
|
966
|
+
side-by-side width up — as on the carousel split slide. Any one set lays every
|
|
967
|
+
row on a 12-column grid (the media 6 columns and none between unless set, the
|
|
968
|
+
text the rest), mirrored on a row with the media on the right, in place of
|
|
969
|
+
the **Split (media – text)**; for example 5 and 5 columns one column apart.
|
|
970
|
+
- **Heading line height** (with a Custom heading size, *per breakpoint*), a
|
|
971
|
+
**Text weight**, and the **List marker color** of the check and chevron lists
|
|
972
|
+
in every row's text.
|
|
973
|
+
|
|
974
|
+
**Call-to-action card** (with an image):
|
|
975
|
+
|
|
976
|
+
- **Image position when stacked**: **Above the text** (default) or **Below the
|
|
977
|
+
text**; an image inset then runs along the sides and the bottom.
|
|
978
|
+
- **Side by side from** the tablet (768 px, default) or the desktop (1024 px);
|
|
979
|
+
below it the card stacks as on a phone.
|
|
980
|
+
- **Custom image inset (px)** is one value for every breakpoint.
|
|
981
|
+
- **Text size**, *per breakpoint*, with a Custom (px) size; the list follows
|
|
982
|
+
it.
|
|
983
|
+
|
|
984
|
+
**Stats** (with an image): **Side by side from** the tablet (default) or the
|
|
985
|
+
desktop; below it the image sits above the figures.
|
|
986
|
+
|
|
987
|
+
**Carousel split slide**:
|
|
988
|
+
|
|
989
|
+
- **Text indent**, offered with the hanging indent on: **Aligned with the title
|
|
990
|
+
text** starts the text below where the title's text starts, after the
|
|
991
|
+
leading icon and its space. Only a title that starts with an icon is
|
|
992
|
+
indented.
|
|
993
|
+
- **Space between media and text when stacked**, and **Space between the
|
|
994
|
+
title, the text and the controls** (the controls a carousel places inside its
|
|
995
|
+
slides), each a step of the spacing scale.
|
|
996
|
+
|
|
997
|
+
**Image**: with a mobile image, **Mobile image shown on** phones only (below
|
|
998
|
+
768 px, default) or phones and tablets (below 1024 px), as for image fields.
|
|
999
|
+
|
|
1000
|
+
**Heading**: **Max text width**, *per breakpoint* — a named measure or a
|
|
1001
|
+
Custom (px) width; a centred or right-aligned heading keeps its alignment.
|
|
1002
|
+
|
|
1003
|
+
**Rich Content**: **List line height**, *per breakpoint*, with a Custom text
|
|
1004
|
+
size.
|
|
1005
|
+
|
|
1006
|
+
**Accordion**: **Title line height**, *per breakpoint*, with a Custom title
|
|
1007
|
+
size.
|
|
1008
|
+
|
|
1009
|
+
**Product grid** and **Product slider**: the header's **Lead size** (a type
|
|
1010
|
+
token or Custom px, *per breakpoint*), **Lead weight** and **Lead color**.
|
|
1011
|
+
|
|
1012
|
+
**Download tile**: **Title weight**.
|
|
1013
|
+
|
|
1014
|
+
### Type sizes per breakpoint
|
|
1015
|
+
|
|
1016
|
+
A text whose size is a different type token per breakpoint — for example a
|
|
1017
|
+
carousel heading at Heading 3 on phones and Heading 2 on the desktop, a hero
|
|
1018
|
+
title, a section heading or a Heading block — now takes each breakpoint's line
|
|
1019
|
+
height, weight and letter spacing from that breakpoint's token as well (until
|
|
1020
|
+
2026-10-28 they stayed the first breakpoint's). A weight the block sets itself
|
|
1021
|
+
still wins; a line height applies at a Custom (px) breakpoint only.
|
|
1022
|
+
|
|
1023
|
+
### Column gaps, column anchors, row alignment and more options
|
|
1024
|
+
|
|
1025
|
+
As above, every option below is empty by default, a page saved before them
|
|
1026
|
+
looks as it did, and options marked *per breakpoint* are set on the
|
|
1027
|
+
**Responsive** tab.
|
|
1028
|
+
|
|
1029
|
+
**Columns of 12** — on **Media and text**, the **Carousel split slide** and
|
|
1030
|
+
**Stats** (with an image), once a layout on 12 columns is chosen:
|
|
1031
|
+
|
|
1032
|
+
- **Space between columns (px)**, *per breakpoint*. Left empty, the gap is the
|
|
1033
|
+
page's side gutter, as before; set it (for example 16 px) to keep the
|
|
1034
|
+
columns where you place them whatever the gutter.
|
|
1035
|
+
- **Columns aligned to** (**Media and text** and the split slide, with
|
|
1036
|
+
**Advanced layout (columns of 12)**): **The media side** (default) keeps a
|
|
1037
|
+
row with the media on the right ending at column 12 — for example text in
|
|
1038
|
+
columns 2–6 and media in 8–12. **Start (column 1)** starts the pair at column
|
|
1039
|
+
1 on either side — text 1–5 and media 7–11 — and **End (column 12)** ends it
|
|
1040
|
+
at column 12.
|
|
1041
|
+
|
|
1042
|
+
**Row**: **Align columns** (top, middle, bottom) now places the columns on a
|
|
1043
|
+
published page as it does in the editor; until 2026-10-28 each column stretched
|
|
1044
|
+
to the row's height whatever was chosen. A row left on **Stretch** (the
|
|
1045
|
+
default) looks as before. A row saved with `center` — the word **Media and
|
|
1046
|
+
text** uses for the same choice — is read as middle.
|
|
1047
|
+
|
|
1048
|
+
**Call-to-action card**:
|
|
1049
|
+
|
|
1050
|
+
- **Side by side from: Desktop (1024 px)** now keeps a two-column list in one
|
|
1051
|
+
column on a tablet as well, while the card is stacked; a card side by side
|
|
1052
|
+
from the tablet keeps its two columns from 768 px.
|
|
1053
|
+
- **Space below the heading**, a step of the spacing scale (16 px by default).
|
|
1054
|
+
- **Text weight**, and **Max text width** (a named measure or Custom px, *per
|
|
1055
|
+
breakpoint*), for the card's text.
|
|
1056
|
+
|
|
1057
|
+
**Stats**: **Value line height**, *per breakpoint*, with a Custom value size. A
|
|
1058
|
+
breakpoint below the first Custom one keeps the value size's own line height.
|
|
1059
|
+
|
|
1060
|
+
**Media and text**: **Item text size** (a type token or Custom px, *per
|
|
1061
|
+
breakpoint*) and **Item text weight** for every feature item's text (15 px and
|
|
1062
|
+
muted by default).
|
|
1063
|
+
|
|
1064
|
+
**Rich Content**: **Text weight**; its lists follow it.
|
|
1065
|
+
|
|
1066
|
+
**Feature list**:
|
|
1067
|
+
|
|
1068
|
+
- **Icon position** is set *per breakpoint* — for example beside the title on a
|
|
1069
|
+
tablet and above it from 1024 px. One position saved before applies to every
|
|
1070
|
+
breakpoint.
|
|
1071
|
+
- An item's **Width on desktops (columns of 12)**: from 1024 px the list is
|
|
1072
|
+
laid out on 12 columns, that item spans its width and the others keep their
|
|
1073
|
+
share of the **Columns** (for example 6 of 12 with two columns).
|
|
1074
|
+
- **Title weight** was already set per breakpoint.
|
|
1075
|
+
|
|
1076
|
+
**Carousel**, **Product slider**, **Product grid** and **Latest posts**: the
|
|
1077
|
+
header's **Heading line height**, *per breakpoint*, with a Custom heading size;
|
|
1078
|
+
a breakpoint below the first Custom one keeps the heading size's own. **Latest
|
|
1079
|
+
posts** also takes a **Lead weight**.
|
|
1080
|
+
|
|
1081
|
+
**Link list**: **Row title line height**, *per breakpoint*, with a Custom row
|
|
1082
|
+
title size.
|
|
1083
|
+
|
|
1084
|
+
**Newsletter sign-up**: a **Button icon** from the icon catalog after the
|
|
1085
|
+
button's label (none by default).
|
|
1086
|
+
|
|
1087
|
+
**Testimonial**: **Quote size** — a type token or Custom px, *per breakpoint*
|
|
1088
|
+
(1.15 rem by default).
|
|
1089
|
+
|
|
1090
|
+
**Download tile** (with the round icon button): **Icon button icon**, a glyph
|
|
1091
|
+
from the icon catalog — for example the cloud download added to the catalog;
|
|
1092
|
+
left empty, a file's tile shows the download arrow and a link's tile the arrow
|
|
1093
|
+
pointing on.
|
|
1094
|
+
|
|
1095
|
+
### Box margins and padding per breakpoint
|
|
1096
|
+
|
|
1097
|
+
**Outer spacing** (margin) and **Inner spacing** (padding) of every block that
|
|
1098
|
+
has them are set per breakpoint on the **Responsive** tab: choose Base
|
|
1099
|
+
(mobile), Tablet or Desktop in its **Scope settings** and enter the values for
|
|
1100
|
+
that breakpoint, for example 16 px below a heading on phones and 32 px on the
|
|
1101
|
+
desktop. A breakpoint without its own value takes the one below it.
|
|
1102
|
+
|
|
1103
|
+
### Full-width buttons and a chevron "read more"
|
|
1104
|
+
|
|
1105
|
+
- **Full-width buttons.** A **Button** block has a **Width** on the **Responsive** tab: **Fit the
|
|
1106
|
+
label** (the default) or **Full width**, which stretches the button across its box. Set it per
|
|
1107
|
+
breakpoint, for example full width on phones and fitted from the tablet up. The blocks with a
|
|
1108
|
+
list of buttons — **Hero**, **Media and text**, **Call-to-action card**, **Background image
|
|
1109
|
+
panel** and the **Carousel split slide** — have a **Button width** for the whole list:
|
|
1110
|
+
at **Full width** the buttons stack, each across the box. Left unset, the buttons look as before.
|
|
1111
|
+
- **"Read more" as a chevron.** In rich text, put the cursor in a "read more" passage and press
|
|
1112
|
+
**Read more as a chevron** (⌄) in the toolbar. The passage then opens with a bare chevron
|
|
1113
|
+
instead of its summary line, and the chevron turns when it opens. The summary text stays the
|
|
1114
|
+
control's name for screen readers, so keep it meaningful ("Show the details"). In the editor
|
|
1115
|
+
the summary stays visible and editable. Press the button again to go back to the text summary.
|
|
1116
|
+
|
|
1117
|
+
### "Read more" placement, accordion look and highlight colours
|
|
1118
|
+
|
|
1119
|
+
- **Where the "read more" sits.** With the cursor in a "read more" passage, **Read more
|
|
1120
|
+
position** in the rich-text toolbar puts its summary — the text or the chevron — at the
|
|
1121
|
+
**Start** of the line (the default), in the **Center** or at the **End**. **Show the revealed
|
|
1122
|
+
text above the summary** (⤒) makes the passage open upwards: while it is open, its text shows
|
|
1123
|
+
above the summary, which stays the one control under it. Only the order on screen changes:
|
|
1124
|
+
keyboard users and screen readers still meet the summary first, as before. A browser that
|
|
1125
|
+
cannot reorder a "read more" passage shows the text below the summary. In the editor the text
|
|
1126
|
+
stays below the summary, to edit, and an arrow before the summary marks the passage.
|
|
1127
|
+
- **Accordion look.** An **Accordion** block has an **Icon** — **Plus and minus** (the default)
|
|
1128
|
+
or a **Chevron** that turns when its item opens, placed at the end of the title's line —,
|
|
1129
|
+
**Items** — **Plain**, **Boxed** (each item in a bordered box, its title and panel inset
|
|
1130
|
+
from the edge; left unset, the **Style** decides as before: *Bordered* is boxed) or
|
|
1131
|
+
**Filled** (each title on a softly tinted bar taken from the colour scheme — a faint dark
|
|
1132
|
+
tint on the light schemes, a faint light one on the dark scheme — with its panel inset
|
|
1133
|
+
below it, items 8 px apart and no dividers) —,
|
|
1134
|
+
**Dividers** for plain items — **None**, **Between items**, or **Above, between and below**
|
|
1135
|
+
(left unset, the **Style** draws its usual line under each item) — and a **Title padding**
|
|
1136
|
+
above and below each title on the **Responsive** tab: a spacing size or a **Custom** px value
|
|
1137
|
+
per breakpoint (12 px when not set). Every panel is still in the page's HTML, closed panels
|
|
1138
|
+
hidden until opened.
|
|
1139
|
+
- **Accordion title colour, divider and icon size.** **Title color** (a brand colour or a hex
|
|
1140
|
+
value) colours every item's title and its icon; left empty, they keep the text's colour.
|
|
1141
|
+
**Divider position** draws the line of an item that has one **Under the item** (the
|
|
1142
|
+
default) or **Under the title**, so an open item shows its line between the title and the
|
|
1143
|
+
panel; with **Between items** the last title has no line, and boxed items are not affected.
|
|
1144
|
+
**Icon size** is **Small (16 px)**, **Medium (20 px)**, **Large (24 px)** or a **Custom (px)**
|
|
1145
|
+
value; left unset, the icon follows the title's text size as before.
|
|
1146
|
+
- **Accordion spacing and title weight.** On the **Responsive** tab, **Space above the open
|
|
1147
|
+
panel** sets the space between an item's title (or its line, with the line under the title)
|
|
1148
|
+
and its open panel, and **Space between items** the space from one item to the next; each is
|
|
1149
|
+
a spacing size or a **Custom (px)** value per breakpoint. A breakpoint left unset keeps the
|
|
1150
|
+
usual spacing: no space above a panel (12 px under a title line), none between plain items,
|
|
1151
|
+
8 px between boxed or filled ones. **Space below the open panel** sets the space under an open
|
|
1152
|
+
panel's content (12 px when unset), and **Space after an open item** the space from an open
|
|
1153
|
+
item to the next title, used instead of **Space between items** while the item is open (a
|
|
1154
|
+
breakpoint left unset uses the space between items); both are a spacing size or a
|
|
1155
|
+
**Custom (px)** value per breakpoint and open and close with the panel. **Title weight** sets
|
|
1156
|
+
how bold every title is — **Default** (the usual semibold) or a weight from **Light (300)** to
|
|
1157
|
+
**Extra bold (800)** — once for every width or, on the **Responsive** tab, per breakpoint; a
|
|
1158
|
+
breakpoint below the first one with a weight keeps the usual weight.
|
|
1159
|
+
- **Opening and closing animate.** A "read more" passage and an accordion item open and close
|
|
1160
|
+
with a short animation of their height. Visitors who ask their system for reduced motion see
|
|
1161
|
+
them open at once, and so do browsers that cannot animate to a content's own height. An
|
|
1162
|
+
accordion item open when the page loads does not animate in.
|
|
1163
|
+
- **Highlight colours.** In a heading, a block's title or a caption, select a phrase and choose
|
|
1164
|
+
**Highlight colour** in the text's toolbar. Pick one of the **Brand colours** — the phrase
|
|
1165
|
+
then follows the brand screen's colour — or type or pick a **Custom colour (hex)**, and
|
|
1166
|
+
**Apply**. The phrase keeps its highlight style (accent, muted or gradient; accent when it had
|
|
1167
|
+
none) and reads in that colour; a gradient phrase becomes solid text in it. **Remove colour**
|
|
1168
|
+
takes the colour off and keeps the highlight. Choose a colour that keeps the text readable on
|
|
1169
|
+
its background. A translated heading keeps the highlight and its colour on the translated
|
|
1170
|
+
words.
|
|
1171
|
+
|
|
1172
|
+
### The settings panel
|
|
1173
|
+
|
|
1174
|
+
Every block's settings follow the same conventions, so a setting reads and
|
|
1175
|
+
behaves alike wherever it appears:
|
|
1176
|
+
|
|
1177
|
+
- **Order.** The content first, then the layout, the look, spacing and borders,
|
|
1178
|
+
and **Hide on**. A text's **weight** sits next to its **size**, both on the
|
|
1179
|
+
**Responsive** tab, and is set per breakpoint like the size (a weight saved as
|
|
1180
|
+
one value keeps applying at every width).
|
|
1181
|
+
- **Only what applies is shown.** For example the autoplay interval only with
|
|
1182
|
+
**Autoplay** on, the arrows' look only while **Show arrows** is on, the
|
|
1183
|
+
controls' placement only while arrows or dots show, the look of a disabled
|
|
1184
|
+
arrow only for a carousel that does not loop, a carousel image's caption look
|
|
1185
|
+
only once it has a caption, the image side only with an image, a row's
|
|
1186
|
+
**Vertical position** only with a **Minimum height**, the **Divider position**
|
|
1187
|
+
only where the accordion's items have lines, and **Muted** only for a video
|
|
1188
|
+
that does not play automatically (an autoplaying video file is always muted).
|
|
1189
|
+
- **One switch for every on/off setting**, in place of Yes/No choices; it stores
|
|
1190
|
+
the same values, so saved pages are unchanged.
|
|
1191
|
+
- **Alignment is per breakpoint** in the icons, social links, logo strip,
|
|
1192
|
+
feature list, stats, statement, hero and tabs, and reads **Left / Center /
|
|
1193
|
+
Right** everywhere (a side reads **Left / Right**). A value saved before
|
|
1194
|
+
applies at every width.
|
|
1195
|
+
- **Gaps** are a spacing step or **Custom gap (px)**, per breakpoint, in the
|
|
1196
|
+
social links, logo strip, product grid and category grid too; a gap saved as a
|
|
1197
|
+
number of pixels opens as Custom with that number and renders as before.
|
|
1198
|
+
- **Custom values in pixels** read "Custom … (px)", and every custom maximum
|
|
1199
|
+
width takes 160–2000 px.
|
|
1200
|
+
- **Rounded corners** is the name of every corner setting; a block with two of
|
|
1201
|
+
them names each (**Image – rounded corners**, **Caption – rounded corners**).
|
|
1202
|
+
- **Images and videos** offer the **Asset library** first, and a new image starts
|
|
1203
|
+
on it. An image saved with no source and a URL keeps its URL.
|
|
1204
|
+
- **Links** in the image, icon, logo strip, announcement bar and map markers
|
|
1205
|
+
are the same link as a button's: a page, product, category, file, a section
|
|
1206
|
+
of this page or a URL, with **Open in new tab** (shown once the link leads
|
|
1207
|
+
somewhere). A URL saved before reads as a URL link with the same target and
|
|
1208
|
+
renders as before; the editor moves it into the new link when the block is
|
|
1209
|
+
opened. Every URL, here and in the social links, must start with `https://`,
|
|
1210
|
+
`http://`, `mailto:`, `tel:` or `/`, as in every other link: any other address
|
|
1211
|
+
(for example `javascript:`) renders the image, icon, logo or text without a
|
|
1212
|
+
link, and a social link without its address.
|
|
1213
|
+
- **Item open at first** (accordion) and **Tab shown at first** (tabs) are
|
|
1214
|
+
chosen from the items' titles instead of typing a number.
|
|
1215
|
+
- **New blocks follow the section's colours**: a new text and new icons or
|
|
1216
|
+
social links take the section's text colour, and a new announcement bar the
|
|
1217
|
+
brand's primary colour. Blocks already on a page keep theirs. The icons' and
|
|
1218
|
+
social links' **Color** then reads **Inherited (text color)**; picking a
|
|
1219
|
+
colour sets one, and **Inherit** returns to the text colour.
|
|
1220
|
+
- **The settings are translated** in the admin's language, including the
|
|
1221
|
+
settings every block shares (name, **Hide on**, spacing, border, background,
|
|
1222
|
+
corners, shadow, typography), which are translated once for all blocks.
|
|
1223
|
+
|
|
1224
|
+
### Motion
|
|
1225
|
+
|
|
1226
|
+
Motion is opt-in and restrained:
|
|
1227
|
+
|
|
1228
|
+
- **Entrance reveal** of a Section (none or fade-up), and a block-level
|
|
1229
|
+
reveal on the hero and the statement (none, fade-up, or words appearing one
|
|
1230
|
+
by one); each can be limited to desktop.
|
|
1231
|
+
- **Hover zoom** on carousel images, carousel split slides and link tiles.
|
|
1232
|
+
- Carousel autoplay is off unless switched on, pauses on hover and focus, and
|
|
1233
|
+
has a pause button.
|
|
1234
|
+
|
|
1235
|
+
Nothing moves for a visitor who prefers reduced motion, and every text is in
|
|
1236
|
+
the server-rendered HTML and visible before any script runs: the hidden
|
|
1237
|
+
starting state is applied by a script only after the page has loaded, and
|
|
1238
|
+
content already on screen is left as it is. The one exception the page cannot
|
|
1239
|
+
control is an animated SVG chosen as the dark scheme's decorative backdrop: it
|
|
1240
|
+
stops under reduced motion only if the SVG itself says so (see
|
|
1241
|
+
[The decorative backdrop](./brand.md#the-decorative-backdrop)).
|
|
75
1242
|
|
|
76
1243
|
### Preview viewports
|
|
77
1244
|
|
|
@@ -202,8 +1369,8 @@ page render.
|
|
|
202
1369
|
| GET | `/pages` | Paginated Page list with filters. |
|
|
203
1370
|
| POST | `/pages` | Create a Page (always starts as `draft`). |
|
|
204
1371
|
| GET | `/pages/:id` | Detail with full content envelope + version. |
|
|
205
|
-
| PATCH | `/pages/:id` | Edit metadata; honours `If-Match` via `version
|
|
206
|
-
| PUT | `/pages/:id/content/:language` | Save the Page Builder tree per language.
|
|
1372
|
+
| PATCH | `/pages/:id` | Edit metadata, including `parentPageId`, `parentPathInUrl`, `breadcrumbsVisible`, `breadcrumbsScheme`, `breadcrumbsOverlay`, `shareImageAssetId` and `translations` (the per-language name, slug and description, replaced whole); honours `If-Match` via `version`. A cyclic or too-deep parent answers `422 CMS_PAGE_PARENT_CYCLE`; an address another page has answers `409 CMS_SLUG_CONFLICT`. |
|
|
1373
|
+
| PUT | `/pages/:id/content/:language` | Save the Page Builder tree per language. A duplicate or reserved anchor answers `422 CMS_DUPLICATE_ANCHOR` / `CMS_RESERVED_ANCHOR`. |
|
|
207
1374
|
| POST | `/pages/:id/{publish,archive,unarchive}` | Lifecycle transitions. |
|
|
208
1375
|
| DELETE | `/pages/:id` | Hard delete (channels are cascade-unbound). |
|
|
209
1376
|
| Same | `/blocks/*` | Same shape; per-channel-unique `code`; reference-protected on delete. |
|
|
@@ -213,7 +1380,9 @@ page render.
|
|
|
213
1380
|
| PATCH | `/hooks/:id` | Edit name / active / scope; `code` is immutable.|
|
|
214
1381
|
| DELETE | `/hooks/:id` | Refused with 409 when `is_system=true`. |
|
|
215
1382
|
| GET / POST / PATCH / DELETE | `/hooks/:id/attachments[/:blockId]` | Attach / reorder / detach Blocks on a Hook. |
|
|
216
|
-
| GET | `/page-builder/config
|
|
1383
|
+
| GET | `/page-builder/config?salesChannelId=` | Merged Page Builder descriptor (metadata only), with `brandTokens`: the effective brand set of the named channel, or the global set. |
|
|
1384
|
+
| GET | `/brand-tokens?salesChannelId=` | The global set, the named channel's override, the effective set and its contrast warnings. `cms.read`. See [Brand](./brand.md). |
|
|
1385
|
+
| PUT | `/brand-tokens` | Save the global set or one channel's override (`tokens: null` resets it). `cms.brand`. |
|
|
217
1386
|
| GET | `/page-builder/translation` | Translation capability: `ready` (provider, model), `disabled`, `not_configured` or `unavailable`, plus the size limit. `cms.translate`. |
|
|
218
1387
|
| POST | `/page-builder/translate` | Translate a canvas (optionally one component or a selected text) into a language; nothing is stored. `cms.translate`. |
|
|
219
1388
|
|
|
@@ -221,10 +1390,23 @@ page render.
|
|
|
221
1390
|
|
|
222
1391
|
| Method | Path | Returns |
|
|
223
1392
|
| ------ | --------------------------------- | -------------------------------------------------------------- |
|
|
224
|
-
| GET | `/pages/by-slug?slug=…&language=…`| Resolved Page with `embeds.blocks`, `embeds.templates`, assets.|
|
|
1393
|
+
| GET | `/pages/by-slug?slug=…&language=…`| Resolved Page with `embeds.blocks`, `embeds.templates`, assets. `slug` takes the page's whole public path in any of its languages; a nested page's own slug also resolves.|
|
|
225
1394
|
| GET | `/blocks/by-code?code=…&language=…`| Resolved Block (single, channel-filtered, active-only). |
|
|
226
1395
|
| GET | `/hooks/by-code?code=…&language=…`| Ordered active Block list for the named Hook. |
|
|
227
1396
|
|
|
1397
|
+
The resolved Page also carries `path` (its public path in the channel and the
|
|
1398
|
+
served language), `url` (that path as the storefront links it, under the
|
|
1399
|
+
language's path prefix), `alternates` (`{language, url}` for
|
|
1400
|
+
every language it is served in), `name` in the served language,
|
|
1401
|
+
`breadcrumbs` (`visible`, `scheme`, `overlay: true` only when the trail lies
|
|
1402
|
+
over the first section, and the `trail` of ancestors, each
|
|
1403
|
+
`{name, slug, path}` with `slug` and `path` null for one not published in the
|
|
1404
|
+
channel), `share.imageUrl` and `languages`.
|
|
1405
|
+
|
|
1406
|
+
The brand tokens have their own public read,
|
|
1407
|
+
`GET /api/v1/storefront/cms/brand-tokens`: the effective set for the resolved
|
|
1408
|
+
channel, with `cache-control: public, max-age=60`.
|
|
1409
|
+
|
|
228
1410
|
Channel resolution prefers the `X-Sales-Channel` header, then falls back
|
|
229
1411
|
to the system-default channel. Language resolution prefers `?language=`,
|
|
230
1412
|
then `Accept-Language`, then the channel's configured default.
|
|
@@ -269,12 +1451,21 @@ itself by posting the matching tags to the storefront's `/api/revalidate`:
|
|
|
269
1451
|
| Block | `cms:block:<code>`, `cms:page`, `cms:hook` |
|
|
270
1452
|
| Template | `cms:page` |
|
|
271
1453
|
| Hook / attachment | `cms:hook:<code>` |
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
1454
|
+
| Brand settings | `cms:brand` — posted straight after the save commits, not through the event |
|
|
1455
|
+
|
|
1456
|
+
The manual cache flush on the Settings module's cache screen revalidates the
|
|
1457
|
+
same tag through its `cms-brand` namespace.
|
|
1458
|
+
|
|
1459
|
+
A saved or published page is therefore the next request's page: the write
|
|
1460
|
+
dispatches the change in an EventBus scope and answers only once the storefront
|
|
1461
|
+
has dropped the tags, so even a request sent the moment the save returns gets
|
|
1462
|
+
the new content. Revalidation needs `STOREFRONT_BASE_URL` and
|
|
1463
|
+
`REVALIDATE_SECRET` on the backend and **the same** secret on the storefront;
|
|
1464
|
+
without them it is skipped and the 60-second window is the fallback (the first
|
|
1465
|
+
request after the window then still gets the previous render once, while the
|
|
1466
|
+
storefront refetches). It is best-effort: a storefront that cannot be reached,
|
|
1467
|
+
does not answer within 3 seconds, or refuses the call is logged and never fails
|
|
1468
|
+
the save. A refusal with status 401 means the two secrets differ.
|
|
278
1469
|
|
|
279
1470
|
Another module that caches CMS content inside an answer of its own subscribes
|
|
280
1471
|
to the same event through `ctx.subscribe`; `megamenu` does, for the blocks a
|
|
@@ -314,7 +1505,9 @@ declaration, the three renderer layers and the block stylesheet.
|
|
|
314
1505
|
`CMS_PAGE_NOT_FOUND`, `CMS_BLOCK_NOT_FOUND`, `CMS_TEMPLATE_NOT_FOUND`,
|
|
315
1506
|
`CMS_HOOK_NOT_FOUND`, `CMS_SLUG_CONFLICT`, `CMS_CODE_CONFLICT`,
|
|
316
1507
|
`CMS_REFERENCED`, `CMS_HOOK_SYSTEM_PROTECTED`,
|
|
317
|
-
`CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE`, `CMS_SCHEMA_UPGRADE_FAILED`,
|
|
1508
|
+
`CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE`, `CMS_SCHEMA_UPGRADE_FAILED`,
|
|
1509
|
+
`CMS_DUPLICATE_ANCHOR` and `CMS_RESERVED_ANCHOR` (422, with `details.anchor`),
|
|
1510
|
+
`CMS_PAGE_PARENT_CYCLE` (422), and for the
|
|
318
1511
|
translation `CMS_TRANSLATION_DISABLED`, `CMS_TRANSLATION_NOT_CONFIGURED`,
|
|
319
1512
|
`CMS_TRANSLATION_UNAVAILABLE` (409), `CMS_TRANSLATION_TOO_LARGE` (413, with the
|
|
320
1513
|
configured `limit`), `CMS_TRANSLATION_SELECTION_NOT_FOUND` (422) and
|