Pre-order Manager — Guida completa

Panoramica

DataFirefly Pre-order Manager trasforma qualsiasi prodotto WooCommerce (semplice o variabile) in un preordine professionale. Il cliente paga un acconto o l’importo totale al momento dell’ordine; alla data di disponibilità (ETA), il plugin converte automaticamente il preordine: i pagamenti completi passano in elaborazione, gli acconti generano un ordine di saldo con link di pagamento. Promemoria automatici, limite di stock futuro, badge personalizzabile e una API REST completa chiudono il flusso.

Installazione

1. Scarica il file dfpreorder.zip dal tuo account DataFirefly.
2. Nell’amministrazione WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin.
3. Seleziona lo ZIP, fai clic su Installa ora e attiva il plugin.
4. Appare un nuovo sottomenu WooCommerce → Pré-commandes: è il centro di controllo del plugin.

Impostazioni globali

Apri WooCommerce → Pré-commandes → scheda Impostazioni. Le opzioni sono raggruppate in blocchi:

• Attivazione — interruttore globale del modulo e politica del carrello misto (consentire o bloccare la miscela di preordini e prodotti standard nello stesso carrello).
• Conversione automatica — attiva la conversione giornaliera all’ETA, definisce un periodo di tolleranza (da 0 a 90 giorni) dopo l’ETA, e il ripristino delle unità riservate all’annullamento.
• Visualizzazione del badge — testo, colore di sfondo, colore del testo e posizionamenti (elenchi del negozio e/o pagina prodotto).
• Etichette — testo del pulsante di aggiunta al carrello ed etichetta che precede l’ETA.
• Email cliente — attivazione delle email di disponibilità e di saldo da pagare.
• Promemoria saldo non pagato — attivazione dei promemoria e soglie in giorni separati da virgole (predefinito 7,14,30).
• Spese di spedizione — opzione di trasferimento delle spese di spedizione sull’ordine di saldo (vedi sezione dedicata più in basso).

Configurare un prodotto in preordine

1. Apri il prodotto nell’editor WooCommerce e trova la scheda Pré-commande nei dati del prodotto.
2. Spunta Attiva preordine.
3. Scegli la modalità di pagamento: “Pagamento completo” (il cliente paga tutto all’ordine) o “Acconto” (percentuale o importo fisso, il saldo viene fatturato alla disponibilità).
4. Inserisci la data ETA (data di disponibilità prevista). Un campo di testo opzionale mostra un’etichetta libera al posto della data (es. “Disponibile a inizio luglio”).
5. Definisci opzionalmente un limite di stock futuro: il numero massimo di unità in preordine. Il contatore delle unità riservate viene mostrato accanto al campo.
6. Personalizza se necessario il testo del badge per questo prodotto e il comportamento di conversione automatica (eredita dall’impostazione globale, forza sì, forza no).
7. Salva: il badge e l’avviso ETA appaiono immediatamente sulla scheda prodotto.

Ciclo di vita di un preordine

Ecco il flusso completo, passo dopo passo:

1. Ordine iniziale — il cliente aggiunge il prodotto al carrello. In modalità acconto, il prezzo mostrato nel carrello e nel checkout è l’importo dell’acconto, con la menzione del saldo restante. Paga tramite il gateway abituale.
2. Registrazione — al pagamento, l’ordine passa allo stato wc-preorder, viene creata una riga nella tabella interna del plugin, e il cliente riceve l’email di conferma del preordine.
3. Attesa — il preordine appare in WooCommerce → Pré-commandes → scheda Elenco con stato, data ETA e importi.
4. Conversione all’ETA — il cron giornaliero (03:00, ora del sito) rileva i preordini scaduti (ETA + periodo di tolleranza opzionale):
   • Modalità pagamento completo: l’ordine passa a “In elaborazione” e il cliente riceve l’email di disponibilità.
   • Modalità acconto: viene generato automaticamente un ordine di saldo (stato “In attesa di pagamento”) e il cliente riceve l’email “Saldo da pagare” con un pulsante di pagamento diretto.
5. Pagamento del saldo — il cliente paga tramite il link dell’email (URL di pagamento nativo WooCommerce, protetto da order key, senza login) o da Il mio account. Al pagamento, il preordine viene contrassegnato come completato e l’ordine originale passa a “In elaborazione” non appena tutte le sue righe di preordine sono risolte.

Gestione dall’amministrazione

La scheda Elenco mostra tutti i preordini con filtro per stato, ricerca per ID ordine o prodotto e paginazione. Esistono quattro stati: In attesa (blu), Saldo in attesa (ambra), Completato (verde) e Annullato (grigio). Ogni riga ha due azioni:

• Converti — forza la conversione immediata senza attendere l’ETA (utile quando lo stock arriva in anticipo).
• Annulla — annulla il preordine, libera le unità riservate (se l’opzione di ripristino è attiva) e passa l’ordine a “Annullato” se era ancora in stato preordine.

