2. Regole Globali e Automazione

Le impostazioni globali si trovano in WooCommerce > Community Pricing PRO > tab Impostazioni e influenzano il comportamento di tutto il plugin. Configurale nell’ordine presentato: ogni sezione dipende da quelle precedenti.

2.1 Stati Ordine Validi (Eligible Order Statuses)

Seleziona quali stati di un ordine WooCommerce contribuiscono al contatore della promozione. È il primo settaggio da configurare: senza ordini conteggiati correttamente, il plugin non funziona. Il contatore riflette le quantità vendute (unità), non il numero di ordini. Default su nuove installazioni: In lavorazione, Completato e In sospeso (on-hold).

2.2 Aggiornamento Ordini Sospesi (Update old orders pricing)

Impostazione Update unpaid order prices? (default: sì). Quando la community raggiunge una nuova soglia:

• Ordini non pagati (es. In attesa di pagamento): il totale della riga viene aggiornato al prezzo community corrente.

📍 Area cliente: come questi due flussi (unpaid vs paid) si riflettono in Il mio Account → My Rewards è spiegato nella FAQ §9.11. Modello di pricing (Mode A) e semantica del contatore: Capitolo 1 §1.1.

• Ordini già pagati: il totale non cambia mid-campaign. Al primo incasso il plugin salva il prezzo unitario pagato; a fine campagna eroga la differenza via Store Credit o Gateway Refund.

2.3 Metodo di Compensazione (Compensation Method)

Scegli come restituire il risparmio ai clienti alla chiusura della campagna:

1. Store Credit (Wallet / Coupon) — PREDEFINITO E CONSIGLIATO: Il sistema genera un coupon sconto personalizzato e lo invia via email. Funziona con qualsiasi gateway di pagamento ed è l’opzione predefinita sulle nuove installazioni.
2. Automatic Gateway Refund: Il sistema tenta di riaccreditare i soldi direttamente sul metodo di pagamento del cliente (Stripe, PayPal, ecc.).

Se selezioni Store Credit, appare il campo Store Credit Validity (days) — imposta la scadenza del coupon in giorni (default: 180 giorni). Impostare a 0 = nessuna scadenza (non consigliato: crea una passività finanziaria indefinita). Con Rimborso su gateway, esegui il test di readiness in §2.4 prima di ogni campagna.

2.4 Modalità Rimborso Sicurezza (Refund Dispatch Mode — Safety Control)

Controlla quando i rimborsi vengono effettivamente erogati dopo la chiusura della campagna. Si trova nella stessa sezione del Metodo di Compensazione:

• Automatico (default): rimborsi/coupon emessi automaticamente dopo il periodo Safety Guard.
• Manuale — richiede approvazione umana DROPSHIPPING SAFE: i rimborsi vengono congelati. Il gestore li sblocca dal Promotion Hub → tab 🔔 Manual Dispatch con Start Compensations dopo aver verificato la consegna. Usare se si spediscono beni fisici (il Diritto di Recesso decorre dalla consegna, non dal pagamento).

Questo Safety Control è dentro il blocco Metodo di Compensazione. Il default globale per i prodotti su “Inherit” si configura separatamente in §2.8.

2.5 Periodo di Sicurezza Rimborso (Refund Safety Guard — giorni)

Numero di giorni da attendere dopo la fine della promozione prima di emettere rimborsi o coupon. Copre il periodo legale di recesso (Diritto di Recesso). Default: 14 giorni. Impostare a 0 per eliminare l’attesa (non consigliato per vendite B2C di beni fisici).

Nella tab Impostazioni questo campo appare subito dopo il blocco Metodo di Compensazione (stessa area di scroll di Store Credit Validity e Forza gateway compatibili).

2.6 Forza Gateway Compatibili (Force refund-compatible gateways)

Compare dopo Refund Safety Guard e Store Credit Validity (days) nella tab Impostazioni. Contano due comportamenti distinti:

