Files
Piwigo_Bratonien_Tools/README.md

1.7 KiB

Piwigo Bratonien Tools

Eigene, modular aufgebaute Administrationswerkzeuge fuer die Bratonien-Piwigo-Installation.

Ziel

Das Plugin ist bewusst als Werkzeugkasten aufgebaut. Neue Funktionen werden als getrennte Tools implementiert und anschliessend zentral registriert. Die Admin-Oberflaeche stellt registrierte Tools automatisch dar.

Aktuelles Tool: Bildcache leeren

Der One-Click-Button Bildcache leeren entfernt alle von Piwigo erzeugten Dateien unter _data/i/, mit Ausnahme von index.htm.

Damit werden unter anderem geloescht:

  • Standard-Bildderivate
  • Vorschaubilder
  • gdThumb-Custom-Derivate (cu_*)
  • weitere von Piwigo oder Plugins dort erzeugte Bildvarianten

Originalbilder unter galleries/ werden nicht veraendert. Piwigo erzeugt benoetigte Derivate beim naechsten Aufruf neu.

Der Browsercache ist bewusst nicht Bestandteil dieses Tools.

Struktur

  • main.inc.php - Plugin-Einstieg und Admin-Menue
  • admin.php - zentraler Admin-Controller
  • include/tool_registry.inc.php - Registry aller verfuegbaren Werkzeuge
  • tools/ - Implementierungen einzelner Werkzeuge
  • template/admin.tpl - gemeinsame Admin-Oberflaeche
  • maintain.class.php - Piwigo-Lifecycle

Neues Tool hinzufuegen

  1. Neue Implementierung unter tools/ anlegen.
  2. Datei in include/tool_registry.inc.php laden.
  3. Tool mit Titel, Beschreibung, Button, Bestaetigung und Handler in der Registry eintragen.

Die Admin-Oberflaeche muss fuer normale One-Click-Werkzeuge nicht angepasst werden.

Sicherheit

Das Plugin prueft Administratorrechte und Piwigos CSRF-Token. Das Bildcache-Tool validiert ausserdem den Zielpfad vor dem Loeschen und greift ausschliesslich auf Piwigos _data/i-Verzeichnis zu.