Il pulsante “Esegui la conversione ora” in alto attiva immediatamente il controllo giornaliero senza attendere il cron delle 03:00.

Lato cliente: Il mio account

Nella pagina Il mio account → Dettaglio ordine:

• L’ordine originale mostra un pannello “Saldo del tuo preordine” con gli ordini di saldo collegati, il loro importo, stato e un pulsante “Paga il saldo” per quelli ancora non pagati.
• L’ordine di saldo mostra a sua volta un pannello “Preordine originale” con link all’ordine iniziale.

Email cliente

Sono incluse quattro email transazionali, ciascuna in versione HTML e testo semplice, modificabili da WooCommerce → Impostazioni → Email:

• Conferma del preordine — inviata alla registrazione del preordine, con avviso acconto ove applicabile.
• Preordine disponibile — inviata alla conversione in modalità pagamento completo.
• Saldo da pagare — inviata alla generazione dell’ordine di saldo, con l’importo evidenziato e pulsante di pagamento diretto.
• Promemoria saldo — promemoria inviati alle soglie configurate se il saldo resta non pagato.

Promemoria automatici

Quando l’opzione è attiva, il cron giornaliero scansiona gli ordini di saldo ancora non pagati (stati in attesa, in sospeso o fallito) e invia un promemoria a ogni soglia configurata. Il campo accetta una lista di giorni separati da virgole — per esempio 7,14,30 per ricordare 7, 14 e 30 giorni dopo la creazione dell’ordine di saldo. Ogni soglia viene attivata una sola volta per ordine; il tracciamento è memorizzato nella meta dell’ordine di saldo.

Spese di spedizione sull’ordine di saldo

Per impostazione predefinita, l’ordine di saldo non contiene spese di spedizione (sono state pagate sull’ordine originale). Se il tuo acconto copre solo la prenotazione del prodotto e fatturi la spedizione al momento dell’invio, attiva l’opzione “Trasferisci le spese di spedizione al saldo”: le righe di spedizione dell’ordine originale vengono duplicate sull’ordine di saldo, con metodo e tasse intatti.

Shortcode

• [dfpo_badge product_id="123"] — mostra il badge Preordine del prodotto indicato (o del prodotto corrente se omesso).
• [dfpo_eta product_id="123"] — mostra la data di disponibilità formattata con la sua etichetta.
• [dfpo_remaining product_id="123"] — mostra il numero di unità ancora prenotabili quando è definito un limite.

API REST

Tutte le rotte si trovano sotto il namespace dfpo/v1 e richiedono la capacità manage_woocommerce (autenticazione tramite chiave API WooCommerce o application password):

• GET /wp-json/dfpo/v1/preorders — elenco paginato (parametri status, page, per_page).
• GET /wp-json/dfpo/v1/preorders/{id} — dettaglio di un preordine.
• POST /wp-json/dfpo/v1/preorders/{id}/convert — forza la conversione (parametro booleano force).
• POST /wp-json/dfpo/v1/preorders/{id}/cancel — annulla e libera lo stock riservato.
• POST /wp-json/dfpo/v1/run-conversion — attiva immediatamente il controllo di conversione.

Hook per sviluppatori

• dfpo_preorder_registered (azione) — dopo la creazione di una riga di preordine.
• dfpo_preorder_converted_full (azione) — dopo la conversione di un pagamento completo.
• dfpo_preorder_converted_deposit (azione) — dopo la generazione dell’ordine di saldo.
• dfpo_preorder_balance_paid (azione) — dopo l’incasso del saldo.
• dfpo_email_preorder_balance_reminder (azione) — all’attivazione di un promemoria (permette di collegare un SMS o altro canale).
• dfpo_badge_html (filtro) — per modificare l’HTML del badge.

Risoluzione dei problemi

• La conversione non si attiva — verifica che WP-Cron funzioni sul tuo hosting (alcuni lo disattivano; usa allora un cron di sistema che chiama wp-cron.php). Puoi sempre convertire manualmente dalla scheda Elenco.
• Il prezzo del carrello sembra errato dopo la modifica del prodotto — svuota il carrello di prova e le cache (oggetto e pagina). Il plugin legge il prezzo originale direttamente dal database per evitare artefatti di cache.
• L’email del saldo non arriva — verifica che l’email “Saldo da pagare” sia attivata in WooCommerce → Impostazioni → Email, e testa la deliverability generale del tuo sito (SMTP consigliato).
• Il badge non appare — verifica l’interruttore globale del modulo, i posizionamenti del badge nelle impostazioni, e che il tema chiami gli hook WooCommerce standard (woocommerce_single_product_summary, woocommerce_after_shop_loop_item_title).

Disinstallazione

Disattivare il plugin conserva tutti i dati. Eliminare il plugin da Plugin rimuove definitivamente le tabelle interne, le opzioni e le meta prodotto. Gli ordini WooCommerce (originale e di saldo) non vengono mai eliminati.