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 Funktionssätze aus.

Rollen festlegen

 

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

 

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 „Site-Einstellungen“). Ausgelieferter Standardwert – Wert aus settings.yaml wenn es das Schema überschreibt (Spalte — = wie im Schema).

 

PIDs

Konfiguration

Leistung

Navigation

Suche

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}.

Für Werte, 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 benutzerdefinierte Schriftarten selbst hosten (in den Dateimanager hochgeladen oder daraus ausgewählt), anstatt auf Systemschriftarten zurückzugreifen. Diese Funktion ersetzt die bisherigen 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 ein 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 Schriftstärke/Schriftart eine Schriftart hinzu. Laden Sie eine woff2 Datei über den Dateimanager aus und legen Sie deren Stärke (100–900) und Stil (normal/kursiv) fest.
4. Leeren Sie den Frontend-Cache. WebFontProcessor generiert 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 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 vom Angreifer bereitgestellter Wert niemals aus dem Inline- <style> Block entkommen.

Einschränkungen

• CSP: Selbst gehostete Schriftarten in fileadmin sind „Same-Origin“ und bereits durch font-src 'self' in Configuration/ContentSecurityPolicies.php. Um Schriftarten von einer anderen Domain bereitzustellen, muss diese Herkunft 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 das :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 um 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 führt automatisch das 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 mitgelieferte Services.yaml importiert eine optionale Schwesterdatei mit ignore_errors: not_found, sodass Projekte lokal begrenzte Dienste (Ad-hoc-Helfer, umgebungsspezifische Verknüpfungen) 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:
  # Example: register a local-only helper or override a service binding.

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

Projekt-Tooling (bin/)

Projektinterne Skripte befinden sich in mpcore/bin/ (außerhalb jeglicher Erweiterungs-Repositorys). Vollständige Befehlsreferenz: mpcore/README.md.

Import auf die Doku-Seite (bin/docsite-import.php)

php bin/docsite-import.php
php bin/docsite-import.php --dry-run
ddev exec php bin/docsite-import.php --dry-run

Von docs-site/: npm run import / npm run import:dry (umschließt dasselbe Skript).

XLF-Sortierung (bin/sort-xlf.php)

php bin/sort-xlf.php
php bin/sort-xlf.php --dry-run --package=mp-core
ddev exec php bin/sort-xlf.php

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-Berichts-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"]

Vertrauensgrenze für die Farbkonfiguration der Website

Inline-CSS-Variablen werden 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 vom Angreifer 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 Felder 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 den 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-Einstellungen“ anstelle von fest programmierten 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