MediaManagerFiles — Medienverwaltung für Nicht-Bild-Dateien¶
Extension for Magento 2¶
Bedienungsanleitung¶
CopeX GmbH
Web: https://copex.io
Email: office@copex.io
Inhaltsverzeichnis¶
| Abschnitt | Seite |
|---|---|
| 1 Voraussetzungen | 2 |
| 2 Konfiguration | 2 |
| 3 Funktionen | 2 |
| 3.1 PDF-Unterstützung in der CMS-Medienverwaltung | 2 |
| 3.2 PDF-Vorschau in der Mediengalerie | 3 |
1 Voraussetzungen¶
- Magento 2.3 oder höher (kompatibel mit 2.4)
- PHP 8.1 oder höher
2 Konfiguration¶
Dieses Modul hat keine Konfiguration im Backend. Nach der Installation ist es sofort aktiv.
3 Funktionen¶
3.1 PDF-Unterstützung in der CMS-Medienverwaltung¶
Das Standard-Magento versucht, jede hochgeladene Datei als Bild zu verarbeiten. Bei Nicht-Bild-Dateien wie PDFs schlägt dieser Resize-Prozess mit einem Fehler fehl.
Dieses Modul löst das Problem durch einen Plugin, der den Resize-Prozess abfängt:
- Wenn das Resize einer Datei einen Fehler auslöst (z.B. bei PDFs, DOC-Dateien oder anderen Nicht-Bild-Formaten), greift der Plugin ein und liefert stattdessen ein Standard-Platzhalter-Bild zurück.
- Der Fehler wird nicht an den Benutzer weitergeleitet; der Upload-Prozess wird erfolgreich abgeschlossen.
- PDFs und andere Nicht-Bild-Dateien können dadurch problemlos über den Magento WYSIWYG-Editor (z.B. in CMS-Seiten und -Blöcken) hochgeladen und verwendet werden.
Zusätzlich werden die erlaubten Dateierweiterungen in der Medienverwaltung um pdf erweitert, sodass PDF-Dateien beim Upload-Filter nicht blockiert werden.
3.2 PDF-Vorschau in der Mediengalerie¶
Bei der Anzeige von Dateien in der Magento-Mediengalerie (CMS > Medienverwaltung) werden PDFs mit einem eigenen PDF-Icon dargestellt, anstatt mit dem Standard-Platzhalter-Bild.
Das PDF-Icon (/wysiwyg/pdf-icon.png) wird automatisch für alle Dateien mit der Endung .pdf verwendet. Andere Dateitypen behalten ihr Standard-Vorschau-Verhalten.
Ablauf beim Upload einer PDF-Datei:
- Administrator öffnet den WYSIWYG-Editor in einer CMS-Seite oder einem CMS-Block.
- Administrator klickt auf "Bild einfügen" und wählt die Medienverwaltung.
- PDF-Datei wird hochgeladen.
- Das Modul verhindert den fehlschlagenden Resize-Versuch.
- Die PDF-Datei erscheint in der Medienverwaltung mit dem PDF-Icon.
- Der Administrator kann die PDF-Datei als Link in die CMS-Seite einfügen.
Lizenz¶
Proprietär — CopeX GmbH. Eine Lizenz pro produktiver Magento-Instanz. Test- und Entwicklungsumgebungen benötigen keine zusätzliche Lizenz.