Zum Inhalt

Medien-Workflow: Ersetzen

Das Workflow-Plugin Ersetzen erlaubt es, hochgeladene Dateien im MAM automatisch durch eine andere Version zu ersetzen. Für die Redaktion bedeutet das: Sie laden weiterhin ihr gewünschtes Bild hoch, doch imperia tauscht es im Hintergrund gegen eine optimierte oder konvertierte Variante aus.

Ersetzungs-Plugin

  • Webp: ersetzt Bilder automatisch durch eine .webp-Variante.
  • Konsistenz erzwingen: korrigiert die Ausrichtung von Bildern

Funktionsweise

Wird im Workflow ein Ersetzen-Schritt eingesetzt, prüft imperia beim Upload der Datei, ob ein passendes Ersetzungs-Plugin verfügbar ist.

  • Kein Ersatz nötig oder erfolgreich ersetzt: der Workflow läuft regulär weiter.
  • Fehler oder inkompatibles Format: der Workflow läuft über den Süd-Ausgang weiter. In diesem Fall wird ein Fehlertext angezeigt.

Um Nachvollziehbarkeit zu sichern, werden im Dokument zwei Dinge gespeichert:

  • ein Fingerabdruck (MD5) der ersetzten Datei, damit doppelte Ersetzungen erkannt werden,
  • sowie ein Vermerk in der Dokument-Historie: „Binary content replaced.“ oder „Failed to replace binary content.“

Einsetzen im Workflow

  • Im Schritt Ersetzen wählen Administratoren ein Ersetzungs-Plugin aus (z. B. Webp).
  • Optional können Parameter ergänzt werden, etwa zur Steuerung von Bildvarianten oder Orientierungen.

Für Entwickler

Das Feature ReplaceAsset basiert auf einem Plugin-System. Jedes Plugin im Realm AssetReplace übernimmt die Aufgabe, eine Datei durch eine transformierte Version zu ersetzen – zum Beispiel ein Bild nach WebP zu konvertieren oder die Orientierung anzupassen.

Wo liegen die Plugins?

Alle verfügbaren Plugins findest du im Code unter:

site/modules/core/Dynamic/AssetReplace/

Neue Plugins können hier einfach ergänzt werden. Sobald das Modul im Verzeichnis liegt, wird es automatisch im Workflow-Schritt ReplaceAsset zur Auswahl angeboten. Eine manuelle Registrierung ist nicht nötig.

Was passiert intern?

Jedes Plugin implementiert eine kleine API, die imperia automatisch aufruft:

  • trigger – entscheidet, ob das Plugin für die aktuelle Datei aktiv wird
  • replace – führt die eigentliche Transformation durch
  • Hilfsfunktionen wie getActionInfo sorgen dafür, dass das Plugin mit Namen und Beschreibung in der Oberfläche erscheint