• Modalità Gateway Refund (motore — sempre attiva): quando il carrello contiene un prodotto in promozione community, il checkout nasconde già i metodi di pagamento che non dichiarano WooCommerce supports('refunds') (es. tipici Bonifico / Contrassegno). Questo non dipende dalla checkbox Force.
• Force refund-compatible gateways? (checkbox Impostazioni): filtro aggiuntivo della stessa famiglia. Con Store Credit selezionato, l’UI Impostazioni deseleziona e disabilita automaticamente questa opzione (JS) perché i coupon funzionano con qualsiasi gateway. Con Gateway Refund, il filtro motore sopra si applica già quando c’è una promo in carrello — lasciare Force deselezionato non riabilita i metodi non rimborsabili per quei carrelli.

2.7 Chiusura Anticipata — Default Globale (Early Closure — Global Default)

Imposta il comportamento predefinito per tutte le campagne:

• No — Attendi la data di scadenza (default): la campagna rimane aperta fino alla data di fine configurata per prodotto.
• Sì — Chiudi immediatamente al raggiungimento del target massimo: la campagna si chiude non appena le vendite raggiungono il cap dell’ultimo scaglione.

I prodotti con opzione impostata su “Inherit” ereditano questo valore. I prodotti con impostazione esplicita la sovrascrivono. Alla chiusura anticipata: la data di fine viene aggiornata, gli eventi pianificati vengono cancellati e il motore di rimborso parte immediatamente.

2.7.1 Early Closure vs Fine senza compensazione

Non sono sinonimi:

• Early Closure — chiusura al raggiungimento del target max (o path auto equivalente) e prosecuzione del flusso di compensazione per gli shopper eleggibili pagati.
• Fine senza compensazione (End Without Compensation) — chiusura admin con nessun reward (path no_reward). Usala solo se intendi fermare l’equalizzazione; i clienti devono vedere un messaggio di esito onesto (My Rewards / ordine / email di risultato).

Early close e lock a livello prodotto: Capitolo 3. Outcome messaging: Novità 2.8 · FAQ Cap. 9 (EWC / Manual Dispatch).

2.8 Modalità Dispatch — Default Globale (Refund Dispatch Mode — Global Default)

Imposta la modalità di erogazione rimborsi predefinita per tutte le campagne (ereditata dai prodotti con “Inherit”):

• Automatico — Rimborsa subito dopo il periodo Safety Guard
• Manuale (Dropshipping Safe) — Sospendi finché il gestore non sblocca DROPSHIPPING

Ogni singolo prodotto può sovrascrivere questa impostazione. Questo default globale vale per i prodotti su “Inherit”; il Safety Control attivo in §2.4 si configura dentro il blocco Metodo di Compensazione.

Stessa figura del §2.7 (Early Closure + Refund Dispatch Mode nella stessa area Impostazioni).

2.9 Avviso Politica di Recesso — Frontend Prodotto (v2.5+)

Questa sezione permette di mostrare un avviso informativo sulla pagina prodotto quando è attiva una promozione community. Introdotto in v2.5.0 — vedi anche Novità della versione 2.5.

2.9.1 Abilita Avviso sulla Pagina Prodotto

Se abilitato, mostra un box informativo nella pagina del prodotto per tutti i prodotti con promozione attiva.

2.9.2 Testo Avviso (Personalizzabile)

Il testo visualizzato sul prodotto. Puoi modificarlo liberamente. Viene mostrato solo quando il prodotto ha una promozione attiva. Testo predefinito:

“Acquistando questo prodotto in promozione, prendi atto che l’ordine è legato alla partecipazione della community. Consulta i nostri Termini e Condizioni Generali per i dettagli sul diritto di recesso.”

2.10 Pagine legali e opzioni avviso (v2.5+)

2.10.1 Mostra Giorni Buffer (Show buffer days)

Aggiunge automaticamente al testo dell’avviso una frase che indica il numero di giorni del Safety Guard prima che vengano erogati i rimborsi. Esempio anteprima:

