Risoluzione dei problemi

Riepilogo

La maggior parte dei problemi di ZenBlocks si risolve con Clear CSS Cache, riattivando il plugin e svuotando la cache del browser. Di seguito trovi i controlli specifici per ogni caso.

I blocchi non compaiono nel pannello di inserimento

Procedura di verifica

  1. Verifica che il plugin sia attivo
  • Apri Plugin nella bacheca WordPress
  • Controlla che ZenBlocks sia presente nell'elenco e risulti attivo
  • Se è disattivato, fai clic su Attiva
  1. Verifica la versione di WordPress
  • Controlla la versione in Bacheca > Aggiornamenti
  • ZenBlocks richiede WordPress 6.0 o superiore
  1. Verifica se Classic Editor è attivo
  • Se il plugin Classic Editor è attivo, il block editor potrebbe essere disabilitato
  • Assicurati in Impostazioni > Scrittura che l'editor predefinito sia il block editor
  1. Verifica eventuali conflitti con altri plugin
  • Disattiva temporaneamente tutti gli altri plugin e lascia attivo solo ZenBlocks
  • Se il blocco compare, riattiva gli altri plugin uno alla volta per individuare il conflitto

Il pannello delle impostazioni non si apre o non viene visualizzato

Procedura di verifica

  1. Assicurati che il blocco sia selezionato
  • Fai clic sul blocco per selezionarlo
  • Controlla che attorno al blocco compaia un bordo blu
  1. Verifica che la sidebar sia visibile
  • Fai clic sull'icona Settings (ingranaggio) in alto a destra nell'editor
  • Assicurati che la scheda Block nella parte alta della sidebar sia selezionata
  1. Controlla eventuali errori negli strumenti sviluppatore del browser
  • Apri gli strumenti sviluppatore del browser (F12)
  • Verifica se nella scheda Console sono presenti errori JavaScript
  • In caso di errore, segnala il problema nel forum di supporto allegando uno screenshot

Gli stili non vengono applicati nel front-end

Procedura di verifica

  1. Svuota la cache CSS
  • Apri Settings > ZenBlocks nella bacheca WordPress
  • Fai clic su Clear CSS Cache
  • Salva di nuovo la pagina interessata
  1. Svuota la cache del browser
  • Svuota la cache del browser
  • Oppure forza il ricaricamento con Ctrl+Shift+R / Cmd+Shift+R
  1. Salva nuovamente la pagina
  • Apri la pagina interessata nell'editor
  • Fai clic su Aggiorna
  • Il file CSS verrà rigenerato
  1. Controlla la cache lato server
  • Se usi un plugin di cache come WP Super Cache, W3 Total Cache o LiteSpeed Cache, svuota anche quella cache
  • Se usi un CDN come Cloudflare, svuota anche la cache del CDN

Nota: La cache CSS di ZenBlocks viene salvata in /wp-content/uploads/zenblocks/. Assicurati che questa cartella sia scrivibile.

Le impostazioni responsive non vengono applicate

Procedura di verifica

  1. Controlla se sono impostati valori per dispositivo
  • In ogni pannello impostazioni della sidebar, fai clic sull'icona dispositivo (PC / MD / TB / SP)
  • Se per un dispositivo specifico il valore è vuoto, verrà usato il valore PC come fallback
  1. Controlla i breakpoint
  • Verifica i valori in Settings > ZenBlocks
  • Assicurati che i valori personalizzati siano quelli previsti
  1. Svuota la cache CSS
  • Il CSS responsive viene messo in cache, quindi dopo aver modificato le impostazioni devi svuotarla
  • Fai clic su Settings > ZenBlocks > Clear CSS Cache
  1. Controlla in modalità responsive del browser
  • Apri gli strumenti sviluppatore del browser (F12)
  • Modifica la larghezza nella device toolbar in base al breakpoint
  • Verifica la visualizzazione a ciascun breakpoint

L'animazione non funziona

Procedura di verifica

  1. Controlla se la funzione Pro è attiva (l'animazione è una funzione Pro)
  • Verifica in Settings > ZenBlocks che la licenza sia Active
  • Controlla che il plugin ZenBlocks Pro sia attivo
  1. Controlla le impostazioni di animazione
  • Apri il pannello Animation Settings nella sidebar
  • Verifica che il tipo di animazione non sia impostato su None
  • Verifica che Duration non sia 0
  1. Controlla nel front-end
  • L'animazione può essere anteprima nell'editor, ma il controllo finale va fatto nel front-end
  • Ricarica la pagina per verificare la riproduzione
  1. Controlla eventuali conflitti con le transizioni
  • Se animazione e transizione sono attive nello stesso momento, possono verificarsi comportamenti indesiderati
  • Verifica se nel pannello transition compare un avviso

L'effetto hover non funziona

Procedura di verifica

  1. Verifica che la scheda Hover abbia valori
  • Seleziona la scheda Hover nel pannello impostazioni della sidebar
  • Controlla che le proprietà che vuoi modificare abbiano valori impostati
  1. Controlla le impostazioni di transizione
  • Verifica che Duration nel pannello transition non sia 0ms
  • Valore consigliato: da 200ms a 400ms
  1. Svuota la cache CSS e ricontrolla

Per maggiori dettagli, consulta buttonBasic FAQ: lo stile hover non si riflette.

Viene visualizzato un errore di validazione del blocco

Procedura di verifica

  1. Aggiorna il plugin all'ultima versione
  • Aggiorna ZenBlocks da Plugin > Aggiornamenti nella bacheca WordPress
  1. Recupera il blocco
  • Fai clic su Attempt to recover block nel messaggio di errore
  • Dopo il recupero, controlla le impostazioni e salva di nuovo la pagina
  1. Se non basta
  • Elimina il blocco e creane uno nuovo
  • Se lo avevi salvato come design personalizzato, applica il preset al nuovo blocco per ripristinarlo

Nota: Gli errori di validazione possono comparire quando il formato di output HTML cambia dopo un aggiornamento del plugin. Il recupero del blocco lo aggiorna automaticamente al nuovo formato.

Se il problema persiste

Se i passaggi sopra non risolvono il problema, pubblica una richiesta nel forum di supporto WordPress.org.

Includi le seguenti informazioni:

  • Versione di WordPress
  • Versione di PHP
  • Nome del tema in uso
  • Versione di ZenBlocks / ZenBlocks Pro
  • Passaggi per riprodurre il problema
  • Screenshot o registrazione dello schermo
  • Messaggi di errore mostrati nella Console degli strumenti sviluppatore del browser