[xdamsList type=’archive ID’ ] search criteria or nothing [/xdamsList]
produce una elenco di risultati, paginati e in un formato “lista”, se non viene inserito alcun criterio la lista pubblica l’intero archivio.
Come nel caso della ricerca full text nel type potrà essere inserito o l’ID di uno specifico archivio o il valore convenzionale “@all” che consentirà la ricerca su tutti gli archivi.
listtemplate per definire quale template di pubblicazione (da predisporsi a cura dell’utente e posizionato nella directory “custom”) utilizzare per la pubblicazione dei risultati
i template per la pubblicazione sono prioritari rispetto a quelli eventualmente definiti a livello di bacheca
possono essere aggiunti dei criteri di selezione per realizzare liste filtrate di oggetti. Qui maggiori info
Opzione Vocabulary
[xdamsList type=’archive ID’ vocabulary=’number of occurrences’] field id [/xdamsList]
produce una elenco di risultati, paginati e in un formato “lista”, come nel caso precedente ma in questo caso il campo field id è mandatorio.
field Id corrisponde all’xpath completo del campo che viene utilizzato come selettore
number of occurrences = numero di risultati da visualizzare per pagina
il risultato che questo shortcode produce è la lista dei valori presenti nel campo in oggetto e può essere utilizzato, per esempio, per produrre una lista degli autori della bibliografia o l’indice dei soggetti.
NOVITA’ VERSIONE 2.2
Sono stati aggiunti diversi attributi che consentono il miglioramento delle funzionalità
itemmultisearch
= indice del campo da cercare, consente di far partire una ricerca multiarchivio da una scheda di dettaglio utilizzando il valore del campo indicato nello shortcode. es. se itemmultisearch=’1′ visualizzerò i risultati della ricerca negli archivi per il valore del primo campo (related content)
redirectitem
consente di definire una URL di una pagina differente in cui visualizzare la scheda
vocabularytemplate
definisce un template da utilizzare per l’esito risultati
showarchives
= yes se si desidera che nella ricerca multilista oltre all’archivio corrente siano visualizzati anche gli altri archivi che contengono risultati
menutemplate
definisce un template per il menu (elenco) degli archivi personalizzato (funziona solo se showarchives=yes)
itemdescpre itemdescpos listdespre listdescpos
attributi per aggiungere un testo prima e dopo la la lista e prima e dopo ciascun elemento della lista
showlist
= yes se si desidera che oltre all’elenco generica dei risultati venga pubblicata la lista dei risultati del primo archivio
E’ stata inoltre aggiunta la navigazione alfabetica nel caso “vocabulary”
attiva una form di ricerca su campi specifici, sono previste due opzioni:
All, tutti i campi previsti e attivati nel setting
Nome campo specifico, solo il campo indicato
Sono previsti i seguenti parametri
listtemplate per definire quale template di pubblicazione (da predisporsi a cura dell’utente e posizionato nella directory “custom”) utilizzare per la pubblicazione dei risultati
formtemplate per definire quale template di pubblicazione (da predisporsi a cura dell’utente e posizionato nella directory “custom”) utilizzare per la pubblicazione del box di ricerca
form per descrivere il risultato atteso nella pubblicazione accetta tre valori
• basic= inizialmente solo box di ricerca e successivamente risultati e box di ricerca
• full= box di ricerca e risultati insieme sempre
• mixed = inizialmente solo box di ricerca e successivamente solo risultati
i template per i form di ricerca sono prioritari rispetto a quelli eventualmente definiti a livello di bacheca
Questo sito raccoglie tutti i materiali informativi e di supporto per l”utilizzo del plugin Wp To xDams Bridge, il software creato per poter pubblicare archivi digitali descritti con la piattafforma di catalogazione xDams (www.xdams.org) su un sito gestito con WordPress (www.wordpress.org) la celebre piattaforma di blogging.
Questa integrazione consente pertanto la gestione, sulla medesima installazione, di contenuti provenienti dagli Archivi e di contenuti editoriali di natura diversa, consentendo di realizzare siti complessi
Il plugin come xDams è totalmente rilasciato con licenza GNU GPL e disponibile senza limitazioni. sono presenti in questo sito anche i manuali completi in formato PDF e i primi video tutorial ospitati dal canale You Tube di xDams.
Il video che segue rappresenta il primo tutorial di una serie predisposta dall’organizzazione xDams (www.xdams.org) e in particolare da regesta.exe (www.regesta.com) per illustrare le capacità e le modalità d’uso del plugin che consente di pubblicare degli archivi catalogati con xDams su un sito il cui back end sia gestito dalla piattaforma WordPress (www.wordpress.org)
Il secondo tutorial per l’utilizzo del plugin WP to xDams Bridge ha come obiettivo quello di illustrare le attività di configurazione necessarie per giungere alla pubblicazione di un form di ricerca a testo libero e capire le opportunità di personalizzazione della visualizzazione dei risultati
Questo è il terzo tutorial per l’utilizzo del plugin WP to xDams Bridge. Il Video è dedicato a illustrare la gestione della visualizzazione dei risultati mediante shortcode che producono liste estratte da archivi descritti mediante xDams Open Source Platform
Il materiale informativo è organizzato in tre parti:
• Configurazione utente
• Shortcode per la pubblicazione dei dati
• API
La configurazione standard predisposta permette l’utilizzo di tutte le tipologie di archivio al momento rilasciate con la distribuzione open source e di conseguenza l’utilizzo del plugin in condizioni d’uso standard di xDams.
Le prime due parti descrivono tutte le funzionalità che consentono a un utente “non tecnico” (in senso informatico) di procedere alla pubblicazione attraverso i consueti strumenti di WordPress
Agli utenti più esperti però il plugin consente anche di personalizzare ulteriormente le proprie pagine grazie alla realizzazione di moduli custom utilizzabili al posto di quelli standard utilizzando semplici API pubbliche. L’illustrazione di queste possibilità aggiuntive è contenuta nella sezione API attualmente in progress. Le informazioni sono già disponibili nel manuale (documento PDF) ma devono ancora essere riviste per la pubblicazione su questo sito
L’utente che però desidera concentrarsi solo sulle funzionalità più operative e necessarie può rinviare ad un secondo momento la lettura del manuale avanzato che descrive le su citate funzioni.
SUMMARY funzioni
Il plugin consente:
• La gestione di pagine di amministrazione
• la pubblicazione di post e pagine
L’attività di configurazione di base permette di:
• definire i campi da visualizzare nei form di ricerca con relative label
• definire i campi da visualizzare nella scheda di dettaglio con relative label
• definire i campi da visualizzare nell’elenco dei risultati
• attivare /disattivare l’accesso agli archivi
La pubblicazione è estremamente semplificata in quanto, grazie a shortcode (semplici istruzioni testuali da inserire nelle pagine di wordpress mediante l’editor grafico), sono disponibili:
• form di ricerca testuale
• form di ricerca su campi specifici
• ricerca multiarchivio
• liste di risultati in formato testuale (con o senza criteri di selezione)
• liste di risultati con preview (con o senza criteri di selezione)
• liste di risultati con slideshow (per schede con immagini)
• liste di risultati per valori esistenti in un campo (vocabolari)
• pubblicazione di singole schede
• pubblicazione di singole immagini
• semplice modulo di story telling
Il plugin è infine predisposto per
• l’import di successive configurazioni,
• l’import / export delle preferenze salvate dall’utente
• la gestione multilingue dei messaggi di sistema e delle label dei campi.
Il quarto tutorial del plugin WP to xDams Bridge è dedicato alle opzioni di ricerca che si possono inserire negli shortcode per la pubblicazione di liste di risultati e filtrarne così l’esito. Vengono illustrate inoltre alcune modalità di creazione di percorsi tematici sfruttando proprio queste opportunità.