- \n
- Svuota la cache del plugin di caching dal pannello WordPress<\/li>\n
- Se usi un CDN (Cloudflare, StackPath), svuota anche la cache del CDN<\/li>\n
- Apri il sito in una finestra in incognito<\/strong> (Ctrl+Shift+N in Chrome) per escludere la cache del browser<\/li>\n
- Se il tuo hosting offre caching a livello server (Varnish, Redis), contatta il supporto per svuotarlo<\/li>\n<\/ol>\n
Causa B: Lo Snippet Non è Attivo<\/h3>\n
Verifica che lo snippet sia effettivamente attivo:<\/p>\n
- \n
- Vai su Code Snippets → All Snippets<\/strong><\/li>\n
- Controlla che il toggle dello snippet sia su Active<\/strong> (verde)<\/li>\n
- Se lo snippet è stato disattivato automaticamente dal sistema di Error Protection, vedrai un avviso<\/li>\n<\/ol>\n
Causa C: Posizione di Inserimento Errata<\/h3>\n
Se lo snippet è attivo ma non appare, verifica la posizione di inserimento:<\/p>\n
- \n
- Uno snippet con inserimento “Site Wide Header” non sarà visibile nel body della pagina<\/li>\n
- Uno snippet con inserimento “Shortcode” richiede che tu inserisca manualmente lo shortcode nella pagina<\/li>\n
- Uno snippet PHP con inserimento “Admin Only” non sarà visibile nel frontend<\/li>\n<\/ul>\n
Causa D: Logica Condizionale<\/h3>\n
Se hai attivato la logica condizionale, verifica che le condizioni siano soddisfatte sulla pagina dove ti aspetti di vedere lo snippet. Ad esempio, uno snippet condizionato a “Page URL contains \/prodotti” non apparirà sulla homepage.<\/p>\n
![\"Troubleshooting](\"https:\/\/gtechgroup.it\/blog\/wp-content\/uploads\/2026\/05\/wpc-01-snippets.png\")
<\/p>\nProblema 2: Lo Snippet Causa un Errore PHP<\/h2>\n
Se dopo aver attivato uno snippet PHP il sito mostra un errore o il famoso “white screen of death”, ecco come procedere:<\/p>\n
Se Riesci ad Accedere alla Dashboard<\/h3>\n
- \n
- Vai su Code Snippets → All Snippets<\/strong><\/li>\n
- WPCode dovrebbe aver già disattivato automaticamente lo snippet problematico<\/li>\n
- Se vedi un avviso di errore, clicca sullo snippet per vedere il dettaglio<\/li>\n
- Correggi l’errore nel codice e riattiva lo snippet<\/li>\n<\/ol>\n
Se NON Riesci ad Accedere alla Dashboard<\/h3>\n
- \n
- Usa l’URL di recupero<\/strong> — se hai salvato l’URL di recupero durante la configurazione, usalo per disattivare tutti gli snippet e ripristinare l’accesso<\/li>\n
- Modalità di recupero WordPress<\/strong> — WordPress 5.2+ include una modalità di recupero nativa. Controlla la tua email per un link di recupero inviato automaticamente da WordPress<\/li>\n
- Disattiva il plugin via FTP<\/strong> — come ultima risorsa, connettiti via FTP e rinomina la cartella del plugin
\/wp-content\/plugins\/insert-headers-and-footers\/<\/code> in qualcosa comeinsert-headers-and-footers-disabled<\/code>. Questo disattiverà il plugin e tutti i suoi snippet<\/li>\n- Database<\/strong> — se hai accesso al database (phpMyAdmin), puoi cercare e disattivare gli snippet direttamente nelle tabelle di WordPress<\/li>\n<\/ol>\n
Errori PHP Comuni e Soluzioni<\/h3>\n
- \n
- Parse Error: syntax error, unexpected ’}’<\/strong> — hai una parentesi graffa di troppo o una mancante. Controlla che ogni
{<\/code> abbia il suo}<\/code><\/li>\n- Fatal Error: Call to undefined function<\/strong> — stai chiamando una funzione che non esiste. Verifica che il nome sia corretto e che il plugin richiesto sia attivo<\/li>\n
- Fatal Error: Cannot redeclare function<\/strong> — hai due snippet che definiscono la stessa funzione. Rinomina una delle due funzioni con un nome univoco<\/li>\n
- Warning: array_merge() expects parameter to be array<\/strong> — stai passando un valore non-array a una funzione che richiede un array. Aggiungi un controllo del tipo prima della chiamata<\/li>\n<\/ul>\n
Problema 3: Conflitto con Altri Plugin<\/h2>\n
A volte WPCode può entrare in conflitto con altri plugin, specialmente:<\/p>\n
- \n
- Plugin che gestiscono anche header\/footer (MonsterInsights, PixelYourSite, Header Footer Code Manager)<\/li>\n
- Plugin di ottimizzazione che minificano o combinano JavaScript e CSS<\/li>\n
- Plugin di sicurezza che bloccano l’esecuzione di codice<\/li>\n<\/ul>\n
Come Identificare il Plugin in Conflitto<\/h3>\n
- \n
- Disattiva tutti i plugin tranne WPCode<\/li>\n
- Verifica se il problema persiste<\/li>\n
- Se il problema è risolto, riattiva i plugin uno alla volta<\/strong><\/li>\n
- Quando il problema riappare, hai trovato il plugin in conflitto<\/li>\n<\/ol>\n
Come Risolvere i Conflitti<\/h3>\n
- \n
- Plugin di header\/footer duplicati<\/strong> — scegli un solo plugin per gestire header\/footer e disinstalla gli altri<\/li>\n
- Plugin di minificazione<\/strong> — escludi gli script di WPCode dalla minificazione. Nella maggior parte dei plugin di caching, puoi aggiungere eccezioni per URL o handle specifici<\/li>\n
- Plugin di sicurezza<\/strong> — aggiungi WPCode alla whitelist del plugin di sicurezza o configura le eccezioni necessarie<\/li>\n<\/ul>\n
![\"Impostazioni](\"https:\/\/gtechgroup.it\/blog\/wp-content\/uploads\/2026\/05\/wpc-03-settings.png\")
<\/p>\nProblema 4: Lo Snippet JavaScript Non Funziona<\/h2>\n
Se uno snippet JavaScript non produce l’effetto desiderato, ecco le cause più comuni:<\/p>\n
Errori nella Console del Browser<\/h3>\n
- \n
- Apri gli strumenti sviluppatore del browser (F12 o Ctrl+Shift+I)<\/li>\n
- Vai alla tab Console<\/strong><\/li>\n
- Cerca messaggi di errore in rosso<\/li>\n
- L’errore ti indicherà la riga e il tipo di problema<\/li>\n<\/ol>\n
Problemi di Timing<\/h3>\n
Se lo script cerca di manipolare un elemento DOM che non esiste ancora, non funzionerà. Assicurati di:<\/p>\n
- \n
- Usare
document.addEventListener(’DOMContentLoaded’, function() { ... });<\/code> per attendere il caricamento del DOM<\/li>\n- Oppure inserire lo script nel footer<\/strong> (dopo il contenuto HTML)<\/li>\n
- Verificare che l’elemento target esista realmente nella pagina<\/li>\n<\/ul>\n
Conflitti jQuery<\/h3>\n
Se usi jQuery nel tuo snippet, ricorda che WordPress carica jQuery in modalità noConflict. Il simbolo
$<\/code> non è disponibile direttamente. Usa:<\/p>\n(function($) {\n $(document).ready(function() {\n \/\/ Il tuo codice jQuery qui\n });\n})(jQuery);<\/code><\/pre>\nScript Bloccato dal Plugin di Caching<\/h3>\n
Alcuni plugin di ottimizzazione (WP Rocket, Autoptimize) combinano e minificano gli script JavaScript. Questo può causare problemi se il tuo script dipende dall’ordine di caricamento o ha una sintassi che non sopravvive alla minificazione. Prova a:<\/p>\n
- \n
- Escludere lo script dalla minificazione nelle impostazioni del plugin di caching<\/li>\n
- Aggiungere l’attributo
data-no-minify="1"<\/code> al tag script<\/li>\n<\/ul>\nProblema 5: Il CSS Personalizzato Non Si Applica<\/h2>\n
Hai aggiunto delle regole CSS ma non vedi alcun cambiamento visivo:<\/p>\n
Specificità CSS Insufficiente<\/h3>\n
Il tuo CSS potrebbe essere sovrascritto da regole più specifiche del tema. Soluzioni:<\/p>\n
- \n
- Aumenta la specificità<\/strong> — usa selettori più specifici (es.
.site-header .main-nav a<\/code> invece dia<\/code>)<\/li>\n- Usa !important<\/strong> — come ultima risorsa, aggiungi
!important<\/code> alle tue regole<\/li>\n- Aumenta la priorità<\/strong> — imposta una priorità alta (es. 99) per caricare il CSS dopo quello del tema<\/li>\n<\/ul>\n
Tipo di Snippet Errato<\/h3>\n
Se hai creato un “HTML Snippet” con solo CSS ma senza i tag
<style><\/code>, il CSS verrà stampato come testo nella pagina. Assicurati di:<\/p>\n- \n
- Usare il tipo CSS Snippet<\/strong> (WPCode aggiunge automaticamente i tag style)<\/li>\n
- Oppure, se usi HTML Snippet, includere i tag
<style>...<\/style><\/code><\/li>\n<\/ul>\nCache CSS<\/h3>\n
I browser memorizzano aggressivamente i file CSS. Svuota la cache del browser e quella del plugin di caching dopo ogni modifica CSS.<\/p>\n
Problema 6: WPCode Rallenta il Sito<\/h2>\n
In circostanze normali, WPCode ha un impatto minimo sulle prestazioni. Se noti un rallentamento:<\/p>\n
Troppe Query al Database<\/h3>\n
Se hai centinaia di snippet, WPCode potrebbe generare un numero elevato di query al database. Soluzioni:<\/p>\n
- \n
- Disattiva o elimina gli snippet non più necessari<\/li>\n
- Consolida snippet simili in un unico snippet<\/li>\n
- Usa un plugin di caching del database (Redis, Memcached)<\/li>\n<\/ul>\n
Snippet PHP Pesanti<\/h3>\n
Uno snippet PHP che esegue operazioni complesse (query al database, chiamate API esterne, elaborazione di file) può rallentare il sito se eseguito su ogni pagina. Soluzioni:<\/p>\n
- \n
- Usa la logica condizionale per caricare lo snippet solo dove necessario<\/li>\n
- Implementa il caching dei risultati all’interno dello snippet usando i transient di WordPress<\/li>\n
- Ottimizza le query SQL e limita le chiamate API<\/li>\n<\/ul>\n
Script JavaScript Pesanti<\/h3>\n
Script che manipolano il DOM frequentemente o eseguono calcoli complessi possono rallentare la pagina. Soluzioni:<\/p>\n
- \n
- Usa
requestAnimationFrame<\/code> per le animazioni<\/li>\n- Evita listener su
scroll<\/code> senza throttling o debouncing<\/li>\n- Carica gli script nel footer con attributo
defer<\/code><\/li>\n<\/ul>\n![\"Dashboard](\"https:\/\/gtechgroup.it\/blog\/wp-content\/uploads\/2026\/05\/wc-02-dashboard-new.png\")
<\/p>\nProblema 7: Lo Snippet Funziona Solo per Gli Amministratori<\/h2>\n
Se lo snippet funziona quando sei loggato come amministratore ma non per i visitatori normali:<\/p>\n
- \n
- Cache differenziata<\/strong> — molti plugin di caching servono pagine diverse agli utenti loggati e non loggati. Svuota la cache e verifica<\/li>\n
- Logica condizionale<\/strong> — verifica che non ci sia una condizione “User Role = Administrator” attiva<\/li>\n
- Inserimento Admin Only<\/strong> — verifica che la posizione di inserimento non sia “Admin Only”<\/li>\n
- CDN<\/strong> — il CDN potrebbe servire una versione cached della pagina. Svuota la cache del CDN<\/li>\n<\/ul>\n
Problema 8: Errori Dopo l’Aggiornamento di WordPress<\/h2>\n
Se gli snippet smettono di funzionare dopo un aggiornamento di WordPress:<\/p>\n
- \n
- Verifica che WPCode stesso sia aggiornato all’ultima versione<\/li>\n
- Controlla il changelog di WordPress per eventuali funzioni deprecate o rimosse<\/li>\n
- Verifica che gli hook utilizzati nei tuoi snippet PHP siano ancora validi<\/li>\n
- Controlla la console del browser per errori JavaScript causati da cambiamenti nel DOM di WordPress<\/li>\n<\/ol>\n
Problema 9: Lo Shortcode Non Viene Interpretato<\/h2>\n
Se inserisci lo shortcode
[wpcode id="123"]<\/code> ma viene mostrato come testo invece di eseguire lo snippet:<\/p>\n- \n
- Verifica che il plugin WPCode sia attivo<\/strong><\/li>\n
- Verifica che l’ID dello snippet sia corretto<\/strong><\/li>\n
- Controlla che lo snippet sia impostato su “Shortcode” come metodo di inserimento<\/li>\n
- Se usi un page builder (Elementor, Beaver Builder), assicurati di inserire lo shortcode in un widget “Shortcode” dedicato, non in un widget di testo semplice<\/li>\n<\/ul>\n
Problema 10: WPCode Non Si Installa o Non Si Aggiorna<\/h2>\n
Se non riesci a installare o aggiornare WPCode:<\/p>\n
- \n
- Spazio disco<\/strong> — verifica di avere spazio sufficiente sul server<\/li>\n
- Permessi file<\/strong> — la directory
wp-content\/plugins\/<\/code> deve avere i permessi corretti (755)<\/li>\n- Limite di memoria PHP<\/strong> — aumenta il limite di memoria in php.ini o wp-config.php<\/li>\n
- Limite di timeout<\/strong> — su hosting lenti, l’aggiornamento potrebbe andare in timeout. Prova a aggiornare via FTP caricando manualmente i file del plugin<\/li>\n
- Firewall\/WAF<\/strong> — alcuni firewall (Sucuri, Wordfence, ModSecurity) possono bloccare il download del plugin. Disabilita temporaneamente il WAF durante l’aggiornamento<\/li>\n<\/ul>\n
Checklist di Troubleshooting Rapido<\/h2>\n
Quando qualcosa non funziona con WPCode, segui questa checklist in ordine:<\/p>\n
- \n
- ☐ Lo snippet è attivo? (toggle su Active)<\/li>\n
- ☐ La posizione di inserimento è corretta?<\/li>\n
- ☐ La logica condizionale è configurata correttamente?<\/li>\n
- ☐ Hai svuotato tutte le cache? (browser, plugin, CDN, server)<\/li>\n
- ☐ Hai verificato in una finestra in incognito?<\/li>\n
- ☐ La console del browser mostra errori?<\/li>\n
- ☐ Il codice sorgente della pagina contiene lo snippet? (Ctrl+U → Ctrl+F)<\/li>\n
- ☐ WPCode è aggiornato all’ultima versione?<\/li>\n
- ☐ Ci sono conflitti con altri plugin? (disattiva temporaneamente gli altri)<\/li>\n
- ☐ Il tema è compatibile? (prova con un tema predefinito come Twenty Twenty-Four)<\/li>\n<\/ol>\n
Quando Contattare il Supporto<\/h2>\n
Se hai seguito tutte le soluzioni in questo articolo e il problema persiste, è il momento di contattare il supporto:<\/p>\n
- \n
- WPCode Free<\/strong> — usa il forum di supporto su WordPress.org<\/li>\n
- WPCode Pro<\/strong> — hai accesso al supporto prioritario via email\/ticket<\/li>\n<\/ul>\n
Quando contatti il supporto, fornisci sempre:<\/p>\n
- \n
- La versione di WordPress e di WPCode<\/li>\n
- Il codice dello snippet problematico<\/li>\n
- Il messaggio di errore esatto (se presente)<\/li>\n
- I passi per riprodurre il problema<\/li>\n
- L’elenco dei plugin attivi<\/li>\n
- Il nome del tema in uso<\/li>\n<\/ul>\n
Conclusioni<\/h2>\n
La maggior parte dei problemi con WPCode ha soluzioni semplici: svuotare la cache, verificare la configurazione, correggere un errore di sintassi. Con questa guida di troubleshooting a portata di mano, puoi risolvere rapidamente qualsiasi problema e tornare a concentrarti su ciò che conta: la gestione e l’ottimizzazione del tuo sito WordPress.<\/p>\n
Ricorda: la prevenzione è sempre meglio della cura. Testa gli snippet in staging, attivali uno alla volta, documenta tutto e fai backup regolari. Seguendo queste best practice, ridurrai al minimo la probabilità di incontrare problemi.<\/p>\n
\n📚 Leggi anche gli altri articoli della serie WPCode<\/h3>\n
- \n
- Come Installare e Configurare WPCode su WordPress<\/a><\/li>\n
- WPCode: Aggiungere Codice a Header e Footer di WordPress<\/a><\/li>\n
- Creare Snippet di Codice Personalizzati con WPCode<\/a><\/li>\n
- Sicurezza degli Snippet: Come WPCode Protegge il Tuo Sito<\/a><\/li>\n
- WPCode Free vs Pro: Confronto Funzionalità e Prezzi<\/a><\/li>\n<\/ul>\n<\/div>\n
Hai un problema con WPCode che non riesci a risolvere? Contatta il team di G Tech Group<\/a>. I nostri tecnici specializzati in WordPress possono diagnosticare e risolvere qualsiasi problema legato a WPCode, ai tuoi snippet e alla configurazione del tuo sito. Offriamo assistenza rapida e professionale per garantire che il tuo sito funzioni sempre al meglio.<\/p>\n
Migliora il Tuo Sito WordPress<\/h3>\n
Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:<\/p>\n
- \n
- Come Installare Elementor su WordPress<\/a><\/li>\n
- Come Installare e Configurare WP Rocket<\/a><\/li>\n
- Come Installare e Configurare SEOPress<\/a><\/li>\n
- Come Installare e Configurare UpdraftPlus<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
Quando WPCode Non Funziona Come Previsto WPCode è un plugin stabile e affidabile, ma come qualsiasi software può presentare problemi in determinate situazioni. Conflitti con…<\/p>\n","protected":false},"author":0,"featured_media":167111,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"Problemi WPCode: Troubleshooting | Guida","_seopress_titles_desc":"Risoluzione problemi WPCode. Snippet non funzionante, errore 500, conflitti e modalita safe mode.","_seopress_robots_index":"","footnotes":""},"categories":[1],"tags":[2921,3071,3331,2918,492,3525],"class_list":["post-167162","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-senza-categoria","tag-debug","tag-errori","tag-problemi","tag-troubleshooting","tag-wordpress","tag-wpcode"],"_links":{"self":[{"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/posts\/167162","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/comments?post=167162"}],"version-history":[{"count":0,"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/posts\/167162\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/media\/167111"}],"wp:attachment":[{"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/media?parent=167162"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/categories?post=167162"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gtechgroup.it\/blog\/wp-json\/wp\/v2\/tags?post=167162"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Come Installare e Configurare WP Rocket<\/a><\/li>\n
- WPCode: Aggiungere Codice a Header e Footer di WordPress<\/a><\/li>\n
- Come Installare e Configurare WPCode su WordPress<\/a><\/li>\n
- WPCode Pro<\/strong> — hai accesso al supporto prioritario via email\/ticket<\/li>\n<\/ul>\n
- WPCode Free<\/strong> — usa il forum di supporto su WordPress.org<\/li>\n
- Permessi file<\/strong> — la directory
- Verifica che l’ID dello snippet sia corretto<\/strong><\/li>\n
- Verifica che il plugin WPCode sia attivo<\/strong><\/li>\n
- Logica condizionale<\/strong> — verifica che non ci sia una condizione “User Role = Administrator” attiva<\/li>\n
- Evita listener su
- Usa
- Oppure, se usi HTML Snippet, includere i tag
- Usa !important<\/strong> — come ultima risorsa, aggiungi
- Aumenta la specificità<\/strong> — usa selettori più specifici (es.
- Oppure inserire lo script nel footer<\/strong> (dopo il contenuto HTML)<\/li>\n
- Plugin di minificazione<\/strong> — escludi gli script di WPCode dalla minificazione. Nella maggior parte dei plugin di caching, puoi aggiungere eccezioni per URL o handle specifici<\/li>\n
- Quando il problema riappare, hai trovato il plugin in conflitto<\/li>\n<\/ol>\n
- Fatal Error: Call to undefined function<\/strong> — stai chiamando una funzione che non esiste. Verifica che il nome sia corretto e che il plugin richiesto sia attivo<\/li>\n
- Modalità di recupero WordPress<\/strong> — WordPress 5.2+ include una modalità di recupero nativa. Controlla la tua email per un link di recupero inviato automaticamente da WordPress<\/li>\n
- Vai su Code Snippets → All Snippets<\/strong><\/li>\n
- Controlla che il toggle dello snippet sia su Active<\/strong> (verde)<\/li>\n
- Se il tuo hosting offre caching a livello server (Varnish, Redis), contatta il supporto per svuotarlo<\/li>\n<\/ol>\n