{"id":167402,"date":"2025-06-09T09:00:00","date_gmt":"2025-06-09T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/problemi-di-installazione-e-attivazione\/"},"modified":"2026-05-30T10:00:00","modified_gmt":"2026-05-30T08:00:00","slug":"problemi-di-installazione-e-attivazione","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/problemi-di-installazione-e-attivazione\/","title":{"rendered":"Problemi di Installazione e Attivazione"},"content":{"rendered":"
\n

Risolvere i Problemi Comuni di LearnDash: Troubleshooting<\/h2>\n

\"Diagnostica<\/p>\n

Anche il plugin LMS pi\u00f9 affidabile pu\u00f2 presentare problemi. LearnDash, nonostante la sua stabilit\u00e0 e maturit\u00e0, non \u00e8 immune da difficolt\u00e0 tecniche che possono compromettere l’esperienza degli studenti e l’operativit\u00e0 della piattaforma. In questa guida completa di troubleshooting, analizzeremo i problemi pi\u00f9 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\u00e0 di risolvere rapidamente la maggior parte dei problemi senza dover contattare il supporto tecnico.<\/p>\n

Problemi di Installazione e Attivazione<\/h2>\n

Il Plugin Non Si Installa<\/h3>\n

Se LearnDash non si installa, il problema pi\u00f9 comune \u00e8 il limite di dimensione dei file di upload<\/strong>. Il file ZIP di LearnDash \u00e8 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<\/code> e post_max_size<\/code> devono essere almeno 64 MB. Se non puoi modificare queste impostazioni dal pannello hosting, carica il file ZIP nella cartella \/wp-content\/plugins\/<\/code> tramite FTP e attiva il plugin dalla dashboard.<\/p>\n

Un altro problema comune \u00e8 l’errore di permessi<\/strong>: la cartella \/wp-content\/plugins\/<\/code> 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.<\/p>\n

La Licenza Non Si Attiva<\/h3>\n

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<\/code> e curl<\/code>. Alcuni hosting bloccano le connessioni in uscita per motivi di sicurezza: contatta il tuo provider per verificare.<\/p>\n

Problemi con i Corsi e le Lezioni<\/h2>\n

Le Lezioni Non Appaiono nel Corso<\/h3>\n

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

Un altro scenario \u00e8 che le lezioni siano associate ma non ordinate. Vai nel Course Builder<\/strong> 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.<\/p>\n

Errore 404 sulle Pagine dei Corsi<\/h3>\n

L’errore 404 sulle pagine dei corsi, lezioni o argomenti \u00e8 quasi sempre un problema di permalink<\/strong>. Vai su Impostazioni > Permalink<\/strong> in WordPress e clicca Salva le Modifiche<\/strong> 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<\/code> nella root del sito sia scrivibile e contenga le regole di riscrittura corrette.<\/p>\n

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\u00e0 un conflitto. Cambia lo slug di uno dei due elementi per risolvere.<\/p>\n

\"Impostazioni<\/p>\n

Il Progresso Non Viene Salvato<\/h3>\n

Se il progresso degli studenti non viene salvato (le lezioni non restano marcate come completate), il problema potrebbe avere diverse cause. La pi\u00f9 comune \u00e8 un conflitto di caching<\/strong>: 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.<\/p>\n

Un’altra causa \u00e8 un conflitto JavaScript<\/strong> 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.<\/p>\n

Problemi con i Quiz<\/h2>\n

Il Quiz Non Funziona o Non Si Carica<\/h3>\n

Se un quiz non si carica o non funziona correttamente, il problema \u00e8 spesso legato a conflitti JavaScript<\/strong>. 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.<\/p>\n

Un altro problema comune \u00e8 il timeout PHP<\/strong>: quiz con molte domande possono richiedere tempi di elaborazione superiori al limite configurato nel server. Aumenta il valore di max_execution_time<\/code> a 300 secondi e verifica che memory_limit<\/code> sia almeno 256 MB.<\/p>\n

Il Punteggio del Quiz Non \u00c8 Corretto<\/h3>\n

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\u00e0 di calcolo (punteggio per domanda, punteggio per risposta corretta, punteggio parziale per risposte parzialmente corrette).<\/p>\n

Problemi con i Pagamenti<\/h2>\n

Lo Studente Non Viene Iscritto Dopo il Pagamento<\/h3>\n

Se lo studente completa il pagamento ma non viene iscritto al corso, il problema dipende dal gateway di pagamento utilizzato. Per Stripe<\/strong>, 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<\/strong> e verifica la URL del webhook.<\/p>\n

Per PayPal<\/strong>, 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\u00e9 gli account personali hanno limitazioni che possono impedire il funzionamento corretto dell’IPN.<\/p>\n

Per WooCommerce<\/strong>, 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 \u00e8 in stato "Completato".<\/p>\n

\"Risoluzione<\/p>\n

Problemi di Prestazioni<\/h2>\n

Il Sito \u00c8 Lento<\/h3>\n

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

Se il database \u00e8 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.<\/p>\n

Query di Database Lente<\/h3>\n

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<\/code> di WordPress, che pu\u00f2 diventare molto grande. L’aggiunta di indici personalizzati su meta_key<\/code> e user_id<\/code> pu\u00f2 migliorare significativamente le prestazioni delle query.<\/p>\n

Problemi con le Email<\/h2>\n

Le Email Non Vengono Inviate<\/h3>\n

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

Dopo la configurazione, utilizza la funzionalit\u00e0 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.<\/p>\n

Problemi di Compatibilit\u00e0<\/h2>\n

Conflitti con il Tema<\/h3>\n

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 \u00e8 specifico del tema, contatta lo sviluppatore del tema per assistenza o personalizza i template di LearnDash nel tuo tema child.<\/p>\n

Conflitti con Altri Plugin<\/h3>\n

I conflitti tra plugin sono una delle cause pi\u00f9 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\u00ec il plugin conflittuale. I conflitti pi\u00f9 frequenti sono con plugin di cache aggressivi, plugin di sicurezza con regole troppo restrittive e plugin che modificano il layout delle pagine.<\/p>\n

Aggiornamenti e Backup<\/h2>\n

Prima di aggiornare LearnDash, fai sempre un backup completo<\/strong> 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\u00e0 principali funzionino correttamente: creazione di corsi, navigazione delle lezioni, quiz, pagamenti e report.<\/p>\n

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

Quando Contattare il Supporto<\/h2>\n

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\u00f9 rapidamente.<\/p>\n

Conclusione<\/h2>\n

La maggior parte dei problemi di LearnDash pu\u00f2 essere risolta con le soluzioni descritte in questa guida. La chiave \u00e8 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.<\/p>\n

Hai un problema tecnico con LearnDash che non riesci a risolvere? Contattaci<\/a> per assistenza tecnica specializzata.<\/p>\n

\n

Articoli Correlati<\/h3>\n