TYPO3 Content Blocks und PHP 8.4 Property Hooks: Weniger Code, mehr Kontrolle

Entwickeln Sie Erweiterungen für TYPO3? Dann kennen Sie vielleicht dieses Problem. Ein neues Feld in der Datenbank braucht Änderungen an fünf Stellen. Das kostet sehr viel Zeit. Dabei passieren leicht Fehler. Und die Arbeit ist oft sehr mühsam.

Die gute Nachricht: Zwei neue Wege lösen dieses Problem. Der erste Weg sind Content Blocks für Daten. Der zweite Weg sind PHP 8.4 Property Hooks für Modelle. Beide zusammen sparen bis zu 80 Prozent vom Standard-Code.

Wichtige Begriffe  

Wir erklären zuerst einige wichtige Begriffe:

Inhaltsverzeichnis  

Was Sie sich an Arbeit sparen  

Hier ist eine kurze Übersicht. Welchen Vorteil haben Sie durch Content Blocks?

Das Bild zeigt die Arbeit in Prozent. 1 Prozent bedeutet: Alles passiert automatisch. Ein kleiner Wert ist besser.

Content Blocks installieren  

Sie installieren die Erweiterung in wenigen Schritten. Sie können Composer nutzen. Oder Sie nutzen den Extension Manager.

# Content Blocks Erweiterung installieren
composer require friendsoftypo3/content-blocks

# Caches leeren und Datenbank neu laden
vendor/bin/typo3 cache:flush -g system
vendor/bin/typo3 extension:setup

Neue Inhalts-Typen mit der Kommando-Zeile machen  

Es gibt den Befehl make:content-block. Er baut auf einer bekannten Erweiterung auf. Der Befehl macht sofort die ganze Struktur für einen neuen Content Block.

Hilfe durch das Programm  

# Starten Sie das Programm. Es hilft Ihnen bei allen Fragen.
vendor/bin/typo3 make:content-block

Direkter Befehl  

# Inhalts-Element auf einmal machen
vendor/bin/typo3 make:content-block \
  --content-type="content-element" \
  --vendor="webconsulting" \
  --name="team-member" \
  --title="Team Member" \
  --extension="my_sitepackage"

Diese Optionen gibt es  

Nach der Arbeit  

# Caches leeren (sehr wichtig!)
vendor/bin/typo3 cache:flush -g system

# Datenbank aktualisieren
vendor/bin/typo3 extension:setup --extension=my_sitepackage

Das Problem: Verstreute Daten  

Früher war das bei TYPO3 so. Ein einziges Feld stand in vielen verschiedenen Dateien:

Sie müssen jede Änderung mit der Hand eintragen. Vergessen Sie eine Stelle? Dann passen die Datenbank und das Formular nicht mehr zusammen. Das führt zu vielen Fehlern.

Die Lösung: YAML-Dateien als einziger Ort für Daten  

Mit Content Blocks schreiben Sie alles nur noch an einen Ort. Sie schreiben dort die Struktur und die Regeln auf. Die Erweiterung macht daraus automatisch diese Dinge:

Der größte Vorteil  

Warum ein einziger Ort für Daten heute so wichtig ist  

Künstliche Intelligenz liest heute oft den Code. Sie schreibt den Code auch um. Darum muss der Code sehr gut geordnet sein. Viele Studien zeigen ein Problem. 65 Prozent der Programmierer haben oft zu wenig Informationen beim Arbeiten. Das ist bei verstreutem Code noch viel schlimmer.

"KI-Programme brauchen einen guten Überblick über den Code. Nur so schreiben sie guten Code. Ist der Code schlecht geordnet? Dann macht die KI viele Fehler."

— PropelCode: Code für KI-Werkzeuge ordnen

Code-Beispiel: Team-Mitglied als Inhalts-Element  

Hier ist ein Beispiel für ein Team-Mitglied. Sie brauchen nur eine YAML-Datei:

# ContentBlocks/ContentElements/team-member/config.yaml
name: vendor/team-member
title: Team Member
description: Display a team member profile

fields:
  - identifier: full_name
    type: Text
    label: Full Name
    required: true
    
  - identifier: position
    type: Text
    label: Position / Role
    
  - identifier: email
    type: Email
    label: Email Address
    
  - identifier: biography
    type: Textarea
    label: Short Biography
    enableRichtext: true

Record Types: Eigene Daten machen  

Content Blocks machen nicht nur Elemente in tt_content. Mit Record Types machen Sie eigene Tabellen in der Datenbank. Das ist perfekt für Nachrichten, Produkte oder Termine.

Content Elements und Record Types im Vergleich  

Richtige Namen für Tabellen  

Wichtig: Sie müssen die Namen richtig wählen. Nutzen Sie die Regel tx_extensionkey_domain_model_*. Nur dann funktionieren die Extbase-Programme richtig.

# Guter Name für Extbase
table: tx_mysitepackage_domain_model_news

Beispiel: Nachrichten als Record Type  

Hier ist ein Beispiel für Nachrichten in einer YAML-Datei:

# ContentBlocks/RecordTypes/news-article/config.yaml
name: myvendor/news-article
table: tx_mysitepackage_domain_model_news
labelField: title
languageAware: true
sortable: true
softDelete: true
trackCreationDate: true
trackUpdateDate: true
restriction:
  disabled: true
  startTime: true
  endTime: true
security:
  ignorePageTypeRestriction: true
