Ce post est en grande partie une traduction d'une explication de l'utilisation du module catégories par Markwest dans un fil trouvé sur http://community.postnuke.com :

http://community.postnuke.com/modul...topic-53957.htm

Quelques rappels fondamentaux sur le module catégories

Le module catégories est plus qu'une solution pour catégoriser les contenus, même si une de ces fonctions est justement de faire ça.
Le module catégories produit à la base un arbre hiérarchique de 'catégories'
Ces catégories ne sont pas reliées (related)entre elles et peuvent être utilisées de différentes façons.
Dans une installation par défaut, le module catégories génère trois (sections) branches de catégories principales (General, Modules, Users)
Nous traiterons ici des deux premières branches.

Général:
Cette première branche produit un ensemble de catégories générales qui doivent simplifier la gestion des items des objets de type listes utilisées dans les modules.
Par exemple, disons que je veuille travailler avec un système web de gestion d'incidents. Dans une des branches, j'ai les catégories Général/Statuts de traitement étendu et /Statuts de traitements basiques.
Plutôt que de construire statiquement dans mes modèles des listes déroulantes en "dur", je peux construire des listes déroulantes en utilisant une de ces branches. Ainsi si je souhaite ajouter un nouveau statut, je l'ajoute dans les items dans ma catégorie. Mes listes déroulantes sont alors automatiquement mises à jour.
En théorie, le module catégories pourrait produire du contenu pour tout type de liste déroulante et tout type de bouton radio à l'intérieur du site.

Modules:
La branche Modules permet en revanche de créer des catégories pour l'ensemble des modules ou par chaque modules:
Par défaut le module catégorie crée une branche "global" (Modules/Global).
Il y a deux scénarios de bases qui nous font utiliser cette branche (mais entre les deux il y a la place pour plein d'autres scénarii).

Scenario 1)
Un ensemble de catégories qui pourront être utilisées dans tous les modules produisant des contenus. Imaginons que je fasse un site sur les logiciels libres d'infographie, je pourrai ainsi créer une liste de rubriques qui serait la suivante : Inkscape, TheGimp, Scribus, Krita, Blender .... Je pourrais alors utiliser ce schéma de catégories pour différents modules (les News, les Downloads, les WebLinks, les Compte Rendus...).

Scenario 2)
Une hiérarchie de catégories est associée à un module spécifique. Par exemple je crée un portail avec des articles (News), et je veux ajouter une zone de téléchargements (Downloads) et un annuaire de liens (Web_Links) en relation avec les rubriques de mon blog. Je peux définir la hiérarchie de catégories suivantes:
Module News:
-Actus logiciels libres
-Opinions
-Vie du site
Module Downloads :(Téléchargements)
-Nos développements
-Utilitaires
-Nos kits graphiques
Annuaire du libre
-Communautés d'utilisateurs
-Professionnels
-Tutoriels

(les modules pris en exemple ne sont pour l'instant pas très significatif car sont des AddOns Downloads et Web_Links n'intègrent pas par défaut le système de catégorie dans PN.8 RC3)

Le registre des catégories détermine comment un module se réfère (ties) aux catégories
Les entrées, les valeurs définies dans le registre des catégories indiquent à un module X quelles catégories il doit utiliser.
Ainsi dans le scénario 1, le module catégorie indique à tous les modules se référant à la hiérarchie "Global" qu'il faut utiliser la même structure hiérarchique Alors que dans le scénario 2 il indique à chaque module d'utiliser des catégories qui lui sont spécifiques.

Par défaut lorsqu'on installe et active n'importe lequel des modules additionnels (les fameux values addons ou tout autres modules compatible .8), il s'intègre dans le système des catégories pour permettre l'utilisation de ces deux scénarios:
Par exemple si on active le module News, l'activation du module crée une catégorie dont le chemin sera /Modules/News (pour l'utilisation du scénario 2 et donc la définition de catégories propres à ce module) mais parallèlement si vous ajouter une catégorie dans /Modules/Global elle sera aussi accessible comme toutes les catégories (ou rubriques) existantes dans cette partie de l'arborescence.
C'est pour ça que lorsque vous ne modifiez pas l'installation par défaut, on vous propose dans chaque module utilisant le système de catégories, les catégories créées par défaut lors de l'installation de votre Postnuke (Sport, Science etc.).


Les attributs des catégories:
Une catégorie peut avoir de plusieurs attributs qui ajoutent des données supplémentaires pour définir cette catégorie. Ces données peuvent être utilisées de différentes façon par les modules.L'administrateur du système pourra ajouter ses propres attributs pour des usages qui lui seront propres.
Un exemple d'utilisation des attributs peut être illustrer à partir du module News.
Si à une catégorie de News (Brèves) vous lui assignez l'attribut topic_image, on pourra pour chaque catégorie du module "News" définir une valeur pour cet attribut qui désignera l'image à utiliser pour illustrer la catégorie. Ceci permet de faire la transition avec l'ancien module "topic" des versions .7x de Postnuke.


Remarques complémentaires de MagicVince pour conclure :

- Avec les attributs des catégories nous entrons dans le détail du module... l'objet ici était de faire état des principes généraux.
- On notera cependant que ce module n'est pas compatible d'emblée avec tous les modules ".8 compliant". Par exemple le modules "Downloads" de Sasha Jost ne s'intègre pas par défaut dans le système des catégories.
- Par ailleurs il peut apparaître comme un module concurrent à Topic auquel, il me semble qu'il se substituera à l'avenir (pour l'instant le dernier intérêt de topic me paraît être d'associer un topic avec une icône (mais comme je l'ai fait remarqué plus haut a priori on peut utiliser topic_image avec catégories.
- Un des intérêts majeurs se trouve pour les sites multilingues. Catégories permet d'avoir plusieurs versions linguistiques pour une même catégorie.

Merci pour cette contribution.

-------------------------------------------
...n'oubliez pas que l'outil Recherche est votre ami !
...bien souvent il répond à nos questions avant même que l'on ne se les pose ! ^^

Merci pour la synthèse et la traduction !

Dans le module Catégories, l'usage des paramètres pour l'utilisateur me semble encore floue,
si tu as compris l'intérêt de laisser l'utilisateur final gérer ses catégories,
je suis très intéressé ...

modifié par : ljvd, 19 Mar 2008 - 15:31

Laurent Dubois - Consultant commercial
Réseaux : Ziki Viadeo Xing

Super contribution, en revanche, connaissez vous un tuto sur l'api des catégories car actuellement je n'ai pas trouvé grand chose !

Niet, je connais pas, ça servirait à quoi? A savoir comment rendre un module compatible avec le système catégorie?