Problemi di Installazione e Attivazione

Risolvere i Problemi Comuni di LearnDash: Troubleshooting

Anche il plugin LMS più affidabile può presentare problemi. LearnDash, nonostante la sua stabilità e maturità, non è immune da difficoltà tecniche che possono compromettere l’esperienza degli studenti e l’operatività della piattaforma. In questa guida completa di troubleshooting, analizzeremo i problemi più comuni che gli amministratori di LearnDash incontrano e forniremo soluzioni testate e affidabili per ciascuno di essi. Avere questa guida a portata di mano ti permetterà di risolvere rapidamente la maggior parte dei problemi senza dover contattare il supporto tecnico.

Problemi di Installazione e Attivazione

Il Plugin Non Si Installa

Se LearnDash non si installa, il problema più comune è il limite di dimensione dei file di upload. Il file ZIP di LearnDash è relativamente grande e potrebbe superare il limite configurato nel tuo hosting. Verifica i limiti PHP nel pannello di controllo del tuo hosting: upload_max_filesize e post_max_size devono essere almeno 64 MB. Se non puoi modificare queste impostazioni dal pannello hosting, carica il file ZIP nella cartella /wp-content/plugins/ tramite FTP e attiva il plugin dalla dashboard.

Un altro problema comune è l’errore di permessi: la cartella /wp-content/plugins/ deve essere scrivibile dal server web. Verifica che i permessi siano impostati a 755 per le directory e 644 per i file. Se utilizzi Plesk, controlla che il proprietario dei file corrisponda all’utente del dominio.

La Licenza Non Si Attiva

Se la licenza non si attiva, verifica di aver inserito l’indirizzo email esattamente come usato per l’acquisto e la chiave di licenza senza spazi extra. Se il problema persiste, potrebbe essere un problema di connessione tra il tuo server e il server di validazione di LearnDash. Verifica che il tuo server possa effettuare richieste HTTP esterne controllando le funzioni wp_remote_get e curl. Alcuni hosting bloccano le connessioni in uscita per motivi di sicurezza: contatta il tuo provider per verificare.

Problemi con i Corsi e le Lezioni

Le Lezioni Non Appaiono nel Corso

Se le lezioni non appaiono nella pagina del corso, il problema più frequente è che le lezioni non sono associate al corso. Modifica ogni lezione e verifica che nella sezione Settings > Associated Course sia selezionato il corso corretto. Se hai creato le lezioni prima del corso, potresti doverle associare manualmente una per una.

Un altro scenario è che le lezioni siano associate ma non ordinate. Vai nel Course Builder del corso e verifica che le lezioni siano presenti nell’elenco. Se non lo sono, aggiungile tramite il builder e trascinale nella posizione desiderata. Dopo aver modificato l’ordine, salva il corso.

Errore 404 sulle Pagine dei Corsi

L’errore 404 sulle pagine dei corsi, lezioni o argomenti è quasi sempre un problema di permalink. Vai su Impostazioni > Permalink in WordPress e clicca Salva le Modifiche senza cambiare nulla. Questo rigenera le regole di riscrittura e risolve la maggior parte degli errori 404. Se il problema persiste, verifica che il file .htaccess nella root del sito sia scrivibile e contenga le regole di riscrittura corrette.

Se hai personalizzato gli slug dei corsi nelle impostazioni di LearnDash, assicurati che non entrino in conflitto con pagine o categorie WordPress esistenti che utilizzano gli stessi slug. Ad esempio, se hai una pagina WordPress chiamata "corsi" e hai impostato lo slug dei corsi LearnDash come "corsi", ci sarà un conflitto. Cambia lo slug di uno dei due elementi per risolvere.

Il Progresso Non Viene Salvato

Se il progresso degli studenti non viene salvato (le lezioni non restano marcate come completate), il problema potrebbe avere diverse cause. La più comune è un conflitto di caching: il plugin di cache serve una versione salvata della pagina che non riflette le azioni recenti dello studente. Configura il plugin di cache per escludere tutte le pagine di LearnDash (corsi, lezioni, argomenti, quiz, profilo) dalla cache.

Un’altra causa è un conflitto JavaScript con altri plugin o con il tema. Apri la console del browser (F12 > Console) e verifica se ci sono errori JavaScript nella pagina. Se trovi errori relativi a script di altri plugin, prova a disattivare temporaneamente quei plugin per confermare il conflitto. In caso di conflitto confermato, contatta lo sviluppatore del plugin conflittuale o cerca un’alternativa compatibile.

Problemi con i Quiz

Il Quiz Non Funziona o Non Si Carica

Se un quiz non si carica o non funziona correttamente, il problema è spesso legato a conflitti JavaScript. Il sistema di quiz di LearnDash utilizza JavaScript pesantemente, e conflitti con altri script (plugin di popup, chatbot, script di analisi) possono causare malfunzionamenti. Testa il quiz disattivando tutti i plugin tranne LearnDash per isolare il conflitto.

Un altro problema comune è il timeout PHP: quiz con molte domande possono richiedere tempi di elaborazione superiori al limite configurato nel server. Aumenta il valore di max_execution_time a 300 secondi e verifica che memory_limit sia almeno 256 MB.

Il Punteggio del Quiz Non È Corretto

Se i punteggi dei quiz non corrispondono alle risposte date, verifica la configurazione delle domande. Per le domande a scelta multipla, assicurati di aver contrassegnato correttamente le risposte giuste. Verifica anche il sistema di punteggio: LearnDash supporta punteggi diversi per ogni domanda e diverse modalità di calcolo (punteggio per domanda, punteggio per risposta corretta, punteggio parziale per risposte parzialmente corrette).

Problemi con i Pagamenti

Lo Studente Non Viene Iscritto Dopo il Pagamento

