Risolvere i Problemi Comuni di Complianz: Troubleshooting

Risolvere i Problemi Comuni di Complianz: Troubleshooting

Anche il plugin più ben progettato può presentare problemi, specialmente quando opera in un ecosistema complesso come WordPress con decine di temi e migliaia di plugin. Complianz è un plugin robusto e affidabile, ma la sua interazione con l’ambiente WordPress, i servizi di terze parti e i sistemi di caching può occasionalmente generare comportamenti inattesi. In questa guida di troubleshooting analizzeremo i problemi più comuni che gli utenti incontrano con Complianz e le relative soluzioni, passo dopo passo.

Problema 1: Il Cookie Banner Non Appare

Il problema più segnalato dagli utenti è la mancata visualizzazione del cookie banner. Le cause possono essere molteplici e richiedono un’analisi sistematica per identificare quella corretta.

Il wizard non è stato completato: Complianz non mostra il banner fino a quando il wizard non è stato completato integralmente. Accedi a Complianz → Wizard e verifica che tutte le fasi siano contrassegnate come completate. Se una fase è incompleta, completala e verifica se il banner appare.

Conflitto con il plugin di caching: questa è la causa più frequente. I plugin di caching (WP Rocket, W3 Total Cache, LiteSpeed Cache, WP Super Cache, ecc.) possono cachare la pagina senza lo script di Complianz, o possono modificare l’ordine di caricamento degli script in modo che Complianz non funzioni correttamente. La soluzione è svuotare la cache dopo aver attivato o modificato Complianz, e aggiungere le pagine della cookie policy e della privacy policy alle esclusioni della cache.

Conflitto con altri plugin di cookie/privacy: se hai installato altri plugin di gestione dei cookie (CookieYes, CookieBot, Cookie Notice, GDPR Cookie Compliance, ecc.), possono entrare in conflitto con Complianz. Disattiva tutti gli altri plugin di gestione dei cookie e verifica se il banner di Complianz appare.

Il tema blocca il banner: alcuni temi WordPress modificano la struttura del DOM o aggiungono CSS che può nascondere il banner di Complianz. Prova a cambiare temporaneamente il tema con uno predefinito di WordPress (Twenty Twenty-Five) per verificare se il problema è legato al tema.

Il banner è già stato accettato: se hai già interagito con il banner durante i test, il cookie di consenso è stato impostato e il banner non verrà mostrato di nuovo. Apri il sito in una finestra di navigazione privata (incognito) per verificare se il banner appare per i nuovi visitatori. In alternativa, cancella i cookie del sito dal browser.

Problema 2: I Cookie Non Vengono Bloccati Prima del Consenso

Se i cookie di terze parti vengono impostati prima che l’utente abbia interagito con il banner, il tuo sito non è conforme al GDPR. Questo problema richiede un’attenzione immediata.

Script inseriti manualmente nel tema: se hai inserito script di Google Analytics, Facebook Pixel o altri servizi direttamente nel file header.php o footer.php del tema (o tramite un plugin di inserimento codice), Complianz non può bloccarli automaticamente. Rimuovi gli script dal tema e utilizza invece il meccanismo di integrazione di Complianz, oppure inserisci gli script tramite Google Tag Manager e configura il Consent Mode.

Plugin che caricano script autonomamente: alcuni plugin WordPress caricano script di tracking direttamente, senza passare per il sistema di Complianz. Ad esempio, il plugin ufficiale di Google Analytics per WordPress potrebbe caricare GA4 indipendentemente da Complianz. Verifica che non ci siano plugin che caricano script di tracking in modo indipendente, e se necessario disattivali a favore dell’integrazione tramite Complianz o GTM.

Contenuti incorporati non gestiti: video YouTube, mappe Google Maps, widget di social media e altri contenuti incorporati possono impostare cookie prima del consenso se non vengono gestiti da Complianz. Verifica che il blocco dei contenuti incorporati sia attivato nelle impostazioni di Complianz e che tutti i servizi di terze parti siano stati dichiarati nel wizard.

Cookie impostati lato server: Complianz opera lato client (nel browser) e non può bloccare cookie impostati lato server da PHP o da altre tecnologie server-side. Se il tuo sito imposta cookie di tracciamento lato server, dovrai gestire il blocco a livello applicativo.

