Benvenuto,    

Home Galleria Faq Contattaci My Page

Il file gallery.xml è scritto con il formato XML che lo rende molto semplice da capire anche per chi non è particolarmente tecnico.
Il file deve iniziare sempre con il TAG <gallery> e deve finire con il TAG </gallery> come mostrato qui sotto.
Nel mezzo del TAG <gallery></gallery> devono essere inserite le direttive che definiscono gli album fotografici della galleria: per ogni album bisogna usare i TAG <album> e </album> all'interno dei quali, a loro volta, saranno indicate le fotografie che ne fanno parte, una dopo l'altra, attraverso il TAG <image> e </image>. Si veda l'esempio riportato qui sotto:
Come si puo' vedere il TAG <album> contiene diversi attributi il cui significato sarà spiegato più avanti.
Le definizioni di ciascun album sono riportate una sotto l'altra secondo la medesima struttura e sempre all'interno dei TAG <gallery></gallery>.
L'ltima sezione del file di configurazione gallery.xml è quella che permette di definire le voci di menu, se si e' scelto di avere un menu di navigazione nella propria gallery. Queste voci sono definite attraverso i TAG <link> uno per ogni voce di menu.
In conclusione la struttura completa del file gallery.xml è riportata qui di seguito. Per tutti i dettagli sulle singole sezione si leggano gli specifici paragrafi qui sotto.

La definizione di un album inizia con il TAG <album> e finisce con il tag </album>. All'interno del TAG <album> devono essere indicati una serie di attributi che ne definiscono le caratteristiche.
Qui di seguito riportiamo uno esempio di codice per l'album chiamato album1.

Nella seguente tabella viene descritto il significato degli attributi che caratterizzano un album fotografico.

parametro	ver	valori possibili	descrizione
name	1.0	stringa	Nome univoco associato all'album. Questo nome e' utile per richiamare l'album per esempio dal menu di navigazione. Non devono esistere due diversi album aventi lo stesso nome.
image	1.0	icona dell'album	Ad ogni album e' possibile associare un'immagine in formato JPG che verra' visualizzata ad esempio negli spot di apertura, nella barra di navigazione degli album o in sovraimpressione sulle voci di menu associate.
title	1.0	stringa	Rappresenta una breve descrizione dell'album, che viene visualizzata, se specificato nel file di configurazione layout.xml, negli spot degli album, in apertura e nella barra di navigazione degli album. Questo stesso titolo viene visualizzato sopra lo slide show dell'album stesso (se previsto in layout.xml).
path	1.0	path sul server	Indica il percorso sul server della cartella nella quale si trovano tutte le immagini associate a questo album. E' buona prassi mettere le foto di un album tutte nella medesima cartella. ATTENZIONE il percorso deve terminare con il carattere / (slash)
slideshow_interval	1.0	numero intero	Rappresenta il numero di secondi in cui una immagine rimane visualizzata prima che inizi l'effetto di transizione verso la successiva immagine.
transition	1.0	zoom wipe hblinds vblinds slidetop slideleft slideright slidebottom hsqueeze vsqueeze fade	Parametro opzionale. Se non specificato assume il valore fade. Rappresenta il tipo di TRANSIZIONE in ingresso delle immagini appartenenti a questo album. Per ogni singola fotografia può essere definito un valore che sostituisce quello definito a livello di album.

Una volta definite l'album fotografico mediante la coppia di TAG <album></album> è necessario elencare le fotografie che appartengono a tale album e che si troveranno sul server, nella cartella indicata dall'attributo path associato all'album stesso.
Ogni fotografia viene definita attraverso la coppia di TAG <image></image> che attraverso alcuni semplici attributi caratterizza la fotografia. La coppia <image></image> è ripetuta una volta per ciascuna foto ed è contenuto all'interno della coppia <album></album>.
Riportiamo qui di seguito un esempio:
Ecco il significato di ciascuno attributo del TAG <image>.

parametro	ver	valori possibili	descrizione
title	1.0	stringa	Titolo della fotografia, visualizzata in sovrapposizione se previsto dalla configurazione di layout.xml.
info	1.0	stringa	Descrizione della fotografia, visualizzata in sovrapposizione se previsto dalla configurazione di layout.xml.
time	1.0	numero intero	Questo parametro opzionale permette di definire, per la singola immagine, il tempo di visualizzazione, espresso in secondi: questo valore sostituisce solo per la foto in questione, il valore impostato a livello di album.
transition	1.0	zoom wipe hblinds vblinds slidetop slideleft slideright slidebottom hsqueeze vsqueeze fade	Parametro opzionale. Se non specificato si assume il valore specificato a livello di album. Rappresenta il tipo di TRANSIZIONE in ingresso per questa immagine.
	1.0	nome foto	La cosa più importante è il nome della fotografia, un file in formato JPEG, riportato all'interno della coppia <image></image>.

Il menu di navigazione consente di:

• navigare tra gli album
• aprire pagine esterne alla gallery (anche di altri siti)
• aprire in sovrapposizione la pagina di contatto

Ogni voce del menu di navigazione è definita attraverso il TAG <link>. Tale dichiarazione deve essere riportata all'interno della coppia <gallery></gallery>. Ecco come si presenta la configurazione del file layout.xml per la dichiarazione del menu di navigazione.
Di seguito gli attributi del TAG <link>.

parametro	ver	valori possibili	descrizione
title	1.0	stringa	Rappresenta la voce del menu, visualizzata nella barra di navigazione.
url	1.0	URL #nome album ##contact	Rappresenta l'azione che deve essere effettuata, quando l'utente preme sulla voce di menu. I valori possibili sono: #contact - apre la pagina di contatto (si veda di seguito) #nome album - inizia lo slide show dell'album indicato (corrispondente all'attributo name dell'album) url - rappresenta l'URL della pagina da aprire, puo' essere interna al sito o esterna e verrà aperta in una nuova pagina.

Qualora sia stato specificato, per qualche voce del menu di navigazione, l'azione #contact, alla pressione di tale voce verra' aperta la pagina di contatto, con le informazioni definite secondo la configurazione che segue.
Il Box Contact altro non e' che un layer sovrapposto allo slideshow, in cui viene riportata una immagine (si veda nel seguito il parametro image) ed un testo (parametri title e TAG <text></text>). Questi ultimi, se contengono indirizzi di pagine su internet oppure indirizzi email vengono trasformati automaticamente in collegamenti ipertestuali e possono essere click-ati per aprire le relative pagine o form di invio email.
Di seguito gli attributi del TAG <link>.

parametro	ver	valori possibili	descrizione
title	1.0	stringa	Questo titolo viene stampato nel BOX Contact. Se contiene stringhe che iniziano per www. queste vengono interpretate come indirizzi su internet e vengono trasformati in collegamenti ipertestuali. Lo stesso dicasi per indirizzi email che vengono trasformati in collegamenti per l'invio di email all'indirizzo specificato.
image	1.0	file immagine	Foto da visualizzare nel Box Contact. Si osservi che l'immagine viene "scalata" per assumere le dimensioni definite per il Box Contact al netto dell'eventuale cornice e margine.

La coppia di TAG <text></text> inclusi all'interno dei TAG <contact></contact> permette di specificare un breve testo che verrà visualizzato dopo il title. Se contiene stringhe che iniziano per www. queste vengono interpretate come indirizzi su internet e vengono trasformati in collegamenti ipertestuali. Lo stesso dicasi per indirizzi email che vengono trasformati in collegamenti per l'invio di email all'indirizzo specificato.