Se lo studente completa il pagamento ma non viene iscritto al corso, il problema dipende dal gateway di pagamento utilizzato. Per Stripe, verifica che le chiavi API siano corrette e che il webhook sia configurato correttamente. LearnDash utilizza i webhook di Stripe per ricevere la conferma del pagamento e iscrivere lo studente. Vai su LearnDash > Settings > Payments > Stripe e verifica la URL del webhook.

Per PayPal, verifica che l’IPN (Instant Payment Notification) sia abilitato e configurato con la URL corretta nel tuo account PayPal. L’URL IPN deve puntare al tuo sito WordPress. Controlla anche che il tuo account PayPal sia un account Business, poiché gli account personali hanno limitazioni che possono impedire il funzionamento corretto dell’IPN.

Per WooCommerce, verifica che il prodotto WooCommerce sia correttamente associato al corso LearnDash. Modifica il prodotto e nella sezione LearnDash verifica che il corso sia selezionato. Controlla anche lo stato dell’ordine: l’iscrizione al corso avviene solo quando l’ordine è in stato "Completato".

Problemi di Prestazioni

Il Sito È Lento

LearnDash, come qualsiasi plugin complesso, può influire sulle prestazioni del sito. Se il sito è lento, implementa queste ottimizzazioni progressive: installa un plugin di cache (WP Rocket, W3 Total Cache) escludendo le pagine dinamiche di LearnDash. Attiva l’object cache con Redis o Memcached se il tuo hosting lo supporta. Ottimizza le immagini con ShortPixel o un plugin simile. Utilizza un CDN per servire i contenuti statici.

Se il database è cresciuto nel tempo, potrebbe beneficiare di un’ottimizzazione. Plugin come WP-Optimize possono pulire le tabelle del database, rimuovere le revisioni dei post e ottimizzare gli indici. Fai sempre un backup completo prima di eseguire operazioni sul database.

Query di Database Lente

Se noti rallentamenti specifici nelle pagine dei report o del profilo utente, il problema potrebbe essere legato a query di database inefficienti, soprattutto con un alto numero di studenti e corsi. LearnDash memorizza i dati di progresso nella tabella usermeta di WordPress, che può diventare molto grande. L’aggiunta di indici personalizzati su meta_key e user_id può migliorare significativamente le prestazioni delle query.

Problemi con le Email

Le Email Non Vengono Inviate

Se le email di notifica di LearnDash non vengono inviate, il problema è quasi sempre legato alla configurazione SMTP del server. WordPress utilizza la funzione wp_mail() che si basa sulla funzione mail() di PHP, spesso bloccata o mal configurata sugli hosting condivisi. Installa un plugin SMTP come WP Mail SMTP e configura l’invio tramite un servizio SMTP affidabile come Gmail SMTP, SendGrid, Mailgun o Amazon SES.

Dopo la configurazione, utilizza la funzionalità di invio email di test del plugin SMTP per verificare che le email vengano recapitate correttamente. Controlla anche la cartella spam del destinatario: le email inviate da un nuovo dominio o senza autenticazione SPF/DKIM potrebbero essere filtrate come spam.

Problemi di Compatibilità

Conflitti con il Tema

Se il layout delle pagine LearnDash appare distorto o rotto, il problema potrebbe essere un conflitto con il tema WordPress. Prova a passare temporaneamente a un tema predefinito come Twenty Twenty-Four per verificare se il problema si risolve. Se il problema è specifico del tema, contatta lo sviluppatore del tema per assistenza o personalizza i template di LearnDash nel tuo tema child.

Conflitti con Altri Plugin

I conflitti tra plugin sono una delle cause più comuni di problemi in WordPress. Per identificare un conflitto, disattiva tutti i plugin tranne LearnDash e verifica se il problema si risolve. Poi riattiva i plugin uno alla volta fino a quando il problema si ripresenta, identificando così il plugin conflittuale. I conflitti più frequenti sono con plugin di cache aggressivi, plugin di sicurezza con regole troppo restrittive e plugin che modificano il layout delle pagine.

Aggiornamenti e Backup

Prima di aggiornare LearnDash, fai sempre un backup completo del sito (file e database). Testa l’aggiornamento in un ambiente di staging se possibile, soprattutto per gli aggiornamenti major. Dopo l’aggiornamento, verifica che tutte le funzionalità principali funzionino correttamente: creazione di corsi, navigazione delle lezioni, quiz, pagamenti e report.

Mantieni anche gli altri plugin e il tema aggiornati per evitare problemi di compatibilità. Tuttavia, evita di aggiornare tutto contemporaneamente: aggiorna un componente alla volta in modo da poter identificare facilmente la causa di eventuali problemi.

Quando Contattare il Supporto

Se non riesci a risolvere un problema con le soluzioni descritte in questa guida, contatta il supporto ufficiale di LearnDash. Quando apri un ticket, fornisci il maggior numero possibile di informazioni: versione di WordPress, versione di LearnDash, versione di PHP, tema utilizzato, elenco dei plugin attivi, descrizione dettagliata del problema con screenshot, e i passaggi per riprodurre il problema. Queste informazioni permettono al team di supporto di diagnosticare il problema più rapidamente.

Conclusione

La maggior parte dei problemi di LearnDash può essere risolta con le soluzioni descritte in questa guida. La chiave è un approccio sistematico: identifica il sintomo, isola la causa (cache, conflitto plugin, configurazione errata) e applica la soluzione appropriata. Mantieni sempre il tuo sito aggiornato, esegui backup regolari e monitora le prestazioni per prevenire problemi prima che si manifestino.

Hai un problema tecnico con LearnDash che non riesci a risolvere? Contattaci per assistenza tecnica specializzata.