“⏱️ Le procedure di rimborso e l’erogazione dei premi vengono avviate X giorni dopo la fine della promozione, in conformità ai termini contrattuali.”

L’anteprima buffer days compare nell’UI avviso / pagine legali — vedi figura §2.10.2.

2.10.2 Pagina Informazioni Legali (Legal Information Page)

Aggiornato in v2.6.3 — demo plugin e pagina storefront sono due scelte distinte.

Il plugin distingue:

• Pagina demo del plugin — creata con Genera pagina demo (una per lingua con Polylang). Compare un pannello stato con titolo e link Modifica/Anteprima. Solo questa pagina può essere rigenerata.
• Pagina usata sullo storefront — scelta dal menu Pagina usata sullo storefront. Viene linkata nelle email e nei box frontend. Puoi selezionare un’altra pagina WordPress e gestirla manualmente: la demo originale resta invariata e il plugin te lo segnala.

Il box giallo amministratore usa lo shortcode [wccp_legal_admin_notice] (traducibile, non congelato nel database).

2.11 Funzionalità Collegate alle Impostazioni Globali

2.11.1 Admin Notice Intelligente

Se ci sono campagne in attesa di dispatch manuale (modalità Manuale attiva), un avviso appare automaticamente in tutte le pagine dell’area admin (visibile solo a Shop Manager e Amministratori):

• 🟠 Arancio — campagne in attesa entro la finestra di tolleranza.
• 🔴 Rosso — campagne scadute che richiedono intervento immediato.

2.11.2 Dashboard Widget (Home Bacheca WP)

Un widget nella Home della Bacheca di WordPress elenca le campagne in attesa di dispatch manuale (solo panoramica stato). Per erogare le compensazioni vai su Promotion Hub → Manual Dispatch e usa Start Compensations (conferma richiesta) — il widget della bacheca non esegue il dispatch via AJAX.

2.11.3 Registro Attività (Global Log)

Accessibile dal tab Global Log nelle impostazioni, mostra ogni vendita rilevata, ogni rimborso emesso e gli eventuali errori dei gateway. Supporta filtri per data e per prodotto, con esportazione CSV. Da 2.9+: Details leggibili, legenda eventi e tooltip — vedi Novità 2.9 e Capitolo 7 §7.4.

2.12 Fuso orario negozio e avviso Settings (v2.8+)

Le date Inizio e Fine promozione (tab Community Pricing del prodotto) sono interpretate nel fuso orario WordPress del sito — Impostazioni → Generali → Fuso orario — non in UTC e non nel fuso del browser dell’admin.

• Prima di pianificare campagne, imposta il fuso corretto (es. Europe/Rome per l’Italia).
• Se il sito resta su UTC o senza fuso impostato, una promo “dalle 10:00” può risultare ancora In arrivo sullo storefront o chiudersi in orari inattesi.
• Dalla v2.8.0, in WooCommerce → Community Pricing → Settings → Global Rules compare un avviso se il fuso è UTC/non impostato su un negozio che non sembra staging — con link rapido alle Impostazioni generali WordPress.

2.13 My Rewards — data stimata compensazione (v2.8+)

Per gli ordini già pagati dopo la chiusura campagna, l’area cliente I miei Premi (My Rewards) mostra lo stato In elaborazione con:

• Tipo premio atteso — coupon Store Credit o rimborso su carta (Compensation Method globale).
• Data stimata — job Action Scheduler (batch rimborsi o chiusura promo) → fine campagna + Refund Safety Guard (days) (§2.3); con guard = 0 e nessun job: entro poche ore dalla chiusura.
• Avviso ritardi — nota che la data è indicativa (verifiche, gateway, revisione manuale).
• In Manual Dispatch non viene mostrata una data automatica.

Dettaglio stati cliente: FAQ §9.11. Implementazione: WCCP_Reward_Status::get_compensation_eta().