## Aide

Ajouter des photos avec pLoader

pLoader pour Windows ou pLoader pour Linux : description, téléchargement et détails des nouvelles versions.

1. Créez un répertoire "upload" à côté du répertoire "galleries" sur votre installation de Piwigo, avec un accès en écriture.
2. Installez pLoader sur votre ordinateur, démarrez le et remplissez les paramètres de connection : l'URL de votre galerie, votre nom d'utilisateur et votre mot de passe.
3. Ajoutez des photos dans la sélection par glisser/déposer depuis votre navigateur de fichiers.
4. Créez une catégorie et sélectionnez la.
5. Sélectionnez des photos.
6. Cliquez sur la flêche verte pour charger les photos dans votre galerie.

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

Ajouter des photos par FTP

### 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 "-", "_" or ".". 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 installation de 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 sont 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

- Fondamentalement, une catégorie est représentée par un répertoire à n'importe quel niveau sous le répertoire "galleries" de votre installation de Piwigo. Chaque catégorie peut contenir autant de sous-niveaux que désiré. Dans l'exemple ci-dessus, categorie-1.1.1.1 est à un niveau 4 de profondeur.
- Fondamentalement, un élément est représenté par un fichier. Un fichier peut être un élément pour Piwigo si l'extension du nom du fichier est parmi la liste du paramètre de configuration `file_ext` (voir fichier include/config.inc.php). Un fichier peut être une image si son extension est parmi le 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 non image (vidéos, sons, fichiers texte, tout ce que vous voulez...) sont par défaut représentés par un 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 miniature 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.

Permissions

- Vous pouvez interdire l'accès aux catégories. Passez le type d'accès à "privé" si vous souhaitez gérer les permissions.
- Vous pouvez rendre une catégorie privée en l'éditant (Administration » Catégories » Gérer » Editer) ou en gérant les options pour votre arbre complet des catégories (Administration » Catégories » Propriétés » Publique/Privée).

- Une fois que certaines catégories sont privées, vous pouvez gérer les permissions avec 3 écrans :

  - Administration » Identification » Utilisateurs » action Permissions (1 lien par utilisateur)
  - Administration » Identification » Groupes » action Permissions (1 lien par groupe)
  - Administration » Catégories » Gérer » Modifier les permissions (1 lien par catégorie)

Groupes d'utilisateurs

- Les groupes d'utilisateurs permettent d'assigner des permissions à une liste d'utilisateurs.
- Vous pouvez créer des groupes et y ajouter des utilisateurs dans la Administration » Identification » Groupes.
- Un utilisateur peut appartenir à plusieurs groupes. L'autorisation est plus forte que l'interdiction : si l'utilisateur "pierre" appartient aux groupes "famille" et "amis", et que seul le groupe "famille" peut visiter la catégorie "Noël 2003", alors "pierre" peut visiter cette catégorie.

Ajout de fichiers par les utilisateurs

Vos utilisateurs peuvent également ajouter leurs photos.

1. Autorisez l'ajout d'images sur une ou plusieurs catégories (Administation » Catégories » Gestion » Edit ou Administration » Catégories » Propriétés » Ajout d'images). Les catégories virtuelles ne permettent pas l'ajout d'images.
2. donner les droits en écriture (pour tous les utilisateurs) sur les répertoires correspondant aux catégories qui sont autorisées à l'ajout.

Les photos ajoutées par les utilisateurs ne sont pas directement visibles sur le site, ils doivent être validés par un administrateur. Pour cela, un administrateur doit se rendre dans Administration » Images » En attente » Images afin d'accepter ou de rejeter les photos proposées.

Liens entre les photos et les catégories, catégories virtuelles

- Les photos sont affichées dans les catégories correspondant aux répertoires.
- Vous pouvez également afficher une photo dans plusieurs catégories, sans dupliquer le fichier sur votre serveur web. Associez la photo à n'importe quelle autre catégorie depuis l'écran d'édition de la photo (auquel vous accéder depuis la page de visualisation de la photo côté galerie, lorsque vous êtes connecté en tant qu'administrateur)
- Les catégories virtuelles partent de ce principe : elles n'ont pas de répertoire associé. Créez des catégories virtuelles depuis Administration » Catégories » Gérer.

Informations diverses

- Une fois votre galerie créée, configurez l'affichage par défaut tel que désiré dans Administation » Configuration » Affichage par défaut. En effet, chaque nouvel utilisateur héritera de ces propriétés d'affichage.
- Pour tout question, la communauté francophone Piwigo est à l'écoute sur le forum.