Das Contao 5 DCA (Data Container Array) ist der Schlüssel, um deine Datenbank-Entities im Backend bearbeitbar zu machen. Deine Datenbank steht zwar dank Doctrine aus Teil 2, aber wie kommen die Daten da rein? Sicher nicht über phpMyAdmin. Dein Kunde – der Strandkorb-Vermieter in Binz – braucht eine saubere Oberfläche.

Hier zeigt das Contao 5 DCA seine Stärke. Es ist eine der mächtigsten Funktionen des CMS und generiert aus einem PHP-Array vollautomatisch Formulare, Listen, Sortierfunktionen und Suchfilter.

Der Gamechanger im Contao 5 DCA: Früher hast du im DCA auch die Datenbank-Felder definiert ('sql' => "varchar(255)..."). Das machen wir nicht mehr! Da wir Entities nutzen, kümmert sich Doctrine um die Datenbank. Das Contao 5 DCA kümmert sich nur noch um die Optik (UI).

Das ist der Plan für dein Contao 5 DCA:

Die Datei am richtigen Ort anlegen.
Die Listenansicht konfigurieren.
Die Paletten und Felder definieren.
Cache leeren und das Ergebnis feiern.

1. Die Datei: Wo gehört das DCA hin?

Contao sucht in Bundles automatisch im Ordner contao/dca. Damit dein Contao 5 DCA geladen wird, musst du die Datei korrekt benennen. Erstelle diesen Ordner in deinem Bundle. Der Dateiname muss exakt so heißen wie deine Tabelle.

Pfad: /src/BeachsideBundle/contao/dca/tl_beach_chair.php

2. Die Grundkonfiguration (Config & List)

Wir starten mit dem Rahmen für das Contao 5 DCA. Kopiere diesen Code in die Datei. Wir sagen dem System, dass es sich um eine Tabelle handelt (Table) und wie die Datensätze aufgelistet werden sollen.

PHP

<?php

use Contao\DC_Table;

$GLOBALS['TL_DCA']['tl_beach_chair'] = [
    // 1. Konfiguration
    'config' => [
        'dataContainer' => DC_Table::class,
        'enableVersioning' => true,
        'sql' => [
            'keys' => [
                'id' => 'primary',
            ],
        ],
    ],

    // 2. Listenansicht (Das Grid)
    'list' => [
        'sorting' => [
            'mode' => 1, // Sortierung nach einem festen Feld
            'fields' => ['chairNumber'], // Sortiere nach Nummer
            'flag' => 1, // Aufsteigend
            'panelLayout' => 'filter;search,limit', // Suchfeld und Filter oben anzeigen
        ],
        'label' => [
            'fields' => ['chairNumber', 'title', 'pricePerDay'],
            'showColumns' => true, // Tabellarische Ansicht
            'format' => '%s - %s [%s Cent]', // Platzhalter für die Ausgabe
        ],
        'global_operations' => [
            'all' => [
                'label' => &$GLOBALS['TL_LANG']['MSC']['all'],
                'href' => 'act=select',
                'class' => 'header_edit_all',
                'attributes' => 'onclick="Backend.getScrollOffset()" accesskey="e"'
            ],
        ],
        'operations' => [
            'edit' => [
                'href' => 'act=edit',
                'icon' => 'edit.svg',
            ],
            'delete' => [
                'href' => 'act=delete',
                'icon' => 'delete.svg',
                'attributes' => 'onclick="if(!confirm(\'' . ($GLOBALS['TL_LANG']['MSC']['deleteConfirm'] ?? null) . '\'))return false;Backend.getScrollOffset()"',
            ],
            'show' => [
                'href' => 'act=show',
                'icon' => 'show.svg',
            ],
        ],
    ],
    
    // ... Palettes und Fields kommen gleich hier drunter
];

Wichtig: Auch wenn wir Doctrine nutzen, benötigt das Contao 5 DCA im config-Bereich noch die Info über den Primary Key (id). Aber wir definieren keine Spalten-Definitionen mehr hier!

