Démarrage rapide

1. Créez un répertoire sur votre ordinateur.
2. Copiez des photos à l'intérieur de ce répertoire, puis redimensionnez-les pour un affichage sur le web. Attention : le nom des répertoires et des fichiers ne doit contenir que des lettres, des chiffres et les caractères "-", "_" ou ".". Pas d'espace ou de caractères accentués.
3. Avec un client FTP, copiez le répertoire dans le répertoire "galleries" de votre installation de Piwigo.
4. Connectez-vous à votre galerie Piwigo et rendez-vous sur Administration » Images » Miniatures pour créer les miniatures manquantes.
5. Rendez-vous sur Administration et cliquez sur le gros bouton de synchronisation.

Bravo ! Vous avez créé avec succès la première catégorie de votre galerie.

Organisation des répertoires et des fichiers

- Les répertoires représentant les catégories se trouvent dans le répertoire "galleries". Ci-dessous l'arbre des répertoires d'une très petite galerie (mais utilisant de nombreuses fonctionnalités) :

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

- A l'exception de ceux appelés "thumbnail", "pwg_high" ou "pwg_representative" (voir explications ci-dessous), chaque répertoire dans "galleries" génère une catégorie. Le nombre de niveaux (profondeur) n'est pas limité.
- Fondamentalement, un élément est représenté par un fichier. Pour Piwigo, un fichier peut être un élément si son extension figure dans la liste du paramètre de configuration `file_ext` (voir fichier include/config.inc.php). Un fichier peut être une image si son extension figure dans la liste du paramètre de configuration `picture_ext`.
- Les éléments de type image doivent avoir une miniature associée (voir la section suivante à propos des miniatures).
- Les éléments de type image peuvent avoir un image en grand format associé. Comme pour le fichier mariage.jpg dans l'exemple ci-dessus. Aucun préfixe n'est nécessaire sur le nom du fichier.
- Les éléments autres que les images (vidéos, sons, fichiers texte, tout ce que vous voulez...) sont représentés par défaut par une icône correspondant à l'extension du nom du fichier. Optionnellement, une miniature et un représentant peuvent être associés (voir le fichier video.avi dans l'exemple).
- Attention : le nom d'un répertoire ou d'un fichier ne doit être composé que de lettres, de chiffres, de "-", "_" ou ".". Pas d'espace ou de caractères accentués.
- 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.
- Une fois que les fichiers, les miniatures et les représentants sont correctement placés dans les répertoires, se rendre sur l'écran Administration » Catégories » Synchroniser.

Miniatures

- Comme mentionné précédemment, chaque élément de type image doit être associé à une miniature.
- Les miniatures sont stockées dans le sous-répertoire "thumbnail" de chaque répertoire représentant une catégorie. Une miniature est un fichier de type image (même extension du nom du fichier) dont le nom de fichier est préfixé par le paramètre de configuration `prefix_thumbnail` (voir include/config.inc.php).
- Les miniatures n'ont pas besoin d'avoir la même extension que leur image associée (une image avec ".jpg" comme extension peut avoir une miniature en ".GIF" par exemple).
- Il est conseillé d'utiliser un outil externe pour la création des miniatures.
- Vous pouvez également utiliser l'outil de création de miniatures intégré à Piwigo mais cela est déconseillé car la qualité risque d'être décevante et cela utilise inutilement les ressources du serveur (ce qui peut être un grave problème sur un serveur mutualisé).
- Si vous choisissez d'utiliser le serveur web pour générer les miniatures, vous devez donner les droits en écriture sur les répertoires.