README

Eigenständige Tabellen und Verzeichnisse für Contao. Keine EFG-Abhängigkeit für Verwaltung oder Ausgabe.

Backend-Menü

Die eigene Menügruppe Tabellenverwaltung bündelt Tabellen, EFG-Daten übernehmen und CSV importieren / exportieren. Die Importseiten führen mit getrennten Abschnitten durch Auswahl, Zuordnung, Vorschau und Bestätigung.

Beim Bearbeiten eines Eintrags nutzen die Feldwerte die verfügbare Breite. Lange Werte werden in mehrzeiligen Textfeldern umgebrochen; die Höhe passt sich beim Tippen an und lässt sich am unteren Rand manuell vergrößern. Schlüssel und Zeilenaktionen bleiben erhalten. Das gespeicherte Datenformat bleibt unverändert; es ist keine Datenbankmigration erforderlich.

Insert-Tags für einzelne Einträge

Die ID eines veröffentlichten Eintrags anhand von Tabellenname und Bezeichnung ermitteln:

{{direntry::Mitgliedsbetriebe::Hilzinger GmbH & Co. KG}}

Der zweite Parameter ist der Name der Tabelle (alternativ ihre numerische ID), der dritte die Bezeichnung des Eintrags im Backend. Bei unbekannten, unveröffentlichten oder mehrfach passenden Einträgen bleibt die Ausgabe leer. Bei einer Umbenennung die entsprechenden Tags anpassen. Namen mit :: sind in dieser Schreibweise nicht verwendbar.

Für einen Detailseiten-Link in einem HTML-Inhaltselement beispielsweise:

<a href="{{link_url::123}}?directory_entry={{direntry::Mitgliedsbetriebe::Hilzinger GmbH & Co. KG}}">Betrieb ansehen</a>

123 durch die ID der Contao-Detailseite ersetzen. Auf dieser Seite ein Inhaltselement Verzeichnistabelle mit Tabelle Mitgliedsbetriebe und Darstellung Details einrichten. Der direntry-Tag gibt ausschließlich die Eintrags-ID aus, nicht die komplette URL oder den Datensatz. Bei leerem Ergebnis den Link nicht verwenden: Eine Detailseite ohne ausgewählte ID zeigt ihre vollständige Übersicht.

Einzelne Feldwerte lassen sich über die bekannte Eintrags-ID ausgeben:

{{tabelle::17::FIRMA}}
{{tabelle::17::TELEFON}}
{{tabelle::17::_title}}

17 ist hier eine Beispiel-ID. Feldschlüssel wie FIRMA exakt wie in der Tabelle schreiben; _title gibt die Backend-Bezeichnung aus. Werte werden als HTML-geschützter Text ausgegeben, ohne HTML aus dem Datenfeld auszuführen. Nicht veröffentlichte Einträge und unbekannte Felder liefern eine leere Ausgabe.

Funktionen

Verzeichnisse, Spalten und Einträge im Backend verwalten.
Frei konfigurierbare Anzeige-, Such-, Sortier- und Detailfelder im Inhaltselement Verzeichnistabelle.
Suche mit Feldauswahl, lokale Rasterbild-Logos sowie Website-, E-Mail- und Telefonlinks.
Aufklappbare Details; HTML-Escaping der Textwerte.
Optionaler EFG-Import mit Vorschau, Transaktion, Duplikatschutz und Bezeichnungsreparatur.

Voraussetzungen

PHP 8.1+, Contao 4.13 oder 5.3+. In Contao 4.13 mit PHP 8.2 sind Backend, Ausgabe und Import geprüft. Die GitHub-Actions-Matrix prüft Paketinstallation und Tests mit Contao 4.13 und 5.3. Ein vollständiger Website-Test unter Contao 5 steht noch aus.

Installation

Bis zur Registrierung auf Packagist dieses Repository in die Composer-Konfiguration der Website aufnehmen:

"repositories": [
  {"type": "vcs", "url": "https://github.com/pbd-kn/contao-tabellenverwaltung-bundle"}
]

composer require pbd-kn/contao-tabellenverwaltung-bundle:dev-main
php vendor/bin/contao-console contao:migrate --dry-run

Datenbank vorher sichern und die Vorschau prüfen. Die Contao-Schemaprüfung kann auch Löschungen für andere Erweiterungen vorschlagen. Nur die gewünschten Änderungen ausführen. install-directory.sql enthält ausschließlich die 16 Schema-Ergänzungen dieses Bundles und ist für eine einmalige Neuinstallation vorgesehen.

Lokale Entwicklung

"repositories": [
  {"type": "path", "url": "../../Github Bundles/contao-tabellenverwaltung-bundle", "options": {"symlink": false}}
]

Eine gespiegelte Paketinstallation nach Quellcodeänderungen aktualisieren:

composer reinstall pbd-kn/contao-tabellenverwaltung-bundle --no-scripts
php vendor/bin/contao-console cache:clear --env=prod

Verwendung

Unter Tabellenverwaltung → Tabellen ein Verzeichnis anlegen und Spalten als eindeutige Schlüssel/Überschriften definieren. Bestehende Schlüssel nicht umbenennen. Über Einträge verwalten die Datensätze öffnen; nur veröffentlichte Einträge erscheinen im Frontend.

In einem Artikel das Inhaltselement Verzeichnistabelle hinzufügen. Die Ausgabe-Einstellungen verwenden kommagetrennte Feldschlüssel:

Einstellung	Beispiel	Wenn leer
Sichtbare Spalten	`FIRMA,STRASSE,PLZ,ORT,TELEFON,EMAIL`	Alle Spalten
Durchsuchbare Spalten	`FIRMA,PLZ,ORT`	Keine Suche
Sortierung	`FIRMA,PLZ,ORT`	Backend-Reihenfolge
Detailfelder	`NAME,VORNAME,INTERNET,EMAIL`	Keine Details

Die Suche bezieht sich auf das ausgewählte Feld. INTERNET/INTERNET1, EMAIL/EMAIL1, TELEFON und MOBIL werden passend verlinkt. LOGO akzeptiert einen vorhandenen Rasterbildpfad unter files/; andere Werte erscheinen als Klartext.

Optionaler EFG-Import

Der Import benötigt die EFG-Quelltabellen, aber keine EFG-Klassen. Den tatsächlichen Formularnamen ermitteln:

SELECT form, COUNT(*) FROM tl_formdata GROUP BY form;

php vendor/bin/contao-console directory:import-efg "Mitgliedsbetriebe" "Mitgliedsbetriebe"
php vendor/bin/contao-console directory:import-efg "Mitgliedsbetriebe" "Mitgliedsbetriebe" --execute

Ohne --execute nur Vorschau. Die Quelle bleibt unverändert, Einträge werden unveröffentlicht kopiert und behalten die EFG-ID als legacyId. Bezeichnungen werden aus Firma, Bezeichnung oder Vor-/Nachname gebildet. Bei fehlenden Namen wird die Quell-ID verwendet. Ungültige/doppelte Feldschlüssel führen zum Abbruch; ein bestehender Verzeichnisname verhindert versehentlichen Doppelimport.

Bezeichnungen aus älteren Importversionen reparieren:

php vendor/bin/contao-console directory:import-efg "Mitgliedsbetriebe" "Mitgliedsbetriebe" --repair-titles
php vendor/bin/contao-console directory:import-efg "Mitgliedsbetriebe" "Mitgliedsbetriebe" --repair-titles --execute

Werte und Ausgabe vor Umstellung prüfen. EFG-Templates, Frontend-Bearbeitung, Module und Insert-Tags werden nicht automatisch ersetzt. EFG erst entfernen, wenn alle übrigen Einbindungen umgestellt sind.

Tests

composer install --no-plugins --no-scripts
composer test

SQLite im Arbeitsspeicher prüft Import, Vorschau, UTF-8, Duplikatschutz und Reparatur sowie die Erhaltung manueller Bezeichnungen und Feldwerte. Weitere Tests prüfen sichere Link-/Bild-/Textformatierung. Keine Website-Daten oder Zugangsdaten sind im Repository enthalten.

Grenzen

Tabellen, Partnerkarten und Detailansichten können als Inhaltselement oder Frontend-Modul eingebunden werden. Partnerkarten öffnen ihre Details auf derselben Seite und bieten einen Zurück-Link; ältere separate Detailansichten bleiben verfügbar; die Auswahl erfolgt über directory_entry, ältere numerische EFG-Parameter werden über legacyId unterstützt. Keine Seitennavigation. Suche/Sortierung erfolgen im Arbeitsspeicher; große Verzeichnisse benötigen eine Erweiterung. Beliebiges HTML und serialisierte EFG-Mehrfachwerte werden nicht übernommen. Menü und Seitenlayout sind Teil der Website.

Lizenz

LGPL-3.0-or-later, siehe LICENSE.

Partnerkarten und Details

Bei Inhaltselementen und Modulen lässt sich die Darstellung Tabelle, Partnerkarten oder Details auswählen. Partnerkarten verwenden die Klasse partnerartikel für bestehende Rotationsskripte und zeigen die Ansprechpartner aus den Verzeichnisdaten. Bei Details werden nur veröffentlichte Einträge des gewählten Verzeichnisses angezeigt. Ohne ausgewählte Eintrags-ID erscheint die vollständige Detailübersicht.

EFG-Import im Backend

