Backend

TYPO3-Backend-Integration für mpc/mp-core: Seite TSconfig, RTE-Voreinstellung, Backend-CSS, Inhaltsvorschau, Backend-Layouts und PHP-Helfer für den Editor.

Übersicht

Bereich	Ort	Zweck
Seite TSconfig	`Configuration/Sets/mp-core/page.tsconfig`	Wird über Site Set geladen; importiert alle Backend-/Editor-TSconfig-Dateien
RTE-Voreinstellung	`Configuration/RTE/Default.yaml`	Als globale Voreinstellung registriert `default` in `ext_localconf.php`
Backend-CSS	`Resources/Public/StyleSheets/backend.css`	TYPO3-Backend-UI-Anpassungen (Vite-Eintrag `backend.js`)
CKEditor-CSS	`Resources/Public/StyleSheets/ckeditor.css`	WYSIWYG-Darstellung im Backend + RTE-Ausgabe im Frontend
CKEditor-Plugin	`Resources/Public/JavaScripts/ckeditor/definition-list.js`	Plugin für die Symbolleiste der Definitionsliste
Vorschau-Renderer	`Classes/Preview/CustomContentPreviewRenderer.php`	Vorschau des Seitenmodul-Inhalts
Backend-Layouts	`Configuration/TsConfig/Page/Mod/WebLayout/BackendLayouts/`	Web > Struktur der Spaltenpositionen auf der Seite
Formular-YAML	`Resources/Extensions/form/Yaml/BaseSetup.yaml`	EXT:Form-Styling (wenn `form` geladen wird)

Seite TSconfig

Registriert über das Site Set (Configuration/Sets/mp-core/page.tsconfig):

@import 'EXT:mp_core/Configuration/TsConfig/Page/ContentElement/All.tsconfig'
@import 'EXT:mp_core/Configuration/TsConfig/Page/Mod/WebLayout/BackendLayouts.tsconfig'
@import 'EXT:mp_core/Configuration/TsConfig/Page/RTE.tsconfig'
@import 'EXT:mp_core/Configuration/TsConfig/Page/TCADefaults.tsconfig'
@import 'EXT:mp_core/Configuration/TsConfig/Page/TCEMAIN.tsconfig'
@import 'EXT:mp_core/Configuration/TsConfig/Page/TCEFORM.tsconfig'

`TCEFORM.tsconfig`

Formularverhalten für den Editor für pages und tt_content:

Seiten: layout — nur „Standard“ (Elemente 1–4 entfernt).
Inhalt: Blendet ungenutzte Kern-CTypes aus (bullets, mehrere menu_*, textmedia, table, …).
Kopfzeilen: erweiterte header_layout Bezeichnungen (Punkte 6–12); Standard-TYPO3-Layout 0 entfernt.
Frames: frame_class und linkToTop global deaktiviert.
Überschreibungen pro CType (z. B. menu_subpages Link-Felder) – siehe Datei für vollständige Liste.

`TCADefaults.tsconfig`

Standardwerte beim Anlegen von Datensätzen, z. B. tt_content.filelink_size = 1, imagecols = 1.

`TCEMAIN.tsconfig`

Standardberechtigungsflags für neue Inhalte (Bearbeitungsrechte für Gruppen/Benutzer).

Assistenten für Inhaltselemente

