Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- liquens:scaffali [2012/04/23 18:13]
gbonanome
+++ liquens:scaffali [2021/03/08 15:39] (versione attuale)
@@ Linea 1: / Linea 1: @@
 ====== Scaffali e ricerche salvate ======
-=== Cosa sono? ===
-Gli **scaffali** sono versatili contenitori virtuali che permettono di pubblicare liste di notizie di vario tipo e con varie modalità di visualizzazione.
+Gli **scaffali** sono contenitori virtuali che permettono di pubblicare liste di notizie di vario tipo e con varie modalità di visualizzazione.
 Le **ricerche salvate** sono particolari scaffali i cui elementi provengono da **una ricerca effettuata nell'OPAC** ed in seguito salvata dall'utente.
-=== Come può un utente creare/gestire uno scaffale o una ricerca salvata? ===
-Per la gestione degli scaffali e delle ricerche salvate da parte dei normali utenti ti rimandiamo alla guida rapida di DNG per utenti, presente nell'installazione di DNG.
-In ogni caso, per ciascun utente esistono 3 scaffali predefiniti di sistema (Finiti, Non finiti, Preferiti). È possibile aggiungere quanti scaffali si desidera dalla propria area personale usando la funzione "//Aggiungi scaffale//". Ogni scaffale può essere reso //Pubblico// (quindi visibile ad altri utenti che navigano sul profilo dell'utente) oppure //Privato// (quindi restare disponibile al solo utente che l'ha creato).\\ L'aggiunta di titoli ad uno scaffale è possibile a partire dai risultati di una ricerca cliccando sull'icona di aggiunta accanto ad ogni titolo, oppure usando la funzione di aggiunta di massa per tutti i titoli riepilogati nella pagina.
-//Per alcuni screenshoot è disponibile una versione obsoleta della pagina di documentazione degli scaffali: [[editors:gestire_gli_scaffali|Gestire gli scaffali]]//
+<WRAP info round>
+== Scaffali in ClavisNG ==
+Il concetto di //scaffale// è ripreso da quello esistente in [[http://docs.comperio.it/clavismanual/doku.php?id=glossario#scaffale|ClavisNG]]. Nell'implementarlo in DiscoveryNG è stato esteso per includere anche le **ricerche salvate**.
+</WRAP>
-=== Che tipi di scaffale posso gestire nel CMS? ===
+===== Creazione =====
-Tramite il CMS è possibile gestire un numero maggiore di tipi di scaffali di quanto possa fare un normale utente di DNG. Ecco tutti i possibili tipi di scaffale:
-  * **Scaffale proveniente da CLAVIS**: è uno scaffale i cui elementi sono pescati da uno scaffale già esistente in CLAVIS. Ogni modifica apportata in CLAVIS a tale scaffale si ripercuoterà immediatamente allo scaffale corrispondente in DNG.
+Un qualsiasi utente autenticato nel portale ha la possibilità di gestire l'aggiunta di titoli ad un suo scaffale. Per ciascun utente esistono 3 scaffali predefiniti di sistema (Finiti, Non finiti, Preferiti). È possibile aggiungere quanti scaffali si desidera dalla propria area personale (**MyDiscovery**) usando la funzione "//Aggiungi scaffale//". Ogni scaffale può essere reso //Pubblico// (quindi visibile ad altri utenti che navigano sul profilo dell'utente) oppure //Privato// (quindi restare disponibile al solo utente che l'ha creato).
+L'aggiunta di titoli ad uno scaffale è possibile:
+  * a partire dalla pagina del singolo titolo
+  * a partire dai risultati di una ricerca:
+    * cliccando sull'icona di aggiunta accanto ad ogni titolo
+    * usando la funzione di aggiunta di massa per tutti i titoli riepilogati nella pagina
+Sempre in fondo ai risultati di una ricerca è presente il pulsante che permette di **salvare la ricerca**. Usandolo verranno salvati i criteri di ricerca (non i risultati), ovvero sarà possibile creare uno scaffale //dinamico//, i cui titoli contenuti potrebbero variare nel tempo.\\ Non è possibile mescolare in uno stesso scaffale una ricerca salvata all'aggiunta di titoli singolarmente.
+<WRAP info round>
+== Documentazione per l'utente ==
+La pagina predefinita **dng-help**, solitamente pubblicata come link //Aiuto//, contiene una serie di informazioni in stile domanda&risposta che spiegano agli utenti il funzionamento degli scaffali.
+</WRAP>
+===== Pubblicazione lato CMS =====
+Tramite il CMS è possibile gestire un numero maggiore di tipi di scaffali di quanto possa fare un normale utente di DNG. È possibile gestire:
+  * **Scaffale di notizie proveniente da CLAVIS**: è uno scaffale i cui elementi sono recuperati da uno scaffale già esistente in [[http://docs.comperio.it/clavismanual/doku.php?id=glossario#scaffale|ClavisNG]]. Ogni modifica apportata in ClavisNG a tale scaffale si ripercuoterà immediatamente allo scaffale collegato in DNG.
   * **Scaffale personale**: è uno degli scaffali (o ricerche salvate) dell'utente che sta accedendo al CMS
   * **Scaffale predefinito**: è uno degli scaffali predefiniti proposti da DNG, come lo scaffale degli ultimi arrivi, dei più votati o delle notizie più commentate
+  * **Scaffale da una ShelfPage**: vedi sotto
+  * **Scaffale da MLOL**: permette di scegliere il tipo di lista predefinita in [[:medialibrary_online|MediaLibrary OnLine]] e il tipo di media da associare alla lista stessa
-===== Pagine di tipo Scaffale (ShelfPage) =====
+{{ :liquens:scaffale_mlol.png |}}
-=== Cos'è una ShelfPage? ===
-Una pagina di tipo scaffale (ShelfPage) è un particolare tipo di pagina di DNG che permette di **visualizzare il contenuto di uno scaffale** in modo del tutto simile a come vengono visualizzati i risultati di una ricerca, con alcune piccole differenze. Inoltre, come ogni pagina di DNG, potrai [[editors:gestire_il_sito#spostare_le_pagine_attraverso_il_sito|posizionare la pagina in qualunque punto del sito]], agendo sull'albero dei contenuti, e decidere se inserirla nel menù di navigazione o meno. Potrai così ad esempio creare ShelfPage "globali", visibili da ogni sezione dell'OPAC, oppure proporre una lista di ShelfPage caratteristiche di una biblioteca, inserendole nell'albero sotto alla pagina corrispondente di quella biblioteca.
+==== Pagine di tipo Scaffale (ShelfPage) ====
-=== Come si crea una ShelfPage? ===
-Per creare una ShelfPage procedi come per la [[editors:crea_e_modifica_contenuti|creazione di una qualsiasi pagina di DNG.]]. Imposta il **Titolo** della ShelfPage ed il **Contenuto** dalla tab Principale->Contenuto. Il contenuto sarà visualizzato come **una descrizione della pagina** prima della lista degli elementi dello scaffale. Dovrai poi associare a questa pagina uno scaffale. Per farlo portati sulla sottotab "Shelf" della tab "Contenuto". Sotto "Shelf type" ti sarà data la possibilità di **scegliere il tipo di scaffale**. Una volta effettuata la scelta del tipo, l'interfaccia ti guiderà nella scelta dello scaffale da associare alla ShelfPage. Opzionalmente, scegliendo una biblioteca dalla tendina "Include results only from this library", potrai **filtrare le notizie mostrate dalla pagina per biblioteca**, mostrando solo quelle notizie che hanno esemplari della biblioteca da te selezionata.
+Una pagina di tipo scaffale (**ShelfPage**) è un particolare tipo di pagina di DNG che permette di **visualizzare il contenuto di uno scaffale** in modo del tutto simile a come vengono visualizzati i risultati di una ricerca. In questo senso è una vera e propria pagina di ricerca con l'unica differenza di offrire l'accesso ad un numero di titoli del catalogo predeterminato.
+Una pagina Scaffale eredita tutte le possibilità presenti in una [[liquens:ricerche|pagina di Ricerca]]. Inoltre, come ogni pagina di DNG, potrai [[editors:gestire_il_sito#spostare_le_pagine_attraverso_il_sito|posizionare la pagina in qualunque punto del sito]], agendo sull'albero dei contenuti, e decidere se inserirla nel menù di navigazione o meno. Potrai così ad esempio creare ShelfPage "globali", visibili da ogni sezione dell'OPAC, oppure proporre una lista di ShelfPage caratteristiche di una biblioteca, inserendole nell'albero sotto alla pagina corrispondente di quella biblioteca.
+Per creare una ShelfPage procedi come per la [[editors:crea_e_modifica_contenuti|creazione di una qualsiasi pagina di DNG.]]. Imposta il **Titolo** della ShelfPage ed il **Contenuto** dalla tab Principale->Contenuto. Il contenuto sarà visualizzato come **una descrizione della pagina** prima della lista degli elementi dello scaffale.\\ Quindi è necessario **associare alla pagina lo scaffale** contenente i titoli da mostrare. Per farlo usa la tab "**Scaffale**" della tab "Contenuto" dove è possibile selezionare il tipo di scaffale (a seconda della scelta compariranno delle opzioni aggiuntive sotto all'elenco)
+    * Usa uno **scaffale di notizie da ClavisNG**, se selezionato permette di utilizzare uno scaffale di notizie creato in ClavisNG. È necessario selezionare //prima la biblioteca// che ha creato lo scaffale, quindi verranno caricati dinamicamente tutti gli //scaffali di sole notizie// (se presenti), tra cui sarà possibile selezionare quello da pubblicare
+    * Usa uno dei **tuoi scaffali di DiscoveryNG**, se selezionato mostra l'elenco degli scaffali (elenco di titoli o ricerche salvate) create dall'operatore utilizzando direttamente le pagine di ricerca di DiscoveryNG
+    * Usa uno **scaffale predefinito di DiscoveryNG**, elenca, se presenti, gli scaffali di sistema utilizzabili
+    * Usa lo **scaffale da una ShelfPage**, permette di pubblicare un widget scaffale a partire da un elenco di titoli ottenuto da una [[liquens:scaffali|Pagina Scaffale]].
+  * Includi **solo i titoli che contengono copie di**, permette di filtrare tutti i titoli recuperati dal widget conservando solo quelli per cui esiste almeno una copia della biblioteca selezionata.
+<WRAP important round>
+== Scaffali pubblicati da altri operatori ==
+È bene fare attenzione nel caso in cui si stia modificando una pagina pubblicata da un altro operatore. In questo caso infatti, se è stata scelta come opzione //Usa uno dei tuoi scaffali di DiscoveryNG// verrà mostrata la dicitura **Scaffale di altro utente**. Una volta modificata e salvata la pagina con uno scaffale di provenienza diverso, non sarà più possibile recupearare lo scaffale dell'utente precedente.
+</WRAP>
+Una volta completata la configurazione, potrai salvare e pubblicare la pagina cliccando sul bottone "**Salva e Pubblica**".
+==== Widget di tipo scaffale ====
-Una volta completata la configurazione, potrai salvare e pubblicare la pagina cliccando sul bottone "Salva e Pubblica".
-===== Widget di tipo scaffale =====
-=== Cos'è uno Widget di tipo scaffale (ShelfWidget)? ===
 Uno ShelfWidget permette di **visualizzare un numero limitato di elementi di uno scaffale** nell'area Widget di una qualsiasi pagina di DNG. E' possibile ad esempio visualizzare in HomePage gli ultimi 20 arrivi nel sistema sottoforma di un carosello di copertine, o di mostrare le 5 notizie più commentate del sistema come una lista numerata.
-=== Aggiunta di uno ShelfWidget ad una pagina ===
-Per aggiungere uno o più ShelfWidget ad una pagina, procedere come per l'aggiunta di un qualsiasi Widget (ricordiamo che per farlo è necessario che la pagina abbia almeno una WidgetArea attiva). Configurare poi lo ShelfWidget utilizzando le indicazioni seguenti.
-=== Opzioni dello ShelfWidget ===
-Uno ShelfWidget è configurabile attraverso vari parametri:
-  * **Titolo** (casella di testo "The title to display"): è il titolo che verrà visualizzato in cima al widget.
-  * **Tipo di visualizzazione** (tendina "How do you want the shelf to be displayed?"): attraverso questa tendina è possibile scegliere l'aspetto che avrà il widget nella pagina (ad esempio se sarà visualizzato come un carosello o una lista numerata).
-  * **Numero di risultati da ritrovare** (The number of manifestations to retrieve): indica il numero totale di risultati che gli utenti potranno visualizzare tramite il widget
-  * **Numero di risultati da mostrare** (The number of manifestations to show): indica il numero di risultati da mostrare contemporaneamente. Ad esempio, per un carosello di copertine, se questo valore è 5 ed il precedente è 20, verranno visualizzate sulla pagina sempre 5 copertine, ma l'utente potrà scorrere il carosello fino a 20 risultati.
-  * **Mostra link ad una ShelfPage** (Show a link to the shelf page): indica se mostrare o meno un link ad una shelfpage che visualizzerà tutti gli elementi dello scaffale
-  * **Scaffale (area grigia):** quest'area è del tutto simile all'area di scelta dello scaffale di una ShelfPage (vedi sezione precedente), e permette la scelta dello scaffale da associare al widget. Si procede esattamente allo stesso modo descritto per l'associazione di uno scaffale ad una ShelfPage. Qui abbiamo però un'opzione in più: è infatti possibile scegliere dire al widget di utilizzare lo scaffale associato ad una determinata SelfPage già esistente. Per fare ciò selezionare come tipo scaffale "Take the shelf of a Shelf Page", e scegliere poi una ShelfPage dalla tendina "Select a ShelfPage".
-  * **Descrizione**: è un'area opzionale in cui si potrà inserire una breve descrizione sul widget. L'utilizzo o meno di tale descrizione dipende dal tipo di visualizzazione selezionata.
-Una volta completata la configurazione del widget, puoi salvare e pubblicare la pagina premendo sul bottone "Salva & Pubblica". Potrai in seguito modificare il ShelfWidget oppure aggiungerne uno nuovo.
+Per maggiori informazioni sul widget scaffale e le sue opzioni, vai alla pagina [[liquens:widgets&#scaffale|Widgets]].
+==== Caching di uno scaffale ====
+E' possibile attivare lo caching del contenuto di uno scaffale.
+Questo significa che, dal punto di vista delle prestazioni del sito, si ha un miglioramento perchè si evita di generare continuamente la pagina ogni volta che si esegue un caricamento.
+{{ :liquens:widgets:scaffale_cache.jpeg?nolink |}}
+Lasciando il valore 0 non si attiva la modalità di caching, mentre, con un valore positivo, si attiva la durata della cache prima che il sistema rigeneri lo scaffale nuovamente.

Manuale utente di DiscoveryNG

Strumenti Utente

Strumenti Sito

Differenze

Strumenti Pagina