Backend-Administratoren können unter Tabellenverwaltung → EFG-Daten übernehmen ein Quellverzeichnis wählen, eine Vorschau prüfen und die bestätigte Übernahme starten. Quelldaten bleiben erhalten; importierte Einträge sind unveröffentlicht. Bestehende Zielnamen verhindern Doppelimporte. EFG kann unabhängig davon weiterhin für Kontaktformular-Mails installiert bleiben.

CSV-Import und CSV-Export im Backend

Unter Tabellenverwaltung → CSV importieren / exportieren können Administratoren ein vorhandenes Verzeichnis auswählen und dessen Einträge als CSV herunterladen oder gesammelt einlesen. Das Verzeichnis und seine Spalten zuerst unter Tabellenverwaltung → Tabellen anlegen. Auch ein leeres Verzeichnis lässt sich als Vorlage exportieren. Dafür sind weder SSH noch FTP oder Datenbankänderungen erforderlich.

Verzeichnis auswählen und Auswählen anklicken.
Mit CSV herunterladen alle Einträge einschließlich unveröffentlichter Einträge exportieren.
Die Datei beispielsweise in Excel über Daten → Aus Text/CSV öffnen. PLZ, Telefonnummern und IDs als Text behandeln, damit führende Nullen erhalten bleiben. Wieder als CSV UTF-8 speichern.
Zum Einlesen die Datei auswählen und Datei laden und Spalten zuordnen anklicken.
Die CSV-Überschriften den Verzeichnisfeldern zuordnen. Passende Feldschlüssel oder Beschriftungen werden automatisch vorgeschlagen.
Vorschau erstellen anklicken. Sie nennt die Anzahl neuer und zu aktualisierender Einträge und zeigt die ersten zehn Datensätze.
Die Vorschau bestätigen und Jetzt importieren anklicken. Erst jetzt wird gespeichert.

Die Exportdatei enthält _id (Eintrags-ID), _title (Bezeichnung), _csv_format (technische Formatkennung) und die Feldschlüssel als Überschriften. _id und _title sind optional beim Einlesen. Für neue Einträge _id leer lassen; eine bestehende ID muss zum ausgewählten Verzeichnis gehören. Ohne ID entstehen immer neue Einträge, auch beim erneuten Einlesen derselben Datei. Beim Übertragen in ein anderes Verzeichnis die IDs leeren. _csv_format bei unveränderten Exportdateien beibehalten; die Kennung ermöglicht die Rückwandlung des Excel-Formelschutzes.

Neue Einträge sind unveröffentlicht. Bei Aktualisierungen bleiben Veröffentlichungsstatus, Sortierung und EFG-Herkunfts-ID erhalten. Nicht zugeordnete Felder behalten ihre bisherigen Werte; leere zugeordnete Zellen leeren den jeweiligen Wert. Bei fehlender Bezeichnung wird für neue Einträge Firma bzw. Vor-/Nachname verwendet. Es werden keine Einträge gelöscht. Ein Import ist eine gemeinsame Datenbanktransaktion; ungültige IDs oder zwischenzeitlich veränderte Einträge führen zum Abbruch ohne Teilimport. Direkte CSV-Änderungen erzeugen keine Contao-Versionen; vor größeren Änderungen eine Datenbanksicherung erstellen.

Import: maximal 5 MB und 10.000 Datensätze, zusätzlich gilt das PHP-Uploadlimit. Kopfzeile erforderlich; Semikolon, Komma und Tabulator (automatisch oder auswählbar), UTF-8 mit/ohne BOM sowie Windows-1252 werden unterstützt. Mehrzeilige und durch Anführungszeichen geschützte Werte bleiben erhalten. Export: UTF-8 mit BOM und Semikolon. Potenzielle Excel-Formeln werden mit einem Apostroph entschärft und beim Rückimport einer Datei mit Formatkennung wiederhergestellt. Behalte die Kennung nur bei, wenn die Datei auf diesem Export beruht. Dateien enthalten auch nicht veröffentlichte Daten und sind entsprechend vertraulich zu behandeln.

Die CSV-Tests prüfen Neuanlage, Vorschau ohne Schreibzugriff, Aktualisierung ohne Duplikate, Teilaktualisierungen, Status-Erhaltung, Kodierung, Trennzeichen, Zeilenumbrüche, Formelschutz mit Rückimport, ungültige/fremde/doppelte IDs, veraltete Vorschauen und vollständiges Zurückrollen bei Fehlern.

Mehrere Einträge veröffentlichen

