Plugin Table of contents
TOCGuide
TOCGuide is a small WordPress plugin. It builds a table of contents from the headings in a post. Publishers get a clean jump list without heavy scripts.
matthummel-pa/tocguide
Note Sample project. Not a client site.
What is in this sample
- Gutenberg Table of Contents block
- [tocguide] shortcode
- Live editor preview
- Sticky + scroll-spy options
- Optional ItemList JSON-LD
- Settings + Docs screens
- Zero config — insert the block; the outline builds itself
- Server-rendered HTML for SEO and screen readers
- Accurate anchors with aria-current while you read
- Numbered or bulleted lists, five style presets
- Shortcode for classic content
- Free forever — GPLv2 or later
At a glance
Who it is for
Writers, shops, and agencies that publish long posts. Also hiring managers who want to see a small plugin I shipped.
Why I built it
Long posts need a jump list. Many plugins add extra blocks or hide the outline from search engines and screen readers.
What I did
I built a light plugin that reads headings and prints the list in the first page load. It stays simple. No big JavaScript kit.
What you can use
A publisher can add a table of contents that is easy to read and easy to find. The plugin is free. Hire me if you want it tailored.
Architecture
- PHP block render callback, small editor script, optional ItemList JSON-LD.
- No React runtime on the front end for the list itself.
Handoff
Download the zip, turn the plugin on, and add the block. Settings are under Settings → TOCflow. Source is on GitHub if you want to fork it.
Questions
Is TOCGuide free?
Yes. Source and releases are on GitHub. There is no theme-shop checkout.
Does it work with classic editor posts?
Yes — use the [tocguide] shortcode. Heading anchors still inject on the front end.
Will it slow my site?
The list is in the first HTML response. Front-end JS is optional for sticky/scroll-spy and respects prefers-reduced-motion.
Can you customize it for my theme?
Yes. Get help for sticky-header offsets, style presets that match your brand, or a private fork.
More projects
Theme Tour sites
WalkRidge
A WordPress theme for tour companies. Visitors browse tours, meet guides, and book in WooCommerce.
Sage WordPress WooCommerce Gutenberg Customizer
Theme Real estate
Acreline
A WordPress theme for real estate shops. Listings, a map, agents, and showing requests — they can edit it themselves.
Sage WordPress Gutenberg Customizer