Problema 3: Conflitti con i Plugin di Caching

I plugin di caching sono la causa più frequente di problemi con Complianz. Ecco le soluzioni specifiche per i plugin di caching più diffusi:

WP Rocket: escludi i file JavaScript di Complianz dalla minificazione e dalla combinazione. Nelle impostazioni di WP Rocket, vai su File Optimization → JavaScript e aggiungi complianz alla lista delle esclusioni. Svuota la cache dopo ogni modifica alle impostazioni di Complianz. Se utilizzi la funzione “Delay JavaScript execution”, assicurati che gli script di Complianz non siano ritardati.

LiteSpeed Cache: escludi i file di Complianz dall’ottimizzazione JavaScript (Page Optimization → JS Settings). Aggiungi cmplz alla lista delle esclusioni JS Combine e JS Defer. Svuota la cache LiteSpeed dopo le modifiche.

W3 Total Cache: escludi i file di Complianz dal minifying JavaScript. In Performance → Minify, aggiungi i file di Complianz alla lista “Never minify”. Se utilizzi il page caching, verifica che le richieste AJAX di Complianz non vengano cachate.

Autoptimize: escludi gli script di Complianz dall’aggregazione JavaScript. Nelle impostazioni di Autoptimize, aggiungi cmplz al campo “Exclude scripts from Autoptimize”.

CDN (Cloudflare, ecc.): se utilizzi un CDN come Cloudflare, assicurati che il CDN non cachi le richieste AJAX di WordPress (path /wp-admin/admin-ajax.php). Inoltre, svuota la cache del CDN dopo le modifiche a Complianz.

Problema 4: Il Banner Non Funziona su Mobile

Se il banner funziona su desktop ma non su mobile (o viceversa), le cause possono essere:

CSS responsive rotto: personalizzazioni CSS che funzionano su desktop possono rompere il layout su mobile. Verifica le media query nel tuo CSS personalizzato e testa su dispositivi mobili reali (non solo nell’emulatore del browser). Rimuovi temporaneamente il CSS personalizzato per verificare se il problema è nel CSS.

Plugin AMP: se il tuo sito utilizza AMP (Accelerated Mobile Pages), le pagine AMP hanno una struttura diversa dalle pagine standard e Complianz potrebbe non funzionare correttamente. Verifica la compatibilità di Complianz con il tuo plugin AMP e considera di disabilitare AMP se non è essenziale.

Viewport meta tag: se il tema non include correttamente il meta tag viewport, il banner potrebbe non essere visualizzato correttamente su mobile. Verifica che nel <head> del sito sia presente il tag <meta name="viewport" content="width=device-width, initial-scale=1">.

Problema 5: Google Consent Mode Non Funziona

Se il Google Consent Mode non invia correttamente i segnali di consenso, verifica i seguenti aspetti:

Versione del plugin: assicurati di utilizzare l’ultima versione di Complianz. Il Consent Mode v2 è supportato solo nelle versioni più recenti del plugin. Aggiorna Complianz alla versione più recente.

Ordine di caricamento degli script: il comando gtag(’consent’, ’default’, ...) deve essere eseguito PRIMA del caricamento di qualsiasi tag Google. Se altri plugin o il tema caricano Google Analytics o GTM prima di Complianz, il Consent Mode non funzionerà correttamente. Verifica l’ordine di caricamento degli script nella tab “Network” degli strumenti di sviluppo.

Conflitto con plugin di Google Analytics: se utilizzi un plugin WordPress per Google Analytics (MonsterInsights, Site Kit, ecc.) in combinazione con Complianz, i due plugin potrebbero entrare in conflitto nella gestione del Consent Mode. È generalmente consigliabile utilizzare un solo metodo per l’integrazione di GA4: o tramite il plugin GA4, o tramite Complianz/GTM.

Configurazione GTM errata: se utilizzi GTM, verifica che i tag nel contenitore abbiano le impostazioni di consenso integrato configurate correttamente. Un tag GA4 senza il consenso integrato configurato ignorerà i segnali del Consent Mode.

Problema 6: La Scansione dei Cookie Non Rileva Tutti i Cookie

La scansione automatica potrebbe non rilevare tutti i cookie presenti sul sito. Ecco le ragioni più comuni:

