Errores de dependencias de assets

Síntoma

Unsatisfied dependency 'core' for an asset 'com_joomlaai.dashboard' of type 'style'

El Dashboard (y todas las demás vistas) muestran una página blanca o un error Joomla.

Causa

Este error ocurre cuando joomla.asset.json incluye "dependencies": ["core"] en un asset de "type": "style". El asset core está registrado como script en Joomla 6; las dependencias cross-tipo no están permitidas.

Solución

Actualiza a JoomlaAI 2.5.3 o superior. El joomla.asset.json corregido no tiene campos "dependencies" en assets style.

Si necesitas arreglarlo manualmente, edita [joomla-root]/media/com_joomlaai/joomla.asset.json y quita todos los campos "dependencies" de los assets con "type": "style".

"Invalid Token" al enviar chat

Síntoma

Cada mensaje chat devuelve "Invalid Token" o "JINVALID_TOKEN".

Causa

El token CSRF del formulario está stale (sesión caducada o página cacheada).

Solución

1. Hard-reload (Ctrl+Shift+R / Cmd+Shift+R).
2. Si persiste, comprueba que el session lifetime de Joomla no sea demasiado corto (Sistema → Configuración global → Sistema → Session Lifetime).
3. Si usas un plugin de caché (JotCache, CDN), asegura que las páginas admin se excluyan del caché.

Jobs programados no se ejecutan

Síntoma

AI Scheduler tiene jobs activos pero no aparecen nuevos items en Content Review. Health Check muestra "run_due_jobs last ran > 15 minutes ago".

Causa

El trigger cron no está configurado.

Solución (Joomla)

Añade al crontab del servidor:

* * * * *  php /path/to/joomla/cli/joomla.php scheduler:run --all --no-interaction >/dev/null 2>&1

Verifica que el plugin Task esté activo: Sistema → Plugins → Task - JoomlaAI.

Solución (WordPress)

Añade un cron real y opcionalmente desactiva el trigger por tráfico:

* * * * *  wp --path=/path/to/wordpress cron event run --due-now >/dev/null 2>&1

O por PHP:

* * * * *  php /path/to/wordpress/wp-cron.php >/dev/null 2>&1

Comprueba que los eventos están programados:

wp cron event list

Deberías ver wpai_run_due_jobs, wpai_provider_health, y wpai_cleanup_old_data.

Errores de clave API

Síntoma

Health Check muestra ❌ Auth error 401 para un proveedor. El chat devuelve un mensaje de error.

Causa

La clave API es errónea, ha caducado o no tiene créditos.

Solución

1. Regenera una clave nueva desde el dashboard del proveedor.
2. En JoomlaAI: Configuración → Providers (Joomla) o Ajustes → Providers (WP).
3. Pega la nueva clave y guarda.
4. Re-ejecuta Health Check para confirmar ✅.

Modelo Claude no encontrado (404)

Síntoma

La API de Claude devuelve 404 cuando un job programado corre.

Causa

IDs de modelo especulativos (ej. claude-sonnet-4 sin sufijo de fecha) son rechazados por la API de Anthropic.

Solución

Usa IDs de modelo completos con sufijo de fecha:

Actualiza el modelo en Configuración → Providers → Claude Default Model.

Ollama connection refused

Síntoma

Health Check muestra ❌ Connection refused para Ollama.

Causa

• Ollama no está corriendo.
• El URL endpoint es erróneo.
• Ollama está en otro host inalcanzable.

Solución

1. Arranca Ollama: ollama serve.
2. Verifica que escucha: curl http://localhost:11434/v1/models.
3. Si está en Docker u otra máquina, actualiza Ollama Base URL en Configuración.

"Extension not found" o upload fallido

Síntoma

Joomla muestra "Extension not found" al subir el paquete zip.

Causa

PHP upload_max_filesize o post_max_size es menor que el zip (249 KB — no debería ser problema normalmente).

Solución

Revisa php.ini o .htaccess:

upload_max_filesize = 8M
post_max_size = 8M

Widget chat no aparece en admin WP

Síntoma

El botón flotante no aparece en el footer del admin WP.

Causa

• El plugin no está activado.
• La pantalla actual está en la lista de exclusión del widget.
• Un error JavaScript en la página impide la inicialización del widget.

Solución

1. Confirma que el plugin esté activo en Plugins → Plugins instalados.
2. Revisa Ajustes → Widget → Excluded screens — la pantalla actual puede estar listada.
3. Abre la consola developer del navegador (F12) y revisa errores JS.
4. Navega a una pantalla known-good como Dashboard y comprueba si aparece.

"Schema version mismatch" en Health Check

Síntoma

Health Check → Database muestra warning de mismatch de versión schema.

Causa

La BD no se actualizó cuando el plugin fue actualizado.

Solución

Reinstala el paquete vía Sistema → Extensiones → Instalar (Joomla) o sube vía Plugins → Añadir nuevo (WP). El script de instalación ejecutará las migraciones pendientes.

Budget "block" no funciona

Síntoma

Los usuarios siguen generando contenido aunque se alcanzó un cap budget con acción "block".

Causa

Las reglas budget se evalúan por petición. Si el cap se puso después de que algunas peticiones ya hubieran terminado, esas no se bloquean retroactivamente.

Solución

Pon el cap a un valor más bajo. El enforcement funciona correctamente para nuevas peticiones una vez el cap esté puesto y el contador lo alcance.

_Última actualización: 2026-05-19 · v2.5.3_