1. Create a directory "upload" next to directory "galleries" in your Piwigo installation, with write access.
2. Install pLoader on your computer, start it and fill the connection settings : your gallery URL, your username and password.
3. Drag'n drop photos from your directory browser into pLoader photo selection.
4. Create a category and select it.
5. Select some photos.
6. Click on the green arrow to transfer photos in your gallery

Congratulations! You have successfuly created the first category of your photo gallery.

Presa in mano rapida

1. Create a directory on your computer.
2. Copy some photos inside this directory, resize them for web display. Warning: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.
3. With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.
4. Logon your gallery and go to Administration » Pictures » Thumbnails to create missing thumbnails.
5. Go to Administration and click on the big Synchronization button.

Congratulations! You have successfuly created the first category of your photo gallery.

Directories and files organization

• 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

• In linea di massima, una categoria è rappresentata da una directory che si trova a qualsiasi livello della directory "galleries" di Piwigo. Ogni categoria può contenere altretanti sottolivelli che si desidera. Nell'esempio qui sopra, categoria-1.1.1.1 si trova al 4 livello di profondità.
• Un elemento è invece rappresentato da un file. Un file può essere un elemento di Piwigo se la sua estensione è tra quelle previste tra le possibilità previste nel parametro di configuarzione file_ext (vedi file include/config_default.inc.php). Un file è considerato come un immagine se la sua estensione si trova tra quelle previste nel file picture_ext.
• Ogni elemento di tipo immagine deve essere associato ad una miniatura (vedi la sezione più in basso riguardante le miniature)
• Gli elementi di tipo immagine possono avere un'immagine associata in alta qualità. 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 e un file rappresentativo (come per il file video.avi nell'esempio proposto).
• Attenzione: il nome delle directory o del file deve essere composto da lettere, numeri o caratteri come "-", "_" o ".". Nessuno spazio ne caratteri con gli accenti.
• Consiglio: una categoria può contenere elementi e sottocategorie nello stesso tempo. Ad ogni modo è altamente consigliato di scegliere per ciascuna categoria quelle che contengono elementi e quelle che invece contengono sottocategorie.
• Una volta che i file, le miniature e i file rappresentativi sono correttamente piazzati nelle directory, andare nello schermo Amministrazione » Generale » Sincronizza.

Miniature

• Come detto prima, ciascun elemento 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 le miniature abbiano 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 servizio di web hosting gratuito.
• Se decidete di usare il server per la creazione delle miniature è necessario dare i diritti di scrittura su tutte le directory e sottodirectory per tutte le categorie di utenti (utente, gruppo, altri).

• You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.
• Potete rendere una categoria privata modificandola da Amministrazione » Categorie » Gestire » Modificare o selezionando l'opzione nell'albero delle categorie Amministrazione » Categorie » Pubblica/Privata).

• Once the category is private, you can manage permissions for groups and users with 3 screens:

  • Administration » Identification » Users » permissions action (one link per user)
  • Administration » Identification » Groups » permissions action (one link per group)
  • Administration » Categories » Manage » edit category permissions action (one link per category)

• Groups is a convenient way to set permissions for a list of users.
• È possibile creare gruppi in Amministrazione » Identificazione » Gruppi e associarci degli utenti.
• Un utente può appartenere a diversi gruppi. L'autorizzazione è prioritaria rispetto alla proibizione. Ad esempio se l'utente "pippo" appartiene ai gruppi "famiglia" e "amici" e, tra questi gruppi, solo il gruppo "famiglia" può vedere la categoria "Natale 2006", ne consegue che l'utente "pippo" sarà abilitato a visionare la categoria "Natale 2006".

Users can upload their photos too.

1. Authorize upload on any physical categories (Administration » Categories » Manage » edit or Administration » Categories » Properties » Upload). Virtual categories can't receive any upload.
2. dare i diritti di scrittura (per tutti gli utenti) sulle directory delle categorie autorizzate a l'aggiunta dei file

Photos uploaded by users are not directly visible on the website. An administrator must validate uploaded photos in Administration » Pictures » Waiting.

• Photos are displayed in the category corresponding to the file directory.
• You can also display a picture in several categories, without duplicating the file on your web server. Associate the photo to any category from the photo editing screen (that any administrator can reach from the photo page on the gallery side).
• Virtual categories are based on this concept: they have no corresponding directory. Create virtual categories from Administration » Categories » Manage.

• Dopo aver creato la Vostra galleria, modificatene le proprietà di visualizzazione di default da Amministrazione » Configurazione » Visualizzazione di default. In questo modo ogni nuovo utente visualizzerrà la galleria con le stesse impostazioni.
• If you have any question, Piwigo community will welcome you on its forum.