Documentazione relativa alla componente "Corsi"

Introduzione

• Gestione dei corsi: crea e organizza un numero illimitato di corsi con descrizioni, immagini e prezzi
• Sistema di categorie: organizza i corsi in categorie logiche
• Integrazione e-commerce: accetta pagamenti tramite PayPal (modalità Sandbox e Live)
• Sistema di valutazione: Consenti ai clienti di valutare e recensire i corsi
• Visualizzazione dei moduli: metti in evidenza i corsi sul tuo sito utilizzando modelli di moduli personalizzabili
• Monitoraggio degli acquisti: tieni traccia di tutti gli acquisti dei corsi e delle transazioni
• Profili dei docenti: aggiungi l’immagine, il nome e la descrizione del docente a ciascun corso
• Metriche dei corsi: visualizza il numero di lezioni e il numero di iscritti
• Opzioni di visualizzazione flessibili: 21 diversi stili di visualizzazione per la presentazione dei corsi

Installazione

Requisiti di sistema

• Joomla 4 o versioni successive
• PHP 7.0 o versioni successive
• MySQL 5.5+ o PostgreSQL 9.5+

Procedura di installazione

1. Scarica il componente
   • Scarica il pacchetto del componente Mx Courses (file .zip contenente componente, modulo e plugin)
2. Installare tramite Joomla
   • Accedi al pannello di amministrazione di Joomla
   • Vai su Sistema → Installa, Aggiorna, Estensioni
   • Fai clic sulla scheda Carica file del pacchetto
   • Seleziona il file zip di Mx Courses scaricato
   • Fare clic su Carica e installa
3. Verifica l'installazione
   • Accedere a Componenti → Mx Courses nel menu di amministrazione
   • Dovresti vedere l'interfaccia di gestione dei corsi
4. Tabelle del database
   • Il processo di installazione crea automaticamente le tabelle del database necessarie:
     • jos_mxcourses_items (elementi del corso)
     • jos_mxcourses_purchases (record di acquisto)

Installazione iniziale e configurazione

Accesso alle impostazioni dei componenti

1. Vai su Componenti → Mx Courses nel menu di amministrazione
2. Fare clic sul pulsante Opzioni nella barra degli strumenti (in alto a destra)

Sezioni di configurazione

Impostazioni di base

Impostazioni multimediali e miniature

Configura le modalità di generazione e visualizzazione delle miniature del corso:

Opzioni di acquisto e valutazione

Abilita le funzionalità di e-commerce e valutazione:

Autorizzazioni

Imposta i livelli di accesso degli utenti per la gestione dei corsi e la visualizzazione degli acquisti:

• Autorizzazioni di gestione di base
• Visualizza le autorizzazioni per i diversi gruppi di utenti

Gestione delle categorie

Le categorie aiutano a organizzare i corsi in modo logico per una navigazione più agevole.

Creazione di una categoria

1. Accedere a Componenti → Categorie
2. Selezionare Mx Courses dal menu a tendina delle estensioni (se necessario)
3. Fare clic su Nuovo
4. Inserisci i dettagli della categoria:
   • Titolo: Nome della categoria (ad es. "Sviluppo web")
   • Alias: nome ottimizzato per l'URL
   • Descrizione: Descrizione della categoria (facoltativa)

Assegnazione dei corsi alle categorie

1. Modifica un corso
2. Nel menu a tendina "Categoria", selezionare la categoria appropriata
3. Salva il corso

Organizzazione della gerarchia delle categorie

Le categorie supportano una struttura padre-figlio:

1. Crea una categoria principale (ad es. "Programmazione")
2. Crea delle sottocategorie (ad es. "Sviluppo web", "Applicazioni desktop")
3. Quando si creano le sottocategorie, selezionare la categoria principale dal campo "Genitore"

Gestione dei corsi (elementi)

Creazione di un nuovo corso

1. Accedere a Componenti → Corsi Mx → Elementi
2. Fare clic sul pulsante Nuovo
3. Inserisci i dettagli del corso:

Campi obbligatori

Campi multimediali

Prezzi e dettagli

Opzioni di visualizzazione

Modifica di un corso

1. Accedere a Componenti → Corsi Mx → Elementi
2. Fare clic sul titolo del corso per modificarlo
3. Modifica i dettagli come necessario
4. Fare clic su Salva o Salva e chiudi

Pubblicazione/Rimozione dei corsi

Corso singolo

1. Clicca sul corso per modificarlo
2. Imposta lo stato su "Pubblicato" (segno di spunta verde) o "Non pubblicato"
3. Fare clic su Salva

Azioni in blocco

1. Nella vista elenco "Elementi", seleziona uno o più corsi utilizzando le caselle di controllo
2. Fai clic sul menu a discesa "Stato" e seleziona:
   • Pubblica - Rendi visibile
   • Annulla pubblicazione - Nascondi al pubblico
   • Archivia - Sposta nell'archivio
   • Cestino - Elimina (recuperabile)

Eliminazione dei corsi

Eliminazione temporanea (Cestino)