fields:
  - identifier: title
    type: Text
    required: true
  - identifier: teaser
    type: Textarea
  - identifier: bodytext
    type: Textarea
    enableRichtext: true
  - identifier: image
    type: File
    allowed: common-image-types
    maxitems: 1
  - identifier: publish_date
    type: DateTime
  - identifier: author
    type: Text

Page Types: Eigene Seiten-Typen machen  

Page Types geben der Tabelle für Seiten neue Typen. Das ist sehr gut für Blog-Texte, Startseiten oder Nachrichten-Seiten.

Wann Sie Page Types nutzen  

Beispiel: Blog-Artikel als Page Type  

# ContentBlocks/PageTypes/blog-article/config.yaml
name: myvendor/blog-article
typeName: 1705234567   # Eine genaue Zeit-Nummer
group: default
fields:
  - identifier: author_name
    type: Text
    label: Autor
  - identifier: teaser_text
    type: Textarea
    label: Teaser
  - identifier: hero_image
    type: File
    allowed: common-image-types
    maxitems: 1
  - identifier: publish_date
    type: DateTime
    label: Datum

Anzeige auf der Internetseite  

Page Types zeigen den Inhalt nicht von alleine. Sie müssen diesen Code nutzen:

page.10 = FLUIDTEMPLATE
page.10 {
    dataProcessing {
        1 = content-blocks
    }
}

Danach können Sie alle Felder in der Vorlage nutzen. Zum Beispiel {data.author_name} oder {data.hero_image}.

File Types: Mehr Daten für Dateien  

File Types geben der Tabelle für Dateien neue Felder. Das ist perfekt für den Namen vom Fotografen oder für Bildrechte.

Diese Datei-Typen gibt es  

Beispiel: Mehr Daten für Bilder  

# ContentBlocks/FileTypes/image-extended/config.yaml
name: myvendor/image-extended
typeName: image
prefixFields: false
fields:
  - identifier: image_overlay_palette
    type: Palette
    label: Mehr Optionen für Bilder
    fields:
      - identifier: alternative
        useExistingField: true
      - identifier: description
        useExistingField: true
      - type: Linebreak
      - identifier: photographer
        type: Text
        label: Fotograf
      - identifier: copyright
        type: Text
        label: Rechte
      - type: Linebreak
      - identifier: crop
        useExistingField: true

PHP 8.4: Property Hooks machen den Code kürzer  

Früher gab es im Code sehr viele Getter-Methoden und Setter-Methoden. Das sind bestimmte Funktionen zum Lesen und Schreiben. PHP 8.4 Property Hooks ändern das komplett.

Der Wechsel  

<?php
declare(strict_types=1);

namespace Vendor\TeamExtension\Domain\Model;

class TeamMember
{
    // Einfache Eigenschaft ohne Regeln
    public string $position = '';
    
    // Eigenschaft mit Änderung
    public string $fullName {
        get => strtoupper($this->fullName);
        set(string $value) => $this->fullName = trim($value);
    }
    
    // Eigenschaft mit Prüfung
    public string $email {
        set(string $value) {
            if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
                throw new \InvalidArgumentException('Falsche E-Mail');
            }
            $this->email = strtolower($value);
        }
    }
    
    // Virtuelle Eigenschaft ohne Spalte in der Datenbank
    public string $slug {
        get => str_replace(' ', '-', strtolower($this->fullName));
    }
}

Die Vorteile von Property Hooks  

Das können Sie mit Property Hooks machen  

Das perfekte Team: Content Blocks und Property Hooks  

Beide Techniken zusammen teilen die Arbeit klar auf:

Das Ergebnis:

• YAML bestimmt die Datenstruktur an einem Ort.
• PHP Modelle enthalten nur noch die Logik der Anwendung.
• Kein Standard-Code mehr für TCA, SQL oder Getter.

Weitere Befehle für die Kommando-Zeile  

Content Blocks hat noch weitere nützliche Befehle:

# Alle Content Blocks anzeigen
vendor/bin/typo3 content-blocks:list

# Sprach-Dateien machen
vendor/bin/typo3 content-blocks:language:generate

# Dateien kopieren
vendor/bin/typo3 content-blocks:assets:publish

Mehrere Sprachen nutzen  

Content Blocks macht Mehrsprachigkeit sehr einfach. Sie verwalten alle Übersetzungen zentral. Das passiert in einer labels.xlf Datei.

Struktur der Ordner  

ContentBlocks/ContentElements/hero-banner/
├── config.yaml
├── language/
│   ├── labels.xlf          # Standard-Sprache
│   └── de.labels.xlf       # Deutsche Sprache
└── templates/
    └── frontend.html

Texte in Vorlagen nutzen  

<!-- Zugriff auf labels.xlf -->
<f:translate key="{cb:languagePath()}:my_label"/>

<!-- Text aus einem anderen Content Block -->
<f:translate key="{cb:languagePath(name: 'vendor/other-block')}:shared_label"/>

Mehrere Sprachen für Record Types  

Sie müssen languageAware in der config.yaml einschalten:

name: myvendor/news-article
table: tx_mysitepackage_domain_model_news
labelField: title
languageAware: true   # Schaltet Übersetzungen ein

Werkzeuge und Hilfen  

Fazit: Jetzt anfangen und später Zeit sparen  

Das Team aus TYPO3 Content Blocks und PHP 8.4 Property Hooks ist sehr stark. Es spart Ihnen viel Zeit beim Programmieren. Und Sie können Ihre Systeme später viel leichter pflegen.