Cookie impostati dopo interazione: la scansione simula una visita passiva al sito. I cookie che vengono impostati solo dopo un’interazione specifica dell’utente (click su un pulsante, invio di un modulo, riproduzione di un video) non vengono rilevati dalla scansione automatica. Questi cookie devono essere aggiunti manualmente.

Cookie impostati solo per utenti registrati: la scansione viene eseguita come visitatore anonimo e non rileva i cookie impostati solo per utenti autenticati (ad esempio, cookie di sessione del CMS, cookie di plugin di membership, ecc.).

Cookie dietro login o paywall: se parti del sito sono accessibili solo dopo il login o il pagamento, la scansione non può accedere a queste aree e non rileverà i relativi cookie.

Cookie con nomi dinamici: alcuni servizi utilizzano cookie con nomi dinamici (che cambiano ad ogni sessione). La scansione potrebbe non riconoscere questi cookie o potrebbe rilevarli con un nome diverso ad ogni scansione.

Per una copertura completa, è consigliabile integrare la scansione automatica con un’analisi manuale, navigando il sito con gli strumenti di sviluppo del browser aperti e annotando tutti i cookie impostati nelle diverse situazioni.

Problema 7: I Documenti Legali Non Si Aggiornano

Se la cookie policy o la privacy policy non riflettono le modifiche apportate alla configurazione, prova queste soluzioni:

Rigenera i documenti: in Complianz, vai alla sezione Documenti e cerca un’opzione per rigenerare o aggiornare i documenti. Dopo aver modificato il wizard o la scansione dei cookie, i documenti dovrebbero aggiornarsi automaticamente, ma in alcuni casi può essere necessario forzare la rigenerazione.

Verifica le pagine WordPress: i documenti di Complianz sono pubblicati come pagine WordPress. Verifica che le pagine esistano, siano pubblicate (non in bozza) e non siano state spostate nel cestino. Naviga su Pagine → Tutte le pagine e cerca le pagine della cookie policy e della privacy policy.

Conflitto con page builder: se utilizzi Elementor, Divi, WPBakery o un altro page builder, il contenuto generato da Complianz potrebbe essere sovrascritto dal contenuto del page builder. Verifica che le pagine dei documenti non utilizzino un template del page builder che potrebbe interferire con il contenuto di Complianz.

Cache della pagina: svuota la cache del sito e del browser dopo aver aggiornato i documenti. I plugin di caching possono mostrare una versione vecchia della pagina fino allo svuotamento della cache.

Problema 8: Errori JavaScript nella Console

Se la console del browser mostra errori JavaScript relativi a Complianz, ecco come diagnosticarli e risolverli:

“cmplz is not defined”: questo errore indica che lo script principale di Complianz non è stato caricato. Potrebbe essere causato da un plugin di caching che blocca o ritarda il caricamento dello script, o da un errore nel caricamento delle risorse. Verifica che il file JavaScript di Complianz sia presente nella tab “Network” degli strumenti di sviluppo e che venga caricato senza errori.

Errori di tipo (TypeError): questi errori possono indicare conflitti con altri plugin JavaScript. Prova a disattivare gli altri plugin uno alla volta per identificare quale causa il conflitto. I conflitti più comuni sono con plugin che modificano il DOM (page builder, slider, popup) o con plugin che gestiscono il consenso (altri plugin cookie/GDPR).

Errori CORS: se vedi errori CORS (Cross-Origin Resource Sharing) nella console, potrebbe indicare un problema con la configurazione del CDN o del server. Verifica che le intestazioni CORS siano configurate correttamente per permettere il caricamento delle risorse di Complianz.

Problema 9: Il Banner Appare Sempre (Non Ricorda il Consenso)

Se il banner riappare ad ogni visita nonostante l’utente abbia già espresso le proprie preferenze, le cause possono essere:

Cookie di Complianz bloccato: il consenso viene memorizzato in un cookie. Se il browser dell’utente blocca i cookie di prima parte, o se un’estensione del browser (ad blocker, privacy tool) cancella i cookie, il consenso non viene memorizzato.

Scadenza del cookie troppo breve: verifica la durata del cookie di consenso nelle impostazioni di Complianz. Se è impostata su un valore troppo breve (ad esempio, sessione), il consenso verrà perso alla chiusura del browser.

