README

Backend-Modul für Contao 4.13 und 5, das die Metadaten von Dateien aus der Dateiverwaltung gesammelt bearbeitet: Titel, Alternativtext, Link, Bildunterschrift und Lizenz lassen sich in vielen Dateien auf einmal suchen und ersetzen oder mit festen Werten setzen — global, für einen Ordner oder für einen Ordner samt Unterordnern.

Contao selbst bietet in der Dateiverwaltung zwar „Mehrere bearbeiten“, aber kein Überschreiben: Wer hundert Fotos eines Turniers mit derselben Bildunterschrift versehen oder einen umbenannten Verein in allen Bildtiteln austauschen will, klickt sich sonst durch jede Datei einzeln.

Voraussetzungen

Contao 4.13 oder Contao 5.7 (geprüft gegen 4.13.58 und 5.7.7)
PHP 7.4 oder 8.x (geprüft mit PHP 8.4)

Installation

composer require schachbulle/contao-metadaten-bundle

Anschließend die Datenbank aktualisieren (Contao Manager oder contao:migrate): Das Bundle legt die Tabelle tl_metadaten für die gespeicherten Aufträge an. Die Metadaten selbst bleiben, wo sie sind — in der Spalte meta der Tabelle tl_files.

Backend

Das Modul heißt Metadaten und steht in der Gruppe System direkt hinter der Dateiverwaltung. Es verwaltet Aufträge: Ein Auftrag beschreibt, welche Dateien wie bearbeitet werden sollen, und lässt sich beliebig oft mit Vorschau ausführen — etwa nach jedem neuen Schwung Turnierfotos.

Nicht-Administratoren brauchen in ihrer Benutzergruppe das Modul unter „Erlaubte Module“ und die Felder von tl_metadaten unter „Erlaubte Felder“.

Auftrag anlegen

Feld	Bedeutung
Titel	Name des Auftrags
Ordner	Ein Ordner aus dem Dateibaum der Dateiverwaltung; ohne Auswahl gelten alle Dateien
Unterordner einschließen	Auch Dateien in allen Unterordnern bearbeiten
Dateiendungen	Nur Dateien mit diesen Endungen, z. B. `jpg, png`; leer für alle
Sprache	Eine aktivierte Backend-Sprache oder „alle vorhandenen Sprachen“
Felder	Nur die angehakten Felder werden bearbeitet
Betriebsart	„Suchen und ersetzen“ oder „Werte setzen“; blendet die passenden Felder ein

Der Ordner wird über Contaos eigenen Dateibaum gewählt, der jeden Zweig erst beim Aufklappen lädt — auch bei sehr großen Dateiverwaltungen ohne Wartezeit.

Benutzer mit Dateifreigaben sehen im Baum nur ihre Freigaben. Ein Auftrag, dessen Ordner außerhalb der eigenen Freigaben liegt, lässt sich nicht ausführen; „alle Dateien“ bedeutet für sie „alle Dateien innerhalb der Freigaben“.

Betriebsarten

Suchen und ersetzen tauscht einen Text in bereits gefüllten Feldern aus. Leere Felder werden dabei nie angefasst. Wahlweise ohne Beachtung der Groß- und Kleinschreibung (auch für Umlaute) oder als regulärer Ausdruck (PCRE ohne Begrenzer, Rückverweise wie $1 im Ersatztext sind erlaubt). Ein leerer Ersatztext entfernt den Suchtext.

Werte setzen schreibt die eingetragenen Werte in die gewählten Felder einer Sprache. Mit „Nur leere Felder füllen“ (Vorgabe) bleiben vorhandene Werte stehen; abgeschaltet werden die gewählten Felder in allen ausgewählten Dateien überschrieben — auch mit einem leeren Wert, was einem Löschen gleichkommt.

Vorschau und Ausführung

Die Operation „Vorschau und Ausführen“ (Symbol mit den zwei Pfeilen) in der Auftragsliste zeigt oben die Einstellungen des Auftrags und darunter je Datei, Sprache und Feld den bisherigen und den neuen Wert, ohne etwas zu speichern. Erst darunter steht der Knopf „… Dateien jetzt ändern“, der genau die angezeigte Änderung ausführt. Danach leitet das Modul auf die Vorschau zurück und listet die geänderten Dateien auf; ein Neuladen der Seite wiederholt die Änderung nicht.

Jede geänderte Datei bekommt eine neue Version in tl_version, genau wie nach einer Bearbeitung von Hand. In der Dateiverwaltung lässt sich der alte Stand deshalb über die Versionsauswahl der Datei wiederherstellen.

Was das Modul nicht tut

Es legt keine Metadaten in Sprachen an, die nicht ausdrücklich gewählt wurden, und rührt beim Ersetzen keine leeren Felder an.
Es ändert keine Dateien auf der Festplatte und synchronisiert nichts — die Metadaten leben allein in der Datenbank.
Es kennt genau die fünf Felder des Contao-MetaWizards. Felder, die andere Erweiterungen ergänzen, bleiben unverändert erhalten.

Prüfstand

tools/pruefstand.php lädt Konfiguration, Sprachdateien, DCA, Template und Klassen des Bundles gegen eine echte Contao-Installation und meldet, ob alle benutzten Kern-Klassen, -Methoden und -Dienste in dieser Fassung vorhanden sind. Eine Datenbank braucht er nicht.

C:\xampp\php\php.exe tools/pruefstand.php F:\Claude\contao-test-413
C:\xampp\php\php.exe tools/pruefstand.php F:\Claude\contao-test

Entwickler

Die Kernlogik (Lesen, Prüfen, Ersetzen, Setzen, Vergleichen) steckt in src/Classes/Bearbeitung.php, die Abbildung eines Datensatzes auf einen Auftrag in src/Classes/Auftrag.php; beides kommt ohne Contao und ohne Datenbank aus. Die DCA tl_metadaten liefert das Formular mit Dateibaum, das Modul src/Modules/Metadaten.php kümmert sich um Vorschau, Dateiauswahl, Versionen und Speichern.

vendor/bin/phpunit          # Unit-Tests der Kernlogik (tests/)

Ohne composer install im Bundle genügt ein anderswo installiertes PHPUnit mit -c phpunit.xml.dist; der Bootstrap registriert dann einen eigenen Autoloader.

Lizenz

LGPL-3.0-or-later, siehe LICENSE.

schachbulle / contao-metadaten-bundle

Package info

Security

Statistics