docs(35): UI-SPEC copy for inlining, site name and the layout opt-out
- C5: the disable_auto_inline_css switch on the CSS tab with its copy; the CSS comment's inlining is now true - C12: the site_name row after the logo, the changed logo comment and a note on the built-in layouts' header and footer, referencing the decision note that supersedes D-10's inlining claim
This commit is contained in:
@@ -320,6 +320,7 @@ The source value of a file-backed record is the owning plugin's ID as text (for
|
||||
| HTML wrapper label / comment | `mail.layout.html` / `mail.layout.html_comment` | HTML layout / Wraps the HTML message. Put {{ .Content }} where the message goes. | Układ HTML / Otacza wiadomość HTML. Wstaw {{ .Content }} w miejscu treści. |
|
||||
| Text wrapper label / comment | `mail.layout.text` / `mail.layout.text_comment` | Plain-text layout / Wraps the plain-text message. Put {{ .Content }} where the message goes. | Układ tekstowy / Otacza wiadomość tekstową. Wstaw {{ .Content }} w miejscu treści. |
|
||||
| CSS label / comment | `mail.layout.css` / `mail.layout.css_comment` | CSS / Styles for this layout. They are inlined into the HTML message after the branding styles. | CSS / Style tego układu. Są wstawiane do wiadomości HTML po stylach wyglądu. |
|
||||
| Inlining switch label / comment (CSS tab) | `mail.layout.disable_inline_css` / `mail.layout.disable_inline_css_comment` | Do not inline CSS / By default the CSS is also copied into each element's style attribute, so mail clients that drop the style block still show it. Turn this on to keep the style block only. | Nie wstawiaj CSS do elementów / Domyślnie CSS jest też kopiowany do atrybutu style każdego elementu, aby klienty poczty usuwające blok stylów nadal go pokazywały. Włącz, aby zostawić tylko blok stylów. |
|
||||
| Delete confirm (custom layouts only, danger) | `mail.layout.delete_confirm` | Delete this layout? This cannot be undone. A layout that customized templates still use cannot be deleted. | Usunąć ten układ? Tej operacji nie można cofnąć. Nie można usunąć układu, którego używają dostosowane szablony. |
|
||||
|
||||
### Partial form (C6)
|
||||
@@ -421,7 +422,8 @@ The source value of a file-backed record is the owning plugin's ID as text (for
|
||||
|
||||
| Field | Key | EN | PL | Default (Winter) |
|
||||
|-------|-----|----|----|------------------|
|
||||
| `logo` (mailimage) label / comment | `mail.brand.logo` / `mail.brand.logo_comment` | Logo / Layouts show the logo where they use {{ .logoUrl }}. | Logo / Układy pokazują logo tam, gdzie używają {{ .logoUrl }}. | none |
|
||||
| `logo` (mailimage) label / comment | `mail.brand.logo` / `mail.brand.logo_comment` | Logo / The built-in layouts show the logo in their header. Your own layouts show it where they use {{ .logoUrl }}. | Logo / Wbudowane układy pokazują logo w nagłówku. Własne układy pokazują je tam, gdzie używają {{ .logoUrl }}. | none |
|
||||
| `site_name` (text) label / comment | `mail.brand.site_name` / `mail.brand.site_name_comment` | Site name / Shown in the header and footer of the built-in layouts. Leave it empty to use the sender name from mail.from. | Nazwa witryny / Wyświetlana w nagłówku i stopce wbudowanych układów. Zostaw puste, aby użyć nazwy nadawcy z mail.from. | empty (the display name of `mail.from`) |
|
||||
| `body_bg` | `mail.brand.body_bg` | Body background | Główne tło | #f5f8fa |
|
||||
| `content_bg` | `mail.brand.content_bg` | Content background | Tło treści | #ffffff |
|
||||
| `header_color` | `mail.brand.header_color` | Header colour | Kolor górnego nagłówka | #bbbfc3 |
|
||||
@@ -602,7 +604,8 @@ Record title: the layout name. Header subtitle: `mail.layout.name`.
|
||||
| `_preview_html` | mailpreview `mode: layout` | full | `mail.layout.tab_html` | all | Starts on the HTML view |
|
||||
| `content_text` | codeeditor `language: text`, `size: huge` | full | `mail.layout.tab_text` | all | Label `mail.layout.text` + comment |
|
||||
| `_preview_text` | mailpreview `mode: layout` | full | `mail.layout.tab_text` | all | Starts on the Plain text view |
|
||||
| `content_css` | codeeditor `language: css`, `size: huge`, `mailImages: true` | full | `mail.layout.tab_css` | all | Label `mail.layout.css` + comment |
|
||||
| `disable_auto_inline_css` | switch | full | `mail.layout.tab_css` | all | Label `mail.layout.disable_inline_css` + comment. Off by default and for a new custom layout. On, postcard keeps the layout's CSS in its style block only; off, it also copies it onto the elements (CSS inlining, `.planning/notes/2026-11-13-mail-layouts-css-inlining.md`). The previews on this form and the save validation render with the switch's value |
|
||||
| `content_css` | codeeditor `language: css`, `size: huge`, `mailImages: true` | full | `mail.layout.tab_css` | all | Label `mail.layout.css` + comment. The comment's "inlined" is true from 35-06 on: the CSS goes into the style block and onto the elements unless the switch above is on |
|
||||
| `_preview_css` | mailpreview `mode: layout` | full | `mail.layout.tab_css` | all | Starts on the HTML view |
|
||||
| `_file_version` | partial `_file_version.htm` | full | `mail.tab_file_version` | update | C7. Its tab therefore does not exist on create |
|
||||
|
||||
@@ -827,14 +830,17 @@ The group is labelled by the field label (`groupLabelledTypes`).
|
||||
| Row | Left | Right |
|
||||
|-----|------|-------|
|
||||
| 1 | `logo` (mailimage, span full) | — |
|
||||
| 2 | `body_bg` | `content_bg` |
|
||||
| 3 | `header_color` | `footer_color` |
|
||||
| 4 | `heading_color` | `text_color` |
|
||||
| 5 | `link_color` | `button_text_color` |
|
||||
| 6 | `button_primary_bg` | `button_positive_bg` |
|
||||
| 7 | `button_negative_bg` | `panel_bg` |
|
||||
| 8 | `table_border_color` | — |
|
||||
| 9 | `_preview` (mailpreview `mode: branding`, span full, label `mail.preview.label`, comment `mail.brand.preview_comment`) | — |
|
||||
| 2 | `site_name` (text, span left, comment `mail.brand.site_name_comment`) | — |
|
||||
| 3 | `body_bg` | `content_bg` |
|
||||
| 4 | `header_color` | `footer_color` |
|
||||
| 5 | `heading_color` | `text_color` |
|
||||
| 6 | `link_color` | `button_text_color` |
|
||||
| 7 | `button_primary_bg` | `button_positive_bg` |
|
||||
| 8 | `button_negative_bg` | `panel_bg` |
|
||||
| 9 | `table_border_color` | — |
|
||||
| 10 | `_preview` (mailpreview `mode: branding`, span full, label `mail.preview.label`, comment `mail.brand.preview_comment`) | — |
|
||||
|
||||
- **Site name and the built-in layouts (35-06, G-35-8).** The built-in `default` and `system` layouts show a header with the logo (the site name is its alternative text) or, without a logo, the site name, and a footer with `© <year> <site name>` (`© <year>` without a name); `minimal` shows the logo above the message. The site name is saved trimmed, at most 255 characters; left empty, the display name of `mail.from` is used. The Branding preview shows the draft's site name. `.planning/notes/2026-11-13-mail-layouts-css-inlining.md` supersedes D-10's claim that postcard already inlined the brand CSS: from 35-06 on it is inlined onto the elements at render, in the preview, the test send and real mail.
|
||||
|
||||
- The colours are `colorpicker` (C2), with no comments; their labels are self-describing.
|
||||
- The footer is unchanged: Cancel, Save and close, Save.
|
||||
|
||||
Reference in New Issue
Block a user