In der Eintragsliste einer Tabelle Mehrere bearbeiten öffnen, die gewünschten Einträge oder Alle auswählen markieren und Überschreiben anklicken. Anschließend nur das Feld Veröffentlicht auswählen, mit Weiter bestätigen, das Häkchen Veröffentlicht setzen und speichern. Der Wert wird gemeinsam für alle ausgewählten Einträge gesetzt. Zum gemeinsamen Zurücknehmen der Veröffentlichung das Häkchen entfernen. Mit Bearbeiten lassen sich die ausgewählten Einträge stattdessen einzeln auf einer gemeinsamen Formularseite ändern. Die Änderungen nutzen Contaos reguläre Datensatzversionierung.

Besslich-/Heike-Preisliste übernehmen

Unter Tabellenverwaltung → Besslich-Preisliste übernehmen können Administratoren die bestehende SQL-Tabelle tl_heike_preisliste kopieren. Dies ist ein eigener Import, kein EFG-Import. Zuerst eine vollständige Datenbanksicherung erstellen und die Datenbank des Bundles installieren.

Einen neuen Tabellennamen eingeben und Vorschau prüfen wählen. Die Vorschau nennt Anzahl und Feldschlüssel und zeigt die ersten zehn Artikel.
Sicherung und Vorschau bestätigen und Jetzt übernehmen wählen.
Unter Tabellen die kopierten Einträge prüfen. Sie bleiben zunächst unveröffentlicht.

Alle vorhandenen Quellspalten werden kopiert, einschließlich sechs Preisfeldern, Beschreibung, listTpl, Sortierung und technischen Werten. Preise werden nicht in Zahlen umgerechnet: leere Werte, NULL und Dezimaldarstellungen bleiben gespeichert. Die ursprüngliche ID steht sowohl in legacyId als auch im Feld HeikeQuellId; das ursprüngliche Feld id bleibt zusätzlich erhalten. Binäre Datei-UUIDs aus import_source werden reversibel in import_source_base64 gespeichert (base64_decode liefert den Originalwert). Zusätzliche Quellspalten mit gültigen Feldschlüsseln werden ebenfalls berücksichtigt.

Die Übernahme läuft in einer Transaktion und kontrolliert gespeicherte Feldwerte und Datensatzanzahl. Seit der Vorschau geänderte Quelldaten verlangen eine neue Vorschau. Ein belegter Zielname oder eine vorhandene Tabelle mit dem Herkunftsfeld HeikeQuellId verhindert erneute Übernahmen, auch nach einer Umbenennung. Dieses Herkunftsfeld deshalb nicht entfernen oder für andere Tabellen verwenden. Während der Übernahme die alte Preisliste nicht bearbeiten.

Die Quelle wird weder geändert noch gelöscht. Bestehende Schmuckartikel, Insert-Tags, Templates und Preisabfragen im Besslichschmuck-Bundle werden durch diesen Import nicht umgestellt. Die Website verwendet weiterhin die alte Preisliste, bis die Integration separat angepasst und geprüft wurde. Alte Tabellen bei Contao-Datenbankupdates weiterhin behalten.

Feldwerte direkt über Tabellenname und Eintragsbezeichnung

Ohne vorheriges Nachschlagen einer ID:

{{tabelle::Lieferanten::Goldhandel Müller::TELEFON}}
{{tabelle::Lieferanten::Goldhandel Müller::_title}}
{{tabelle::Lieferanten::Goldhandel Müller::_id}}

Der erste Parameter bezeichnet die Tabelle (Name oder numerische Tabellen-ID), der zweite die Bezeichnung des Eintrags im Backend, der dritte den exakten Feldschlüssel. Eine Verschachtelung mit direntry ist nicht nötig. Die bisherigen Aufrufe {{tabelle::17::TELEFON}} bleiben gültig.

Alle Feldwerte eines Eintrags als JSON-Objekt ausgeben:

{{tabelle::Lieferanten::Goldhandel Müller::*}}
{{tabelle::17::*}}

Das JSON enthält sämtliche gespeicherten Feldwerte als Zeichenfolgen und zusätzlich _id (interne Eintrags-ID als Zahl) sowie _title (Bezeichnung). Reservierte Metadaten haben Vorrang vor gleichnamigen Feldern. Unicode bleibt lesbar; HTML-sensitive Zeichen in Werten werden als JSON-Unicode-Escapes ausgegeben. Die Ausgabe ist gültiges JSON, kein HTML-escaped JSON-Text. Für den Einbau in HTML-Attribute muss der aufrufende Code zusätzlich das passende Attribut-Escaping verwenden.

Nur veröffentlichte Einträge werden ausgegeben. Bei fehlenden oder mehrdeutigen Namen bleibt die Ausgabe leer, auch bei *. Namen mit :: können nicht über diese Syntax adressiert werden. Die Bezeichnung ist die Eintragsbezeichnung und muss keinem bestimmten Datenfeld entsprechen.

pbd-kn / contao-tabellenverwaltung-bundle

Package info

Security

Statistics