Konfiguration

Site-Sets (TYPO3 13.4+)

mpc/mp-core ist ein Aggregator, der auf mpc/mp-core-base sowie auf alle Funktionsumfänge. Es reicht aus, nur mpc/mp-core in Ihre Website einzubinden. Wenn Sie eine fein abgestimmte Steuerung benötigen, fügen Sie mpc/mp-core-base und wählen Sie einzelne Funktionsumfänge aus.

Rollen festlegen

 

Wichtig: Beim Erstellen eines benutzerdefinierten Site-Sets muss dependencies: [mpc/mp-core-base, …] — niemals mpc/mp-core. Das Abhängigkeiten von einem untergeordneten Set über den Aggregator herzustellen, führt zu einem SetRegistry-Rekursions-Deadlock.

 

mpc/mp-core-base Abhängigkeiten

Erforderlich: typo3/form, typo3/redirects, typo3/indexed-search

Optional (wird bei Installation verwendet): georgringer/news-recordlinks, georgringer/news-sitemap, mpc/mpc-vidply, mpc/mpc-rss

Aktivieren von Sets

Backend: Site-Verwaltung -> Sites -> Registerkarte „Sets“ -> Sets aktivieren und anordnen.

YAML (config/sites/[site]/config.yaml):

base: 'https://example.com'
rootPageId: 1
dependencies:
  - mpc/mp-core

Oder einzelne Sets gezielt auswählen:

dependencies:
  - mpc/mp-core-base
  - mpc/mp-core-container
  - mpc/mp-core-seo

Website-Einstellungen

Bearbeitbar über Website-Verwaltung → Websites → Einstellungen oder config/sites/[site]/settings.yaml.

Nach Änderungen neu generieren settings.definitions.yaml / settings.yaml:

node Documentation/scripts/sync-site-settings.mjs

Kern (gemeinsam genutzt — mpc/mp-core / registriert über mpc/mp-core-base)

Definitionen und Standardwerte der Website-Einstellungen befinden sich in Configuration/Sets/mp-core/settings.definitions.yaml und settings.yaml. Der Basissatz verweist lediglich auf diese Dateien.

Quelle: Configuration/Sets/mp-core/

 

Schema-Standard — default in settings.definitions.yaml (Benutzeroberfläche „Websiteeinstellungen“). Ausgelieferter Standardwert – Wert aus settings.yaml wenn es das Schema überschreibt (Spalte — = wie im Schema).

 

PIDs

Konfiguration

Leistung

Navigation

Meta

Vorlagen & Pfade

Container (mpc/mp-core-container)

Quelle: Configuration/Sets/mp-core-container/

Nachrichten (mpc/mp-core-news)

Quelle: Configuration/Sets/mp-core-news/

Formular (mpc/mp-core-form)

Quelle: Configuration/Sets/mp-core-form/

SEO (mpc/mp-core-seo)

Quelle: Configuration/Sets/mp-core-seo/

Verwendung von Einstellungen in TypoScript

Website-Einstellungen werden als einfache TypoScript-Konstanten unter ihrem gepunkteten Schlüssel (ohne settings. Präfix), z. B. {$navigation.maxDepth}, {$config.admPanel}, {$PIDs.pidWebFonts}. Die Pfadeinstellungen (pageTemplates, basePath, …) werden zusätzlich mit einem settings. Präfix bereitgestellt, weshalb die mpcSitepackage.* Pfadkonstanten auf {$settings.pageTemplates}.

Bei Werten, die zur Renderzeit aufgelöst werden müssen (z. B. innerhalb config, page.metaoder in DataProcessor-Eigenschaften) lesen Sie diese direkt über den site:settings.* Daten-Getter statt über eine Konstante:

# Flat constant (resolved at TypoScript parse time)
page.10.dataProcessing.110.levels = {$navigation.maxDepth}

# Runtime getter (preferred for config / meta / processor stdWrap)
config.compressJs.data = site:settings.performance.compressJs // {$config.compressJs}
page.meta.robots.data = site:settings.meta.robots

Schriftdesign-Tokens werden nicht über TypoScript verwendet: Sie werden aus den Web-Font-Datensätzen (siehe Web-Fonts) generiert WebFontProcessor und als benutzerdefinierte CSS-Eigenschaften in Resources/Private/Partials/Page/Styles.html.

