Tidy Table of Contents
| 开发者 | pierreferrolliet |
|---|---|
| 更新时间 | 2026年5月22日 20:28 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
Tidy Table of Contents automatically generates a clean, accessible table of contents from your headings. It works out of the box with no configuration, and offers deep customization when you need it.
Key features:
- 🤖 Automatic — parses H2–H6 headings and generates the TOC instantly
- ♿ Accessible — proper ARIA roles, keyboard navigation
- ⚡ Performant — output cached per post, no render-blocking JS
- 🎨 Customizable — configure depth, position, title, open/collapsed state
- 📌 Per-post control — override global settings via meta box
- 🔗 Smooth scroll — animated anchor navigation
- 📱 Responsive — collapsible on mobile
- 🧩 Shortcode —
[tidy_toc]for manual placement
安装:
- Upload the
tidy-table-of-contentsfolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
- The TOC will appear automatically above the first H2 heading in your posts
- Configure global defaults under Settings → Tidy TOC
屏幕截图:
常见问题:
Which heading levels are included?
By default H2 and H3. You can configure the minimum and maximum heading depth in the settings.
Can I disable the TOC for a specific post?
Yes. Each post has a meta box where you can disable the TOC or override global settings.
Does it work with the block editor?
Yes. The TOC is generated server-side from the rendered post content, so it works regardless of how the post was written.
Does it slow down my site?
No. The TOC output is cached per post and invalidated automatically when the post is updated.
Can I place the TOC manually?
Yes. Use the [tidy_toc] shortcode anywhere in your content, or disable auto-insertion in the settings.
更新日志:
1.0.8
- Declared compatibility with WordPress 7.0.
- Replaced the grid-template-rows collapse trick with a max-height transition. The grid trick would refuse to fully collapse in some themes, leaving a residual strip with the first row of items partially visible. max-height: 0 hides the body cleanly.
- Fixed the collapsed state leaving a visible padding strip under the header. The body wrapper is now
box-sizing: border-boxso its padding is included in the collapsed height (full collapse, no leftover band).
- TOC item sizes inherit from the active theme again (reverts the explicit
remfallback added in 1.0.4). - Title bumped to 1.25rem so the SOMMAIRE label stays clearly readable as a header above inherited link sizes.
- Fixed the toggle button picking up theme button styles (coloured background, padding, hover gradient) — the "Table of Contents" header now reliably renders as a plain text label across themes.
- Hardened TOC item font sizes against context shrinkers (sidebar, nav, .entry-content ul). Sizes are now expressed in
remso they track the theme's root font size while staying isolated from nested overrides.
- Default insertion position is now "After first paragraph" (was "Before content") — better reading flow on a fresh install.
- Removed hardcoded font sizes from the front-end stylesheet (base, title, H2/H3/H4 link sizes). The TOC now inherits typography from the active theme.
- Removed all rendering code for premium-only features (sticky positioning, "custom" theme with color/radius/border options, reading-time badge). The free plugin now exposes only the three documented free themes (Minimal, Card, Outline) — no hidden capabilities behind add-on hooks.
- Removed all licence checks and premium-feature gating from the free plugin code (premium features are now distributed via a separate companion plugin).
- Hardened JSON-LD output with JSON_HEX_* flags to prevent script-tag breakouts.
- Removed the now-unnecessary
load_plugin_textdomain()call (handled by WordPress.org translation system since WP 4.6). - Added extension hooks for add-on plugins (settings defaults/sanitisation, render options, shortcode atts/headings, settings page, admin/front localized data, plugin row links).
- Initial release — automatic TOC generation, caching, accessibility, per-post control.