Order Attachment für Magento 2

MAGENTO 2 · CHECKOUT · DATEIEN · BESTELLUNGEN

Kowal Order Attachment

Ergänzen Sie ein Bild- oder PDF-Feld im Checkout, sichtbar für alle Bestellungen oder ausgewählte Produkte. Verknüpfen Sie den Anhang mit dem Kauf und stellen Sie ihn berechtigten Mitarbeitern im Magento-Adminbereich bereit.

JPG, PNG und PDF · Backend-Validierung · Dateien außerhalb von pub/media

SO FUNKTIONIERT ES IN DER PRAXIS

Order Attachment ist ein praktisches Magento 2 Modul für Shops, die zusätzliche, mit der Bestellung verknüpfte Dateien von Kunden erfassen müssen. Die Erweiterung eignet sich besonders dort, wo für die Kaufabwicklung Fotos, Scans, PDF-Dokumente, Grafikentwürfe, Bestätigungen, Rezepte, Formulare oder andere vom Kunden übermittelte Materialien erforderlich sind.

Das Modul fügt im Checkout ein sicheres Anhangsfeld hinzu und speichert die Datei zusammen mit der Bestellung. Das Formular kann für alle Bestellungen sichtbar sein oder nur dann, wenn der Warenkorb ein Produkt enthält, das als anhangspflichtig markiert ist. Dadurch erzwingt der Shop keinen Upload, wo er nicht benötigt wird, und kann zugleich Produkte, die zusätzliche Daten erfordern, präzise verarbeiten.

Der wichtigste Vorteil des Moduls ist die Kontrolle über den Zeitpunkt und die Sicherheit der Dateiübertragung. Der Anhang wird auf der Backend-Seite validiert, außerhalb des öffentlichen Verzeichnisses gespeichert und Administratoren ausschließlich über geschützte Aktionen im Magento-Panel zur Verfügung gestellt. Das verringert das Risiko einer versehentlichen Offenlegung von Kundendateien und beseitigt das Problem öffentlicher Links zu privaten Dokumenten.

Nach Aufgabe der Bestellung sieht der Administrator den Anhang direkt in der Bestellansicht. Er kann die Datei herunterladen oder eine Vorschau öffnen, sofern das Format unterstützt wird. Unterstützt werden gängige Bildformate sowie PDF, und die zulässigen Erweiterungen sowie die maximale Dateigröße können im Administrationsbereich konfiguriert werden.

• Globales Aktivieren oder Deaktivieren des Moduls in der Magento-Konfiguration.
• Bedingte Anzeige des Upload-Felds im Checkout.
• Unterstützung der Konfiguration pro Produkt über ein Produktattribut.
• Möglichkeit, einen Anhang nur für ausgewählte SKU zu verlangen.
• Upload von Bildern und PDF-Dateien.
• Backend-Validierung von Erweiterung, MIME type und Dateigröße.
• Sichere Speicherung von Dateien außerhalb des öffentlichen Verzeichnisses.
• Verknüpfung des Anhangs mit einer konkreten Bestellung.
• Link zum Herunterladen der Datei im Administrationsbereich.
• Vorschau unterstützter Dateien in der Bestellansicht.
• Automatische Bereinigung alter temporärer Dateien.

Das Modul ist für Magento 2 Shops vorgesehen, die Produkte oder Dienstleistungen verkaufen, für die eine zusätzliche Datei vom Kunden benötigt wird, z. B.:

• personalisierte Produkte,
• Druck und Printmedien,
• Grafikdienstleistungen,
• medizinische oder optische Produkte, die Dokumente erfordern,
• Bestellungen, die ein Referenzfoto erfordern,
• B2B-Produkte, die Bestätigungen oder Formulare erfordern.

• Weniger manuelle E-Mail-Kommunikation nach Aufgabe der Bestellung.
• Geringeres Risiko, eine Datei zu verlieren, da der Anhang direkt der Bestellung zugeordnet wird.
• Besserer Prozess für die Abwicklung von Produkten, die zusätzliche Daten erfordern.
• Mehr Kontrolle über die Sicherheit von Kundendateien.
• Einfachere Arbeit des Administrationsteams im Magento-Panel.