Web-Fonts

Redakteure können eigene Schriftarten selbst hosten (in den Dateimanager hochgeladen oder von dort ausgewählt), anstatt auf Systemschriftarten zurückzugreifen. Diese Funktion ersetzt die früheren design.fonts.* Zeichenfolgen-Einstellungen.

Datenmodell

Das Feld „Gilt für“ einer Familie ordnet diese einer benutzerdefinierten CSS-Eigenschaft zu:

Editor-Workflow

1. Erstellen Sie einen Systemordner zur Speicherung der Datensätze und legen Sie dessen Seiten-ID in der PIDs.pidWebFonts Website-Einstellung fest. Belassen Sie die Einstellung auf 0 , um die Datensätze auf der Stammseite der Website zu speichern.
2. Erstellen Sie im Listenmodul dieses Ordners eine Web-Schriftfamilie: Geben Sie die Schriftfamilie name (z. B. Inter), einen fallback Stapel (z. B. sans-serif) ein und wählen Sie „Gilt für“ aus.
3. Fügen Sie pro Strichstärke/Stil eine Schriftart hinzu. Laden Sie eine Datei über den Dateimanager hoch oder wählen Sie eine woff2 Datei über den Dateimanager aus und legen Sie die Stärke (100–900) sowie den Stil (normal/kursiv) fest.
4. Leeren Sie den Frontend-Cache. WebFontProcessor erzeugt die @font-face Regeln und die :root Variablenzuordnung in den mit einem Nonce versehenen Inline-Block <style> Block in der Seiten- <head>.

Rendering-Pipeline

Webfont records (FAL files)
  -> WebFontProcessor (page.headerData.2040.dataProcessing.20)
  -> WebFontCssBuilder (validate + sanitize, build @font-face + :root CSS)
  -> {webFontsCss} in Styles.html
  -> <f:asset.css useNonce="1"> + mpc:format.cssSanitize

Alle Werte werden anhand fester Zulassungslisten in Bezug auf WebFontCssBuilder (Gewichtung, Stil, font-display, Dateiformat, benutzerdefinierter Variablenname, unicode-range) überprüft, und der Familienname, der Fallback sowie die URL werden von allen Zeichen bereinigt, die aus der CSS-Deklaration herausfallen könnten, sodass ein von einem Angreifer bereitgestellter Wert niemals aus dem Inline- <style> .

Einschränkungen

• CSP: Selbst gehostete Schriftarten mit fileadmin sind „Same-Origin“ und bereits durch font-src 'self' in Configuration/ContentSecurityPolicies.php. Um Schriftarten von einer anderen Domain bereitzustellen, muss diese Herkunft zu font-src über eine site-spezifische config/sites/<id>/csp.yaml.
• Backend-Berechtigungen: Administratoren können die Einträge sofort bearbeiten. Backend-Gruppen ohne Administratorrechte benötigen tables_modify (und tables_select) für tx_mpcore_domain_model_webfontfamily und tx_mpcore_domain_model_webfontface.
• Eine Familie wird nur ausgegeben, wenn sie mindestens ein Gesicht mit einer auflösbaren Schriftartdatei enthält; andernfalls wird die :root Zuordnung wird übersprungen (der Familienname allein würde nichts laden).

Website-Konfiguration (config.yaml)

Über die Website-Einstellungen hinaus erweitert mp-core den Website-Datensatz und die Website-Sprache durch Configuration/SiteConfiguration/Overrides/sites.php. Konfigurieren Sie diese unter „Site-Verwaltung“ → „Sites“ → [Site] → „Konfiguration“ (oder unter config/sites/[site]/config.yaml).

Sprachspezifische Paletten: copyrightText, Logo-Felder und logoText / logoTextHidden können je nach Sprache der Website variieren.

TypoScript-Struktur

