En standard, la description d’une catégorie Piwigo s’affiche en intégralité sur la page d’index, et sous les vignettes dans la page de la catégorie ; mais le plugin Extended Description offre bien d’autres possibilités.

Pour lire cet article, je vous suggère d’ouvrir dans une autre fenêtre, ou un autre onglet de votre navigateur, la page correspondant à cette catégorie de ma galerie de démonstration, à partir de laquelle vous pourrez visualiser directement les résultats fournis par les exemples suivants :

1. Description abrégée vs description complète

La place réservée à la description, à côté de la vignette d’une catégorie, est assez limitée ; mais rien ne vous empêche d’en mettre beaucoup plus sur la page de la catégorie elle-même, en utilisant <!--more--> pour séparer les deux parties de la description.

Seule la partie qui précède cette balise s’affichera sur la page d’index, mais la totalité de la description apparaîtra sur la page de la catégorie.

2. Description courte vs description longue

Mais vous pouvez préférer avoir 2 descriptions totalement différentes sur les 2 pages : l’une, courte, pour la page d’index ; l’autre, longue, pour la page catégorie. C’est alors la balise <!--complete--> qu’il vous faut utiliser pour séparer les 2 descriptions.

3. Description en haut vs description en bas

Par défaut, la description de catégorie s’affiche au dessous des vignettes sur la page catégorie. Pour la mettre au-dessus, ou même en mettre une partie en haut, et l’autre en bas, il vous suffit d’utiliser la balise <!--up-down--> comme ceci :

4. Description multilingue

Extended Description permet également de gérer des descriptions multilingues. Il suffit, pour ce faire, d’encadrer chaque langue du couple de balise [lang=XX]…[/lang], où XX représente le code ISO de la langue, ou default pour la langue par défaut de la galerie.

Pour voir le résultat en anglais sur la galerie de démonstration, utilisez le sélecteur de langage :

5. Une catégorie dans la description d’une catégorie

Il vous est également possible d’afficher directement une autre catégorie sous les vignettes, ce qui constitue un moyen de lier des catégories entre elles, sans pour autant que l’une soit parente de l’autre. Utilisez à cet effet la balise [cat=XX], où XX est le numéro de la catégorie à afficher.

Pour déterminer la numéro d’une catégorie, rendez-vous simplement sur sa page d’index, et consultez son URL dans la barre d’adresse de votre navigateur:

http://www.marie-noelle-augendre.com/piwigo/index.php?/category/69

le numéro de la catégorie est celui qui suit category/, soit 69 dans cet exemple.

6. Des images dans la description d’une catégorie

Une idée peut-être un peu plus tordue (je n’ai pas réussi à trouver de réels besoin pour ce cas de figure) consiste à ajouter des images sur la page d’index de la catégorie, en utilisant la balise [img=XX,YY,ZZ;right;name], où :

• XX, YY, ZZ, etc. sont des numéros d’images séparés par une virgule
• right, ou left, est un paramètre optionnel indiquant si les images doivent être placées à droite ou à gauche
• name, également optionnel, provoque l’affichage du nom des photos

La détermination du numéro d’une image se fait de la même manière que pour une catégorie : affichez la page de l’image, consultez son URL dans la barre d’adresse de votre navigateur:

http://www.marie-noelle-augendre.com/piwigo/picture.php?/246/category/81

le numéro de l’image est celui qui suit picture.php?/, soit 246 dans cet exemple.

Pour finir

Vous trouverez au départ de cette page tous les écrans de documentation du plugin Extended Description (ces écrans d’aide seront installés sur votre galerie avec le plugin) … et vous pourrez constater que je n’ai pas (encore) traité le sujet du masquage des catégorie ou image ; ce sera pour une prochaine fois.