Documentazione / Scrivi messaggi utili ai clienti

Min/Max · Guida della versione 0.12.0 · Aggiornata il 13 settembre 2026

Scrivi messaggi utili ai clienti

Spiega ai clienti cosa devono modificare. Mantieni chiaro il vincolo effettivo della regola, soprattutto quando usi lo stesso testo per molti prodotti.

Imposta i messaggi predefiniti

  1. Apri HookSpark → Min/Max → Messaggi .
  2. Scrivi il messaggio sulle quantitĂ  in Errori di quantitĂ  e quello sulla spesa in Errori di importo.
  3. Espandi il selettore delle variabili per inserirne una supportata nel punto del cursore.
  4. Seleziona Anteprima con valori di esempio. Leggi sia i valori di input fittizi sia il messaggio risultante.
  5. Salva i messaggi. La sola anteprima non salva il testo.

Un esempio riutilizzabile e sicuro per le quantità è Controlla la quantità. {default}. Mantiene la spiegazione predefinita pertinente alla violazione effettiva.

Messaggio personalizzato con la variabile default e relativo esempio visualizzato
Anteprima non salvata di un messaggio: {default} inserisce la spiegazione predefinita. L’anteprima usa valori fittizi. Seleziona l’immagine per ingrandirla.

Personalizza una singola regola

Apri la regola ed espandi Messaggio del cliente . Inserisci il messaggio specifico e salva la regola. La precedenza è: messaggio non vuoto della regola → messaggio globale per quella metrica → spiegazione predefinita. Lascia vuoto il testo della regola per ereditare quello globale; lascia entrambi vuoti per usare il testo predefinito tradotto.

Riferimento delle variabili

VariabileSignificato / disponibilitĂ 
{product}Nome del prodotto nei contesti del singolo prodotto; non disponibile per un aggregato senza prodotto.
{rule}, {group}Il nome della regola. In questa versione entrambe indicano il nome della regola.
{minimum}, {maximum}La soglia configurata; non disponibile se il campo della soglia è vuoto.
{multiple}Il multiplo di quantitĂ , quando impostato. Non disponibile nelle regole sugli importi.
{current}La quantità o l’importo attuale pertinente.
{missing}Quanto manca al minimo, mai sotto zero. Non è la successiva quantità valida per la confezione.
{currency}Codice valuta memorizzato per le regole sugli importi; non disponibile nei messaggi sulle quantitĂ .
{default}La spiegazione predefinita completa per questa violazione.

Esempi e limiti

Per una regola di importo minimo: Spesa minima: {minimum} {currency}. Importo attuale: {current} {currency}. {default}. Con minimo 100 e importo attuale 80 EUR, soglia e importo vengono visualizzati a partire da questi valori.

Se una regola di quantità ha minimo 6 e multiplo 6, con quantità attuale 7 il valore di {missing} è 0, ma la quantità resta non valida. Non usare “aggiungi {missing}” come soluzione universale per ogni cliente.

I modelli sono testo semplice, al massimo 2000 byte: niente PHP o HTML arbitrario. Variabili sconosciute e parentesi graffe non valide vengono rifiutate. Se una variabile elencata non è disponibile in un contesto specifico, l’intero messaggio viene sostituito dalla spiegazione predefinita, anziché mostrare un segnaposto vuoto.

Verifica e traduci

Prova un carrello realmente non valido, poi correggilo: il vecchio errore deve scomparire. Le anteprime globali usano valori fittizi, non il carrello reale. I messaggi personalizzati salvati sono contenuti tuoi: traducili direttamente, perché cambiare lingua di WordPress non traduce automaticamente le tue frasi.

Se un’altra sessione ha già salvato i messaggi, confronta il nuovo testo salvato con la tua bozza prima di inviarla di nuovo. Ricarica l’editor e confronta le modifiche prima di salvare di nuovo.

Anteprima della schermata