Configuration/
├── ContentSecurityPolicies.php     # Frontend CSP mutations auto-applied when
│                                   # the `security.frontend.*ContentSecurityPolicy`
│                                   # feature toggle is on (see "Content Security
│                                   # Policy" below)
├── Services.yaml                   # PSR-4 autowiring for `Mpc\MpCore\*`; explicit
│                                   # `public: true` for DataProcessors and the
│                                   # `ColorPickerValueItems` itemsProcFunc; optional
│                                   # `Services.local.yaml` import (see below)
├── Services.local.yaml             # (optional, gitignored) local-only DI overrides
├── Sets/
│   ├── mp-core/
│   │   ├── config.yaml               # Aggregator (depends on all feature sets)
│   │   ├── settings.yaml             # Shared Site Settings defaults
│   │   ├── settings.definitions.yaml # Shared Site Settings schema
│   │   ├── constants.typoscript, setup.typoscript, page.tsconfig
│   ├── mp-core-base/
│   │   └── config.yaml               # System deps + pointers to mp-core settings
│   ├── mp-core-container/
│   │   ├── config.yaml, settings.yaml, settings.definitions.yaml
│   │   ├── constants.typoscript, setup.typoscript
│   ├── mp-core-news/
│   │   ├── config.yaml, settings.yaml, settings.definitions.yaml
│   │   ├── constants.typoscript, setup.typoscript
│   ├── mp-core-form/
│   │   ├── config.yaml, settings.yaml, settings.definitions.yaml
│   │   ├── constants.typoscript, setup.typoscript
│   └── mp-core-seo/
│       ├── config.yaml, settings.yaml, settings.definitions.yaml
│       ├── constants.typoscript, setup.typoscript
├── TypoScript/
│   ├── constants.typoscript, setup.typoscript
│   ├── VueComponents.typoscript
│   ├── Helper/PageClass.typoscript
│   ├── Constants/*.typoscript
│   └── Setup/
│       ├── 10.Config, 20.Page, 30.Page.Styles, 40.Page.Scripts
│       ├── 50.Page.Navigation, 60.Lib, 90.CleanupRTE
│       ├── Page/*.typoscript
│       └── ContentElements/tt_content/*.typoscript
└── Extensions/
    ├── constants.typoscript, setup.typoscript

Abhängigkeitsinjektion (Services.yaml)

Configuration/Services.yaml bindet automatisch den Mpc\MpCore\* Namespace und registriert die Dienste, die TYPO3 außerhalb des Containers auflösen muss, als public: true:

Nur lokal gültige DI-Überschreibungen (Services.local.yaml)

Die ausgelieferte Services.yaml importiert eine optionale Schwesterdatei mit ignore_errors: not_found, sodass Projekte lokal begrenzte Dienste (Tooling-Befehle, Ad-hoc-Helfer) registrieren können, ohne die veröffentlichte Datei zu ändern oder die Container-Kompilierung zu unterbrechen, wenn die Datei fehlt:

# Configuration/Services.local.yaml  (gitignored)
services:
  Mpc\MpCore\Command\ImportDocumentationCommand:
    tags:
      - { name: console.command, command: 'docsite:import' }

Configuration/Services.local.yaml ist in .gitignore für genau dieses Muster aufgeführt.

Content Security Policy (ContentSecurityPolicies.php)

Configuration/ContentSecurityPolicies.php enthält eine strenge Frontend-CSP, die von TYPO3 13.4+ automatisch angewendet wird, sobald einer dieser Feature-Toggles aktiviert ist (System -> Einstellungen -> Feature-Toggles):

• security.frontend.enforceContentSecurityPolicy -- Durchsetzungsmodus
• security.frontend.reportContentSecurityPolicy -- Nur-Bericht-Modus

Die mitgelieferte Richtlinie ändert die TYPO3-Frontend-Standardeinstellungen wie folgt:

Überschreibungen pro Website

Betreiber können die Richtlinie pro Website über config/sites/<id>/csp.yaml:

inheritDefault: true
mutations:
  - mode: extend
    directive: img-src
    sources: ["https://cdn.example.com"]
  - mode: extend
    directive: form-action
    sources: ["https://newsletter.example.com"]

Konfiguration der Farbe der Vertrauensgrenze für die Website

Inline-CSS-Variablen in Resources/Private/Partials/Page/Styles.html werden nun über den mpc:format.cssColor ViewHelper weitergeleitet, der an Mpc\MpCore\Service\CssColorValidator. Es werden nur syntaktisch gültige CSS-Farben (benannte, #rgb[a], #rrggbb[aa], rgb()/rgba()/hsl()/hsla()) ausgegeben; fehlerhafte oder von Angreifern bereitgestellte Website-Konfigurationseinträge werden stillschweigend verworfen, sodass sie niemals aus dem Inline- <style> .

Derselbe Validator wird auch in Mpc\MpCore\UserFunc\ColorPickerValueItems , sodass das Dropdown-Menü des Backend-Farbwählers ebenfalls ungültige Slots herausfiltert und die Bezeichnungen auf 200 Zeichen begrenzt.

Konfiguration des Vorlagenpfads

page.10 = FLUIDTEMPLATE
page.10 {
  templateRootPaths {
    0 = EXT:mp_core/Resources/Private/Templates/Page/
    10 = {$settings.pageTemplates}
  }
  partialRootPaths {
    0 = EXT:mp_core/Resources/Private/Partials/
    10 = {$settings.pagePartials}
  }
  layoutRootPaths {
    0 = EXT:mp_core/Resources/Private/Layouts/
    10 = {$settings.pageLayouts}
  }
}

Pfadpriorität: 0 = Kern, 10 = Erweiterung, 20+ = Projekt. Höhere Zahlen haben Vorrang vor niedrigeren.

Überschreibungen durch Erweiterungen

plugin.tx_news.view.templateRootPaths.10 = EXT:mp_core/Resources/Extensions/news/Templates/
plugin.tx_form.view.templateRootPaths.10 = EXT:mp_core/Resources/Extensions/form/Templates/
plugin.tx_indexedsearch.view.templateRootPaths.10 = EXT:mp_core/Resources/Extensions/indexed_search/Templates/

Bedingte Konfiguration

Navigationsbündel hängen vom Feld „Site-Konfiguration“ ab navType (siehe Configuration/SiteConfiguration/Overrides/sites.php):

[traverse(site("configuration"), "navType") == "1"]
  page.includeJSFooter.navigationPrimary = EXT:mp_core/Resources/Public/JavaScripts/navigationPrimary.js
[END]

TCA-Überschreibungen

Schnellübersicht

Seitenfelder (pages.php)

Globaler Link-Assistent (tt_content_00_base.php)

Palette: link_config

Benutzerdefinierte Inhaltselemente

Dateimetadaten / Verweise

Häufige Anpassungsmuster

Hinzufügen eines Feldes zu einem bestehenden Element

$myColumns = [
    'tx_my_field' => [
        'label' => 'My Field',
        'config' => ['type' => 'input', 'size' => 30],
    ],
];
ExtensionManagementUtility::addTCAcolumns('tt_content', $myColumns);
ExtensionManagementUtility::addToAllTCAtypes('tt_content', 'tx_my_field', 'textmedia', 'after:bodytext');

Datenbankschema

Fügen Sie Spalten hinzu ext_tables.sqlund führen Sie anschließend „Admin-Tools“ -> „Wartung“ -> „Datenbankstruktur analysieren“ aus.

CREATE TABLE tt_content (
    tx_my_field varchar(255) DEFAULT '' NOT NULL
);

Tipps

1. Verwenden Sie vorhandene Paletten aus tt_content_00_base.php und tt_content_00_header.php
2. Fügen Sie benutzerdefinierten Feldern das Präfix tx_ , um Konflikte zu vermeiden
3. Verwenden Sie „LLL:EXT:...“-Referenzen für alle Beschriftungen
4. Verwenden Sie „displayCond“ für die bedingte Sichtbarkeit von Feldern: 'displayCond' => 'FIELD:my_toggle:=:1'
5. Verwenden Sie „Site Settings“ anstelle von fest codierten TypoScript-Werten
6. Beachten Sie die Pfadnummerierung: 0 (Kern), 10 (Erweiterung), 20+ (Projekt)

Weiterführende Informationen

• Backend – RTE, Seite „TSconfig“, Inhaltsvorschau
• Inhaltselemente – TCA-Feldreferenz pro CType
• Frontend – Build-System und Asset-Pipeline
• Favicons – Favicon-Generierung
• TYPO3-TCA-Referenz
• TYPO3-Site-Sets
• TYPO3-TypoScript-Referenz
• b13/container