3.5.3.2 Ajouter et utiliser les catégories de la publication

Comme pour les archives, une publication peut appartenir à des catégories. Naturellement, vous pouvez afficher ces catégories dans votre publication. La récupération et l'affichage de ces catégories fonctionnent exactement de la même façon que dans le chapitre 3.5.2.3, mais au lieu d'utiliser ces motifs :

• GetFlattenedBlogCategories
• GetBlogCategoriesTree

On utilisera les motifs suivants :

• GetFlattenedEntryCategories
• GetEntryCategoriesTree

En effet, ces deux motifs récupèrent uniquement les catégories associées à la publication courante. La plupart du temps, dans une publication, on utilisera plutôt GetFlattenedEntryCategories. En effet, afficher l'arbre des catégories spécique à la publication n'est pertinent que dans des cas très spécifiques.

En se basant sur le chapitre 3.5.2.3 et sur ce que nous avons vu précédemment, nous aurions alors quelque chose ça :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

<div class="entry" id="entry.:GetEntryID:.">
    <h1><a class="entry_title" href=".:GetEntryPath:.">.:GetEntryTitle:.</a></h1>
    <span class="entry-date"><a href=".:GetEntryArchivePath:.">.:GetEntryDate:.</a></span>
    
    .:IfBlogMetadataIsTrue::disable_categories::
    <!-- Bloc HTML à conserver si la variable vaut true -->
    ::
        .:IfBlogMetadataIsTrue::display_entry_categories_as_list::
            <ul id="entrycategorieslist">
            .:GetFlattenedEntryCategories::
              <li class="entrycategoriesitem">
                <a href="{path}" title="{value} ({count})">{value}</a>
              </li>
              ::
            :.
            </ul>
        :.
        
        .:IfBlogMetadataIsTrue::display_entry_categories_as_tree::
            .:GetEntryCategoriesTree::
                <ul>::
                <li><a href="{path}" title="{count} publications">{value}</a>::
                {childs}</li>::
                </ul>
            :.
        :.
    :.
    
    <div class="entry_content">
        .:GetEnTryContent:.
    </div>
</div>

Quelques remarques :

• Comme dans le chapitre 3.5.2.3, on s'assure que VenC est bien configuré pour générer les catégories en premier lieu.
• Ici, on teste deux variables display_entry_categories_as_list et display_entry_categories_as_tree qui doivent se trouver dans le fichier de configuration du blog. Or, nous pouvons imaginer que l'on veuille contrôler l'affichage de nos catégories depuis la publication elle-même, c'est-à-dire en testant une métadonnée de la publication. Pour ce faire, on utiliserait par exemple le motif IfEntryMetadataIsTrue à la place de IfBlogMetadataIsTrue.