Introduzione all’utilizzo degli shortcodes

Una volta completate le operazioni di configurazione degli archivi e delle modalità di pubblicazione dei risultati è possibile definire dove e come gli archivi vengono pubblicati. Tale pubblicazione, a questo punto, avviene semplicemente immettendo in un post o in una pagina uno shortcode, ovvero delle stringhe di testo contraddistinte da un tag iniziale indicato tra parentesi quadre e un tag che chiude l’esecuzione di tale codice, sempre indicato tra parentesi quadre.

La sintassi segue questa regola:

[nomeDelTag] contenuto [/nomeDelTag]

dove il simbolo / seguito dal nome del tag ne indica la chiusura

Nel tag iniziale possono essere inclusi dei parametri per cui la sintassi diventa

[nomeDelTag param1=val1 param2=val2] contenuto [/nomeDelTag]

Un esempio di utilizzo reale di shortcode è il seguente:

[xdamsItem type=’fotografico’] IT-xDams-archivioprovincialems-FT0001-000371[/xdamsItem]

Elenco degli ShortCode

shortcode descrizione
[xdamsItem type=’archive ID’ ] xdams item id [/xdamsItem] Pubblica una scheda
[xdamsImage type=’archive ID’ ] xdams item id [/xdamsImage] Pubblica l’immagine allegata di una scheda
[xdamsSearch type=’archive ID’ ] search criteria or nothing [/xdamsSearch] Form ricerca fulltext
[xdamsAdSearch type=’archive ID’ ][/xdamsADSearch] Form ricerca avanzata
[xdamsList type=’archive ID’ ] search criteria or nothing [/xdamsList] Lista
[xdamsList type=’archive ID’  vocabulary=’number of occurrences’] field id [/xdamsList] Lista (vocabolario)
[xdamsListImg type=’archive ID’ ] search criteria or nothing [/xdamsListImg] Lista con immagini
[xdamsPreview type=’fotografico’] search criteria or nothing [/xdamsPreview] Lista con immagini e preview
 [xdamsDynSlider type=’fotografico’] search criteria or nothing [/xdamsDynSlider] Slider
[xdamsStory type=’story ID’ height=’maximum height of the slide’ ratio=’fullscreen’ interval=’slides interval’ ] Story id  [/xdamsStory] Story Telling
[xdamsTree type=’archive ID’ ] [/xdamsTree] Albero – coming soon
[xdamsTree type=’archive ID’ ] [/xdamsTree] Albero – coming soon