1. Seleziona i corsi da eliminare
2. Fare clic sul pulsante "Cestino" o selezionare l'opzione dal menu a tendina "Stato"
3. I corsi vengono spostati nel cestino ma possono essere recuperati

Eliminazione definitiva

1. Accedere ai corsi che si trovano nel Cestino
2. Seleziona i corsi
3. Fai clic sul pulsante "Elimina"
4. Conferma l'eliminazione

Configurazione di pagamenti e acquisti

Configurazione di PayPal

Modalità Sandbox (test)

1. Vai su Componenti → Mx Courses → Opzioni
2. Fai clic sulla scheda Acquisti e valutazioni
3. Abilita "Abilita acquisti"
4. Imposta la modalità di pagamento su Sandbox
5. Inserisci il tuo indirizzo e-mail PayPal per la modalità Sandbox
6. Imposta la valuta (di solito USD per i test)
7. Fai clic su "Salva"

Per ottenere le credenziali Sandbox:

• Visita PayPal Developer Sandbox
• Crea un account aziendale di prova
• Utilizza l'indirizzo e-mail aziendale fornito nella Sandbox

Modalità live (produzione)

1. Vai su Componenti → Corsi Mx → Opzioni
2. Fai clic sulla scheda Acquista e valuta
3. Imposta la modalità di pagamento su "Live"
4. Inserisci la tua email aziendale PayPal (account PayPal verificato)
5. Imposta la valuta desiderata
6. Fai clic su "Salva"

Importante: passa alla modalità "Live" solo dopo aver effettuato test approfonditi in modalità "Sandbox".

Gestione degli acquisti

Tieni traccia di tutti gli acquisti dei clienti:

1. Accedi a Componenti → Corsi Mx → Acquisti
2. Visualizza l'elenco di tutti gli acquisti:
   • Nome del cliente
   • Titolo del corso
   • Data di acquisto
   • Importo pagato
   • Stato del pagamento

Come interpretare lo stato dell'acquisto

• In sospeso: pagamento ricevuto ma non ancora confermato
• Completato: pagamento confermato, il cliente ha accesso
• Non riuscito: la transazione di pagamento non è andata a buon fine
• Rimborsato: il pagamento è stato rimborsato

Impostazioni di visualizzazione del modulo

Il modulo Mx Courses visualizza i corsi in tutto il sito.

Installazione del modulo

1. Il modulo mod_mx_course viene installato insieme al componente
2. Accedere a Estensioni → Moduli nel pannello di amministrazione
3. Fare clic su Nuovo per creare una nuova istanza del modulo

Configurazione del modulo

Impostazioni di base

Parametri del modulo

Stili di visualizzazione disponibili

Scegli tra 21 diversi layout di moduli:

Prova diversi stili per trovare quello più adatto al tuo sito.

Assegnazione del modulo alle pagine del menu

Per visualizzare il modulo solo su pagine specifiche:

1. Modifica il modulo
2. Fai clic sulla scheda "Assegnazione al menu"
3. Seleziona:
   • Su tutte le pagine: Visualizza ovunque
   • Nelle pagine in cui: Visualizza solo nelle pagine selezionate
   • Nelle pagine in cui NON: Nascondi nelle pagine selezionate

Funzionalità frontend

Vista cliente

Pagina con l'elenco dei corsi

I clienti vedono:

• Titolo del corso e immagine in miniatura
• Breve descrizione (testo introduttivo)
• Nome del docente, descrizione e immagine del profilo
• Numero di lezioni e numero di iscritti
• Prezzo (se impostato)
• Valutazioni e recensioni (se abilitate)
• Pulsante "Leggi di più" o "Acquista ora"

Pagina dei dettagli del corso

Quando si visualizza un corso completo:

• Descrizione completa del corso
• Immagine del corso a grandezza naturale
• Informazioni dettagliate
• Prezzo e pulsante "Acquista corso" (se abilitato)
• Valutazione media e recensioni dei clienti

Acquisto di un corso

Per i corsi a pagamento:

1. Fare clic sul pulsante "Acquista corso"
2. Conferma i dettagli del corso
3. Reindirizzamento alla pagina di pagamento PayPal
4. Completa il pagamento tramite PayPal
5. Torna al sito con la conferma dell'acquisto
6. Accedi ai materiali del corso (se disponibili)

Per i corsi gratuiti:

1. Fare clic sul pulsante "Iscriviti" (se abilitato)
2. Iscrizione immediata come utente registrato

Lascia recensioni e valutazioni

Se la valutazione è abilitata:

1. Nella pagina dei dettagli del corso, scorri fino alla sezione delle valutazioni
2. Clicca sulla valutazione a stelle desiderata (da 1 a 5 stelle)
3. Se lo desideri, aggiungi un commento alla recensione
4. Invia la valutazione

Regole di autorizzazione:

• Tutti: qualsiasi visitatore può valutare (solo per gli utenti registrati)
• Solo acquirenti: solo i clienti che hanno acquistato il corso possono assegnare una valutazione

Integrazione con la ricerca

