Nuovi commenti in tutto il codice (#2)

* Aggiunti commenti alla pagina di login

* Aggiunti commenti alla pagina della visualizzazione voti

* Aggiunti commenti alla dashboard del professore

* Aggiunti commenti alla pagina di aggiunta voti

web/addmarks.htm

@@ -15,18 +15,21 @@
 			var rank = Cookies.get("rank");
 			var selectedclass = Cookies.get("selectedclass");
 
+			//Visualizza un errore in una riga.
 			function displayFieldError(formgroup, str)
 			{
 				formgroup.find(".help-block").text(str);
 				formgroup.find("input").addClass("has-error");
 			}
 
+			//Rimuovi l'errore da una riga.
 			function clearFieldError(formgroup)
 			{
 				formgroup.find(".help-block").text("");
 				formgroup.find("input").removeClass("has-error");
 			}
 
+			//Visualizza un errore su tutta la pagina.
 			function displayFullPageError(str)
 			{
 				$("#error").text(str)
@@ -34,6 +37,7 @@
 				$("#data").addClass("hidden");
 			}
 
+			//Converti una data in Unix Epoch
 			function toEpoch(datestr)
             {
                 var date = new Date(datestr);
@@ -41,6 +45,7 @@
                 return epoch;
             }
 
+			//Controlla se una riga ha degli errori
 			function checkForErrors()
 			{
 				var rowId = $(this).parents("tr").attr("id")
@@ -88,6 +93,7 @@
 				}
 			}
 
+			//Crea la tabella di tutti gli alunni della classe e i campi in cui inserire i voti
 			function drawTable(list)
 			{
 				for(var i = 0; i < list.length; i++)
@@ -100,6 +106,7 @@
 				};
 			}
 
