Konfiguration

Site-Sets (TYPO3 13.4+)

mpc/mp-core ist ein Aggregator, der auf alle oben genannten Elemente angewiesen ist. 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-page (das „base“, „news“, „form“ und „container“ einbindet) ein und fügen Sie mpc/mp-core-seo oder eine andere SEO-Erweiterung hinzu.

Rollen festlegen

 

Wichtig: Beim Erstellen eines benutzerdefinierten Site-Sets dependencies: [mpc/mp-core-base, …] (oder mpc/mp-core-page) – niemals mpc/mp-core. Das Herleiten aus einem untergeordneten Set führt je nach Aggregator zu einem SetRegistry-Rekursions-Deadlock.

 

Verwendung von mp-core mit einer anderen SEO-Erweiterung

Um die Seitenrendering-Funktion von mp-core zusammen mit mpc/mpc-seo (oder einer beliebigen anderen SEO-Erweiterung) zu nutzen, sollten Sie mpc/mp-core-page anstelle von mpc/mp-core. mp-core gibt dann keine SEO-Meta-Tags, Titel-Trennzeichen oder JSON-LD aus: Die Seite sowie das FAQ-/News-JSON-LD von mp-core erfordern die seo.schema.enabled Einstellung, die nur mpc/mp-core-seo definiert.

dependencies:
  - mpc/mp-core-page
  - mpc/mpc-seo

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

Sets aktivieren

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-page
  - 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-base/settings.definitions.yaml und settings.yaml.

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

 

Schema-Standard — default in settings.definitions.yaml (Benutzeroberfläche „Website-Einstellungen“). Ausgelieferter Standardwert – Wert aus settings.yaml wenn es das Schema überschreibt (Spalte — = identisch mit dem 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 eigene Schriftarten selbst hosten (in den Dateimanager hochgeladen oder von dort 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 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 Schriftvariante 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) und den 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> .

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 ü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 Begleitdatei 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.

Import auf die Dokumentations-Website (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

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

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 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 Beschriftungen 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 für alle Beschriftungen LLL:EXT:...-Referenzen
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