[xdamsSearch type=’archive ID’ ][/xdamsSearch]
Attiva una form di ricerca a testo libero, 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.
Tra tag iniziale e tag finale può essere inserita una o una serie di condizioni aggiuntive rispetto al testo da cercare, questa opzione può risultare particolarmente utile se si desidera limitare l’esito della ricerca ai soli oggetti dell’archivio come nell’esempio che segue:
[xdamsSearch type=’storico’ form=’full’]/c/@level=item OR /c/@level=file[/xdamsSearch]
Questa condizione è posta in AND con il testo da cercare per cui occorre fare attenzione a come descrivere l’opzione stessa. Per evitare poco comprensibili effetti derivanti dalla differente priorità tra gli operatori logici al momento sono gestite solo condizioni uguali (tutti AND oppure tutti OR).
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
NOVITA’ VERSIONE 2.2
Sono stati aggiunti diversi attributi che consentono il miglioramento delle funzionalità
redirect
= consente di definire una URL di una pagina differente in cui visualizzare l’elenco risultati
redirectitem
= consente di definire una URL di una pagina differente in cui visualizzare la scheda
boxdim
= definisce l’eventuale larghezza del box di ricerca
formtemplate
= definisce un template da utilizzare il form di ricerca (nel folder wpxdamsbridge_custom)
formdescpost
= consente di utilizzare un testo da inserire nel form prima delle chiusura del layout personalizzato
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
[xdamsImage type=’archive ID’ ] xdams item id [/xdamsImage]
pubblica l’immagine allegata a una scheda specifica
per pubblicare un’immagine occorre indicare l’identificativo dell’archivio in type e il codice identificativo della scheda tra lo shortcode di apertura e quello di chiusura.
Import settings
Questa funzionalità permette di creare un file di tipo json contenente le informazioni che sono state memorizzate sul DB mediante le pagine di configurazione, ovvero le label dei campi, gli indirizzi per le richieste rest, storie ecc.
Al momento il file denominato savedsettings.json viene allocato in:
Directory dei plugin/WPxdamsBridge/WPxdams_config
Scopo principale di questa funzione è il back up dei dati e la migrazione da un’installazione di test a una di produzione o viceversa.
Export settings
Questa funzione è speculare alla precedente e consente di importare sul DB i dati contenuti nel file savedsettings.json precedentemente descritto e posizionato nella directory citata al paragrafo precedente
Una volta arrivati nella pagina specifica ci si trova di fronte all’elenco degli archivi che si possono aggiornare, cliccando sul flag di selezione si indica quali archivi saranno importati o re-importati al comando di import.
L’attivazione del comando determinerà la ricopertura di ogni dato già salvato nel DB con i dati presenti nei file pertanto occorre essere perfettamente sicuri di volere importare un archivio.
La prima importazione non creerà ovviamene problemi ma una importazione, successiva alla prima, di archivi già gestiti determinerà la perdita dei dati preesistenti relativamente ai campi di ricerca e visualizzazione.
Le funzionalità attivabili da questa voce di menù sono tre:
- Importazione, anche selettiva, di archivi dai file di configurazione pubblicati insieme al plugin
- Esportazione di tutte le preferenze salvate dall’utente in un file di tipo json
- Importazione da file delle preferenze salvate come descritto al punto precedente
I file di configurazione si intendono i file pubblicati con il plugin e che descrivono la struttura degli archivi. Il plugin propone alcune configurazioni ionizialai che possono essere modificate dall’utente.
Per una più dettagliata descrizione di questi file si consiglia la lettura del manuale avanzato ma nel paragrafo che segue ne anticipiamo una breve introduzione
La conoscenza dei dettagli relativi a questi file non è necessaria al corretto funzionamento ma l’obiettivo di questa breve introduzione è di dare una prima overview dello schema dei dati che possono essere importati. Tali file sono al momento predefiniti per gli archivi che utilizzano la modalità standard offerta dall’hosting erogato da regesta. I file si trovano bella cartella:
Directory dei plugin/WPxdamsBridge/WPxdams_config
Il file principale è il file archive.json che elenca gli archivi e delle tipologie di schede che si possono gestire. Correlati a questo ci sono, nella medesima directory, un file specifico per ogni archivio (sempre .json), utilizzati per descrivere le opzioni dei form di ricerca
Per ogni tipo di scheda infine esistono ulteriori opzioni di configurazione specificate in ulteriori file XML
———————————————————————————————————–
NEWS FROM 2.2 VERSION
Sono state introdotte:
la possibilità di pubblicare i valori di un campo con attributo di uno specifico.
Sintassi: nome campo[nome attributo=valore da ricercare]
il campo ‘separator’ che introduce un testo solo tra due occorrenze dello stesso campo
———————————————————————————————————-
Per ognuna delle schede disponibili di uno specifico archivio (operazione possibile a partire inizialmente dai file di configurazione di ogni tipologia di scheda) è possibile descrivere quali campi mostrare e con quali label.
In fase di avvio del progetto si può richiamare ogni singola scheda e salvare la configurazione personalizzata. La funzione di import a partire dalla versione 1.1 salva la configurazione di default sul DB già in fase di prima attivazione e da qui la configurazione può essere gestita poi nel plugin.
Si può invertire l’ordine dei campo mediante drag and drop.
E’ possibile modificare
- il nome del campo da file di configurazione
Attenzione questa è la stringa che viene utilizzata per identificare il dato nel file di risposta delle API rest e pertanto deve corrispondere al path (o parte di esso se non ci sono ambiguità) utilizzato per descrivere il dato medesimo:
Altri campi utilizzabili per la personalizzazione:
- la casella di input per definire la propria label personalizzata
- il flag per pubblicare o meno il campo.
- Il flag per cancellare il campo
- il flag per pulire un campo da eventuale html incluso (tag e testo incluso tra i tag)
- 4 campi di testo il cui contenuto viene inserito prima e dopo il titolo e il valore assunto dal campo.
Questi 4 campi servono a personalizzare la visualizzazione delle liste senza alcun intervento di programmazione infatti possono contenere semplice testo (es. punteggiatura) o comandi HTML (es. <br> per a capo, <strong> e </strong> per il grassetto o <em> e </em> per il corsivo).
Per i più esperti è possibile anche definire una classe la cui descrizione includere poi in un file CSS.
Viene pubblicata anche
- l’informazione se è un gruppo di campi
- l’informazione se prevede un attributo
- la label originale del file di configurazione
Nel caso si importi un nuovo file di configurazione occorre ripetere l’operazione e salvare. Nella stessa pagina è inoltre disponibile il pulsante “update and add” che consente di inserire un campo ex-novo direttamente da back office.
Per gestire più viste dei medesimi dati si può procedere come al punto “work around” del form di ricerca
——— OBSOLETE ————————–
DALLA VERSIONE 2.2 E’ STATO INTRODOTTO UN ATTRIBUTO NEGLI SHORTCODE CHE PREVEDE FORM PERSONALIZZATI A LIVELLO DI OGNI SINGOLA PAGINA – VEDI FORMTEMPLATE
Al momento è possibile solo un form di ricerca per ogni archivio ma lo shortcode permette di creare form di ricerca con tutti i campi o solo con un campo specifico.
Nel caso si desideri creare una nuova vista del form di ricerca personalizzata è possibile definire un nuovo archivio virtuale, che insista sempre su un medesimo archivio reale, ma che consente di creare una maschera con dati diversi da quella già definita.
Ragionamento analogo può essere applicato nel caso della visualizzazione di dettaglio di una scheda, più archivi virtuali possono rendere possibile definire schemi di visualizzazione diversi in base a necessità diverse ma su medesimi archivi
