Table of Contents

Introduzione

La nuova versione di IRIS è dotata di una veste grafica basata sul framwork Bootstrap 5. Questo gli consente di avere una migliore usabilità da parte degli utenti, una più ampia portabilità sui dispositivi, privilegiando quelli mobile, ed infine garantire un livello di sicurezza più elevato.
La struttura della veste grafica di IRIS è stata semplificata per dare modo agli amministratori dell'archivio di poter intervenire su di essa in modo più rapido ed intuitivo. È infatti possibile gestire tutti gli elementi che compongono l'archivio attraverso l'utilizzo del tool 'Layout'.

Tool di gestione della veste grafica

Il tool di gestione della veste grafica di IRIS è uno strumento disponibile agli amministratori che operano in visione completa. Per utilizzare il tool occorre accedere al menu e portarsi in Configurazione > Layout.
Il tool si compone di 4 elementi principali:

...

Di seguito i dettagli sull'utilizzo di questi 4 strumenti e dell'impatto che hanno sulla gestione della veste grafica dell'archivio.

CMS

 Attraverso il CMS (Content Managment System) è possibile inserire in Archivio i file che che saranno utilizzati per comporre la veste grafica.  Il Il CMS è composto da un'interfaccia che presenta 5 cartelle principali ovvero cineca, css, image, static e sr. I files caricati all'interno di una di queste 5 cartelle saranno disponibili all'URL URL_DI_SISTEMA/dir/

All'interno della cartella 'sr' sono depositati i file che serviranno per gestire la veste grafica dell'applicativo è 'sr'. Tutti i file caricati in questa cartella sono letti automaticamente dal sistemsistema.

Per accedere alla cartella basta selezionarla con un doppio click, all'interno si trovano due cartelle chiamate rispettivamente bootstrap e cineca che non devono essere utilizzate.

Si possono caricare solo alcune tipologie di files. Per estendere l'elenco delle tipologie ammesse, aprite un ticket sul customerportal. Le tipologie ammesse sono pdf,doc,docx,xls,xlsx,gif,jpeg,jpg,bmp,css,js,html,csv,ico,json,map,mp4,odt,otf,png,ppt,pptx,svg,ttf,webp,woff,xml,zip,7z,txt

Particolare attenzione ai files:

• /sr/local.css                       -     inserire i css personalizzati per l'ateneo
• /sr/local.js                         -     inserire i js personalizzati per l'ateneo
• /sr/logo_customer.png     -     caricare logo ateneo

(se non esistono vengono usati file di default/vuoti)

Il file /sr/cineca/css/bootstrap-ricerca.min.css non va modificato. In caso di modifica, al successivo riavvio del sistema la modifica andrà persa. Questo file viene infatti rielaborato dalla funzione StileNB: In questa cartella è possibile caricare il file local.css che serve per sovrascrivere le classi css dell'archivio.

Caricamento file

Per caricare uno o più file all'interno della cartella 'sr' occorre cliccare sul tasto menu (icona con 3 puntini) e selezionare la voce Upload files. Si aprirà una finestra di dialogo che consente di selezionare i file di interesse dal proprio pc. Una volta selezionati i file occorre cliccare sul pulsante 'Upload' per caricare i file.

Creazione cartella

Per creare una nuova cartella all'interno della cartella 'sr' occorre cliccare sul tasto menu (icona con 3 puntini) e selezionare la voce 'New folder'. Si aprirà una finestra di dialogo che consente di attribuire un nome alla cartella che si sta creando, dopo aver digitato il nome della cartella occorre cliccare su 'Create' per crearla.

Gestione file

Cliccando con il pulsante destro del mouse su un file caricato all'interno della cartella 'sr' viene visualizzato un menu con le seguenti azioni:

• Download: consente di scaricare il file selezionato;
• Rename: consente di rinominare il file selezionato;
• Move: consente di spostare il file selezionato;
• Copy: consente di effettuare una copia del file selezionato;
• Permissions: visualizza una finestra di dialogo per gestire i permessi associati al file;
• Delete: consente di eliminare il file selezionato;

Gestione cartella

Cliccando con il pulsante destro del mouse su una cartella di quelle presenti nella cartella 'sr' viene visualizzato un menu con le seguenti azioni:

• Open: consente di accedere alla cartella selezionata;
• Rename: consente di rinominare la cartella selezionata;
• Move: consente di spostare la cartella selezionata;
• Permissions: visualizza una finestra di dialogo per gestire i permessi associati alla cartella selezionata;
• Compress: consente di comprimere la cartella selezionata;
• Delete: consente di eliminare la cartella selezionata;

local.css

Il file local.css è un file molto importante perché consente di sovrascrivere le classi css degli elementi che compongono l'Archivio. Attraverso la sovrascrittura delle classi css standard è possibile modificare l'aspetto degli elementi che compongono l'archivio: ad esempio, è possibile attribuire un aspetto differente da quello standard a tutti gli elementi di tipo <H1>.

...

Ulteriori dettagli sull'utilizzo delle classi css sono disponibili al seguente indirizzo: CSS Tutorial (w3schools.com)

