DataFirefly Order Vouchers — Guida completa
Installa e utilizza la visualizzazione dei codici promozionali usati e dell'importo dello sconto nell'elenco degli ordini del back office, per PrestaShop 8 e 9.
Presentazione e prerequisiti
DataFirefly Order Vouchers aggiunge due colonne all’elenco degli ordini del back office: il o i codici promozionali utilizzati su ciascun ordine, e l’importo totale dello sconto (formattato nella valuta dell’ordine). Il modulo non crea alcuna tabella, non scrive nulla nel database e non sovrascrive alcun controller: si limita a leggere i buoni già registrati sui tuoi ordini e a mostrarli nella griglia.
- Compatibile con PrestaShop 8.0 a 9.x.
- PHP 7.4 a 8.3.
- Multinegozio e multilingua (FR/EN/ES/DE/IT).
- Nessuna sovrascrittura di file: solo gli hook nativi della griglia Symfony degli ordini.
I dati provengono dalle tabelle order_cart_rule e cart_rule. Un ordine senza buono mostra semplicemente una cella vuota in entrambe le colonne.
Installazione
- Scarica l’archivio
dfordervouchers.zipdal tuo account cliente. - Nel back office, vai su Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e rilascia l’archivio.
- L’installazione registra i due hook della griglia degli ordini. Non è richiesta alcuna configurazione.
Subito dopo l’installazione, apri Ordini > Ordini: le due nuove colonne compaiono subito dopo la colonna “Totale”.
Il modulo non ha una pagina di configurazione: funziona immediatamente dopo l’installazione, senza alcuna impostazione.
Le due colonne aggiunte
Codice/i promozionale/i
Questa colonna mostra il codice di ciascun buono realmente applicato all’ordine. Quando un ordine combina più codici, vengono raggruppati, deduplicati e separati da virgole. Le promozioni automatiche (regole del carrello senza codice) non vengono mostrate in questa colonna, poiché non hanno un codice da presentare.
Sconto
Questa colonna totalizza l’importo scontato sull’ordine, così come registrato al momento della convalida (IVA inclusa per impostazione predefinita), e lo mostra nella valuta dell’ordine. Un ordine in sterline o dollari mostra quindi il suo importo nella propria valuta. Se non è stato applicato alcuno sconto, la cella rimane vuota.
Come funziona
A partire da PrestaShop 1.7.7, l’elenco degli ordini si basa sulla griglia Symfony. Il modulo vi si aggancia tramite due hook ufficiali:
actionOrderGridDefinitionModifier: aggiunge le due colonne alla definizione della griglia, subito dopo la colonna “Totale”.actionOrderGridQueryBuilderModifier: arricchisce la query della griglia con due sottoquery correlate suorder_cart_ruleecart_rule.
Poiché le sottoquery sono correlate all’ID dell’ordine, non producono alcuna duplicazione di righe e non entrano in conflitto con il raggruppamento interno della griglia. L’importo riutilizza la valuta già unita dal core nella query della griglia.
Il modulo è in sola lettura: non scrive mai nel database e non modifica alcun ordine. Può essere installato e disinstallato senza alcun impatto sui tuoi dati.
Casi particolari
Più codici su un ordine
Tutti i codici vengono mostrati, separati da virgole. L’importo della colonna “Sconto” somma tutti i buoni applicati all’ordine.
Promozioni automatiche senza codice
Per impostazione predefinita, la colonna “Sconto” somma tutte le riduzioni dell’ordine, comprese le eventuali promozioni automatiche senza codice. La colonna “Codice/i promozionale/i” mostra solo i buoni che hanno un codice. Su richiesta è disponibile una variante che limita l’importo ai soli buoni con codice.
Multivaluta
L’importo viene sempre mostrato nella valuta dell’ordine corrispondente, riutilizzando la valuta unita dalla griglia nativa.
Multinegozio
La visualizzazione rispetta il contesto del negozio corrente del back office, esattamente come la griglia nativa degli ordini.
Ordinamento e personalizzazione
Le etichette di entrambe le colonne sono traducibili tramite il sistema di traduzione dei moduli PrestaShop, in tutte e cinque le lingue. Poiché l’ordinamento nativo della griglia si basa su una whitelist di campi, cliccare sull’intestazione di queste colonne calcolate non attiva alcun ordinamento ma non provoca alcun errore.
FAQ e risoluzione dei problemi
Le colonne non compaiono
Verifica che il modulo sia installato e attivato nel Gestore dei moduli, quindi ricarica la pagina Ordini > Ordini. Le colonne compaiono subito dopo la colonna “Totale”.
La colonna “Sconto” è vuota anche se viene mostrato un codice
Questo può accadere se il buono registrato sull’ordine ha un valore nullo, ad esempio un buono di spedizione gratuita. Il codice rimane visualizzato, ma l’importo scontato è uguale a zero.
Il modulo funziona su PrestaShop 8 e 9?
Sì. Si basa sulla griglia Symfony degli ordini presente in entrambe le versioni, tramite gli hook ufficiali di definizione e di query builder.
Cosa succede alla disinstallazione?
La disinstallazione rimuove semplicemente i due hook. Poiché non è stata creata alcuna tabella e non è stato scritto alcun dato, non resta nulla nel database.