3. Palettes & Fields: Das Formular bauen

Jetzt definieren wir, was editierbar ist. Das Contao 5 DCA nutzt "Palettes" für das Layout und "Fields" für die Logik. Füge diesen Teil unter das list-Array in dieselbe Datei ein.

Ein Roboterarm sortiert Interface-Elemente

PHP

    // 3. Paletten (Das Layout des Formulars)
    'palettes' => [
        'default' => '{title_legend},title,chairNumber;{details_legend},pricePerDay,description',
    ],

    // 4. Felder (Die Eingabemöglichkeiten)
    'fields' => [
        'id' => [
            'sql' => "int(10) unsigned NOT NULL auto_increment" // ID braucht SQL definition für Contao Core Logik
        ],
        'tstamp' => [
            'sql' => "int(10) unsigned NOT NULL default '0'"
        ],
        'title' => [
            'inputType' => 'text',
            'search' => true,
            'eval' => ['mandatory' => true, 'maxlength' => 255, 'tl_class' => 'w50'],
            // KEIN 'sql' hier! Das macht die Entity via Doctrine.
        ],
        'chairNumber' => [
            'inputType' => 'text',
            'search' => true,
            'sorting' => true,
            'eval' => ['mandatory' => true, 'maxlength' => 10, 'unique' => true, 'tl_class' => 'w50'],
        ],
        'pricePerDay' => [
            'inputType' => 'text',
            'eval' => ['mandatory' => true, 'rgxp' => 'digit', 'tl_class' => 'w50'],
            'label' => ['Preis pro Tag (in Cent)', 'Bitte Preis in Cent eingeben (1000 = 10,00€)'],
        ],
        'description' => [
            'inputType' => 'textarea',
            'eval' => ['rte' => 'tinyMCE', 'tl_class' => 'clr'], // Rich Text Editor
        ],
    ],

Analyse des Codes:

Kein SQL: Bei title, chairNumber usw. fehlt der sql-Key. Das ist korrekt! Contao schaut in die Datenbank, sieht dass die Spalte (dank Doctrine) existiert, und ist zufrieden.
rgxp => digit: Wir zwingen den User, nur Zahlen einzugeben (für unseren Cent-Preis).
rte => tinyMCE: Wir binden mit einer Zeile den kompletten HTML-Editor ein.

4. Der letzte Schliff: Menü-Eintrag

Das DCA ist da, aber man sieht es im Backend-Menü noch nicht. Wir müssen Contao sagen: "Zeig einen Link zu tl_beach_chair an."

Da wir in Contao 4.13+ / 5 arbeiten, machen wir das modern über eine Konfigurationsdatei, nicht mehr über die config.php. Da wir aber gerade ein Bundle bauen, ist der klassische Weg über die config.php innerhalb des Bundles immer noch der Standard, um Backend-Module zu registrieren.

Erstelle /src/BeachsideBundle/contao/config/config.php:

PHP

<?php

use Acme\BeachsideBundle\Model\BeachChairModel; // Kommt gleich!

// Backend Modul registrieren
$GLOBALS['BE_MOD']['content']['beach_chairs'] = [
    'tables' => ['tl_beach_chair'],
];

5. Cache leeren & Testen

Führe im Terminal aus:

vendor/bin/contao-console cache:clear

Logge dich ins Contao Backend ein. Links im Menü unter "Inhalte" solltest du jetzt "beach_chairs" sehen. (Der Name ist noch klein geschrieben, weil wir keine Übersetzungen angelegt haben – das machen wir beim Polish).

Eine sortierte Liste von Objekten in einer Reihe

Klicke drauf. Klicke auf "Neu". Siehst du die Maske? Titel, Nummer, Preis, Beschreibung? Speichere einen Strandkorb. Wenn er in der Liste erscheint: BÄM! Du hast gerade eine volle CRUD-Applikation (Create, Read, Update, Delete) gebaut.

#dca

Contao 5 DCA: Perfekte Backend-Masken für Entities erstellen