Generatore XML per Ozio Gallery Tiltviewer
Ozio Gallery è un ottimo gestore di gallerie fotografiche per Joomla. Uno dei vestiti più accattivanti (tecnicamente skin) è TiltViewer.
Questo articolo è utile ai webmaster che utilizzano Joomla, per chi invece fosse interessato alla produttività personale faccio notare come un foglio Excel possa eseguire operazioni complesse, proprio come un programma!
Ozio Gallery "carrozzato" TiltViewer è poco flessibile se utilizzato con le opzioni automatiche di Joomla,

per ottenere la piena funzionalità della photogallery è necessario implementare un file XML che espande le funzionalità e migliora la flessibilità d'utilizzo del componente.
Cosa è un file XML? E' un file in formato testo (quelli che puoi creare con Notepad) con coppie di indicatori, chiamati tag, che delimitano il valore da essi descritto. Non sono stato chiaro?!? Niente paura, ti faccio un esempio utilizzando un file XML di TiltViewer per Ozio Gallery.
<tiltviewergallery>
<photos>
<photo imageurl="../../../../images/directory1/foto1.jpg">
<title>titolo fotografia 1</title>
</photo>
<photo imageurl="../../../../images/directory1/foto2.jpg">
<title>>titolo fotografia 2</title>
<description>descrizione foto 2</description>
</photo>
<photo imageurl="../../../../images/directory1/foto3.jpg">
<title>>titolo fotografia 3</title>
<description>descrizione foto 3</description>
</photo>
</photos>
</tiltviewergallery>
La photogallery creata con l'xml di esempio sarà composta da tre fotografie (foto1, foto2 e foto3 .jpg), che fisicamente si trovano nella cartella di Joomla "images/directory1". Sulle immagini della photogallery apparirà il simbolo
utilizzato per visualizzare il retro delle fotografie dove apparirà il titolo e la descrizione assegnata da XML. Quindi ritornando al nostro esempio
- girando la foto1 troveremo scritto "titolo fotografia 1" in neretto
- girando la foto2 troveremo scritto "titolo fotografia 2" in neretto e sotto la dicitura "descrizione foto 2"
- girando la foto3 troveremo scritto "titolo fotografia 3" in neretto e sotto la dicitura "descrizione foto 3"
Hai scoperto come è fatto un file XML per Tiltviewer per Ozio Gallery. Ora puoi inserire in una stessa gallery immagini provenienti da fonti e directory diverse, gestire un titolo ed una descrizione diversa per ognuna di esse.
Con l'XML automatico avresti potuto assegnare solo la directory contenente le fotografie da mostare; niente titolo, descrizione e nessuna possibilità di formare una fotogallery con immagini provenienti da diverse locazioni.
Per esserti di maggiore aiuto codifico un esempio di XML manuale per TiltViewer che assembla una fotograllery formata da 3 fotografie di cui:
- due immagini provenienti da directory diverse (pippo e pluto)
- la terza proveniente da un altro sito web (i9lli-scritta-300)
<tiltviewergallery>
<photos>
<photo imageurl="../../../../images/directory1/pippo.jpg">
<title>Esempio Uno</title>
<description>Titolo e descrizione sul retro della 1 foto.</description>
</photo>
<photo imageurl="../../../../images/directory2/pluto.jpg">
<title>Esempio Due</title>
<description>Titolo e descrizione sul retro della 2 foto.</description>
</photo>
<photo imageurl="http://www.i9LLi.it/images/stories/i9lli-scritta-300.jpg">
<title>Esempio Tre</title>
<description>Questa foto è su un altro sito web.</description>
</photo>
</photos>
</tiltviewergallery>
E se volessi applicare alla fotografia un link ipertestuale?
L' XML manuale ti permette anche questo.
Con linkurl puoi far comparire il link ipertestuale sul retro dell'immagine, sotto il titolo e la descrizione.
Fai attenzione ad impostare correttamente questi parametri:
Attiva modalità download/link: Sì
Testo pulsante download: Il testo che vuoi far comparire nel link (quello indicato dalla freccia)
Mostra pulsante gira immagine: Sì
e poi crea un XML simile a questo
....
<photo imageurl="../../../../images/directory1/pippo.jpg"
linkurl="http://www.i9LLi.it">
<title>Esempio Uno</title>
<description>Titolo descrizione link sul retro della foto</description>
</photo>
....
Interessante vero?!? E per concludere alcune domande che ti potrebbero sorgere.
D. Dove sono i file XML manuali di di Tiltviewer?

Normalmente risiedono nella directory del tuo sito nella cartella
>>> components/com_oziogallery2/skin/tiltviewer/manual-xml/nomefile.ozio <<<
Durante la configurazione della voce di menu se decidi di utilizzare il metodo manuale devi selezionare "xml manuale" e nella textbox il percorso del file XML associato alla photogallery che vuoi gestire.
D. Esiste un generatore XML automatico per Ozio Gallery con Tiltviewer?
Non l'ho trovato, ma visto che anch'io avevo lo stesso problema l'ho realizzato utilizzando le macro VBA di Excel (in modo un po' avanzato). Il generatore automatico di XML è in gradio di generare automaticamente il codice.
Se ti piacerebbe importare in automatico i nomi dei file delle tue fotografie, editare comodamente il titolo, descrizione e link e con un solo click creare il file XML ben scritto e privo di errori, beh allora ho quello che fa per te.


L'Excel per generare automaticamente l'XML di Tiltviewer per Ozio Gallery, lo puoi scaricare ed utilizzare gratuitamente. Excel ti avviserà che il foglio contiene macro, abilitale senza problemi, il codice VBA è liberamente visualizzabile e quindi a prova di virus.
Le pagine dei miei siti devono superare la validazione del W3C sia come markup che come CSS. Durante la procedura di validazione le pagine contenenti le photogallery mi davano il seguente errore:
>>>.oziofloat Numero non valido : width only 0 can be a length. Devi mettere un'unità dopo il tuo numero : 640 640
>>>.oziofloat Numero non valido : height only 0 can be a length. Devi mettere un'unità dopo il tuo numero : 480 480
il problema era dovuto al fatto che non avevo inserito l'unità di misura (px), è bastato inserire l'unità di misura perchè la validazione W3C del CSS fosse corretta.


