Description
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
Credits
This plugin was created and maintained for many years by conjur3r. We are grateful for all the hard work he put in and we are excited to continue to build on that!
Captures d’écran
Exemple de table des matières, positionnée en haut, alignée à droite et d’une largeur de 275px 
Exemple du code court sitemap_pages 
Exemple de code court sitemap_posts 
Le panneau d’options se trouve dans Réglages > TOC+ 
Quelques options avancées 
L’onglet Plan du site
Installation
La procédure normale d’installation de l’extension s’applique, c’est-à-dire rechercher table des matières plus à partir de l’écran de votre extension ou via la méthode manuelle :
- Téléversez le dossier
table-of-contents-plusdans votre répertoire/wp-content/plugins/. - Activez-la via le menu Extensions dans l’admin WordPress
That’s it! The table of contents will appear on pages with at least four or more headings.
You can change the default settings and more under Settings > TOC+
Avis
Contributeurs/contributrices & développeurs/développeuses
« Table of Contents Plus » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs
“Table of Contents Plus” a été traduit dans 25 locales. Remerciez l’équipe de traduction pour ses contributions.
Traduisez « Table of Contents Plus » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal
2411.1
- Released: 21 November 2024
- Security hardening reported by WPScan
2411
- Released: 14 November 2024
- Security hardening reported by Patchstack
- Plugin updates for compatibility with Plugin Check
2408
- Released: 14 August 2024
- Redo XSS issue reported by wpscan
2406
- Released: 16 June 2024
- Revert ‘Do not output CSS/JS on pages not eligible’ introduced in 2402 as it broke some clever edge cases
- Fixed XSS issue requiring editor or higher privileges for show/hide text (thanks to wpscan)
2402.1
- Released: 22 February 2024
- Fixed check for shortcode use (#164)
2402
- Released: 21 February 2024
- Added option to generate TOC in REST requests, disabled by default (props ballpumpe)
- Composer improvements (props mohjak)
- Do not output CSS/JS on pages not eligible
- Update POT translation file
- Update links to help
2311
- Released: 7 November 2023
- Bump tested WordPress version to 6.4
- Do not trigger on REST requests (props steffenster)
- Update include mechanism in init.php (props maciejmackowiak)
2309
- Released: 19 September 2023
- Bump tested version to 6.3.1
- Added
child_ofproperty to sitemap_pages shortcode (props flagsoft). This lets you output a listing of child pages for a set parent or « current ». Property is optional and defaults to all pages. - Fixed XSS possibility handling nonce while saving options (thanks to Patchstack)
- Updated WordPress Coding Standard to 3.0
2302
- Released: 9 February 2023
- Added
toc_bracketsCSS class to square brackets around show/hide text - Added a filter to the
toc_extract_headingsfunction (props Raymond Radet) - Refactor using WordPress-Extra coding standard
2212
- Released: 16 December 2022
- Bump tested version to 6.1.1
- When using the TOC+ widget, execute shortcodes beforehand (props endcoreCL)
- When using the TOC+ widget, abort early when no post for edge cases (props jonas-hoebenreich)
- Add start property to toc shortcode to override the minimum number of headings needed to display (props woutervanvliet)
- Add no_numbers property to toc shortcode to disable leading heading indexes (props TedAvery)
- Fixed XSS vulnerability in toc shortcode, class property (thanks to wpscan)
- Fixed XSS vulnerabilities in sitemap_pages and sitemap_categories shortcodes, label property
2106
- Released: 23 June 2021
- Add compatibility with Rank Math SEO
- Bump tested WordPress version to 5.7
- Add PHP coding style
- Adhere to majority of coding tips
2002
- Released: 9 February 2020
- Fixed encoding when using %PAGE_TITLE% or %PAGE_NAME%
- Bump tested WordPress version to 5.3
- Removed all local translations as you can find more up to date ones at translate.wordpress.org
- Removed translators links from readme
1601
- Released: 5 January 2016
- Bump tested WordPress version to 4.4
- Add ‘enable’ and ‘disable’ API functions so a developer can better control the execution.
- Add Brazilian Portuguese translation thanks to Blog de Niterói
- Add Spanish translation thanks to David Saiz
- TOC+ widget now adheres to a blank title if none provided. Thanks to Dirk for the cue.
- Updated jQuery Smooth Scroll 1.5.5 to 1.6.0
- Updated text domain to better support translation packs.
1509
- Released: 4 September 2015
- Added Hebrew translation thanks to Ahrale
- Added Japaense translation thanks to シカマル
- Added Greek translation thanks to Dimitrios Kaisaris
- Updated jQuery Smooth Scroll 1.4.10 to 1.5.5
- Supply both minified and unminified CSS and JS files, use minified versions.
- Convert accented characters to ASCII in anchors.
- Bump tested WordPress version to 4.3
- Fixed: PHP notice introduced in WP 4.3
- Fixed: javascript error with $.browser testing for Internet Explorer 7.
- Plugin has moved to GitHub for better collaboration.
- Help needed: preg_match_all failing with bad UTF8 characters producing no TOC. If you can help, please participate in this issue.
1507
- Released: 5 July 2015
- Added Danish translation courtesy of Cupunu
- Simplified the translation duty by moving the help material to the plugin’s website.
- Updated translation file.
1505
- Released: 2 May 2015
- Huge thanks to Jason for an updated Simplified Chinese translation.
- Added collapse property to the toc shortcode. When set to true, this will hide the table of contents when it loads. Example usage: [toc collapse= »true »]
- Added label_show and label_hide properties to the toc shortcode. This lets you change the « show » and « hide » link text when using the shortcode.
- Bump tested WordPress version to 4.2.1.
1408
- Released: 1 August 2014
- Added a human German translation courtesy Ben
- Added « class » attribute to the TOC shortcode to allow for custom CSS classes to be added to the container. Thanks to Joe for suggesting it
1407
- Released: 5 July 2014
- Added Ukrainian translation courtesy Michael Yunat
- Added French translation courtesy Jean-Michel Duriez
- Empty headings are now ignored, as suggested by archon810
- Removed German translation, may have been machine translated, ref
- Fixed: Special chars in TOC+ > Settings > Exclude Headings no longer get mangled on save. Thanks to N-Z for reporting it.
1404
- Released: 18 April 2014
- Bump WordPress support to 3.9
- Fixed: Strip HTML tags from post titles for sitemap_posts so those items do not appear under a < heading. Thanks to Rose for reporting it.
- Fictitious: This release was powered by three blind mice.
1402
- Released: 19 February 2014
- Added German translation courtesy Cord Peter
- Modify toc_get_index API function to also reset minimum number of headings to 0.
- Removing the TOC+ widget from the sidebar no longer requires you to uncheck the ‘Show the table of contents only in the sidebar’ option. It will be reset on removal.
- Delay count of headings until disqualified have been removed. Thanks to Simone di Saintjust for raising it.
- Using the TOC+ widget, you can now limit the display to selected post types. Thanks to Pete Markovic for the idea.
- Updated translation file (extra options added).
1311
- Released: 10 November 2013
- Added third parameter to toc_get_index API function to enable eligibility check (eg apply minimum heading check, is post type enabled, etc). This has been switched off by default and only affects those using the API. Thanks Jonon for your comment.
- Added Dutch translation courtesy Renee
- Apply bullet option to TOC+ widget, thanks to Thomas Pani for the patch.
1308
- Released: 5 August 2013
- Fix javascript issue with minimum jQuery version check (broke smooth scrolling using WordPress 3.6).
- Replaced Slovak translation with a human translated version courtesy Boris Gereg.
- Remove signature from source when using the shortcode but not allowed to print (eg on homepage).
- Add « separate » attribute for sitemap_posts shortcode to not split by letter, thanks DavidMjps for the suggestion.
1303.1
- Released: 22 March 2013
- New: added Polish translation, curtesy Jakub
- Fixed: an issue in 1303 that ignored headings with the opening tag on the first line and the heading text on a new line. Thanks to richardsng for the quick discovery.