+			//Ricevi dal server i dati di una classe.
 			function getClassData()
 			{
 				if(sessionid == undefined)
@@ -159,7 +166,7 @@
 					displayFieldError($("#form-date"), "Questo campo non può essere lasciato vuoto.")
 				}
 				/*
-				Se description viene mandato vuoto non succede niente, vero?
+				Se description viene mandato vuoto non succede niente, vero? VERO? Altrimenti, togli il commento da qua.
 				else if($("#input-description").val() === "")
 				{
 					displayFieldError($("#form-description"), "Questo campo non può essere lasciato vuoto.")

web/login.htm

@@ -14,6 +14,7 @@
 
             function beginLoading()
             {
+                //Disabilita il bottone login e inizia a far girare la rotellina di caricamento.
                 $("#btn-login").unbind("click");
                 $("#input-password").unbind("keypress");
                 $("#btn-login").addClass("disabled");
@@ -22,6 +23,7 @@
 
             function successfulLoading()
             {
+                //Controlla il rank ricevuto in precedenza dal server, interrompi il timer del timeout e manda l'utente alla dashboard del suo ruolo
                 clearTimeout(logintimer);
                 enableButtons();
                 $("#status-icon").removeClass("glyphicon-cog loading");
@@ -33,12 +35,14 @@
                 }
                 else if(rank === "stud")
                 {
+                    //Cambia qui appena abbiamo una dashboard per gli studenti
                     window.location.href = "marks.htm";
                 }
             }
 
             function endLoading()
             {
+                //Interrompi l'animazione di caricamento e riabilita il bottone di login.
                 clearTimeout(logintimer);
                 enableButtons();
                 $("#status-icon").addClass("faded").removeClass("loading");
@@ -46,6 +50,7 @@
 
             function login()
             {
+                //Esegui la richiesta di login al server e visualizza il risultato sulla pagina.
                 $("#form-username").removeClass("has-error");
                 $("#form-password").removeClass("has-error");
                 $("#help-username").text(" ");
@@ -125,7 +130,8 @@
                 $("#btn-login").click(login);
                 $("#input-password").keypress(function(key)
                 {
-                    //Invio.
+                    //Se viene premuto il tasto invio mentre è selezionato il campo password, esegui il login.
+                    //Invio == 13
                     if(key.which === 13)
                     {
                         key.preventDefault();

web/marks.htm

@@ -11,10 +11,14 @@
         <script src="https://code.jquery.com/jquery-1.12.4.min.js"></script>
         <script src="/lib/cookie.js"></script>
         <script>
+            //Elenco di tutti i voti ricevuto dal server
             var voteList = [];
+            //Ordine attuale delle colonne, false è crescente e true è decrescente
             var reverseme = false;
+            //Come si chiamano i periodi per i voti. (Per cambiare tra quadrimestre e trimestre)
             var termname = "quadrimestre";
 
+            //Ordina una colonna.
             function sortMe()
             {
                 $(".fa").removeClass("fa-sort-asc fa-sort-desc");
@@ -29,6 +33,7 @@
                 tableSort("mark", "number");
             }
 
+            //Aggiungi lo 0 a un numero se ha meno di due cifre
             function padNumber(string)
             {
                 if(Number(string) < 10)
@@ -41,6 +46,7 @@
                 }
             }
 
+            //Trasforma le date in una stringa nel formato AAAA-MM-DD
             function stringifyDates()
             {
                 for(var i = 0; i < voteList.length; i++)
@@ -50,6 +56,7 @@
                 }
             }
 
+            //Ottieni l'elenco di tutti i numeri di periodi esistenti
             function getTermList(list)
             {
                 var termList = [];
@@ -64,6 +71,7 @@
                 return termList;
             }
 
+            //Ottieni l'elenco di tutte le materie con almeno un voto
             function getSubjectList(list)
             {
                 var subjectList = [];
@@ -78,6 +86,7 @@
                 return subjectList;
             }
 
+            //Disegna la tabella dei voti in base ai dati ricevuti dal server (voteList)
             function drawTable(list)
             {
                 $("#marks tbody").html("");
@@ -111,6 +120,7 @@
                 });
             }
 
+            //Calcola le medie per ogni materia e disegna le tabelle
             function calcAndDrawAvg(list)
             {
                 var subjectlist = getSubjectList(list);
@@ -154,9 +164,10 @@
                 }
             }
 
+            //Ordina una tabella in base alla riga
             function tableSort(index, type)
             {
-                /*Questo codice è un tantino hackeroso... Ma finchè funziona perchè cambiarlo, no?*/
+                //Questo codice è un tantino hackeroso... Ma funziona!
                 if(type === "string")
                 {
                     voteList.sort(function(a, b) {
@@ -181,6 +192,7 @@
                 drawTable(voteList);
             }
 
+            //Aggiungi le freccine per l'ordinamento alla tabella dei voti
             function enableSort()
             {
                 $("#sort-subject").click(sortMe);
@@ -189,7 +201,7 @@
                 $("#sort-term").click(sortMe);
             }
 
-            //Ricevi i voti.
+            //Ricevi i voti dal server.
             $.post("https://api.emilianomaccaferri.me/getMarks",
                 {
                     "sessionid": Cookies.get("sessionid")

web/profdashboard.htm

@@ -15,6 +15,7 @@
             var rank = Cookies.get("rank");
             var classList;
 
+            //Visualizza un errore su tutta la pagina
             function displayFullPageError(str)
 			{
 				$("#error").text(str)
@@ -22,6 +23,7 @@
 				$("#data").addClass("hidden");
 			}
 
+            //Vai alla pagina di visualizzazione voti della classe selezionata
             function gotoaddmarks()
             {
                 classname = $(this).parents(".col-sm-3").attr("id");
@@ -29,6 +31,7 @@
                 window.location.href = "multiaddmark.htm";
             }
 
+            //Ottieni dal server l'elenco di tutte le classi del prof
             function getClasses()
             {
                 if(sessionid == undefined)
@@ -58,6 +61,7 @@
                 }, "json")
             }
 
+            //Disegna la dashboard.
             function drawDashboard(list)
             {
                 for(var i = 0; i < classList.length; i++)