Presa in mano rapida

1. Create una directory sul vostro PC.
2. Copiate qualche foto in questa directory, e ridimenzionatele per la visualizzazione sul web. Attenzione: il nome delle directories e dei files deve contenere solo delle lettre, cifre e i caratteri "-", "_" o ".". Nessuno sazio o caratteri accentuati.
3. Con un cliente FTP, copiate la directory in nella directory "galleries" del vostro Piwigo.
4. Connettetevi alla vostra galleria Piwigo e andate a Amministrazione » Immagini » Miniature per creare le miniature mancanti.
5. Andare a Amministrazione e cliccare sul grosso pulzante Sincronizzazione.

Bravo! Avete appena creato la prima categoria della vosrta galleria.

Organizzazione delle directories e dei files

- Nella directory "galleries" si trovano le categorie di Piwigo. Qui di seguito potete vedere lo schema di un 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

- Eccezzione fatta per "thumbnail", "pwg_high" o "pwg_representative" (vedi spiegazzioni qui sotto), ogni directory inserita in "galleries" genera una categoria. Il numero di livelli (profondità) non è limitato.
- 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 configuarzione `picture_ext`.
- Ad ogni elemento di tipo immagine deve essere associato una miniatura (vedi la sezione più in basso riguardante le miniature).
- Gli elementi di tipo immagine possono avere un'immagine associata in alta risoluzzione. 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 quant'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 d'una directory o di un'file deve essere composto da lettere, numeri o caratteri come "-", "_" o ".". Nessuno spazio ne caratteri accentuati.
- Conseil : une catégorie peut contenir des éléments et des sous-catégories à la fois. Néanmoins, il est fortement conseillé pour chaque catégorie de choisir entre contenir des éléments ou bien des sous-catégories.
- Una volta che i file, le miniature e i file rappresentativi sono correttamente piazzati nelle directory, andare nello schermo Amministrazione » Generale » Sincronizzare.

Miniature

- Come detto prima, ogni elemento di tipo immagine deve essere associato ad una miniatura.
- 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 di usare un software esterno per la creazione delle miniature.
- È anche possibile usare la creazione delle miniature integrata a Piwigo, ma ciò non è raccomandato in quanto la qualità delle miniature può essere scadente ed il processo potrebbe utilizzare troppe risorse del server (ciò può essere un problema per un provider mutualizzato).
- Se decidete comunque di usare il server web per la creazione delle miniature è necessario dare gli accessi in scrittura su tutte le directory.