Démarrage rapide

1. Créez un répertoire sur votre ordinateur.
2. Copiez des photos à l'intérieur de ce répertoire. 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, rendez-vous sur Administration et cliquez sur le gros bouton de synchronisation.

Bravo ! Vous avez créé avec succès le premier album de votre galerie.

Organisation des répertoires et des fichiers

- Les répertoires représentant les albums 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) :

      galleries
      |-- mariage
      |   |-- ceremonie
      |   |   |-- entree
      |   |   |   |-- arrivee-de-paul.jpg
      |   |   |   +-- arrivee-de-virginie.jpg
      |   |   +-- sortie
      |   |       |-- sortie-enfants-honneur.jpg
      |   |       +-- sortie-de-paul-et-virginie.jpg
      |   +-- cocktail
      |       |-- discours001.jpg
      |       |-- discours002.jpg
      |       +-- discours003.jpg
      +-- voyage-de-noces
      |   |-- hotel.png
      |   |-- video-decollage-avion.avi
      |   +-- pwg_representative
      |       +-- video-decollage-avion.jpg
      +-- seance-photographe
          |-- img0001.jpg
          |-- img0002.jpg
          +-- pwg_format
              |-- img0001.cr2
              |-- img0001.cmyk.jpg
              |-- img0001.zip
              |-- img0002.cr2
              +-- img0002.cmyk.jpg

- A l'exception de "pwg_representative" et "pwg_format", chaque répertoire dans "galleries" génère un album. Le nombre de niveaux (profondeur) n'est pas limité.
- Fondamentalement, une photo est représentée par un fichier. Pour Piwigo, un fichier peut être une photo 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 photo si son extension figure dans la liste du paramètre de configuration `picture_ext`.
- Les éléments autres que les photos (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, un représentant peut être associé (voir le fichier video-decollage-avion.avi dans l'exemple).
- Formats multiples : vous pouvez proposer une photo dans plusieurs formats. Dans cet exemple, il y a 3 formats supplémentaires pour img0001.jpg. Vous pouvez activer cette fonctionnalité en ajoutant `$conf['enable_formats'] = true;` à votre configuration locale et en définissant une liste de formats, comme `$conf['format_ext'] = array('cmyk.jpg', 'cr2', 'zip');`
- 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 : un album peut contenir des photos et des sous-album à la fois. Néanmoins, il est fortement conseillé pour chaque album de choisir entre contenir des photos ou bien des sous-album.
- Une fois que les fichiers sont correctement placés dans les répertoires, se rendre sur l'écran Administration » Outils » Synchroniser.