Differenze

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

--- liquens:widgets [2013/01/10 15:06]
gbonanome
+++ liquens:widgets [2021/06/29 15:20] (versione attuale)
etiengo [Slider per Eventi con Banner]
@@ Linea 11: / Linea 11: @@
-===== Inserimento di un widget =====
+===== Aggiungere un widget =====
 {{:liquens:widgets:inserimento_widget.png?500}}
-L'area che permette l'inserimento dei widget è divisa in due colonne. Sulla sinistra, nello spazio **Widgets disponibili**, sono elencati tutti i [[#Widget disponibili|widget che è possibile aggiungere]]. Cliccando sul titolo del widget, questo verrà aggiunto in testa all'area destra della pagina che riepiloga i **Widgets utilizzati**.
+L'area che permette l'inserimento dei widget è divisa in due colonne. Sulla sinistra, nello spazio **Widgets disponibili**, sono elencati tutti i [[#Widget disponibili|widgets che è possibile aggiungere]]. Cliccando sul titolo del widget, questo verrà aggiunto in testa all'area destra della pagina che riepiloga i **Widgets utilizzati**.
 Cliccando sul triangolo blu accanto al titolo (oppure sui pulsanti //Espandi/Contrai//) è possibile aprire o nascondere il pannello che elenca le opzioni di configurazione del widget utilizzato.\\ Nella parte inferiore dello stesso pannello, cliccando sul pulsante //Cancella// è possibile **rimuovere** il widget.
@@ Linea 21: / Linea 21: @@
 Poichè i widget pubblicati sono mostrati uno di seguito all'altro, **è possibile riordinarli** utilizzando il drag&drop.
-I dati di configurazione di un widget non sono sottoposti, come il resto delle informazioni della pagina, al controllo di versione. In questo senso, una volta cancellato o modificato un widget non sarà possibile tornare alla sua versione precedente.
+<WRAP important round>
+== Controllo di versione ==
+I widgets non sono sottoposti al controllo di versione (come il [[:editors:gestire_il_sito#versioni_precedenti
+|resto delle informazioni nella pagina]]). In questo senso, una volta cancellato o modificato un widget non sarà possibile tornare alla sua versione precedente.
+</WRAP>
+Esattamente come il resto delle informazioni della pagina, per vedere i widgets aggiunti è necessario cliccare il pulsante //Salva e pubblica//.
+===== Posizionare un widget =====
+Alcune aree widget permettono di utilizzare il layout a griglia del tema predefinito per affiancare tra loro i widget e creare pagine complesse.
+In queste aree, ogni widget avrà 2 opzioni aggiuntive: la **larghezza** e la **posizione**.
+{{:liquens:widgets:bs_grid_layout.png?600|}}
+Poichè la griglia è composta da 12 colonne, la **larghezza** indica quante di queste colonne dovrà occupare il widget stesso. In questo senso 12 indica che il widget dovrà occupare il 100% dello spazio a disposizione nella pagina, 6 indica che occuperà la metà dello spazio a disposizione e così via.
+La tendina **posizione** permette invece di specificare il //comportamento del widget rispetto a quello precedente//:
+  * **Nuova riga** indica che il nuovo widget verrà posizionato su una nuova riga rispetto ai precedenti
+  * **Accanto al precedente** permette di posizionare il nuovo widget sulla stessa riga del precedente, ma affiancandolo ad esso
+  * **Sotto al precedente** permette di posizionare il nuovo widget all'interno della stessa colonna del precedente ma sotto di esso. Per questo motivo l'opzione che permette di determinare la larghezza, in questo caso viene disattivata.
+|{{:liquens:widgets:gridwidgetexamplecms.png?500|}}\\ Esempio della configurazione a griglia nel CMS|
+|{{:liquens:widgets:gridwidgetexample.png?500|}}\\ Risultato della configurazione|
-Esattamente come il resto delle informazioni della pagina, per vedere i widget aggiunti è necessario cliccare il pulsante //Salva e pubblica//.
 ===== Widget disponibili =====
@@ Linea 35: / Linea 62: @@
   * **Titolo da visualizzare**, viene mostrato sopra all'elenco degli eventi
   * **Mostra solo gli eventi di**, permette di scegliere se mostrare solo gli eventi di una biblioteca oppure tutti gli eventi del sistema
+  * **Filtra eventi per categoria**, permette di scegliere di mostrare solo gli eventi di una certa categoria
   * **Numero massimo di eventi da mostrare**, permette di indicare quanti eventi mostrare nel widget
   * **Ordina gli eventi casualmente**, se selezionato ordinerà i prossimi eventi in maniera casuale, altrimenti sono mostrati sempre in ordine cronologico
@@ Linea 87: / Linea 115: @@
 ==== MediaLibrary ====
-Utilizzabile **solo** all'interno di una [[liquens:ricerche|pagina di Ricerca]]. Permette, a fronte di una ricerca, di mostrare in un pannello i risultati ottenuti dalla stessa sulla piattaforma [[http://www.medialibrary.it/|MediaLibraryOnline]].
+Il widget MediaLibrary è stato sostituito dall'integrazione in DNG della [[:medialibrary_online|MediaLibrary OnLine]].
-__Requisiti__: è necessario che la biblioteca o il sistema disponga di un account valido sulla piattaforma MediaLibraryOnline
-__Opzioni__:
-  * **Titolo**, viene mostrato in testa al widget
-  * **UserId dell'account**
-  * **Password dell'account**
-  * **PortalId dell'account**
 ==== Lista di pagine ====
@@ Linea 132: / Linea 152: @@
 __Opzioni__:
+  * **Titolo** del widget da mostrare
   * **Messaggio da visualizzare quando non ci sono messaggi disponibili**, permette di specificare un messaggio da mostrare nel caso non ci siano ultimi post nel forum
   * **Numero di messaggi da visualizzare**, permette di indicare quanti post mostrare
   * **ID del topic**, permette di specificare l'ID di un topic del forum e mostrare solo i messaggi che compaiono in quel topic (l'ID è solitamente visibile nell'URL della pagina)
   * **ID dell'autore**, permette di specificare l'ID di un autore della community e mostrare solo i suoi post
+  * **ID della manifestation**, permette di mostrare solo le recensioni di uno specifico titolo del catalogo. L'ID del titolo del catalogo è l'ultima parte dell'URL della pagina del titolo, composta solitamente di 3 parti separate da : ad esempio //test:catalog:123456//.
   * **Mostrare il titolo dei post?**, se selezionato mostra anche il titolo del post, altrimenti viene mostrato solo il contenuto
-  * **ID della manifestation**, permette di mostrare solo le recensioni di uno specifico titolo del catalogo
   * **Dimensioni dell'avatar**, permette di variare le dimensioni dell'avatar dell'autore del post: piccolo, medio, largo
   * **Tipo del post**, permette di filtrare i post mostrati distinguendo tra //recensioni// dei titolo e //post// normali del forum.
 ==== Box di ricerca ====
@@ Linea 179: / Linea 199: @@
 </WRAP>
+==== Menu ====
+Permette di mostrare un [[liquens:menu|menu di navigazione]] all'interno della pagina.
+__Requisiti__: il menu deve essere stato precedentemente [[liquens:menu&#creare_un_nuovo_menu|creato]] dall'area Menu del CMS
+__Opzioni__:
+  * **titolo** del widget
+  * un **limite** al numero di voci da mostrare. In maniera predefinita vengono mostrate tutte
+  * il **menu** da mostrare, che deve essere stato precedentemente creato dall'area Menu.
+{{:liquens:menu:menu_widget.png?600|}}
+==== Contenuto della pagina ====
+Permette di mostrare il Testo della pagina in cui si trova o di una qualsiasi pagina pubblicata.
+__Opzioni__:
+  * **Contenuto di questa pagina**, mostra il contenuto del Testo della pagina
+  * **Contenuto di un'altra pagina**, mostra il Testo di una qualsiasi altra pagina pubblicata. Iniziando a scrivere nel box verrà proposta la pagina tramite autocompletamento.
+==== Slider per Eventi con Banner ====
+Permette di mostrare gli eventi in cui è stato impostato qualsiasi tipo di [[liquens:eventi#banner|banner]].\\ In altri termini, questo widget non mostra gli eventi nei quali nel pannello "Banner" è impostato "nessun banner".
+{{:liquens:widget_eventi_banner_configurazione.png |}}
+Le sezioni del widget con cui scegliere le sue opzioni sono:
+  * **Filtra gli eventi per appartenenza**, con cui specificare se mostrare o gli eventi di Sistema, o gli eventi di tutte le biblioteche, o gli eventi di una o più biblioteche specifiche.\\ Per selezionare di quali biblioteche mostrare gli eventi, fare clic su "Scelta multiple delle biblioteche" e tenendo premuto il tasto ''CTRL'' sulla tastiera, fare clic sui nomi delle biblioteche visualizzate;
+  * **Filtra gli eventi per categoria**, con cui scegliere fino a tre categorie di eventi;
+  * **Filtra gli eventi futuri**, con cui specificare un filtro temporale - per giornata, per un periodo di 30 giorni o per singolo mese -;
+  * **Intervallo di scorrimento dello slider**, con cui impostare per quanti secondi sarà visualizzato ciascun banner;
+  * **Limite di eventi da mostrare nello slider**, con cui imporre il numero massimo di eventi visualizzati.\\ Per visualizzare tutti gli eventi attuali con banner, impostare un valore alto - per esempio, ''999'' -;
+  * **Utilizza cache per migliorare le prestazioni**, con cui impostare il numero di minuti per i quali non verrà ricalcolato l'elenco dei banner da mostrare.\\ La funzione è utile nel caso in cui il widget venga inserito in una pagina complessa, che altrimenti potrebbe impiegare diversi secondi a essere visualizzate nel browser;
+  * **Testo da mostrare nel caso non si ci siano risultati**, in cui scrivere il messaggio che verrà visualizzato al posto dello slider nel caso in cui nessun evento con banner soddisfi i filtri impostati nel widget, oppure quando non siano registrati eventi con banner.
+Una volta impostato il widget "Slider per Eventi con Banner", il risultato è la pubblicazione di uno spazio in cui i banner degli eventi vengono visualizzati in sequenza:
+{{:liquens:widget_eventi_banner_risultato.png?400|}}
+Facendo clic su un banner, verrà aperta la pagina dell'evento corrispondente.
+===== Esportare un widget =====
+Esiste la possibilità di ottenere l'HTML di un widget pubblicato sul sito, allo scopo di incorporare il widget stesso su un sito esterno.
+Innanzitutto è necessario individuare l'ID univoco del widget pubblicato. Per farlo è sufficiente entrare nel CMS alla pagina in cui è pubblicato e posizionare il mouse sopra al widget.
+{{:liquens:widgets:id_del_widget.png?500}}
+Per ottenere l'HTML del widget sarà quindi sufficiente usare il seguente URL
+<code>
+http://ulr-di-base/data/html/widget/id-del-widget
+</code>
+Dove //url-di-base// corrisponde all'indirizzo dell'installazione di DiscoveryNG, mentre //id-del-widget// è il numero identificativo del widget pubblicato.
+==== Come incorporare il codice ====
+Il metodo più comodo per incorporare il codice in un altro sito è utilizzando il tag HTML [[http://docs.webplatform.org/wiki/html/elements/iframe|iframe]]
+Nel caso precedente si sarebbe potuto usare:
+<code>
+<iframe src="http://dngdemo.comperio.it/data/html/widget/85" frameborder=0 width=500></iframe>
+</code>
+dove //frameborder=0// rimuove i bordi dall'iframe, mentre //width=500// indica che il riquadro sarà largo 500px.
+{{ :liquens:widgets:incorpora_widget.png?500 }}
+Ogni widget permette di ottenere facilmente l'<iframe> corrispondente, già compilato, cliccando sul link **Codice da incorporare**.
+<WRAP info round>
+== Stilare l'iframe ==
+In maniera predefinita DiscoveryNG esporta il widget così com'è, sarà quindi opportuno stilare in maniera adeguata tramite HTML e CSS l'iframe.\\
+Alcune risorse utili:
+  * http://docs.webplatform.org/wiki/html/elements/iframe
+  * http://www.w3.org/TR/html-markup/iframe.html#iframe
+  * http://www.w3schools.com/tags/tag_iframe.asp
+</WRAP>

Manuale utente di DiscoveryNG

Strumenti Utente

Strumenti Sito

Differenze

Strumenti Pagina