Errori dipendenze asset

Sintomo

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

La Dashboard (e tutte le altre viste) mostra una pagina bianca o un errore Joomla.

Causa

Questo errore si verifica quando joomla.asset.json include "dependencies": ["core"] su un asset di "type": "style". L'asset core è registrato come script in Joomla 6; le dipendenze cross-tipo non sono permesse.

Fix

Aggiorna a JoomlaAI 2.5.3 o superiore. Il joomla.asset.json corretto non ha campi "dependencies" sugli asset style.

Se devi sistemare manualmente, modifica [joomla-root]/media/com_joomlaai/joomla.asset.json e rimuovi tutti i campi "dependencies" dagli asset con "type": "style".

"Invalid Token" all'invio chat

Sintomo

Ogni messaggio chat restituisce "Invalid Token" o "JINVALID_TOKEN".

Causa

Il token CSRF nel form è stale (sessione scaduta o pagina cachata).

Fix

1. Ricarica la pagina con hard-reload (Ctrl+Shift+R / Cmd+Shift+R).
2. Se il problema persiste, controlla che il session lifetime di Joomla non sia troppo basso (Sistema → Configurazione globale → Sistema → Session Lifetime).
3. Se usi un plugin di cache (es. JotCache, CDN), assicurati che le pagine admin siano escluse dalla cache.

Job pianificati non eseguiti

Sintomo

L'AI Scheduler ha job attivi, ma non appaiono nuovi item in Content Review. Health Check mostra "run_due_jobs last ran > 15 minutes ago".

Causa

Il trigger cron non è configurato.

Fix (Joomla)

Aggiungi al crontab del server:

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

Verifica che il plugin Task sia abilitato: Sistema → Plugin → Task - JoomlaAI.

Fix (WordPress)

Aggiungi un cron reale e opzionalmente disabilita il trigger via traffico di WP-Cron:

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

Oppure via PHP:

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

Controlla che gli eventi cron siano pianificati:

wp cron event list

Dovresti vedere wpai_run_due_jobs, wpai_provider_health, e wpai_cleanup_old_data.

Errori chiave API

Sintomo

Health Check mostra ❌ Auth error 401 per un provider. La chat restituisce un messaggio di errore.

Causa

La chiave API è errata, scaduta, o senza crediti.

Fix

1. Rigenera una nuova chiave dal dashboard del provider.
2. In JoomlaAI: Configurazione → Providers (Joomla) o Impostazioni → Providers (WP).
3. Incolla la nuova chiave e salva.
4. Riesegui Health Check per confermare ✅.

Modello Claude non trovato (404)

Sintomo

L'API Claude restituisce 404 quando un job pianificato viene eseguito.

Causa

Gli ID modello speculativi (es. claude-sonnet-4 senza suffisso data) vengono rifiutati dall'API Anthropic.

Fix

Usa gli ID modello completi con suffisso data:

Aggiorna il modello in Configurazione → Providers → Claude Default Model.

Ollama connection refused

Sintomo

Health Check mostra ❌ Connection refused per Ollama.

Causa

• Ollama non è in esecuzione.
• L'URL endpoint è sbagliato.
• Ollama gira su un altro host non raggiungibile.

Fix

1. Avvia Ollama: ollama serve.
2. Verifica che ascolti: curl http://localhost:11434/v1/models.
3. Se gira in Docker o su altra macchina, aggiorna Ollama Base URL in Configurazione.

"Extension not found" o upload fallito

Sintomo

Joomla mostra "Extension not found" all'upload del pacchetto zip.

Causa

PHP upload_max_filesize o post_max_size è più piccolo del file zip (249 KB — non dovrebbe normalmente essere un problema).

Fix

Controlla il tuo php.ini o .htaccess:

upload_max_filesize = 8M
post_max_size = 8M

Widget chat non appare nell'admin WP

Sintomo

Il pulsante chat flottante non appare nel footer admin WordPress.

Causa

• Il plugin non è attivato.
• La schermata admin corrente è nella lista di esclusione del widget.
• Un errore JavaScript sulla pagina impedisce l'inizializzazione del widget.

Fix

1. Conferma che il plugin sia attivo in Plugin → Plugin installati.
2. Controlla Impostazioni → Widget → Excluded screens — la schermata corrente potrebbe essere nella lista.
3. Apri la console developer del browser (F12) e controlla errori JS.
4. Naviga su una schermata known-good come la Dashboard e controlla se il widget appare.

"Schema version mismatch" in Health Check

Sintomo

Health Check → Database mostra un warning di mismatch versione schema.

Causa

Il database non è stato aggiornato quando il plugin è stato aggiornato.

Fix

Reinstalla il pacchetto via Sistema → Estensioni → Installa (Joomla) o carica via Plugin → Aggiungi nuovo (WP). Lo script di install eseguirà le migration pendenti.

Budget "block" non funziona

Sintomo

Gli utenti continuano a generare contenuti anche dopo aver raggiunto un cap budget con azione impostata su "block".

Causa

Le regole budget sono valutate per-richiesta. Se il cap è stato impostato dopo che alcune richieste erano già complete, queste non vengono retroattivamente bloccate.

Fix

Imposta il cap a un valore più basso. L'enforcement budget funziona correttamente per le nuove richieste una volta che il cap è in posizione e il contatore di utilizzo lo raggiunge.

_Ultimo aggiornamento: 2026-05-19 · v2.5.3_