Der Administrator kann im Panel festlegen:

• ob das Modul aktiv ist,
• wann das Anhangsfeld sichtbar sein soll,
• ob der Anhang erforderlich ist,
• welche Dateierweiterungen zulässig sind,
• wie groß die maximale Dateigröße ist,
• ob der Anhang in der Bestellansicht sichtbar sein soll,
• ob eine Dateivorschau verfügbar ist.

Das Modul wurde mit der Annahme entwickelt, dass jede hochgeladene Datei nicht vertrauenswürdig ist. Deshalb werden Dateien serverseitig validiert, erhalten sichere technische Namen und werden nicht als direkte URLs in pub/mediaveröffentlicht. Download und Vorschau erfolgen über durch Magento-Berechtigungen geschützte administrative Controller.

Stores → Configuration → Sales → Order Attachments bietet Sichtbarkeit, Pflicht, Titel, Beschreibung, Formate, Limit und Vorschau. Standardmäßig ist das Modul deaktiviert, das Formular betrifft ausgewählte Produkte und das Limit beträgt 10 MB.

Unterstützte Erweiterungen sind jpg, jpeg, png und pdf. requires_order_attachment kennzeichnet Produkte, die das Feld benötigen; der Warenkorb prüft auch untergeordnete Produkte. Sichtbarkeit und Dateipflicht sind getrennte Einstellungen.

Der aktuelle Checkout unterstützt eine Datei, deren Entfernung und erneuten Upload. Der Validator verwirft leere oder übergroße Dateien, prüft Erweiterung und inhaltsbasierten MIME-Typ sowie bei PDF die Signatur %PDF-.

Namen mit mehreren Punkten, etwa projekt.wersja.pdf, werden abgelehnt. Die Konfigurationsliste erweitert die Unterstützung nicht auf Formate ohne MIME-Zuordnung im Modul. Diese Kontrollen ersetzen keinen zusätzlichen Dateiscanner, falls Ihr Prozess ihn erfordert.

Der Upload wird der Quote zugeordnet und vorübergehend außerhalb des öffentlichen Verzeichnisses gespeichert. Nach Bestellerstellung wird er an den Bestellort verschoben; Cron entfernt alte temporäre Dateien.

Vorschau und Download erfordern View Order Attachments sowie Bestellzugriff. Die Modulkonfiguration besitzt eine eigene Berechtigung. Der Zugang ist auch über kowal.store → Modules → Order Attachments → Configuration möglich.

Das Formular ist eine Komponente des Standard-Magento-Checkouts. Hyvä, alternative Checkouts und Headless erfordern Prüfung und eigene Integration der Upload-Oberfläche.

Die Pflicht wird auch beim Quote Submit geprüft; API-Bestellungen und andere Wege müssen eine passende Anhangzuordnung sicherstellen. Ein fehlendes Formular in einer Oberfläche deaktiviert nicht automatisch die Backend-Validierung.

Paket kowal/module-order-attachment, Modul Kowal_OrderAttachment. Installieren Sie nach der Konfiguration des Zugriffs auf das Kowal-Repository das Paket, aktivieren Sie das Modul, aktualisieren Sie Magento und leeren Sie den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte entsprechend dem Prozess des Shops.

1. Sichtbarkeit und Pflicht festlegen
Modus konfigurieren und ausgewählte Produkte kennzeichnen.

2. Der Kunde lädt die Datei hoch
Das Backend prüft Format, Inhalt und Größe.

3. Die Mitarbeiter erhalten den Anhang
Nach dem Kauf erscheint die Datei in der Bestellansicht.

Sie kennzeichnen das Produkt mit Requires Order Attachment. In einem entsprechenden Warenkorb sieht der Kunde das Upload-Feld und lädt vor dem Kauf ein Bild hoch.

Nach der Bestellung kann ein berechtigter Administrator die Datei herunterladen oder eine unterstützte Vorschau öffnen. Das Material bleibt der jeweiligen Bestellung zugeordnet.