Error inesperado en WPML al configurar una web multilingüe nueva
Cuando ni en una web limpia esperas este tipo de errores
En Zonsai trabajamos a menudo con proyectos WordPress multilingües, y uno de los plugins que solemos implementar para ello es WPML. Lo conocemos bien, lo hemos configurado muchas veces y, en general, funciona como se espera. Pero esta vez no fue así.
Estábamos trabajando en una web totalmente nueva, una instalación limpia de WordPress, sin contenido previo ni configuraciones heredadas. Todo apuntaba a que sería una configuración rápida y sin complicaciones. Sin embargo, al llegar al paso final del asistente de WPML —concretamente al paso 6, llamado “Plugins”—, algo falló.
Pantalla en blanco en el paso de plugins
La idea de ese paso es sencilla: WPML detecta qué plugins tienes activos y te recomienda instalar los componentes adicionales que podrían ayudarte (como String Translation, SEO Multilingual, etc.). Pero lo que encontramos fue una pantalla completamente en blanco.
Consola del navegador abierta, y ahí estaba el error:
“Cannot convert undefined or null to object”
La pista estaba en el archivo app.js de WPML. Algo en el asistente estaba intentando acceder a una clave inexistente en la respuesta AJAX.
¿Dónde estaba el fallo?
Al revisar la pestaña de red, encontramos que WPML enviaba una petición a admin-ajax.php, y esta devolvía datos aparentemente válidos. Pero si observábamos con detalle, una de las secciones no incluía la clave plugins, que el JS esperaba de forma obligatoria.
El código JS esperaba hacer algo así como:
Object.keys(section.plugins)y claro, si plugins no existe, esto lanza un error fatal. Increíblemente, no había ninguna validación previa.
Solución: recurrimos a una versión anterior
Después de varias pruebas:
- Reinstalación del plugin
- Reset total de WPML
- Filtros en PHP para corregir la respuesta
Nada funcionó.
La solución fue sencilla, pero inesperada: instalamos la versión 4.5.14 de WPML, que sigue siendo estable y ampliamente utilizada. Y con ella, todo funcionó perfectamente. Pudimos completar el asistente de configuración sin errores. Después de eso, actualizamos a la versión 4.7, y al haber pasado ya ese paso crítico, no volvió a dar problemas.
¿Qué aprendemos de esto?
Incluso en una instalación completamente nueva y limpia, puedes encontrarte errores imprevisibles provocados por pequeños bugs en versiones recientes de plugins. Este fallo concreto en WPML puede afectar a más desarrolladores si no se valida correctamente la estructura de datos que espera el asistente.
¿Por qué lo contamos?
En Zonsai nos especializamos en desarrollo WordPress profesional, y este tipo de incidencias no solo las resolvemos: aprendemos de ellas, documentamos el proceso y mejoramos los flujos para futuros proyectos.
Además de ofrecer soluciones multilingües con WPML, ayudamos a clientes a montar webs multidioma optimizadas desde el primer día, evitando errores como este y asegurando una base sólida para escalar.
Si buscas un partner técnico que sepa reaccionar cuando algo se rompe (incluso aunque no sea tu culpa), estás en buenas manos.
¿Te has encontrado con errores similares en una web aparentemente limpia? ¿Necesitas que tu web multilingüe esté bien configurada desde el principio? En Zonsai te ayudamos a hacerlo con garantías.