Configuration/TsConfig/Page/ContentElement/Element/*.tsconfig registriert neue Einträge im Assistenten für Inhaltselemente:

Datei	CType
`Gallery.tsconfig`	`gallery`
`Stage.tsconfig`	`stage`
`Banner.tsconfig`	`banner`
`Singleteaser.tsconfig`	`singleteaser`

Container-CTypes (ce_*) werden von b13/container TCA registriert, nicht durch separate Assistenten-TSconfig-Dateien.

Backend-Layouts

Mod/WebLayout/BackendLayouts/Default.tsconfig und Article.tsconfig definieren die Spaltenstruktur für das Seitenmodul:

Layout	Datei	Typische Spaltenpositionen
Standard	`Default.tsconfig`	4 (Logos oben), 0 (oben), 1 (Hauptbereich), 2 (unten)
Artikel	`Article.tsconfig`	Artikelspezifische Bereiche

SVG-Symbole: Resources/Public/BackendLayouts/.

RTE (CKEditor 5)

Registrierung

// ext_localconf.php
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['default'] = 'EXT:mp_core/Configuration/RTE/Default.yaml';

Seite TSconfig wählt die Voreinstellung aus:

// Configuration/TsConfig/Page/RTE.tsconfig
RTE.default.preset = default

Tag-Neuzuordnung in derselben Datei: b → strong, i → em, s → del (RTE und DB-Parser).

Stylesheets

Konstante	Datei
`BE.stylesheets.mp_core_backend`	`Resources/Public/StyleSheets/backend.css`
`BE.stylesheets.mp_core_ckeditor`	`Resources/Public/StyleSheets/ckeditor.css`

Neu erstellen mit npm run build nach Build/ nach SCSS-Änderungen.

Voreingestellte Hervorhebungen (`Configuration/RTE/Default.yaml`)

contentsCss: ckeditor.css — Der Editor spiegelt die Frontend-Typografie und -Schaltflächen wider.
Symbolleiste: Überschriften, Stile, Sprache, Listen (inkl. Definitionsliste), Tabellen, Quelltextbearbeitung usw.
Stil-Plugin: Bootstrap-Schaltflächen, Kicker/Lead, Blockzitate, Klassen für Überschriftenebenen, Klassen für Linktypen, Text-Hilfsfunktionen.
Listen-Eigenschaften: benutzerdefinierte Stile, Startindex, umgekehrte Reihenfolge.
Definitionslisten-Plugin: benutzerdefiniertes Modul @mpc/mp-core/ckeditor/definition-list.js (siehe Configuration/JavaScriptModules.php).
Zulässige Link-Klassen: internal-link, external-link, download, email, phone, audio, video, glossary, public, legal, gallery, chart.
Verarbeitung: zusätzliche zulässige Tags (figure, figcaption, dl, dt, dd, …).

Bezeichnungen: Resources/Private/Language/locallang_rte.xlf.

Frontend-RTE-Ausgabe

TypoScript lib.parseFunc_RTE in Configuration/TypoScript/Setup/60.Lib.typoscript und 90.CleanupRTE.typoscript Steuerung der HTML-Sanitisierung und -Umbrüche im Frontend.

Inhaltsvorschau (`CustomContentPreviewRenderer`)

Global registriert unter tt_content:

// Configuration/TCA/Overrides/tt_content_00_base.php
$GLOBALS['TCA']['tt_content']['ctrl']['previewRenderer'] =
    \Mpc\MpCore\Preview\CustomContentPreviewRenderer::class;

Verhalten:

Delegiert an TYPO3s StandardContentPreviewRenderer , sofern möglich.
Erfasst TypeError aus den Core-Vorschau-Tools ab (fehlende Dateiverweise, Null-Sanitization) und rendert einen Fallback: optionales 150×150-Bild-Thumbnail, Header, Subheader, Text-Auszug (200 Zeichen).
Als vorübergehende Lösung gedacht, bis Randfälle in der Core-Vorschau behoben sind.

PHP-Backend-Helfer

Klasse	Rolle
`UserFunc\ColorPickerValueItems`	`itemsProcFunc` für `grid_bgcolor` — Erstellt Farboptionen aus der Website-Konfiguration `color-*` Schlüssel
`Backend\Form\Container\FilesControlContainer`	Dateifeld-Container; leitet `fieldInformation` an untergeordnete Felder
`Preview\CustomContentPreviewRenderer`	Siehe oben

Registriert in Configuration/Services.yaml (ColorPickerValueItems ist public: true für TCA-Callbacks).

Inhaltsblöcke (Backend-Editor)

Definitionsliste — ContentBlocks/ContentElements/definitionlist/

Element	Wert
`name`	`dl/definitionlist`
`typeName`	`definitionlist`
Gruppen	`lists`

Felder (Inhaltsblöcke-Schema):

Feld	Typ	Anmerkungen
`TYPO3/Header`	Grundlegend	Verwendet Kern-Kopfzeilenfelder
`radioboxes`	Radio	`0` = untereinander, `1` = nebeneinander
`item`	Sammlung	Begriff (`text`) + Definition (`textarea`, RTE aktiviert)
`TYPO3/Appearance`	Grundlegende	Rahmen, Abstände

Vorlagen:

Frontend: templates/frontend.html
Vorschau im Backend: templates/backend-preview.html

Inhaltsblöcke werden bereitgestellt von friendsoftypo3/content-blocks (Composer-Abhängigkeit).

Icons

Configuration/Icons.php registriert SVG-Symbole für CTypes und Container (tx_gallery, tx_stage, ce_accordion, …) registriert, die im Assistenten für neue Inhalte und im Seitenbaum verwendet werden.

Zugehörige Dokumentation

Inhaltselemente – TCA-Felder und Vorlagen pro CType
Konfiguration – Site-Einstellungen, Site- config.yaml Felder
Frontend – Vite-Build für backend.css / ckeditor.css