AIFORYA Table of Contents

Documentation technique de AIFORYA Table of Contents, reprise telle quelle de celle livrée avec l'extension.

← Revenir à la fiche produit Ajoute automatiquement un sommaire cliquable à vos articles et pages à partir des titres du contenu, avec ancres et code court — en local, sans clé API.

Description

AIFORYA Table of Contents génère un sommaire (table des matières) cliquable à partir des titres de vos contenus. Vos lecteurs se repèrent plus vite dans les articles longs et sautent directement à la section qui les intéresse. 100 % en local : aucune clé API, aucun service externe.

Fonctionnalités de la version gratuite

• Adresses de section permanentes — une ancre attribuée une fois est conservée, même si vous renommez le titre, déplacez la section ou repaginez l'article. Les liens partagés continuent d'aboutir.
• Registre d'alias — les anciennes adresses d'une section restent atteignables. Elles sont conservées par défaut : une adresse qu'on cesse d'honorer est une promesse rompue sans que personne ne le sache.
• Articles paginés couverts de bout en bout — quand un article est découpé avec la balise <!--nextpage-->, le sommaire liste les titres de toutes les pages, pas seulement celle qu'on lit, et chaque entrée mène à la bonne page et au bon titre. Le lecteur voit la structure entière dès la première page.
• Sommaire automatique — analyse les titres (h2, h3, etc.) du contenu et construit une liste hiérarchisée de liens.
• Ancres cliquables — un lien d'ancrage unique est ajouté à chaque titre pour permettre le saut direct.
• Insertion automatique ou manuelle — placez le sommaire automatiquement avant le premier titre, ou choisissez son emplacement avec le code court [aiforya_toc].
• Contenus au choix — activez le sommaire sur les types de contenu de votre choix (articles, pages…).
• Seuil et niveaux réglables — définissez le nombre minimum de titres requis et le niveau de titre maximum pris en compte.
• Style neutre et discret — le sommaire s'intègre à n'importe quel thème public sans imposer ses couleurs.

Confidentialité et autonomie

L'extension fonctionne entièrement sur votre serveur. Aucune donnée n'est transmise à un service tiers.

Version avancée

Une version avancée (voir aiforya.fr) ajoute notamment : sommaire flottant, numérotation, comptage des mots et lissage du défilement. La version gratuite reste entièrement fonctionnelle et autonome, sans limite de durée.

External services

Ce plugin peut, uniquement si vous le demandez explicitement, communiquer avec le service AIFORYA Echo pour les fonctions d'assistance et d'avis intégrées à l'administration :

• AIFORYA Echo (https://echo.aiforya.fr) — utilisé lorsque vous envoyez un message via l'onglet « Support » ou publiez un avis via l'onglet « Avis ». Les données transmises se limitent au contenu de votre message, à votre adresse e-mail et au domaine de votre site. Chaque envoi requiert votre consentement RGPD explicite (case à cocher). Aucune donnée n'est transmise sans action de votre part.
  • Conditions d'utilisation : https://www.aiforya.fr/fr/cgv
  • Politique de confidentialité : https://www.aiforya.fr/fr/politique-confidentialite

Le cœur du plugin (génération du sommaire cliquable à partir des titres du contenu) fonctionne intégralement sans aucun appel réseau.

Installation

1. Installez et activez l'extension.
2. Ouvrez le menu AIFORYA Table of Contents.
3. Dans l'onglet Réglages, choisissez les types de contenu, le nombre minimum de titres et les niveaux à inclure.
4. Publiez ou modifiez un contenu long : le sommaire apparaît automatiquement. Pour le placer vous-même, insérez [aiforya_toc].

Frequently Asked Questions

Comment le sommaire est-il construit ?

L'extension analyse les titres du contenu (h2, h3, etc. jusqu'au niveau que vous choisissez) et en fait une liste hiérarchisée. Un lien d'ancrage est ajouté à chaque titre pour permettre le saut direct.

Sur quels contenus le sommaire apparaît-il ?

Sur les types de contenu que vous sélectionnez dans l'onglet Réglages, et uniquement lorsqu'ils atteignent le nombre minimum de titres défini.

Puis-je placer le sommaire à un endroit précis ?

Oui. Insérez le code court [aiforya_toc] à l'emplacement voulu. Lorsque ce code court est présent, l'insertion automatique est désactivée pour ce contenu afin d'éviter les doublons.

Le sommaire est-il compatible avec mon thème ?

Oui. Il utilise un style neutre et discret, pensé pour s'intégrer à n'importe quel thème public.

Ai-je besoin d'une clé API ?

Non. La version gratuite est entièrement autonome et fonctionne en local, sans service externe.

Screenshots

1. Aperçu de l'état et de la configuration du sommaire.
2. Réglages : affichage, contenus concernés et contenu du sommaire.
3. Le sommaire cliquable affiché sur un article.

Changelog

1.1.1

• Correctif : la garde de déclaration de la classe de diagnostic empêche désormais l'autoload, ce qui évite une redéclaration fatale lorsque plusieurs extensions AIFORYA se chargent en même temps.

1.1.0

• Nouvel onglet Diagnostic. Il relit tous les liens d'ancre de votre site et vous dit, lien par lien, s'ils arrivent encore là où ils devaient. Rien n'est modifié : l'audit ne fait que lire et compter.
• Les liens sont classés en cinq états, volontairement séparés : Cassés (la section visée n'existe plus — les seuls qui demandent votre attention), Rattrapés (la section a été renommée et le lien fonctionne encore parce que son ancienne adresse est conservée — sans cette extension, chacun d'eux serait cassé), Corrects, Pas encore mesurés et Hors de ce site.
• « Pas encore mesuré » est un résultat, pas un échec. Un contenu dont le registre d'ancres n'a pas encore été écrit n'est jamais compté comme cassé. Sans cette distinction, une extension fraîchement installée annoncerait des centaines de liens cassés sur un site en parfait état.
• L'audit avance par lots pour ne pas expirer sur un grand site, et il indique toujours combien d'éléments restent. Tant qu'il en reste, les chiffres sont annoncés comme partiels — un décompte qui s'arrête à mi-chemin sans le dire est pire que pas de décompte du tout.

1.0.2

• Corrections de l'interface d'administration partagée entre les extensions AIFORYA.

1.0.1

• L'aide intégrée et la FAQ peuvent désormais être traduites. En 1.0.0, ces réponses étaient du texte figé qu'aucune traduction ne pouvait atteindre.
• Nettoyage interne de l'écran des réglages. Aucun changement dans la façon dont le sommaire est construit ou affiché.

1.0.0

• Version initiale : sommaire automatique à partir des titres, ancres cliquables, insertion automatique ou via le code court [aiforya_toc], types de contenu, seuil et niveaux réglables.