Dominio del cookie errato: in configurazioni multidominio o con www e senza www, il cookie potrebbe essere impostato su un dominio diverso da quello visitato. Verifica che il dominio del cookie corrisponda al dominio del sito.

Cache che serve pagine diverse: alcuni sistemi di caching avanzati potrebbero servire versioni diverse della pagina a utenti diversi, causando la visualizzazione del banner anche a utenti che hanno già consentito. Verifica la configurazione della cache e assicurati che il cookie di consenso di Complianz sia escluso dalla logica di cache.

Problema 10: Complianz Rallenta il Sito

Se noti un rallentamento del sito dopo l’installazione di Complianz, ecco come diagnosticare e risolvere il problema:

Scansione in corso: durante la scansione dei cookie, Complianz effettua diverse richieste HTTP che possono rallentare temporaneamente il sito. La scansione dovrebbe essere un’operazione occasionale, non continua. Verifica che non sia configurata una scansione troppo frequente.

Ottimizzazione degli script: assicurati che i file JavaScript e CSS di Complianz siano minificati. I plugin di caching possono gestire la minificazione automaticamente, ma verificalo se sospetti un problema di prestazioni.

Database non ottimizzato: il registro dei consensi (versione premium) può far crescere il database nel tempo. Se noti un rallentamento progressivo, verifica le dimensioni della tabella dei consensi e valuta di implementare una politica di retention per eliminare i record più vecchi.

Plugin in eccesso: se hai molti plugin attivi, il problema potrebbe non essere Complianz di per sé ma l’accumulo di plugin. Utilizza un plugin di profiling come Query Monitor per identificare le reali fonti di rallentamento.

Strumenti di Diagnosi

Complianz include strumenti di diagnosi integrati che possono aiutarti a identificare e risolvere i problemi. Nella dashboard di Complianz, la sezione “Stato” mostra avvisi e suggerimenti per migliorare la configurazione. Presta attenzione a tutti gli avvisi e risolvi quelli segnalati come critici.

Oltre agli strumenti integrati, ecco alcuni strumenti esterni utili per la diagnosi:

• Strumenti di sviluppo del browser (F12): per verificare i cookie, gli script caricati, gli errori JavaScript e le richieste di rete
• Google Tag Assistant: per verificare il funzionamento del Consent Mode e dei tag Google
• Query Monitor (plugin WordPress): per identificare query lente, errori PHP e conflitti tra plugin
• GTmetrix / PageSpeed Insights: per misurare l’impatto sulle prestazioni del sito
• CookieMetrix: per una scansione esterna indipendente dei cookie del sito

Quando Contattare il Supporto

Se hai provato tutte le soluzioni sopra elencate e il problema persiste, è il momento di contattare il supporto. Per ottenere una risposta rapida ed efficace, includi nel tuo messaggio di supporto le seguenti informazioni:

• Versione di WordPress, del tema e di Complianz
• Descrizione dettagliata del problema con screenshot
• Passi per riprodurre il problema
• Lista dei plugin attivi
• Eventuali errori dalla console del browser (F12 → Console)
• Se il problema si verifica anche con il tema predefinito di WordPress
• Se il problema si verifica con tutti gli altri plugin disattivati

Conclusione

La maggior parte dei problemi con Complianz ha soluzioni semplici e ben documentate. I conflitti con i plugin di caching e con altri plugin di gestione dei cookie sono le cause più frequenti, e la loro risoluzione è generalmente rapida. La chiave per un troubleshooting efficace è un approccio sistematico: isola il problema, identifica la causa e applica la soluzione specifica.

Mantenere Complianz e WordPress aggiornati alle ultime versioni riduce significativamente la probabilità di incontrare problemi, poiché gli sviluppatori rilasciano regolarmente aggiornamenti che correggono bug e migliorano la compatibilità.

Se hai bisogno di assistenza tecnica per risolvere un problema con Complianz o per configurare il plugin sul tuo sito, contattaci. Il nostro team ha esperienza nella risoluzione di problemi complessi e può aiutarti a ottenere una configurazione perfetta.

Migliora il Tuo Sito WordPress

Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:

• Come Installare Elementor su WordPress
• Come Installare e Configurare WP Rocket
• Come Installare e Configurare SEOPress
• Come Installare e Configurare UpdraftPlus