Guida rapida

1. Create una directory sul vostro PC.
2. Copiate qualche foto in questa directory e ridimensionatele per la visualizzazione sul web. Attenzione: il nome delle directory e dei files deve essere solamente formato da lettere, cifre e/o i simboli "-", "_" o ".". Non utilizzare spazio o caratteri accentati.
3. Con un client FTP (tipo FIlezilla), caricate la directory in cui avete messo le foto, nella directory "galleries" della vostra galleria Piwigo.
4. Connettetevi alla vostra galleria Piwigo e andate in Amministrazione » Immagini » Miniature per creare le miniature mancanti.
5. Andate in Amministrazione e cliccate sul pulsante Sincronizzazione.

Bene! Avete appena creato la prima categoria della vostra galleria.

Organizzazione delle directory e dei files

- Nella directory "galleries" si trovano le categorie di Piwigo. Qui di seguito potete vedere lo schema ad albero di una piccola galleria (ma che usa moltissime funzionalità) :

      .
      |-- admin
      |-- doc
      |-- galleries
      |   |-- categoria-1
      |   |   |-- categoria-1.1
      |   |   |   |-- categoria-1.1.1
      |   |   |   |   |-- categoria-1.1.1.1
      |   |   |   |   |   |-- pwg_high
      |   |   |   |   |   |   +-- matrimonio.jpg
      |   |   |   |   |   |-- thumbnail
      |   |   |   |   |   |   +-- TN-matrimonio.jpg
      |   |   |   |   |   +-- matrimonio.jpg
      |   |   |   |   +-- categoria-1.1.1.2
      |   |   |   +-- categoria-1.1.2
      |   |   |-- categoria-1.2
      |   |   |   |-- pookie.jpg
      |   |   |   +-- thumbnail
      |   |   |       +-- TN-pookie.jpg
      |   |   +-- categoria-1.3
      |   +-- categoria-2
      |       |-- porcello.gif
      |       |-- pwg_representative
      |       |   +-- video.jpg
      |       |-- thumbnail
      |       |   +-- TN-porcello.jpg
      |       +-- video.avi
      |-- include
      |-- install
      |-- language
      |-- template
      +-- tool

- Ad eccezzione di "thumbnail" (miniature), "pwg_high" o "pwg_representative" (vedi spiegazioni qui sotto), ogni directory inserita in "galleries" genera una categoria. Il numero di livelli (profondità) è illimitato.
- Un elemento è invece rappresentato da un file. Un file può essere un elemento di Piwigo se la sua estensione è presente tra le possibilità previste nel parametro di configuarzione `file_ext` (vedi file include/config.inc.php). Un file è considerato come un immagine se la sua estensione è presente tra quelle previste nel parametro di configurazione `picture_ext`.
- Ad ogni elemento di tipo immagine deve essere associata una miniatura (vedi la sezione più in basso riguardante le miniature).
- Gli elementi di tipo immagine possono avere un'immagine associata in alta risoluzione. Come per il file matrimonio.jpg nell'esempio proposto. Nessun prefisso è necessario prima del nome del file.
- Gli elementi che non sono delle immagini (video, suoni, file di testo o altro) sono generalmente rappresentati con un'icona corrispondente all'estensione del file. In modo opzionale, è possibile associare una miniatura ed un file rappresentativo (come per il file video.avi nell'esempio proposto).
- Attenzione: il nome di una directory o di un file deve essere composto da lettere, numeri o simboli come "-", "_" o ".". Non utilizzate spazio e caratteri accentati.
- Suggerimento: una categoria può contenere elementi e sub-categorie assieme. Tuttavia, è fortemente raccomandato scegliere per ciascuna categoria se inserire elementi o sub-categorie.
- Una volta che i file, le miniature e i file rappresentativi sono correttamente inseriti nelle directory, andare alla pagina Amministrazione » Generale » Sincronizzare.

Miniature

- Come detto prima, ogni elemento di tipo immagine deve essere associato ad una miniatura (thumbnail).
- Le miniature si trovano nella sottodirectory "thumbnail" di ogni directory che rappresenta una categoria. La miniatura è un file di tipo immagine (stesso nome del file) con un prefisso che può essere personalizzato dal parametro di configurazione `prefix_thumbnail` (vedi include/config.inc.php).
- Non è necessario che la miniatura abbia la stessa estensione dell'immagine che rappresenta (per esempio, un'immagine ".JPG" può avere come miniatura un'immagine ".GIF").
- È altamente consigliato utilizzare un software esterno per la creazione delle miniature.
- È anche possibile utilizzare la creazione delle miniature integrata a Piwigo, ma ciò non è raccomandato in quanto la qualità delle miniature potrebbe essere scadente ed il processo potrebbe utilizzare troppe risorse del server (e potrebbe essere un serio problema su un server condiviso).
- Se si sceglie di utilizzare il webserver per generare le miniature, è necessario consentire l'accesso in scrittura su tutte le directory categoria.