Order Attachment voor Magento 2

MAGENTO 2 · CHECKOUT · BESTANDEN · BESTELLINGEN

Kowal Order Attachment

Voeg een foto- of PDF-veld toe aan de checkout, zichtbaar voor alle bestellingen of geselecteerde producten. Koppel de bijlage aan de aankoop en maak deze beschikbaar voor bevoegde medewerkers in het Magento-paneel.

JPG, PNG en PDF · Backendvalidatie · Bestanden buiten pub/media

ZO WERKT HET IN DE PRAKTIJK

Order Attachment is een praktische Magento 2-module voor webshops die extra bestanden van klanten willen verzamelen die aan een bestelling zijn gekoppeld. De extensie is vooral nuttig wanneer voor de afhandeling van een aankoop foto’s, scans, PDF-documenten, grafische ontwerpen, bevestigingen, recepten, formulieren of ander materiaal van de klant nodig zijn.

De module voegt een veilig bijlageveld toe in de checkout en slaat het bestand samen met de bestelling op. Het formulier kan zichtbaar zijn voor alle bestellingen of alleen wanneer de winkelwagen een product bevat dat is gemarkeerd als bijlage vereist. Zo dwingt de webshop geen upload af waar die niet nodig is, en kunnen producten die extra gegevens vereisen toch nauwkeurig worden verwerkt.

Het belangrijkste voordeel van de module is de controle over het moment van uploaden en de veiligheid van de bestandsoverdracht. De bijlage wordt aan de backendzijde gevalideerd, buiten de publieke map opgeslagen en uitsluitend via beveiligde acties in het Magento-beheerpaneel beschikbaar gesteld aan beheerders. Dit beperkt het risico op onbedoelde openbaarmaking van klantbestanden en voorkomt het probleem van openbare links naar privédocumenten.

Na het plaatsen van de bestelling ziet de beheerder de bijlage direct in het besteloverzicht. Het bestand kan worden gedownload of, als het formaat wordt ondersteund, in een voorbeeldweergave worden geopend. Ondersteund worden populaire afbeeldingsformaten en PDF, en toegestane extensies en de maximale bestandsgrootte kunnen in het beheerpaneel worden geconfigureerd.

• Globaal in- of uitschakelen van de module in de Magento-configuratie.
• Voorwaardelijke weergave van het uploadveld in de checkout.
• Ondersteuning voor configuratie per product via een productattribuut.
• Mogelijkheid om een bijlage alleen voor geselecteerde SKU’s verplicht te maken.
• Upload van afbeeldingen en PDF-bestanden.
• Validatie aan de backendzijde van extensie, MIME type en bestandsgrootte.
• Veilige opslag van bestanden buiten de publieke map.
• Koppeling van de bijlage aan een specifieke bestelling.
• Link om het bestand te downloaden in het beheerpaneel.
• Voorbeeldweergave van ondersteunde bestanden in de bestelweergave.
• Automatische opschoning van oude tijdelijke bestanden.

De module is bedoeld voor Magento 2-webshops die producten of diensten verkopen waarvoor een extra bestand van de klant nodig is, bijvoorbeeld:

• gepersonaliseerde producten,
• drukwerk en printdiensten,
• grafische diensten,
• medische of optische producten waarvoor documenten nodig zijn,
• bestellingen waarvoor een referentiefoto nodig is,
• B2B-producten waarvoor bevestigingen of formulieren nodig zijn.

• Minder handmatige e-mailcommunicatie na het plaatsen van de bestelling.
• Kleiner risico dat een bestand zoekraakt, omdat de bijlage direct aan de bestelling wordt toegevoegd.
• Een beter proces voor de afhandeling van producten waarvoor extra gegevens nodig zijn.
• Meer controle over de beveiliging van klantbestanden.
• Eenvoudiger werk voor het beheerteam in het Magento-paneel.

De beheerder kan in het paneel instellen:

• of de module actief is,
• wanneer het bijlageveld zichtbaar moet zijn,
• of de bijlage verplicht is,
• welke bestandsextensies zijn toegestaan,
• wat de maximale bestandsgrootte is,
• of de bijlage zichtbaar moet zijn in het besteloverzicht,
• of een bestandsvoorbeeld beschikbaar is.

De module is ontworpen vanuit de aanname dat elk geüpload bestand niet vertrouwd is. Daarom worden bestanden aan de serverzijde gevalideerd, krijgen ze veilige technische namen en worden ze niet gepubliceerd als directe URL’s in pub/media. Downloaden en voorbeeldweergave verlopen via administratieve controllers die worden beschermd door Magento-rechten.

Stores → Configuration → Sales → Order Attachments biedt instellingen voor zichtbaarheid, verplichting, titel, beschrijving, formaten, limiet en voorbeeldweergave. Standaard is de module uitgeschakeld, geldt het formulier voor geselecteerde producten en is de limiet 10 MB.

Ondersteunde extensies zijn jpg, jpeg, png en pdf. requires_order_attachment markeert een product waarvoor het veld nodig is; de winkelwagen controleert ook onderliggende producten. Zichtbaarheid van het formulier en de verplichting om een bestand toe te voegen zijn afzonderlijke instellingen.

De huidige checkout ondersteunt één bestand, verwijderen en opnieuw uploaden. De validator weigert lege of te grote bestanden, controleert extensie en MIME op basis van de inhoud en bij PDF ook de %PDF--signatuur.

Namen met meer dan één punt worden geweigerd, bijvoorbeeld project.versie.pdf. De configuratielijst voegt geen ondersteuning toe voor formaten zonder MIME-mapping in de module. Deze controles vervangen geen aanvullende bestandsscanner als het winkelproces die vereist.

De upload wordt aan de quote gekoppeld en tijdelijk buiten de openbare directory opgeslagen. Na het aanmaken van de bestelling verhuist het bestand naar de bestellingslocatie; cron verwijdert oude tijdelijke bestanden.

Voorbeeldweergave en downloaden vereisen View Order Attachments en toegang tot de bestelling. Configuration van de module is een afzonderlijke bevoegdheid. Toegang is ook mogelijk via kowal.store → Modules → Order Attachments → Configuration.

Het formulier is een component van de standaard Magento-checkout. Hyvä, alternatieve checkouts en headless vereisen controle en een eigen integratie van de uploadinterface.

De verplichting wordt ook bij quote submit gecontroleerd. Bestellingen via API of andere routes moeten dus een geldige koppeling van de bijlage bieden. Neem niet aan dat het ontbreken van het formulier de backendvalidatie uitschakelt.

Pakket kowal/module-order-attachment, module Kowal_OrderAttachment. Configureer de toegang tot de Kowal-repository, installeer het pakket, schakel de module in, werk Magento bij en leeg de cache. Neem in productie compilatie en het uitrollen van statische inhoud op volgens het winkelproces.

1. Stel zichtbaarheid en verplichting in
Configureer de modus en markeer geselecteerde producten.

2. De klant uploadt een bestand
De backend controleert formaat, inhoud en grootte.

3. Medewerkers ontvangen de bijlage
Na de aankoop verschijnt het bestand in de bestelling.

Markeer het product met Requires Order Attachment. Bij zo'n winkelwagen ziet de klant het uploadveld en verstuurt de foto vóór de aankoop.

Na het plaatsen van de bestelling kan een bevoegde beheerder het bestand downloaden of een ondersteunde voorbeeldweergave openen. Het materiaal blijft gekoppeld aan de specifieke bestelling.