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 » Tools » Miniature per creare le miniature mancanti.
5. Andate in Amministrazione e cliccate sul pulsante Sincronizzazione.

Bene! Avete appena creato il primo album della vostra galleria.

Organizzazione delle directory e dei files

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

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

- Ad eccezzione di "thumbnail" (miniature), "pwg_high" o "pwg_representative" (vedi spiegazioni qui sotto), ogni directory inserita in "galleries" genera un album. Il numero di livelli (profondità) è illimitato.
- Una foto è invece rappresentata da un file. Un file può essere una foto 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 una foto se la sua estensione è presente tra quelle previste nel parametro di configurazione `picture_ext`.
- Ad ogni elemento di tipo foto deve essere associato una miniatura (vedi la sezione più in basso riguardante le miniature).
- Gli elementi di tipo foto possono avere una foto 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 foto (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: un album può contenere delle foto e dei sub-album. Tuttavia, è fortemente raccomandato scegliere, per ogni album, se inserire delle foto o dei sub-album.
- Una volta che i file, le miniature e i file rappresentativi sono correttamente inseriti nelle directory, andare alla pagina Amministrazione » Tools » Sincronizzare.

Miniature

- Come detto prima, ogni elemento di tipo foto deve essere associato ad una miniatura (thumbnail).
- Le miniature si trovano nella sottodirectory "thumbnail" di ogni directory che rappresenta un album. La miniatura è un file di tipo foto (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 della foto che rappresenta (per esempio, una foto ".JPG" può avere come miniatura una foto ".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.