Stile

Attraverso lo strumento Stile è possibile modificare l'aspetto degli elementi principali che caratterizzano l'archivio. Tale strumento è composto da una serie di campi che rappresentano gli elementi principali dell'aspetto grafico dell'archivio e i rispettivi valori di default.

...

• colore primario:  il colore primario associato agli elementi dell'archivio. Questo colore caratterizza ad esempio il bunner principale;
• colore secondario: il colore secondario associato agli elementi dell'archivio. Questo colore caratterizza ad esempio lo sfondo del menu;
• colore successo: il colore che caratterizza i messaggi di successo che compaiono in archivio;
• colore errore: il colore che caratterizza i messaggi di errore che compaiono in archivio;
• colore info: il colore che caratterizza i messaggi di informazione che compaiono in archivio;
• colore attenzione: il colore che caratterizza i messaggi di warning che compaiono in archivio;
• colore chiaro: il colore che caratterizza la classe css light;
• colore scuro:  il colore che caratterizza la classe css dark;
• colore sfondo pagina:  il colore che caratterizza lo sfondo di tutte le pagine;
• colore sfondo forms:  il colore che caratterizza lo sfondo delle form dell'archivio;
• colore testo menu top: il colore che caratterizza il testo del menu principale dell'archivio, cioè quello in alto;
• stile menu sx - border: il colore che caratterizza il bordo del menu dell'archivio;
• abilita arrotondamenti: abilita o disabilita gli arrotondamenti a tutti gli elementi dell'archivio (true = arrotondamenti abilitati; false = arrotondamenti disabilitati);
• bordo schede: indica lo spessore da attribuire al bordo delle schede espresso in px;
• ombra schede: indica l'ombra delle schede. Il valore è espresso in px (ulteriori informazioni presenti in CSS Shadow Effects (w3schools.com));
• arrotondamento bordo schede: indica il raggio di arrotondamento del bordo delle schede espresso in px;
• arrotondamento forms: indica il raggio di arrotondamento del bordo delle forms espresso in px;
• arrotondamento buttons: raggio di arrotondamento del bordo dei bottoni espresso in px;
• scss personalizzato: si tratta di un file generato automaticamente dal sistema.
• import fonts: font da utilizzare;

...

...

• il campo scss personalizzato

...

• va utilizzato solo da utenti competenti nella programmazione scss. Permettere di includere del codice personalizzato in modo da generare css con stili particolari

Configurazioni

Attraverso tale strumento è possibile stabilire le caratteristiche che devono avere gli elementi che compongono l'archivio.

...

• impostazioni sito
• impostazioni homepage

Impostazioni sito

La sezione impostazioni sito è composta da 6 campi in cui indicare le caratteristiche che devono avere gli elementi principali dell'archivio. Essendo la veste grafica di IRIS basata su Bootstrap 5 le caratteristiche degli elementi devono essere indicate con le notazioni proprie di bootstrap 5.

• container pagina pubblica: valore di default = container-xxl. Indica che l'archivio verrà visualizzato presentando del margine ai lati dello schermo.
• stile menu top: valore di default = navbar-dark sticky-top
• stile footer totali: valore di default = bg-primary text-white. Indica che l'elemento totalFooter avrà come colore di sfondo il colore primario impostato nello strumento Stile, mentre il testo sarà di colore bianco.
• stile menu top backgroung: valore di default = bg-primary. Indica che il banner principale avrà come colore di sfondo il colore primario impostato nello strumento Stile.
• stile site header: valore di default = bg-secondary text-white. Indica che l'elemento newsHeader avrà come colore di sfondo il colore secondario impostato nello strumento Stile, mentre il testo sarà di colore bianco.
• stile menu sx: valore di default = bg-secondary. Indica che il menu principale avrà come colore di sfondo il colore secondario impostato nello strumento Stile.

Impostazioni homepage

Attraverso questa sezione è possibile gestire gli elementi che compongono la homepage. In particolare è possibile stabilire:

...

Se un elemento ha una lunghezza pari a 12 colonne allora occupa l'intera larghezza della homepage; se un elemento ha una lunghezza pari a 6 colonne allora occupa metà della larghezza della homepage e sarà visualizzato su una riga accanto a uno o più elementi. Ad esempio, se ho 4 faccette e voglio che siano visualizzate su una sola riga, allora dovrò impostare il campo css facets con il valore col-lg-3 (12/3=4); se voglio che le 4 faccette siano visualizzate su due righe in modo che ci siano due faccette per ogni riga allora dovrò impostare il campo css facets con il valore col-lg-6 (12/6=2).
Al termine di ogni modifica occorre cliccare sul pulsante 'Salva e vai alla visualizzazione dei dati' (posizionato in basso a sinistra della pagina) e successivamente cliccare 'aggiornamento configurazioni'.

Modifica news

Il tool Modifica News permette di inserire del testo statico in homepage: dando a possibilità all'Ente di inserire dei messaggi o dei contenuti html personalizzati. 

...