A powerful and flexible Table of Contents plugin for WordPress with H2–H6 support, automatic numbering, scrollspy navigation, and flexible display positions.
| Item | Value |
|---|---|
| Contributors | cclin |
| Tags | table of contents, toc, headings, navigation, scrollspy |
| Requires at least | WordPress 5.8 |
| Tested up to | WordPress 6.9 |
| Requires PHP | 7.4 |
| Stable version | 1.0.1 |
| License | GPLv2 or later |
| License URI | https://www.gnu.org/licenses/gpl-2.0.html |
Smart Table of Contents is a highly customizable Table of Contents (TOC) plugin designed for professional content structure and reader navigation.
It automatically extracts headings from your content and generates a dynamic navigation structure that improves both readability and user experience.
- Extract heading levels H2 to H6 (configurable)
- Support automatic heading numbering such as
1,1.1,1.1.1 - Multiple TOC positions:
- Inline at the top of the article
- Fixed left-side TOC with scrollspy
- Left-side TOC scrollspy highlights active headings while scrolling
- Full admin settings:
- Select heading levels
- Enable or disable numbering
- Auto insert TOC at the beginning of content
- Supported post types, including custom post types such as
topic
- Independent expand and collapse behavior for inline TOC and left-side TOC
- Gutenberg compatible
- Fully internationalized (i18n ready)
- Clean OOP-based structure
- Separate JavaScript and CSS files for easier maintenance
- Upload the plugin folder
cc-smart-tocto/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
- Go to Settings → Smart TOC
- Configure your preferences
- Remove Custom CSS feature
- Improve security compliance
- Minor code cleanup
- Initial release
This plugin bundles the following third-party library:
- Repository: https://github.com/select2/select2
- License: MIT
- Full license text:
/assets/vendor/select2/LICENSE
Chance Lin
https://cclin.cc