Se la ricerca di Joomla è abilitata:

• I corsi compaiono nei risultati di ricerca del sito
• La ricerca include titolo, descrizione e testo introduttivo
• Il componente dispone del plugin Finder per la ricerca avanzata

Risoluzione dei problemi

Problemi comuni e soluzioni

I corsi non vengono visualizzati sul sito

Problema: i corsi sono stati configurati ma non sono visibili nel modulo

Soluzioni:

• Verificare che lo stato del corso sia impostato su "Pubblicato"
• Verificare che il modulo sia pubblicato
• Verificare che l'assegnazione del menu del modulo includa la pagina corrente
• Svuotare la cache di Joomla (Sistema → Cache → Elimina tutto)
• Verificare l'assegnazione della categoria se si sta filtrando per categoria

Le immagini non vengono visualizzate

Problema: le immagini del corso appaiono danneggiate o mancanti

Soluzioni:

• Verificare che il file immagine esista sul server
• Verificare il percorso dell'immagine nel database
• Reimposta le miniature (Componenti → Mx Courses → Opzioni → Media → Reimposta miniature)
• Controllare i permessi del file immagine (dovrebbe essere leggibile)
• Provare a caricare nuovamente l'immagine

I pagamenti PayPal non funzionano

Problema: il pulsante "Acquista corso" non funziona o il pagamento non va a buon fine

Soluzioni:

• Verifica che l'opzione "Abilita acquisti" sia attiva
• Verifica che l'indirizzo e-mail PayPal sia corretto
• Effettuare un test in modalità Sandbox prima di passare alla modalità Live
• Verificare le impostazioni IPN (Notifica di pagamento istantanea) in PayPal
• Controllare i log degli errori del server per individuare eventuali errori IPN di PayPal
• Assicurarsi di disporre di un certificato SSL se si è in modalità Live

Miniature non generate

Problema: le miniature personalizzate non vengono visualizzate o appaiono errate

Soluzioni:

• Vai su Opzioni → scheda Media
• Fare clic sul pulsante "Reimposta miniature"
• Attendere il completamento del processo
• Controlla l'impostazione "Stile miniatura" per ogni corso
• Verifica che l'immagine soddisfi i requisiti minimi di dimensione

Errore del database durante l’installazione

Problema: l'installazione non va a buon fine a causa di un errore del database

Soluzioni:

• Verificare che l'utente del database disponga dei permessi CREATE/ALTER TABLE
• Verificare la compatibilità delle versioni di MySQL/PostgreSQL
• Assicurarsi che il prefisso del database non sia in conflitto con le tabelle esistenti
• Provare a disinstallare e reinstallare il componente
• Controllare i log di sistema di Joomla per individuare eventuali errori specifici

Domande frequenti

Domande generali

D: Posso applicare prezzi diversi a gruppi di utenti diversi?
R: Il componente supporta un unico prezzo per corso. Per una gestione avanzata dei prezzi, si consiglia di utilizzare plugin aggiuntivi di e-commerce per Joomla.

D: Quali metodi di pagamento sono supportati?
R: Attualmente, PayPal è il metodo di pagamento principale. L'integrazione di ulteriori gateway di pagamento richiede uno sviluppo personalizzato.

D: Posso offrire sconti o buoni sconto sui corsi?
R: Il componente di base non include funzionalità di sconto. Alcune estensioni di terze parti potrebbero fornire questa funzionalità.

Domande tecniche

D: Il componente supporta più lingue?
R: Sì, è completamente compatibile con il multilinguismo. È possibile creare corsi in diverse lingue utilizzando il campo "Lingua".

D: Posso esportare i dati dei corsi?
R: È possibile accedere alla funzionalità di esportazione tramite gli strumenti del componente di Joomla o direttamente dal database (MySQL/PostgreSQL).

D: Esiste un’API per l’integrazione con sistemi esterni?
R: Il componente utilizza l’architettura MVC standard di Joomla. Gli endpoint API personalizzati richiedono uno sviluppo su misura.

Domande sulla personalizzazione

D: Posso personalizzare i modelli di visualizzazione dei moduli?
R: Sì, i modelli dei moduli si trovano in /modules/mod_mx_course/tmpl/. Modifica i file di stile per personalizzare i layout.

D: Come faccio ad aggiungere campi personalizzati ai corsi?
R: Modifica i file di definizione dei moduli XML in /admin/models/forms/item.xml.

D: Posso modificare la procedura di acquisto?
R: Sì, modifica il controller del sito e il gestore IPN in /site/controller.php.

Domande sulle prestazioni

D: Questo componente rallenterà il mio sito?
R: No, è ottimizzato per le prestazioni. Utilizza la cache di Joomla per ottenere i migliori risultati.

D: Quanti corsi posso creare?
R: Un numero illimitato. Le prestazioni dipendono dalle risorse del server e dalla strategia di caching.

Assistenza e risorse

• Email di assistenza:
• Aggiornamenti: disponibili tramite il server di aggiornamento di Joomla (per un anno dalla data di acquisto)