Order Attachment per Magento 2

MAGENTO 2 · CHECKOUT · FILE · ORDINI

Kowal Order Attachment

Aggiungi al checkout un campo per immagini o PDF, visibile per tutti gli ordini o per prodotti selezionati. Collega l'allegato all'acquisto e rendilo disponibile al personale autorizzato nel pannello Magento.

JPG, PNG e PDF · Validazione backend · File fuori da pub/media

COME FUNZIONA IN PRATICA

Order Attachment è un pratico modulo Magento 2 per i negozi che hanno bisogno di raccogliere dai clienti file aggiuntivi collegati all ordine. L estensione è particolarmente utile quando per completare l acquisto sono necessari foto, scansioni, documenti PDF, progetti grafici, conferme, prescrizioni, moduli o altri materiali forniti dal cliente.

Il modulo aggiunge un campo allegato sicuro nel checkout e salva il file insieme all ordine. Il modulo può essere visibile per tutti gli ordini oppure solo quando il carrello contiene un prodotto contrassegnato come richiedente un allegato. In questo modo il negozio non impone l upload dove non è necessario e allo stesso tempo può gestire con precisione i prodotti che richiedono dati aggiuntivi.

Il principale vantaggio del modulo è il controllo sul momento e sulla sicurezza dell invio del file. L allegato viene validato lato backend, archiviato fuori dalla directory pubblica e reso disponibile agli amministratori esclusivamente tramite azioni protette del pannello Magento. Questo riduce il rischio di divulgazione accidentale dei file dei clienti ed elimina il problema dei link pubblici a documenti privati.

Dopo l invio dell ordine, l amministratore vede l allegato direttamente nell anteprima dell ordine. Può scaricare il file oppure aprirne l anteprima, se il formato è supportato. Sono supportati i formati di immagine più comuni e i PDF, mentre le estensioni consentite e la dimensione massima del file possono essere configurate nel pannello di amministrazione.

• Abilitazione o disabilitazione globale del modulo nella configurazione di Magento.
• Visualizzazione condizionale del campo di upload nel checkout.
• Supporto della configurazione per prodotto tramite attributo del prodotto.
• Possibilità di richiedere l allegato solo per SKU selezionati.
• Upload di immagini e file PDF.
• Validazione lato backend di estensione, MIME type e dimensione del file.
• Salvataggio sicuro dei file fuori dalla directory pubblica.
• Associazione dell allegato a un ordine specifico.
• Link per scaricare il file nel pannello di amministrazione.
• Anteprima dei file supportati nella vista ordine.
• Pulizia automatica dei vecchi file temporanei.

Il modulo è pensato per i negozi Magento 2 che vendono prodotti o servizi che richiedono un file aggiuntivo da parte del cliente, ad esempio:

• prodotti personalizzati,
• stampa e tipografia,
• servizi grafici,
• prodotti medicali o ottici che richiedono documenti,
• ordini che richiedono una foto di riferimento,
• prodotti B2B che richiedono conferme o moduli.

• Meno comunicazioni manuali via email dopo l invio dell ordine.
• Minore rischio di perdere il file, perché l allegato viene collegato direttamente all ordine.
• Processo migliore per la gestione dei prodotti che richiedono dati aggiuntivi.
• Maggiore controllo sulla sicurezza dei file dei clienti.
• Lavoro più semplice per il team amministrativo nel pannello Magento.

L amministratore può impostare nel pannello:

• se il modulo è attivo,
• quando il campo allegato deve essere visibile,
• se l allegato è obbligatorio,
• quali estensioni di file sono consentite,
• qual è la dimensione massima del file,
• se l allegato deve essere visibile nell anteprima dell ordine,
• se è disponibile l anteprima del file.

Il modulo è stato progettato partendo dal presupposto che ogni file caricato sia non attendibile. Per questo motivo i file vengono validati lato server, ricevono nomi tecnici sicuri e non vengono pubblicati come URL diretti in pub/media. Il download e l anteprima avvengono tramite controller amministrativi protetti dai permessi di Magento.

Stores → Configuration → Sales → Order Attachments permette di impostare visibilità, obbligatorietà, titolo, descrizione, formati, limite e anteprima. Per impostazione predefinita il modulo è disattivato, il campo riguarda prodotti selezionati e il limite è di 10 MB.

Le estensioni supportate sono jpg, jpeg, png e pdf. requires_order_attachment indica il prodotto che richiede il campo; il carrello controlla anche i prodotti figli. Visibilità del modulo e obbligo di aggiungere un file sono impostazioni separate.

Il checkout attuale supporta un file, la sua rimozione e un nuovo caricamento. Il validatore rifiuta file vuoti o troppo grandi, controlla estensione e MIME dal contenuto e, per i PDF, anche la firma %PDF-.

Un nome con più di un punto viene rifiutato, ad esempio progetto.versione.pdf. L'elenco nella configurazione non estende il supporto a formati privi di una mappa MIME nel modulo. Questi controlli non sostituiscono un ulteriore scanner dei file, se richiesto dal processo del negozio.

Il caricamento è assegnato alla quote e salvato temporaneamente fuori dalla directory pubblica. Dopo la creazione dell'ordine il file viene spostato nella relativa posizione e il cron elimina i vecchi file temporanei.

Anteprima e download richiedono il permesso View Order Attachments e l'accesso all'ordine. Configuration del modulo è un permesso separato. Puoi accedere anche da kowal.store → Modules → Order Attachments → Configuration.

Il modulo di caricamento è un componente del checkout standard Magento. Hyvä, checkout alternativi e headless richiedono una verifica e un'integrazione personalizzata dell'interfaccia di upload.

L'obbligatorietà viene controllata anche durante quote submit: gli ordini via API o altri percorsi devono quindi garantire un collegamento conforme dell'allegato. L'assenza del modulo nell'interfaccia non significa che la validazione backend sia disattivata.

Il pacchetto kowal/module-order-attachment, modulo Kowal_OrderAttachment. Dopo aver configurato l'accesso al repository Kowal, installa il pacchetto, abilita il modulo, aggiorna Magento e svuota la cache. In produzione, includi compilazione e deploy dei contenuti statici secondo il processo del negozio.

1. Imposti visibilità e obbligatorietà
Configuri la modalità e contrassegni i prodotti selezionati.

2. Il cliente carica il file
Il backend controlla formato, contenuto e dimensione.

3. Il personale riceve l'allegato
Dopo l'acquisto il file appare nella vista dell'ordine.

Contrassegni il prodotto con l'attributo Requires Order Attachment. Con questo carrello il cliente vede il campo di caricamento e invia l'immagine prima dell'acquisto.

Dopo l'ordine, l'amministratore autorizzato può scaricare il file oppure aprire l'anteprima supportata. Il materiale resta collegato a un ordine specifico.