AIFORYA Table of Contents

AIFORYA Table of Contents builds a clickable table of contents from the headings in your content — and then keeps the resulting anchor links working.

The problem this plugin exists for

In most tables of contents an anchor is derived from the heading text. Rename “Introduction” to “Foreword” and #introduction stops existing. Every link that pointed at it is now broken: your own internal links, links from other sites, links in newsletters you sent two years ago.

Nothing warns you. The page still returns 200, and the browser simply does not scroll.

What this plugin does instead

A section is given its address when it is first published, and keeps it. The heading text can change, the section can be moved, the post can be split into pages — the address follows the content, never the wording or the position. Every heading text a section has ever had is kept as an alias, so older links keep resolving too.

Try it in thirty seconds: publish a post with two sections, copy a link to the second one, then swap the two sections around and rename one of them. Your link still lands on the right section.

Features

• Permanent section addresses — an anchor assigned once is kept, through renames, reordering and repagination.
• Alias registry — previous addresses of a section stay reachable, so old links keep working. Addresses are kept by default: an address you stop honouring is a promise you break without knowing it.
• Multipage posts covered end to end — when a post is split with the <!--nextpage--> tag, the table lists the headings of every page and links to the right page and heading. This is the same promise applied across pages.
• Automatic table of contents — reads the headings (h2, h3, and so on) in your content and builds a hierarchical list of links.
• Clickable anchors — a unique anchor link is added to each heading so readers can jump directly.
• Automatic or manual placement — insert the table automatically before the first heading, or choose where it goes with the [aiforya_toc] shortcode.
• Post types of your choice — enable the table on the post types you want (posts, pages, and more).
• Adjustable threshold and levels — set the minimum number of headings required, and the deepest heading level to include.
• Neutral, unobtrusive styling — the table fits into any public theme without imposing its own colours.

Privacy

The plugin runs entirely on your own server. Nothing is sent to any third party.

Advanced version

An advanced version (see aiforya.fr) adds a floating table of contents, numbering, word counts and smooth scrolling. This free version is fully functional on its own, with no time limit.