Solución de problemas

Conclusión

La mayoría de los problemas de ZenBlocks se resuelven con Clear CSS Cache, reactivar el plugin y borrar la caché del navegador. A continuación encontrará pasos concretos para cada caso.

Los bloques no aparecen en el panel de inserción

Procedimiento de comprobación

Compruebe si el plugin está activado

Abra Plugins en el panel de administración de WordPress
Verifique que ZenBlocks aparece en la lista y está marcado como activo
Si está desactivado, haga clic en Activar

Compruebe la versión de WordPress

Revise la versión en Escritorio > Actualizaciones
ZenBlocks requiere WordPress 6.0 o superior

Compruebe si Classic Editor está activado

Si el plugin Classic Editor está activo, el editor de bloques puede estar deshabilitado
Confirme en Ajustes > Ajustes de escritura que el editor predeterminado es el editor de bloques

Compruebe si hay conflictos con otros plugins

Desactive temporalmente todos los demás plugins y deje activo solo ZenBlocks
Si el bloque aparece, reactive los demás plugins uno a uno para identificar el conflicto

El panel de ajustes no se abre o no se muestra

Procedimiento de comprobación

Asegúrese de que el bloque está seleccionado

Haga clic en el bloque para seleccionarlo
Compruebe que aparece un borde azul alrededor del bloque

Compruebe si la barra lateral está visible

Haga clic en el icono de Ajustes (engranaje) en la esquina superior derecha del editor
Confirme que la pestaña Bloque está seleccionada en la parte superior de la barra lateral

Compruebe errores en las herramientas de desarrollo del navegador

Abra las herramientas de desarrollo del navegador (F12)
Revise si hay errores de JavaScript en la pestaña Console
Si aparece un error, compártalo en el foro de soporte junto con una captura de pantalla

Los estilos no se aplican en el front-end

Procedimiento de comprobación

Borre la caché CSS

Abra Ajustes > ZenBlocks en el panel de administración de WordPress
Haga clic en Clear CSS Cache
Vuelva a guardar la página afectada

Borre la caché del navegador

Borre la caché del navegador
O fuerce la recarga con Ctrl+Shift+R / Cmd+Shift+R

Vuelva a guardar la página

Abra la página afectada en el editor
Haga clic en Actualizar
El archivo CSS se regenerará

Compruebe la caché del servidor

Si usa un plugin de caché como WP Super Cache, W3 Total Cache o LiteSpeed Cache, vacíe también esa caché
Si usa un CDN como Cloudflare, purgue también la caché del CDN

Punto: La caché CSS de ZenBlocks se guarda en /wp-content/uploads/zenblocks/. Asegúrese de que este directorio tiene permisos de escritura.

La configuración responsive no se refleja

Procedimiento de comprobación

Compruebe si hay valores definidos por dispositivo

En cada panel de ajustes de la barra lateral, haga clic en el icono de dispositivo (PC / MD / TB / SP)
Si un dispositivo no tiene valor, se utilizará el valor de PC como fallback

Compruebe los breakpoints

Revise los valores en Ajustes > ZenBlocks
Confirme que los valores personalizados son los esperados

Borre la caché CSS

El CSS responsive se almacena en caché, así que debe vaciarla después de cambiar ajustes
Haga clic en Ajustes > ZenBlocks > Clear CSS Cache

Compruébelo en el modo responsive del navegador

Abra las herramientas de desarrollo del navegador (F12)
Cambie el ancho en la barra de dispositivos para ajustarlo al breakpoint
Revise la visualización en cada breakpoint

La animación no funciona

Procedimiento de comprobación

Compruebe si la función Pro está activada (la animación es una función Pro)

Confirme en Ajustes > ZenBlocks que la licencia está en estado Active
Verifique que el plugin ZenBlocks Pro está activo

Compruebe los ajustes de animación

Abra el panel Animation Settings de la barra lateral
Verifique que el tipo de animación no está establecido en None
Compruebe que Duration no es 0

Compruébelo en el front-end

La animación puede previsualizarse en el editor, pero la comprobación final debe hacerse en el front-end
Recargue la página para confirmar la reproducción

Compruebe si hay conflicto con las transiciones

Si la animación y la transición están activas al mismo tiempo, puede producirse un comportamiento no deseado
Compruebe si aparece una advertencia en el panel de transición

El efecto hover no funciona

Procedimiento de comprobación

Compruebe que la pestaña Hover tiene valores

Seleccione la pestaña Hover en el panel de ajustes
Verifique que las propiedades que quiere cambiar tienen valores asignados

Compruebe los ajustes de transición

Verifique que Duration en el panel de transición no sea 0ms
Valor recomendado: 200ms a 400ms

Borre la caché CSS y vuelva a comprobar

Para más detalles, consulte buttonBasic FAQ: el estilo hover no se refleja.

Se muestra un error de validación del bloque

Procedimiento de comprobación

Actualice el plugin a la última versión

Actualice ZenBlocks desde Plugins > Actualizaciones en el panel de WordPress

Recupere el bloque

Haga clic en Intentar recuperar el bloque en el mensaje de error
Después de la recuperación, compruebe los ajustes y vuelva a guardar la página

Si no se resuelve

Elimine el bloque y cree uno nuevo
Si lo había guardado como diseño personalizado, aplique el preset al bloque nuevo para restaurarlo

Nota: Los errores de validación pueden aparecer si el formato de salida HTML cambia tras actualizar el plugin. La recuperación del bloque lo actualiza automáticamente al formato nuevo.

Si el problema persiste

Si los pasos anteriores no resuelven el problema, publique su caso en el foro de soporte de WordPress.org.

Incluya la siguiente información:

Versión de WordPress
Versión de PHP
Nombre del tema en uso
Versión de ZenBlocks / ZenBlocks Pro
Pasos para reproducir el problema
Captura de pantalla o grabación de pantalla
Mensajes de error mostrados en la Console de las herramientas de desarrollo