🌍
Français
Table des matières
Gérer ses catégories
Deux moyens sont possibles pour accéder à la page de gestion d'une catégorie :
- [ Administration » Catégorie » Gérer » ensuite, vous naviguez de catégorie en catégorie » icône : “éditer les informations de cette catégorie”] ”
” - Si vous êtes identifié avec votre compte webmaster, visitez votre galerie et arrivé sur la catégorie que vous souhaitez administrer, cliquez sur l'icône ”” (Voir Fig.2)
 |  |
| Fig.1 “Ecran de gestion de la catégorie” | Fig.2 “Accès via la visite” |
Les catégories représentent la structure de votre galerie. Elles peuvent être de deux natures :
- Physiques
- Virtuelles
Renvoi: Voir l'article sur les différences entre catégorie physique et virtuelle
La page de gestion de catégorie est découpée en 6 zones (Voir Fig.1) :
Fondamentaux pour les catégories PHYSIQUES
Fondamentalement, une catégorie PHYSIQUE est représentée par un répertoire de n'importe quel niveau dans le répertoire ./galleries/ de Piwigo. A moins de travailler en local, vous devrez utiliser un client FTP 1) pour gérer les répertoires des catégories.
Chaque catégorie peut contenir autant de sous-catégories que vous le souhaitez.
Attention : thumbnail, pwg_high, pwg_representative sont des noms de catégories réservés pour Piwigo. Ne les utilisez pas pour nommer vos catégories.
- thumbnail : vos miniatures (en format jpg ou png).
- pwg_high : (facultatif) vos images en haute résolution.
- pwg_representative : (facultatif) les images de substitution qui représenteront les fichiers ne pouvant pas être affichés (exemple : un fichier zip peut être représenté par une image du même nom).2)
| IMPORTANT: |
|---|
Le nom des catégories et des fichiers peuvent être composés de lettres [a-zA-Z], de chiffres [0-9], ainsi que des symboles suivants [- _ .]
Il ne doit y avoir ni espace, ni caractère accentué. Cette restriction est nécessaire car certains navigateurs web ne permettent pas d'afficher des fichiers (images par exemple) ayant dans leurs noms des caractères NON ASCII ou avec des espaces.
Articles connexes :
- Chaque catégorie peut être représentée par une image : voir representation
- Pour bien préparer vos photos, voir preparation
Notion de dépendance
| Cette page est écrite sur la base de catégories physiques. |
|---|
But : comprendre comment ordonner ses catégories pour mieux les identifier et mieux les classer.
Niveau de difficulté : Intermédiaire
Réflexion sur le niveau de dépendance des catégories. On verra qu'en fonction de votre raisonnement, on arrivera à la même conclusion, à savoir : comment bien ordonner ses catégories.
En fonction de l'architecture
- catégorie mère : contient des sous-catégories
- catégorie fille : contient des éléments
Un bon schéma valant mieux qu'un long discours voici un visuel d'exemple :
Fig.3 “Arborescence”
- Dans notre capture d'écran, le dossier “Allan” a comme catégorie mère le dossier “Les_parties”.
- Le dossier “Allan” est la catégorie mère de deux autres dossiers : “2007-01-07” et “2008-01-27”
:!:D'ailleurs, une catégorie ne contenant aucune photo doit être pour vous l'occasion d'avoir une profonde réflexion sur la façon dont vous organisez vos photos/dossiers 
.
Même si Piwigo n'a aucun problème pour gérer des catégories qui sont mères et filles en même temps, il vous est fortement conseillé de choisir pour chaque catégorie le type mère ou le type fille. Voici les raisons de conception menant à ce conseil :
- Navigation : dans la partie publique de votre site, vous avez pu avoir compris que les vignettes de la page principale peuvent représenter soit une sous-catégorie soit un élément. Si une catégorie contient au moins un élément, seules les vignettes de cet élément seront affichées… et non les vignettes des sous-catégories. Avoir une catégorie mère et fille en même temps coupe la navigation quand les membres de la galerie utilisent uniquement les vignettes pour aller profondément dans votre structure de catégories.
- Permissions : comme expliqué dans la Gérer les permissions sur les photos, si vous mettez une catégorie à privée, et que vous l'autorisez pour un utilisateur, automatiquement tous les parents de la catégorie deviennent autorisés (seulement les parents et non les “cousines”). Mais si vos catégories sont mal gérées, il pourra y avoir des problèmes de confidentialité. Ce n'est pas forcément ce que vous vouliez vraiment avoir. Veillez donc à bien maîtriser cet aspect.
En fonction du contenu
- catégorie thème : la catégorie est associée à un thème comme une personne ou une couleur
- catégorie événement : la catégorie est associée à un événement comme un anniversaire, une soirée de Noël.
- catégorie date : en fonction de la date des photographies.
- etc
Remarque : L'emploi de catégories virtuelles est recommandé pour un raisonnement complexe.
Zone "Informations"
Zone "Options"
Fig.6 “Zone Options”
3 options sont proposées (Voir Fig.6).
Cliquez sur les liens pour accéder aux pages explicatives.
| Nom de la ligne | Fonctionnement similaire | Détails de la fonction |
|---|---|---|
| Type d'accès | Cliquez ici | Gestion des autorisations avec les catégories |
| Verrouiller | Cliquez ici | onglet_verrouiller |
| Commentaires | Cliquez ici | Les commentaires |
| Autorisez l'ajout d'images | Cliquez ici | Gestion de l'ajout d'images (upload) pour les visiteurs |
Zone "Ordre de tri"
Zone "Représentant"
Zone "Associer tous les éléments de la catégorie à une nouvelle catégorie"
Zone "Associer tous les éléments de la catégorie à des catégories existantes"
* * *
Gérer ses catégories physiques
Aller plus loin dans la description et les sous menus. Rajouter des liens pour des explications supplémentaires.
En plus de pouvoir les gérer par FTP (voir aussi l'article concernant les mises en garde, il est possible de faire les actions suivantes via le panneau [ Administration » Catégories » Gérer ]
Les déplacer par simple “glisser/déposer”.- Le bouton ”
Sauvegarder l'ordre” permet de sauvegarder l'ordre de vos catégories. - Le bouton ”
Ordonner l'ordre Alphabético-numériquement” est là pour classer vos catégories en fonction de leur nom.
Éditer les permissions.
Gérer les catégories. dépendantes.
Gérer les éléments de la catégorie.- Éditer les informations.
Aller à la catégorie.
Gérer ses catégories virtuelles
Aller plus loin dans la description et les sous menus. Rajouter des liens pour des explications supplémentaires.
Vous les repérez grâce à la petite icône 
Elles sont gérées exclusivement sur votre serveur (puisqu'elles n'apparaissent pas comme des dossiers physiques).
Via le panneau [ Administration » Catégories » Gérer ] vous pourrez :
- Les déplacer par simple “glisser/déposer”.
- Le bouton ”
Sauvegarder l'ordre” pour sauvegarder l'ordre de vos catégories. - Le bouton ”
Ordonner l'ordre Alphabético-numériquement” est là pour classer vos catégories en fonction de leur nom.
Supprimer la catégorie virtuelle.- Éditer les permissions.
- Gérer les catégories dépendantes.
- Gérer les éléments de la catégorie.
- Éditer les informations
- Aller à la catégorie.
Associer, dupliquer, partager une catégorie
Liens relatifs à cette fonctionnalité:
- liens source/destination entre catégories : discussion associée à cette spécification
Le besoin est le suivant : en un minimum d'opérations, associer, dupliquer, partager le contenue d'une catégorie vers une autre catégorie.
Spécification fonctionnelle
Efficacité
Très concrètement, il s'agit de pouvoir associer une catégorie physique à une catégorie virtuelle, afin de bénéficier de la souplesse de gestion des catégories virtuelles. Dans une galerie comme celle d'un développeur de PWG (Pierrick en l'occurrence), chaque catégorie physique est associée à une catégorie virtuelle.
C'est le principe même de ploader
Procédure:
- Naviguez à travers [ Administration » Catégories » Gérer > Votre_catégorie ]
- Une fois votre catégorie identifiée, cliquez sur éditer les informations de cette catégorie
- Choisir la catégorie virtuelle nouvelle créée comme catégorie à laquelle associer toutes les photos, prendre “toutes” comme cible et valider.
- Dans le cadre Associer tous les éléments de la catégorie à une nouvelle catégorie vous pouvez donc associer le contenu de votre catégorie à une catégorie virtuelle ET/OU à une catégorie réelle de votre choix.
Ainsi, vos images peuvent se retrouver à plusieurs dans plusieurs catégories.
Caractéristiques
- On parle de catégorie source, ce qui entraîne automatiquement la notion de catégorie de destination. Plutôt que de choisir une catégorie source, on choisit une catégorie de destination.
- Multiplicité : chaque catégorie peut avoir N catégories sources et N catégories de destination.
- Les liens entre catégories sont persistants. Cela signifie que si une catégorie a une catégorie source, alors à chaque ajout dans la catégorie source, la catégorie de destination est automatiquement créditée de l'ajout (par lien virtuel).
Règles
- Transitivité : si la catégorie 126 a pour source la catégorie 282 et pour destination 528, alors tout ajout dans 282 entraîne l'ajout virtuel dans 528.
- Suppression : la suppression d'un lien entre catégories entraîne la suppression des liens entre photos et catégories correspondantes.
Si on confirme la règle de suppression, on peut créer la règle suivante :
- Arrêt v1 : l'arrêt se fait sur une Catégorie Virtuelle, et cela stoppe l'alimentation de toutes les sources. Il suffit alors de recréer une autre catégorie virtuelle qui a comme source l'ancienne catégorie virtuelle et toutes les sources à maintenir.
- Arrêt v2 : l'arrêt d'un lien entre catégories entraîne le positionnement d'un champ de type Date “end_date” pour déterminer quelles photos importer pour la source impactée en faisant correspondre avec le champ “images.date_available”. Est-ce que le test de date n'est pas trop consommateur?
Les permissions sur les catégories
Les administrateurs peuvent gérer les accès à différents albums de leur galerie. C'est ce qu'on appelle les permissions ou les autorisations dans Piwigo.
Les catégories peuvent être de deux natures : publique ou privée.
Les permissions ne peuvent être gérées que sur les catégories privées.
Vous lirez aussi la page consacrée aux permissions des utilisateurs : gestion_des_permissions
Statut d'accès aux catégories privées
Avant de gérer les permissions proprement dites, il faut commencer par définir sur quelles catégories (albums) vont avoir effet les futures permissions.
Seuls les catégories ayant un statut privé peuvent bénéficier de la gestion future des permissions.
Paramétrage du statut
La première chose à faire est de rendre privées les catégories devant l'être. Deux choix possibles:
- en paramétrant une seule catégorie : [ Administration » Catégories » Gestion ] Choisir la catégorie puis cliquer sur le bouton
- en changeant les options sur l'arbre de la catégorie : [ Administration » Catégories » Propriétés ] Et de faire basculer d'un côté ou de l'autre les catégories.
Statut par défaut
A la création, une catégorie peut être publique ou privée, cela dépend de la configuration et de la catégorie parente :
- Configuration =
$conf['newcat_default_status'] = 'public';
Attention, si la catégorie parente est privée, alors la catégorie fille est automatiquement privée. Ce paramètre de configuration doit être positionné dans le fichier de configuration. (Lire : localfileseditor)
- Statut =
private si la catégorie parente est privée.
Règles de modifications du statut
Quand vous paramétrez les statuts d'accès aux catégories, les règles automatiques suivantes sont appliquées :
- sur une catégorie parente, si le statut passe de public à privé, toutes les catégories filles deviennent privées
- sur une catégorie parente (avec des catégories filles), si le statut passe de privé à public, les catégories filles RESTENT privées
- sur une catégorie fille, si le statut passe de privé à public, toutes les catégories parentes deviennent publiques. On ne parle pas des cousines, mais des parents de la racine des catégories.
Règles d'autorisations
Ici sont listées les règles utilisées par Piwigo concernant les autorisations :
- pour un groupe ou un utilisateur, interdire une catégorie rend toutes les filles de la catégorie inaccessibles.
- pour un groupe ou un utilisateur, autoriser une catégorie rend toutes les catégories parentes accessibles.
- pour un groupe, autoriser une catégorie rend cette catégorie accessible à tous les membres du groupe (même effet pour les catégories parentes respectant la règle précédente).
- un utilisateur peut accéder à une catégorie privée s'il est autorisé ou s'il appartient à un groupe qui peut accéder à la catégorie.
- enlever un utilisateur d'un groupe fait perdre à cet utilisateur les autorisations acquises par son appartenance au groupe.
- un nouvel utilisateur n'a aucune autorisation.
- un utilisateur ou un groupe, s'il est autorisé sur une catégorie fille mais pas sur la catégorie parente, pourra accéder à la catégorie fille uniquement avec un lien directe vers la catégorie fille. Il ne pourra pas “naviguer” sur la galerie puisque la catégorie parente lui sera interdite.
Exemple
Voici un simple exemple avec des impressions écrans. Au début, toutes les catégories sont publiques :
Vous décidez de positionner {animaux » chats} à privée
Toutes les catégories filles deviennent automatiquement privées. Alors, vous décidez que {animaux » chats » semaines 8} doit être en fait public :
Toutes les catégories parentes deviennent automatiquement publiques. Les catégories parentes de {animaux » chats » semaines 8} sont {animaux » chats} (précédemment privée) et {animaux} (qui était déjà public)
Pour autant, si la catégorie mère devient visible, il n'en va pas de même pour les catégories filles qui sont toujours privées ! Pas d'inquiétude.