Posizionare questa cartella nella cartella themes di WordPress. Per usare il tema è necessario creare prima una pagina (Home > Pagine > Aggiungi pagina) e successivamente selezionare il template laureandosi per la pagina appena creata.
La struttura interna di Laureandosi è disposta in questo modo:
├─ laureandosi.php (file principale)
├─ src (cartella contenente i file sorgenti)
│ ├─ class (cartella contenente le classi PHP)
│ ├─ lib (cartella contenente le librerie PHP)
│ ├─ test (cartella contenente le classi di test PHP)
│ └─ res (cartella contenente le risorse)
│ ├─ page
│ │ └─ home (cartella che contiene la pagina principale)
│ └─ config (cartella che contiene i file di configurazione)
│ ├─ corsi_di_laurea.json (file di configurazione dei corsi di laurea)
│ ├─ esami_informatici.json (file che contiene l'elenco degli esami informatici)
│ └─ filtro_esami.json (file di configurazione del filtro degli esami)
Note
I report verranno salvati nella directory principale di WordPress e NON in questa cartella.
Il file corsi_di_laurea.json contiene l'elenco dei corsi di laurea, le formule, i parametri, e il messaggio da inviare per email. Un esempio del contenuto del file è il seguente:
{
"t-inf": {
"cdl": "T. Ing. Informatica",
"cdl-alt": "INGEGNERIA INFORMATICA (IFO-L)",
"cdl-short": "t-inf",
"voto-laurea": "M*3+18+T+C",
"tot-CFU": 177,
"par-T": {
"min": 0,
"max": 0,
"step": 0
},
"par-C": {
"min": 1,
"max": 7,
"step": 1
},
"txt-email": "..."
},
}I campi sono i seguenti:
cdl: nome completo del corso di laureacdl-alt: nome completo del corso di laurea (versione alternativa)cdl-short: nome abbreviato del corso di laureavoto-laurea: formula per il calcolo del voto di laureatot-CFU: numero totale di CFUpar-T: parametro T per il calcolo del voto di laureapar-C: parametro C per il calcolo del voto di laureatxt-email: messaggio da inviare per email ai laureandi
Il file esami_informatici.json contiene l'elenco degli esami informatici. Un esempio del contenuto del file è il seguente:
[
"FONDAMENTI DI PROGRAMMAZIONE",
"ALGORITMI E STRUTTURE DATI",
"BASI DI DATI",
"RETI LOGICHE",
"CALCOLATORI ELETTRONICI",
"PROGETTAZIONE WEB",
"INGEGNERIA DEL SOFTWARE",
"SISTEMI OPERATIVI",
"RETI INFORMATICHE",
"PROGETTAZIONE DI RETI INFORMATICHE",
"PROGRAMMAZIONE AVANZATA",
"PROGRAMMAZIONE",
"FONDAMENTI DI INFORMATICA I",
"FONDAMENTI DI INFORMATICA II"
]Il file filtro_esami.json contiene le informazioni per il filtro degli esami. Un esempio del contenuto del file è il seguente:
{
"t-inf": {
"*": {
"esami-non-avg": [
"PROVA DI LINGUA INGLESE (B1)",
"PROVA DI LINGUA INGLESE",
"PROVA DI LINGUA INGLESE B2",
"TIROCINIO"
],
"esami-non-cdl": [
"PROVA FINALE",
"LIBERA SCELTA PER RICONOSCIMENTI",
"TEST DI VALUTAZIONE DI INGEGNERIA"
]
},
"1234": {
"esami-non-avg": [
"TEST3"
],
"esami-non-cdl": [
"TEST4"
]
}
}
}I campi sono i seguenti:
esami-non-avg: esami che non vanno considerati per il calcolo del voto medioesami-non-cdl: esami che non vanno mostrati nel report
Note
Come chiave del corso di laurea è utilizzato il nome abbreviato del corso di laurea. Se si vuole applicare le stesse regole a tutti i laureandi è possibile utilizzare il carattere*. Se si vuole applicare delle regole specifiche ad un singolo laureando è possibile utilizzare il numero di matricola del laureando (come in esempio il1234).
Per utilizzare il programma è necessario accedere alla pagina creata in fase di installazione.
Il programma permette di eseguire 3 operazioni:
- Crea Report: Permette di creare i report dei laureandi e per la commissione di laurea.
- Apri Report: Permette di aprire il per la commissione di laurea per la revisione.
- Invia Report: Permette di inviare per email i report ai laureandi.
In caso di dubbi è possibile passare il mouse sopra i vari pulsanti per avere una descrizione dell'operazione.
Note
È possibile riprendere l'utilizzo del programma da qualsiasi punto anche dopo averlo chiuso. Per esempio se si è già creato i report ma non si è ancora aperto il report per la commissione è possibile aprirlo senza dover ricreare tutto.
Note
È stato implementato un meccanismo di registrazione dell'invio email che previene l'invio di email multiple allo stesso laureando. Per ripristinare il meccanismo è necessario cancellare il filestato_invio.jsonsituato nella rispettiva cartella dei report.
Warning
Se attivo lo sflagTestvarrà ignorato il filtro esami e il controllo corso di laurea.
Per questa operazione è necessario aver selezionato il corso di laurea (dal menù a tendina), la data di laurea (dal calendario) e scritto i numeri di marticola dei laureandi (uno per riga) nell'apposito campo di testo. Successivamente è necessario cliccare sul pulsante Crea Report per creare i report.
Se la creazione dei report è andata a buon fine verrà visualizzato un messaggio di conferma del tipo 3 report creati con successo.
Altrimenti verrà visualizzato un messaggio di errore del tipo Errore: ... con il relativo messaggio di errore.
Per questa operazione è necessario aver selezionato il corso di laurea (dal menù a tendina), la data di laurea (dal calendario) e aver precedentemente completato l'operazione Crea Report. Successivamente è necessario cliccare sul pulsante Apri Report per aprire il report per la commissione di laurea.
Se tutto è corretto verrà aperta una nuova scheda del browser con il report per la commissione di laurea.
Altrimenti verrà visualizzato un messaggio di errore del tipo Errore: ... con il relativo messaggio di errore.
Per questa operazione è necessario aver selezionato il corso di laurea (dal menù a tendina), la data di laurea (dal calendario), scritto i numeri di marticola dei laureandi (uno per riga) nell'apposito campo di testo e aver precedentemente completato l'operazione Crea Report. Successivamente è necessario cliccare sul pulsante Invia Report per inviare i report ai laureandi.
Se l'invio dei report procede correttamente verranno visualizzati i messaggi di conferma del tipo Report inviato al laureando 65468. 3 report rimanenti. ... per ogni laureando ogni 10 secondi.
Altrimenti verrà visualizzato un messaggio di errore del tipo Errore: ... con il relativo messaggio di errore.
Warning
Verranno inviate le email SOLO ai laureandi inseriti nel box 'Matricole'.
Per testare il programma è possibile accedere alla pagina test aggiungendo ?test alla fine dell'url della pagina.
Per esempio se la pagina è raggiungibile all'indirizzo https://www.example.com/laureandosi/ è possibile accedere alla pagina test all'indirizzo https://www.example.com/laureandosi/?test.
In questa pagina è possibile testare le funzionalità del programma. I test verranno eseguiti automaticamente al caricamento della pagina.
Se tutti i test sono andati a buon fine verrà visualizzato un OK verde affianco ad ogni test, altrimenti verrà visualizzato il messaggio di errore. È possibile espandere il contenuto di ogni test cliccando sul pulsante > affianco al test per visualizzarne i dettagli.
