Une extension puissante et simple d’utilisation qui crée automatiquement un index spécifique au contexte ou une table des matières (TOC) pour les pages longues (et les types de publication personnalisés). Plus qu’une simple extension de table des matières, cette extension peut également produire un plan de site listant les pages et/ou les catégories sur l’ensemble de votre site.
Conçue à partir de la base et dans l’optique de Wikipédia, la table des matières apparaît par défaut avant le premier titre d’une page. Cela permet à l’auteur/autrice d’insérer un contenu d’introduction qui peut résumer ou présenter le reste de la page. Elle utilise également un système de numérotation unique qui ne se perd pas dans les différences de CSS entre les thèmes.
Cette extension est une excellente assistante pour les sites riches en contenu tels que les configurations orientées vers les systèmes de gestion de contenu. Cela dit, les blogueurs bénéficient également des mêmes avantages lorsqu’ils rédigent de longs articles structurés.
Elle comprend un panneau d’options d’administration dans lequel vous pouvez personnaliser des réglages tels que la position d’affichage, le nombre minimum de titres avant l’affichage d’un index, d’autres affichages, etc. Pour les utilisateurs/utilisatrices chevronné⋅e⋅s, les options avancées permettent d’affiner le comportement de l’application, par exemple en excluant les niveaux de titres indésirables tels que h5 et h6, en désactivant la sortie du fichier CSS inclus, en ajustant le décalage vers le haut, etc. À l’aide de codes courts, vous pouvez modifier le comportement par défaut, par exemple en masquant certaines pages ou même en masquant complètement la table des matières.
Vous préférez inclure l’index dans la colonne latérale ? Allez dans Apparence > Widgets et faites glisser le TOC+ dans la colonne latérale et la position que vous souhaitez.
Les types de publication personnalisé sont pris en charge, mais l’insertion automatique ne fonctionne que si la fonction the_content() a été utilisée par le type de publication personnalisé. Chaque type de message apparaîtra dans le panneau d’options, activez donc ceux que vous voulez.
Collaborer, participer, forker cette extension sur Github.
Codes courts
L’extension a été conçue pour être aussi transparente et indolore que possible et n’a pas exigé que vous insériez un code court pour fonctionner. Cependant, l’utilisation du code court vous permet de contrôler entièrement la position de la table des matières dans votre page. Les codes courts suivants sont disponibles avec cette extension.
Lorsque des attributs sont omis pour les codes courts ci-dessous, ils reprennent les réglages que vous avez définis sous Réglages > TOC+. Les attributs suivants sont détaillés dans l’onglet d’aide.
[toc]
Permet de générer la table des matières à l’endroit souhaité. Utile pour les sites qui ne nécessitent une table des matières que sur une petite poignée de pages. Prend en charge les attributs suivants :
- « libellé » : texte, titre de la table des matières
- « no_label » : true/false, affiche ou cache le titre
- « contenant (wrapping) » : texte, soit « gauche », soit « droite ».
- « heading_levels » : nombres, permet de sélectionner les niveaux de titres à inclure dans la table des matières. Séparez les niveaux multiples par une virgule. Exemple : inclure les titres 3, 4 et 5 mais exclure les autres avec
heading_levels="3,4,5". - « class » : texte, saisissez les classes CSS à ajouter au conteneur. Séparez plusieurs classes par un espace.
- « start » : nombre, s’affiche lorsque ce nombre de titres est présent dans le contenu.
[no_toc]
Vous permet de désactiver la table des matières pour l’article, la page ou le type de publication personnalisé en cours.
[sitemap]
Produit une liste de toutes les pages et catégories de votre site. Vous pouvez l’utiliser sur n’importe quelle publication, page ou même dans un widget texte. Notez que cela n’inclura pas un index des articles, utilisez donc sitemap_posts si vous avez besoin de cette liste.
[sitemap_pages]
Permet d’afficher une liste de pages uniquement. Les attributs suivants sont acceptés :
- « heading » : nombre entre 1 et 6, définit le Titre HTML à utiliser
- « label » : texte, titre de la liste
- « no_label » : true/false, affiche ou cache le titre de la liste
- « exclure » : ID des pages ou des catégories que vous souhaitez exclure
- « exclude_tree » : ID de la page ou de la catégorie que vous souhaitez exclure, y compris tous ses descendants.
- « child_of » : « current » ou identifiant de la page parent. La valeur par défaut est 0, ce qui inclut toutes les pages.
[sitemap_categories]
Identique à [sitemap_pages] mais pour les catégories.
[sitemap_posts]
Cette fonction vous permet d’afficher un index de tous les publications publiés sur votre site. Par défaut, les articles sont listés par ordre alphabétique en fonction de leur première lettre. Les attributs suivants sont acceptés :
- « order » : texte, soit ASC, soit DESC
- « orderby » : texte, les options les plus courantes sont « title », « date », « ID » et « rand ». Voir WP_Query pour une liste.
- « separate » : true/false (valeur par défaut : true), ne sépare pas les listes par la première lettre si la valeur est false.
Utilisez les classes CSS suivantes pour personnaliser l’apparence de votre liste :
- toc_sitemap_posts_section
- toc_sitemap_posts_letter
- toc_sitemap_posts_list
J’adore, comment puis-je témoigner ma reconnaissance ?
Si vous avez été impressionné par cette extension et que vous souhaitez montrer votre gratitude, plutôt que de m’envoyer un don, faites un don à l’organisation caritative de votre choix.
Je ne demanderai jamais aucune forme de récompense ou de compensation. Aider les autres à atteindre leurs objectifs est pour moi une source de satisfaction 🙂