Konfiguration

Site Sets (TYPO3 13.4+)

mpc/mp-core ist ein Aggregator, der auf mpc/mp-core-base sowie allen Funktionsumfängen. Es reicht aus, mpc/mp-core in Ihre Website einzubinden. Wenn Sie eine feinere Steuerung benötigen, fügen Sie mpc/mp-core-base und wählen Sie einzelne Funktionssätze aus.

Rollen festlegen

 

Wichtig: Wenn Sie ein benutzerdefiniertes Site-Set erstellen, setzen Sie dependencies: [mpc/mp-core-base, …] — niemals mpc/mp-core. Das Abhängigmachen vom Aggregator eines untergeordneten Sets 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

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 auswählen:

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

Website-Einstellungen

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

Nach Änderung 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 Standardeinstellungen der Website-Einstellungen befinden sich in Configuration/Sets/mp-core/settings.definitions.yaml und settings.yaml. Das Basisset 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

Flüssige Wurzelpfade

Inhalt

Konfiguration

Leistung

Design

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

# Constants
mpCore.design.primaryColor = {$settings.design.colors.primary}

# Setup
page.10.templateRootPaths.10 = {$settings.pageTemplates}

Site-Konfiguration (config.yaml)

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

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

TypoScript-Struktur

Configuration/
├── RequestMiddlewares.php          # HtmlWhitespaceCompressorMiddleware
├── Services.yaml
├── 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

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.

Erweiterungsüberschreibungen

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

Navigations-Bundles 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 / Referenzen

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-Einstellungen anstelle von fest codierten TypoScript-Werten
6. Beachten Sie die Pfadnummerierung: 0 (Kern), 10 (Erweiterung), 20+ (Projekt)

Weiterführende Literatur

• 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