Di seguito sono riportati i criteri di conformità e le raccomandazioni verificabili tramite App di valutazione dell'adesione al modello scuole.
Per il corretto funzionamento dell'App di valutazione, è necessario inserire dei data attribute all’interno dei tag HTML del sito.
Note
I data attribute, dove possibile, sono già presenti nei materiali forniti da Designers Italia, sia all'interno dei template HTML che dei CMS messi a disposizione. Rimane tuttavia responsabilità dell'ente verificare che siano correttamente inseriti dovunque richiesto.
La chiave generale dell’attribute è data-element=* e va inserita all’interno dei tag HTML.
Per tutto ciò che è un URL, per esempio FAQ o Segnalazione disservizio, l'App controlla anche che l’URL nell’href del componente non sia nullo e, per alcuni casi specifici, che sia in HTTPS (vedi dettagli audit) e che riporti ad una pagina “funzionante”.
NB: Per tutto ciò che viene controllato sulla base di un vocabolario si utilizzano controlli non case-sensitive.
Condizioni di successo: tutti i titoli (heading) e tutti i paragrafi delle pagine del sito in lingua italiana devono usare esclusivamente i font Titillium Web, Lora e Roboto Mono.
Modalità di verifica: tramite ricerca dello specifico attributo data-element, viene verificato che i font richiesti siano i primi a venir utilizzati all'interno di tutti gli <h> e <p> in una scheda servizio casualmente selezionata.
Template HTML su cui si effettua scraping: scuole-home.html, scuola-servizi-tipologia.html, scuole-servizio-generico.html
Requisiti tecnici: Il menù di secondo livello "Servizi" deve contenere voci ("Famiglie e studenti", "Personale scolastico" e "Percorsi di studio") con attributo data-element=”service-type” al fine di prelevare gli URL (in modo randomico) del listato servizi (contengono l’URL alla pagina scuola-servizi-tipologia), devono essere degli <a> con “href” e possono essere inclusi in altri tag (ad es: <li>).
Dalla pagina "scuola-servizi-tipologia" le card devono contenere una tag <a> con attributo data-element=”service-link”.
Condizioni di successo: il sito usa la libreria Bootstrap Italia in una versione uguale o superiore alla 1.6.
Modalità di verifica: viene verificata la presenza della libreria Bootstrap Italia e la versione in uso individuando la proprietà CSS --bootstrap-italia-version all’interno del selettore :root o la variabile globale window.BOOTSTRAP_ITALIA_VERSION.
Condizioni di successo: se è in uso il tema CMS del modello scuole, la versione utilizzata è uguale o superiore alla 2.0.
Modalità di verifica: viene verificato l'uso del tema CMS del modello e la versione in uso ricercando il testo commentato presente nel file style.css del tema Wordpress, se presente.
Condizioni di successo: le voci del menù di primo livello del sito sono esattamente quelle indicate nel documento di architettura dell'informazione e sono nell'ordine indicato (ovvero Scuola, Servizi, Novità, Didattica).
Modalità di verifica: tramite ricerca di uno specifico attributo data-element, vengono identificate le voci presenti nel menù del sito, il loro ordine e confrontate con quanto indicato nel documento di architettura dell'informazione, applicando una tolleranza di massimo 3 voci aggiuntive;
Template HTML su cui si effettua scraping: scuole-home.html
Requisiti tecnici: Il tag <ul> deve avere l’attributo data-element=”menu” ed essere composto da <li> e <a>
Esempio:
.. literalinclude:: esempi-codice-scuole/c-sc-1-4.html
Condizioni di successo: le voci del menù di secondo livello corrispondono a quelle indicate nel documento di architettura dell'informazione del modello scuole.
Modalità di verifica: tramite ricerca di uno specifico attributo data-element, viene verificata la correttezza delle voci del menù di secondo livello riferite alla voce di primo livello "Scuola".
Template HTML su cui si effettua scraping: scuole-home.html
Requisiti tecnici: Il tag <ul> deve avere l’attributo data-element=”school-submenu” ed essere composto da <li> (può contenere anche altri tag, ad esempio <a>).
Esempio:
.. literalinclude:: esempi-codice-scuole/c-sc-1-5.html
Condizioni di successo: il sito presenta una voce nel footer che riporta all'informativa privacy.
Modalità di verifica: tramite ricerca di uno specifico attributo data-element, viene verificata la presenza di un link nel footer che riporti a una pagina esistente e con certificato HTTPS valido e attivo.
Template HTML su cui si effettua scraping: scuole-home.html
Requisiti tecnici: Il tag <a> deve avere l’attributo data-element=”privacy-policy-link” e contenere un “href” (può essere contenuto in altri tag, ad esempio <li> …). Il tag deve essere presente all’interno del tag <footer>.
Esempio:
.. literalinclude:: esempi-codice-scuole/c-sc-2-1.html
Condizioni di successo: il sito presenta una voce nel footer che riporta alla dichiarazione di accessibilità.
Modalità di verifica: tramite ricerca di uno specifico attributo data-element, viene verificata la presenza di un link nel footer che riporti a una pagina esistente che sia quella contenente la dichiarazione di accessibilità (il link deve iniziare con "https://form.agid.gov.it/view/").
Template HTML su cui si effettua scraping: scuole-home.html
Requisiti tecnici: Il tag <a> deve avere l’attributo data-element=”accessibility-link” e contenere un “href” (può essere contenuto in altri tag, ad esempio <li> …). Il tag deve essere presente all’interno del tag <footer>.
Esempio:
.. literalinclude:: esempi-codice-scuole/c-sc-2-2.html
Condizioni di successo: il sito presenta solo cookie idonei come definito dalla normativa.
Modalità di verifica: viene verificato che il dominio dei cookie identificati sia corrispondente al dominio del sito web. Se nella pagina analizzata non vengono rilevati cookie non verrà generata una tabella di risultati.
Condizioni di successo: il sito utilizza un certificato https valido e non obsoleto secondo le raccomandazioni AGID.
Modalità di verifica: viene verificato che il certificato https del sito sia valido e attivo.
Condizioni di successo: gli argomenti utilizzati appartengono alla lista indicata all'interno del documento di architettura dell'informazione del modello scuole alla voce "Le parole della scuola".
Modalità di verifica: tramite ricerca di specifici attributi data-element, gli argomenti identificati all'interno della funzione di ricerca del sito vengono confrontati con l'elenco di voci presente nel documento di architettura dell'informazione.
Template HTML su cui si effettua scraping: scuole-home.html, scuole-risultati-ricerca.html
Requisiti tecnici: Il bottone (<button>) "cerca" deve avere attributo data-element=”search-modal-button” in modo da poterne simulare l'apertura. Il tag <input> di testo deve avere attributo data-element=”search-modal-input” in modo da poter essere inserito testo di ricerca. Infine, il bottone per cercare (avvia ricerca) deve avere data-element=”search-submit”.
La pagina risultati ricerca deve contenere un listato di argomenti <ul> con attributo data-element=”all-topics”; deve contenere degli <li> (può contenere altri tag).
Esempio:
.. literalinclude:: esempi-codice-scuole/r-sc-1-1.html
Condizioni di successo: nelle schede informative di servizio le voci indicate come obbligatorie sono presenti e sono nell'ordine corretto.
Modalità di verifica: tramite ricerca di specifici attibuti data-element, viene verificato se le voci indicate come obbligatorie all'interno del documento di architettura dell'informazione sono presenti e se le voci obbligatorie presenti nell'indice della pagina sono nell'ordine corretto. La verifica viene effettuata su una scheda servizio casualmente selezionata.
Template HTML su cui si effettua scraping: scuole-home.html, scuola-servizi-tipologia.html, scuole-servizio-generico.html
Requisiti tecnici: Il menù di secondo livello "Servizi" deve contenere voci ("Famiglie e studenti", "Personale scolastico" e "Percorsi di studio") con attributo data-element=”service-type” al fine di prelevare gli URL (in modo randomico) del listato servizi (contengono l’URL alla pagina scuola-servizi-tipologia), devono essere degli <a> con “href” e possono essere inclusi in altri tag (ad es: <li>).
Dalla pagina "scuola-servizi-tipologia" le card devono contenere una tag <a> con attributo data-element=”service-link”.
Si atterra quindi sulla pagina "scuole-servizio-generico" che contiene le componenti da ispezionare:
- Titolo con attributo
data-element=”service-title”che può essere un tag qualsiasi (h1, p, etc..). Viene controllata la presenza del Titolo della scheda servizio. - Descrizione con attributo
data-element=”service-description”che può essere un tag qualsiasi (h1, p, etc..). Viene controllata la presenza della Descrizione della scheda servizio. - La breadcrumb <ul>/<ol> con attributo
data-element=”breadcrumb”che contiene i tag <li> che possono contenere altri tag. Viene controllato che all’interno della breadcrumb della scheda siano contenuti i valori: "Famiglie e studenti" o "Personale scolastico". - La sezione "A cosa serve" con
data-element=”used-for”che può essere un tag qualsiasi. Viene controllata la presenza della sezione “A cosa serve” della scheda servizio. - Gli argomenti con
data-element=”topic-list”in un tag <a>. Viene controllata la presenza di almeno una voce “argomenti” all’interno della scheda servizio. - Gli elementi del luogo con
data-element=”places”che contenga i tag <span> per la label e <p> per il valore relativo alla label. Controlla la presenza della card “luogo” e alcuni elementi al suo interno, quali: "indirizzo", "orari", "gps", “email”, “PEC” e “telefono”. Il controllo viene effettuato sulla presenza della label e sulla sua valorizzazione (cioè le label devono chiamarsi “indirizzo”, “orari” etc..). NB: Per quanto riguarda le coordinate GPS viene controllato che l’URL della mappa contenga il valore “map” (in modo da coprire più servizi di mappe possibili) mentre per quanto riguarda gli orari viene controllato tramite Regexp che il valore della label “orari” contenga un orario in formato in ore, minuti oppure ore, minuti e secondi. - Il componente per le strutture responsabili che abbia un wrapper con
data-element=”structures”e che contenga un tag <a> con l’url (href) alla Struttura responsabile del servizio. Viene controllata la presenza dell’elemento. - Il componente metadati con
data-element=”metadata”che può essere un tag qualsiasi il cui testo contenga le stringhe “pubblicato” o “revisionato”. - Il componente indice <ul>/<ol> con
data-element=”page-index”che contenga <li> e <a> in cui devono essere presenti le voci da ispezionare. Su questo menù vengono controllate sia in presenza che in sequenzialità (cioè una voce per essere in posizione corretta deve avere la precedente e la successiva come descritto dal modello). Le voci che vengono controllate sono: "Cos'è", "Come si accede al servizio", "Cosa serve", "Tempi e scadenze", “Contatti” e “Ulteriori informazioni”.
Voci delle quali viene verificata la presenza: titolo, tipologia (contenuto breadcrumb), tassonomia argomenti, descrizione breve, “Cos’è”, “A cosa serve”, “Come si accede al servizio”, indirizzo (Sede canale fisico), posizione GPS tramite mappa (Sede canale fisico), orario per il pubblico (Sede canale fisico), email (Sede canale fisico), PEC (Sede canale fisico), telefono (Sede canale fisico), “Cosa serve”, “Tempi e scadenze”, “Struttura responsabile del servizio” e metadati. Voci delle quali viene verificata la presenza e sequenzialità all’interno dell’indice della pagina: "Cos'è", "Come si accede al servizio", "Cosa serve", "Tempi e scadenze", “Contatti” e “Ulteriori informazioni”.
Esempio:
.. literalinclude:: esempi-codice-scuole/r-sc-1-2.html
Condizioni di successo: l'indirizzo IP fa riferimento a un datacenter localizzato su territorio europeo.
Modalità di verifica: viene verificato che la localizzazione dell'IP rientri all'interno di uno dei confini degli stati membri dell'Unione Europea.