Installazione passo passo
- Carica e attiva il plugin
Scarica lo zip del plugin, poi in WordPress vai su Plugin > Aggiungi nuovo > Carica plugin, seleziona `zefirox-woocommerce.zip` e attivalo. WooCommerce deve essere già attivo.
- Genera la chiave API
Nella dashboard Zefirox apri Impostazioni > Altri CMS e premi Genera chiave API. Copiala subito: per sicurezza non verrà mostrata di nuovo.
- Configura WooCommerce > Zefirox
Compila Zefirox API URL (l'URL API indicato nella dashboard), Widget script URL (di solito `<URL dashboard>/dms-widget.js`) e API key. Gli URL devono essere HTTPS.
- Crea la campagna e collega il prodotto
Crea la campagna nella dashboard Zefirox, poi modifica il prodotto WooCommerce: nella scheda Generale incolla l'ID (UUID) nel campo Zefirox campaign ID. Per i prodotti variabili puoi indicare un ID diverso per ogni variazione.
- Scegli come mostrare il widget
Con l'opzione Product page widget attiva il widget appare da solo sulle pagine dei prodotti in campagna; in alternativa usa lo shortcode `[zefirox_widget]` (anche con `product_id` o `campaign_id`).
- Fai un ordine di prova
Completa un ordine pagato su un prodotto collegato e controlla le note dell'ordine: deve comparire "Zefirox: order reported to campaign …".
Cosa ottieni su WooCommerce
- Widget sulla pagina prodotto con prezzo attuale, prossimo scaglione, barra di avanzamento e countdown.
- Mappatura campagna per prodotto, con possibilità di sovrascriverla per singola variazione.
- Shortcode `[zefirox_widget]` per posizionare il widget dove vuoi.
- Invio degli ordini pagati firmato (HMAC SHA-256 con timestamp) e idempotente, una richiesta per campagna.
- Invio in background con Action Scheduler e fino a 6 ritentativi automatici, più l'azione ordine "Resend to Zefirox".
- Compatibile con HPOS (High-Performance Order Storage) e con i blocchi Carrello/Checkout.
- Nessun nome, e-mail o indirizzo del cliente inviato a Zefirox.
Quando un ordine viene inviato a Zefirox
Il plugin invia l'ordine solo quando è pagato: pagamento completato o stato "In lavorazione"/"Completato". Gli ordini in attesa di pagamento, sospesi o falliti non vengono inviati.
Per ogni campagna presente nell'ordine parte una richiesta con quantità e importo in centesimi. L'esito viene salvato sull'ordine e scritto nelle note.
- Coda in WooCommerce > Stato > Azioni pianificate (gruppo `zefirox`).
- Errori registrati anche in WooCommerce > Stato > Log (sorgente `zefirox`).
- Override facoltativi in `wp-config.php`: `ZEFIROX_API_URL`, `ZEFIROX_WIDGET_URL`, `ZEFIROX_API_KEY`.
Sicurezza della chiave API
La chiave API serve solo lato server per autenticare e firmare le notifiche d'ordine: non viene mai esposta nel negozio. Nel campo delle impostazioni, una volta salvata, puoi lasciarla vuota per mantenerla.
Domande frequenti
Il plugin è disponibile nella directory di WordPress.org?
Non ancora: si installa caricando lo zip da Plugin > Aggiungi nuovo > Carica plugin.
Cosa succede se l'API di Zefirox non risponde?
Gli ordini restano in coda con Action Scheduler e vengono ritentati automaticamente fino a 6 volte. Gli errori finiscono nelle note dell'ordine e puoi reinviare a mano con "Resend to Zefirox".
Posso usare il plugin con i blocchi Carrello e Checkout?
Sì, il plugin dichiara la compatibilità con i blocchi Carrello/Checkout e con HPOS.
Cosa viene rimosso disinstallando il plugin?
Impostazioni, ID campagna di prodotti e variazioni e invii in sospeso. Le note degli ordini restano come storico.