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:

  • CMS
  • Configurazioni
  • Stile
  • Modifica news

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 saranno utilizzati per comporre la veste grafica. 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. Tutti i file caricati in questa cartella sono letti automaticamente dal sistema.

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 Stile

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>.

ATTENZIONE

Per sovrascrivere correttamente le classi css standard è OBBLIGATORIO che il file si chiami local.css (scritto in minuscolo) e che sia nella cartella CMS>sr.


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.


Per modificare il valore di un elemento basta cliccare nel corrispondente campo, inserire il valore desiderato quindi cliccare su Salva e vai alla visualizzazione dei dati e successivamente su aggiornamento configurazioni (pulsante posizionato in alto nella pagina)

Per modificare un campo che rappresenta un colore è possibile cliccare all'interno del campo, comparirà una palette che consente di selezionare la tonalità di colore desiderata.



Di seguito l'elenco dei campi presenti nel tool e il loro significato:

  • 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.

La pagina del tool 'Configurazioni' si compone di due sezioni:

  • 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.
  • stile css per badge bitstream: valore di default = bg-info. Indica il colore di background da utilizzare per il badge che accompagna i bitstream che indica la tipologia di accesso (accesso aperto, riservato, etc.)
  • visualizza menu contatti: valore di default = false. Visualizza nella barra in alto il menu "contatti"

Impostazioni homepage

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

  • Quali elementi devono essere visualizzati;
  • In che ordine devono comparire;
  • Che dimensioni devono avere.

L'homepage di IRIS è suddivisa in 12 colonne e ciascun elemento che la compone può essere largo da 1 a 12 colonne; tutti gli elementi sono visualizzati in sequenza



Nel campo 'elenco componenti home' vanno indicati gli elementi che gli elementi che andranno a comporre la homepage. Tutti gli elementi devono essere separati da virgola (es. newsHeader,news1,news2,simpleSearchForm).


Di default la homepage è composta dai seguenti elementi:

  • newsHeader: header della homepage;
  • news1: news numero 1;
  • recentSubmissions: carosello che mostra gli ultimi prodotti inseriti in archivio;
  • simpleSearchForm:  form di ricerca semplice
  • facets: faccette per sfogliare i prodotti dell'archivio
  • news2: news numero 2;
  • mostViewed: faccetta prodotti più visualizzati;
  • mostDownloaded: faccetta prodotti più scaricati;
  • totalFooter: contatori totali. Il contatore 'Autori' comprende solo autori riconosciuti in almeno una 1 pubblicazione. L'aggiornamento dei contatori avviene circa ogni ora.


I restanti campi servono a definire la larghezza che avrà ciascun elemento della homepage: tale larghezza è espressa con la notazione bootstrap 5 col-lg-[numero colonne].

Di seguito i dettagli

  • css slider submission: dimensione dell'elemento carosello;
  • css facets: dimensione di ciascuna faccetta;
  • css most viewed: dimensione della faccetta prodotti più visualizzati;
  • css search site form: dimensione della form di ricerca base;
  • css most downloaded: dimensione della faccetta prodotti più scaricati;
  • css custom query
  • css tag cloud

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. 



Nella maschera sono presenti i seguenti elementi:

  • Testo homepage header: contiene l'html dell'elemento newsHeader presente nel tool configurazioni. Di default è presente il codice html che consente di visualizzare la form di ricerca base nello sfondo viola.
  • Testo statico da 1 a 9:  contiene l'html dell'elemento news1 – news9 presente nel tool configurazioni.
  • Testo statico in mydspace:  contiene l'html dell'elemento visualizzato nella parte alta della pagina i miei prodotti. Questo testo viene visualizzato da tutti gli utenti  in qualsiasi visione ( comepleta, personale e dipartimentale).

Di seguito riportiamo il contenuto standard dell'elemento newsHeader.

<div class="site-header bg-secondary">
	<div class="container">
		<h3 class="mt-4 text-center">Esplora il catalogo della ricerca</h3>
		<form action="/simple-search">
			<div class="input-group mt-3">
				<input class="form-control" name="query"/>
					<button class="btn btn-primary" type="submit">
					<i class="fas fa-search"></i>
				</button>
			</div>
		</form>
		<div class="d-flex justify-content-end mt-2">
			<a href="/simple-search" class="text-white">Ricerca avanzata</a>
		</div>
		<div class="mt-3 text-left text-white">
			<h5 class="cinecaSiteHomeIntroduction">CINECA IRIS Institutial research information system</h5>
			<p>è la soluzione IT che facilita la raccolta e la gestione dei dati relativi alle attività e ai prodotti della Ricerca. Fornisce a Ricercatori, amministratori e valutatori gli sturmenti per monitorare i risultati della ricerca, aumentarne la visibilità e allocare in modo efficace le risorse disponibili</p>
		</div>
	</div>
</div>

Di seguito proponiamo la resa grafica dell'elemento descritto sopra.

Di seguito riportiamo il contenuto di esempio per la news1 e il significato delle notazioni bootstrap 5 che caratterizzano le classi dei suoi elementi.

<div class="col-6 mt-2">
	<div class="card">
		<div class="card-body">
			<p> testo statico 1</p>
		</div>
	</div>
</div>

Di seguito il dettaglio delle notazioni

  • col-6 mt-2: vuol dire che la news è larga 6 colonne (col-6) e avrà un margine dall'elemento superiore di 2 unità (mt-2);
  • card: significa che l'elemento sarà visualizzato come una card, cioè come un riquadro dallo sfondo bianco con i bordi smussati;
  • card-body: permette di trattare il contenuto di questo elemento come parte della card.

Nell'immagine sotto è visibile la resa grafica dell'elemento descritto sopra.

Risorse Esterne

Tutte le risorse esterne (javascripts, css, fonts) vengono recuperate passando dal proxy CDN CINECA (https://static.cineca.it) in modo da essere conformi a quanto previsto dal regolamento GDPR (dalla versione 22.11.2.0)

  • No labels