- Versione
- 1.0.4
- Aggiornato il
- 05/11/2026
- Richiede WordPress
- 6.5 o superiore
- Richiede PHP
- 8.1 o superiore
- Dimensione
- 87 KB
- SHA-256
aebe3d7ffc9078bb…
ThinkKarma trasforma un sito WordPress costruito con Elementor in un gioco a punti: ogni visitatore ha un saldo di karma che sale o scende in base a come si comporta sulla pagina, e il sito cambia di conseguenza, con sezioni alternative, skin grafiche, frasi, finestre e piccoli effetti. È pensato per siti e negozi dall’identità ironica o sperimentale che vogliono un’esperienza diversa per ogni visitatore senza rinunciare alla cache di pagina.
Saldo, fasce ed eventi
Il saldo viene calcolato nel browser e determina la fascia del visitatore: di serie Santo, Neutro, Sospetto e Dannato, con soglie, nomi e numero modificabili. A muovere il saldo sono 27 eventi nativi, tra cui scroll veloce, lettura lenta, inattività, clic ripetuti, copia del testo, ritorno sul sito, visita notturna, scelte sul banner dei cookie, azioni sul carrello WooCommerce e sequenze di tasti segrete (di serie il codice Konami). Le soglie di ciascun evento si regolano in ThinkKarma → Impostazioni, dove si disattivano anche quelli indesiderati.
Lo stato del visitatore (saldo, visite, varianti viste, traguardi) viene salvato nel browser solo dopo il consenso dato con ThinkConsent nella categoria scelta; senza consenso il gioco riparte a ogni pagina. Al server arrivano solo conteggi anonimi aggregati, mai il saldo del singolo visitatore.
Regole e reazioni
Ogni regola collega un evento a una variazione del saldo, con priorità, tempo di attesa e condizioni facoltative: fasce, visite, giorni, orari, dispositivo, provenienza, intervallo di date e probabilità. Quando scatta, la regola esegue una o più reazioni: messaggio a comparsa, nuovo titolo, timbro, schermata di crash, finestra di dialogo, testo rallentato, pagina che trema, si inverte o si specchia, scambio di variante alla pagina successiva, sblocco di un traguardo, coupon, suono.
Varianti, canali e skin compatibili con la cache
Le sezioni che cambiano sono “slot” (di serie sei, da home_hero a 404). Per ogni slot si creano varianti, ciascuna legata a un template Elementor pubblicato, con peso, condizioni, skin associata e una regola di novità che evita di riproporre le ultime viste. La scelta avviene nel browser con un piccolo script in testa alla pagina, prima che venga disegnata: l’HTML in cache resta identico per tutti e la variante arriva da una rotta REST cacheabile. I canali raggruppano varianti di più slot in un’unica combinazione, che il visitatore può cambiare con il telecomando.
Le skin ridefiniscono colori e tipografia globali di Elementor, oltre a raggi, bordi, grana, cursore e font woff2 locali, senza CDN; al salvataggio il plugin avvisa se il contrasto tra testo e sfondo scende sotto il livello AA. All’attivazione vengono create due skin di partenza e un frasario di esempio. In ogni widget e contenitore di Elementor la scheda Avanzate riceve una sezione ThinkKarma per mostrarlo solo a certe fasce o con certe varianti, specchiarlo o farlo tornare indietro al clic. Quando cambia un contenuto di gioco, il plugin svuota la cache di LiteSpeed.
Widget Elementor
Nella categoria ThinkKarma di Elementor ci sono quindici widget: Variant Slot, Contatore karmico con pulsante “Cambia canale”, Slot machine karmica a tre rulli (azione, oggetto, tempistica) che può proporre un prodotto WooCommerce con il prezzo reale, Specchio, Ticker televendita, Bollino, Karma.exe, Finestra di dialogo retrò, Il Quotidiano di Te, Pratica dell’Ufficio, Tribunale del Karma, Scia boomerang del cursore, Frase del giorno, Traguardi e Modalità tranquilla. Frasi e titoli accettano segnaposto come {saldo}, {fascia}, {visite}, {giorni_assenza}, {ora}, {minuti_sul_sito}, {prodotto_visto} e {carrello_n}.
Il Tribunale del Karma
Il widget Tribunale raccoglie brevi storie dei visitatori. Per inviarne una serve un codice monouso ricevuto via email; la storia entra in moderazione, segnalata se contiene parole del filtro, e l’amministratore può pubblicarla, respingerla o trasformarla in una bozza di prodotto WooCommerce con accredito. Le storie pubblicate si votano in forma anonima, un voto per dispositivo. L’email è conservata cifrata, serve solo ad avvisare l’autore della pubblicazione e viene cancellata dopo un periodo configurabile, di serie 30 giorni; limiti orari e giornalieri frenano gli invii di codici.
Coupon karmici
Con WooCommerce attivo, una regola può premiare il visitatore con un coupon monouso: percentuale o importo fisso, validità in ore (di serie 48), ordine minimo, cumulabilità, prefisso del codice (di serie KARMA-), massimo per dispositivo e tetto giornaliero per tutto il sito. Il karma non modifica mai i prezzi mostrati né quelli del carrello. I codici emessi e il loro utilizzo si controllano in ThinkKarma → Coupon karmici.
Accessibilità e pagine protette
Crash, finestre ed effetti invasivi non partono mai su carrello, checkout, account, pagina di conferma dell’ordine e sui percorsi indicati nelle impostazioni (di serie privacy, cookie e termini). Il plugin rispetta l’impostazione di sistema per la riduzione del movimento, offre una modalità tranquilla attivabile dal visitatore e gestisce il focus e il tasto Esc nelle finestre.
Statistiche, debug e API
La dashboard mostra conteggi anonimi aggregati per giorno degli ultimi 30 giorni: varianti e canali visti, eventi, fasce, tiri della slot, crash, coupon emessi e usati, aggiunte al carrello e acquisti. Gli amministratori hanno in pagina un pannello di debug e possono forzare saldo, variante o canale dall’indirizzo; ThinkKarma → Import/Export sposta l’intera configurazione in JSON.
L’API REST nel namespace thinkkarma/v1 espone, per gli amministratori o con una Application Password, le rotte /bulk/{entity} per creare e aggiornare fino a 200 elementi per volta, /export, /import, /stats e /purge. Nel browser l’oggetto JavaScript window.ThinkKarma permette di leggere lo stato, emettere eventi personalizzati con prefisso custom: e modificare il saldo.
Integrazione con l’ecosistema ThinkClouds
Il plugin si aggiorna da ThinkRepo e dichiara un manifesto ThinkClouds con contenuti, riferimenti a template e prodotti, dati personali, rotte e controlli di salute. Per ThinkConsent descrive, in italiano e in inglese, lo stato salvato nel browser e il cookie che limita coupon e voti a un dispositivo.
Requisiti
- WordPress 6.5 o superiore
- PHP 8.1 o superiore
- Elementor, necessario per slot, varianti e widget
- WooCommerce, facoltativo, per coupon, prodotti della slot machine e promozione delle storie
- ThinkConsent, consigliato, per ricordare lo stato del visitatore tra una pagina e l’altra
- LiteSpeed Cache, facoltativo, per lo svuotamento automatico della cache
Download riservato alle persone autorizzate: ti chiederemo la tua email e un codice di conferma.
Novità per versione
1.0.4 05/11/2026
2026-11-05
- Il ticker non si riscrive a ogni variazione del saldo: le cinque frasi restano fino al prossimo caricamento.
- I widget dentro una variante vengono riempiti anche dopo l'avvio di Elementor.
- Due richieste insieme non superano i due codici l'ora per lo stesso indirizzo. Se l'email non parte, il posto nel tetto viene restituito.
- I voti del tribunale non si perdono se arrivano nello stesso momento.
1.0.3 05/11/2026
2026-11-05
- Le skin sovrascrivono i colori globali di Elementor: la dichiarazione vale anche sul body, non solo sull'elemento html.
- La scelta della variante non si blocca più quando in uno slot ce ne sono più di quattro.
- Il ticker mostra cinque frasi del suo contesto, e i widget dentro una variante (titolo, frasi, ticker, saldo) si riempiono dopo il caricamento.