Le sezioni di questa guida verranno scritte in base alle richieste che ne farete.

Gallerie di Immagini

La classe d'oggetti responsabile del funzionamento delle gallerie d'immagini è senza dubbio la più gettonata, sia come uso da parte dei visitatori, che come numero di richieste di supporto.
Il motore su cui girano le gallerie di questo sito si chiama ZPhotoSlides, e fornisce una quantità di strumenti molto potenti e versatili tanto per chi naviga il "prodotto finito" quanto per chi lo crea.
Veniamo dunque ad una descrizione del suo utilizzo basilare.
Se avete appreso quanto descritto nella guida "Pubblicare oggetti" , dovreste sapere che la prima cosa da fare è creare un contenitore per ospitare le vostre foto, poi potrete pensare a come aggiungerle effettivamente per riempire questa scatola vuota.

Le gallerie d'immagini sono oggetti complessi. Talmente complessi, che richiedono ben 2 scatole per esser contenute!!!
Una scatola è la "Cartella di Gallerie" (ZPhotoSlidesFolder). Entro questa scatola bisogna crearne almeno un'altra, che sarà appunto la galleria: ZPhotoSlide. Entro una cartella ZPhotoSlidesFolder è possibile creare gallerie a volontà, ma non è possibile creare gallerie all'esterno di una di queste speciali cartelle.

Dunque:
-> ZPhotoSlide contiene le vostre foto
-> ZPhotoSlidesFolder contiene le vostre gallerie

1. Il primo passo è creare una cartella di gallerie: scegliete ZPhotoSlidesFolder dal menù "aggiungi un nuovo elemento". Compilate nome breve, titolo e descrizione.
2. Al termine vi troverete all'interno della vostra cartella di gallerie. Se visitate il menù "aggiungi un nuovo elemento", noterete che sono presenti solo due opzioni. All'interno di una cartella di gallerie è infatti possibile annidare solo:
   

•     una galleria d'immagini

•     un'altra cartella di gallerie

Scelgiete naturalmente ZPhotoSlides per creare la vostra galleria. Alternativamente potete complicare ulteriormente la struttura della vostra mostra fotografica creando altre cartelle di gallerie...

3.  Cliccando su ZPhotoSlides viene creata una galleria vuota con nome astruso e, come di consueto, il portale vi presenta automaticamente il form per settare gli attrributi più importanti: Nome Breve, Titolo, Descrizione. Cliccate su conferma modifica dopo aver compilato il form.

4.   Ora vi viene presentata la galleria vuota. Non badate alla scritta "Questa cartella non contiene elementi visibili. Per aggiungere nuovi contenuti premi il pulsante 'Aggiungi nuovo elemento', oppure incolla dei contenuti da un'altra locazione.": è l'avviso predefinito, ma non si applica nel caso delle gallerie. Infatti non c'è alcun pulsante "Aggiungi nuovo elemento"!. Invece, un pulsante rosso spicca nel mezzo: "add new zphoto", ed una ricca barra d'amministrazione vi sovrasta.

Metodi per aggiungere foto

Esistono 3 modi per aggiungere foto, pensati per due esigenze diverse.

•   Se dovete aggiungere solo una foto:

Allora cliccate sul pulsante rosso "add new zphoto". Una "zphoto" è un tipo particolare di scatola, usata dalla galleria per immagazzinare immagini (al posto della normale scatola "immagine".
Nel momento in cui cliccate viene creata una scatola-immagine vuota, e si presenta il form per modificarla.
Dovete inserire i soliti 3 parametri "nome breve", "titolo", "descrizione". Inolte, dovete specificare quale immagine volete inviare al sito: per fare ciò potete inserire a mano il percorso (es: /home/daniele/mare.jpg) oppure cliccate sul pulsante "browse" (o "naviga") a fianco del form per per il percorso. Comparirà il solito navigatore che vi permette di scegliere file sul vostro computer.
Cliccando su "conferma modifiche" la foto verrà inviata al server, che la metterà nella scatola da voi creata con il titolo e gli altri attributi che voi avete scelto.

•  Se dovete aggiungere fino a 5 foto:

All'interno della vostra galleria vuota, cliccate su "add photos" nella barra di amministrazione. Vi si presenterà una pagina complessa. Nei primi 5 form, potete inserire 5 percorsi di 5 immagini da inserire (oppure cliccate su "browse" per cercarli graficamente).
Una volta compilati i form che vi occorrono, liccate su -->invia immagini<--

•   Se dovete aggiungere molte foto contemporaneamente

Se dovete mandare 50 foto, il metodo precedente non è molto pratico: dovete rifare la stessa operazione ben 50 volte!
La procedura da seguire è questa:

1.     Mettete tutte le foto che volete inviare in una cartella. (senza sotto cartelle). Esempio: miefoto
2. Create un file .zip, .bz2, .tar o .gz della cartella. Esempio: miefoto.bz2
3. All'interno della vostra galleria vuota, cliccate su "add photos" nella barra di amministrazione. 
4. Nell'interfaccia descritta precedentemente, inserite il percorso del file "miefoto.bz2" nel campo intitolato "File (Zip):", oppure avviate come al solito il browser grafico cliccando su "browse" per cercare il vostro file.
5.  Cliccate su -->invia immagini<--

L'aggiunta di foto può richiedere MOLTO tempo. Non siate impazienti. Prima di ritentare, inviatemi una mail segnalandomi l'accaduto (rischiate di trovarvi con le foto dublicate o triplicate!!!).