Описание
Smart Table of Contents is the ultimate lightweight, SEO-friendly Table of Contents plugin for WordPress. It automatically generates a beautiful, clickable TOC from your post and page headings — helping visitors navigate long-form content effortlessly while boosting your site’s SEO with structured, crawlable anchor links.
🚀 Upgrade to Smart TOC Pro for advanced sticky/floating controls, advanced mobile behavior, and more!
🎯 Perfect For
- Bloggers with long-form content
- Documentation & knowledge base sites
- Tutorial and how-to websites
- News and magazine publishers
- Educational platforms & online courses
- Any WordPress site with lengthy articles
✨ Free Features
- Automatic TOC Generation — Instantly creates a table of contents from your H2-H6 headings
- Smooth Scrolling — Elegant smooth scroll animation when clicking TOC links
- Collapsible TOC — Visitors can expand/collapse the table of contents
- Active Heading Highlight — Highlights the current section as users scroll
- Shortcode Support — Use
[aniksmta_toc]to place TOC anywhere in your content - Customizable Heading Levels — Choose which headings to include (H2-H6)
- Counter Formats — Choose decimal numbers, Roman numerals, hierarchical (1.1.1), or no counters
- Collapsible Sections — Add toggle buttons to expand and collapse nested headings
- Theme Presets — Light, Dark, and Minimal theme presets plus default style
- Theme Color Picker — Match your site’s branding with custom accent color
- Toggle Icon Styles — Choose between Chevron (Default) and Plus/Minus icons
- Auto Dark Mode — Automatically switch to dark theme if the user’s device is in dark mode
- SEO Schema Markup — SiteNavigation JSON-LD structured data for search engines
- SEO Optimized — Clean HTML markup with proper anchor links for search engines
- Ultra Lightweight — Under 15KB, zero jQuery dependency
- Translation Ready — Fully internationalized with POT file included
- Per-Post Control — Enable/disable TOC for individual posts or pages
- Per-Post Heading Override — Override global heading levels on individual posts
- Global Heading Exclusion — Exclude headings by text across the entire site
- Exclude Headings by CSS Class — Skip specific headings using the
no-tocclass - Page Exclusion Rules — Easily hide TOC on Home, Archive, Search, and 404 pages
- Multiple Positions — Before content, after first paragraph, or manual placement
- Sticky TOC (Basic) — Keep TOC visible while reading with simple sticky behavior
- Floating Desktop TOC (Basic) — Persistent TOC button and panel on the side of the screen for desktop users
- Mobile TOC Modal (Basic) — Mobile button opens TOC in a compact modal panel
- Copy Anchor Links — One-click copy for any TOC item link
- Reading Progress Bar (Basic) — Top progress indicator for long-form content
- Estimated Reading Time (Basic) — Display how long it takes to read the article
- Back to Top Button (Basic) — Quick scroll-to-top functionality
- Dynamic Content Refresh — Auto-initialize TOC behavior for content added after page load
- Lazy-load TOC Init — Delayed initialization until TOC enters viewport
- Gutenberg Block (Basic) — Insert TOC from the block editor with title and collapsed controls
- Sidebar Widget (Basic) — Display TOC in widget areas with title and collapsed controls
- Dashboard Widget — Quick TOC stats and access from your WordPress dashboard
Take your table of contents to the next level with Smart TOC Pro:
- 📌 Advanced Sticky/Floating TOC — Rich sticky modes, floating panel layouts, offsets, and behavior controls
- 📊 Advanced Progress Modes — Extra progress variants and panel-integrated progress experiences
- ⏱️ Advanced Reading Time Controls — Custom WPM speed, advanced formatting, and placement options
- ⬆️ Advanced Back to Top Button — Icon packs, shapes, colors, visibility controls, and circular progress ring
- ⌨️ Keyboard Navigation — Navigate TOC with keyboard shortcuts for better accessibility
- 💻 Custom CSS Support — Full styling control with custom CSS
- 📱 Advanced Mobile Options — Themed modal styles, gestures, and advanced trigger controls
- 🔢 Advanced Numbering Controls — Color overrides, prefixes, and suffixes for numbers
- 🗂️ Fine-Grained Collapsible Controls — Set default expanded/collapsed states per nested section
- 🎨 10+ Premium Theme Presets — Glassmorphism, gradient, and modern UI styles
- ⚙️ Advanced Display Conditions — Granular URL, category, tag, and author exclusion logic
- 📦 Settings Export/Import — Easily migrate settings between sites
- 🧱 Advanced Gutenberg Block Controls — More layout and behavior customization
- 📦 Advanced Sidebar Widget Controls — Rich display and behavior options
- 🔒 Priority Support — Fast, dedicated customer support
How It Works
- Install and activate the plugin
- Configure settings under Settings Smart TOC
- The TOC automatically appears on your posts and pages
- Or use
[aniksmta_toc]shortcode for manual placement
Shortcode Usage
Basic usage:
[aniksmta_toc]
With custom title:
[aniksmta_toc title=»In This Article»]
Collapsed by default:
[aniksmta_toc collapsed=»true»]
🐛 Bug Reports
Found a bug? Please report it on our GitHub Issues page.
💬 Support & Help
- Documentation: Smart Table of Contents Documentation
- Support Forum: WordPress.org Support
- Contact: Contact
- Pro Support: Priority Support for Pro Users
🗺️ Roadmap
We’re constantly improving Smart TOC! Upcoming features:
- Additional shortcode attributes
- Advanced styling options
- Performance optimizations
- More counter format options
Have a feature request? Submit it on GitHub!
Скриншоты
Установка
- Upload the
anik-smart-table-of-contentsfolder to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to Settings Smart TOC to configure the plugin
- That’s it! TOC will automatically appear on your posts and pages
Часто задаваемые вопросы
-
How do I add TOC to a specific location?
-
Use the shortcode
[aniksmta_toc]in your post or page content where you want the TOC to appear. Set the position to «Manual (Shortcode Only)» in settings. -
Can I exclude a specific post from having TOC?
-
Yes! Edit the post and look for the «Smart TOC» meta box in the sidebar. Check the box to disable TOC for that specific post or page.
-
How do I change the TOC position?
-
Go to Settings Smart TOC Display Settings and choose from:
* Before Content — TOC appears at the top of your content
* After First Paragraph — TOC appears after the first paragraph
* Manual (Shortcode only) — Use[aniksmta_toc]shortcode for custom placement -
Can I exclude certain headings from TOC?
-
Yes! Add the CSS class
no-tocto any heading you want to exclude:This heading won’t appear in TOC
-
How do I change the TOC title?
-
Go to Settings Smart TOC Display Settings and change the «TOC Title» field. Or use the shortcode attribute:
[aniksmta_toc title="In This Article"] -
Does it work with page builders?
-
Yes, Smart TOC works with most page builders including:
* Elementor
* Beaver Builder
* Divi Builder
* WPBakery
* Gutenberg -
Is it compatible with caching plugins?
-
Yes, Smart TOC is fully compatible with popular caching plugins:
* WP Super Cache
* W3 Total Cache
* WP Rocket
* LiteSpeed Cache
* Autoptimize -
Why isn’t the TOC showing on my posts?
-
Check these common issues:
1. Make sure the plugin is enabled in Settings Smart TOC
2. Verify the post type is selected in settings
3. Check if you have the minimum number of headings required
4. Make sure TOC isn’t disabled for that specific post -
Does it affect page speed?
-
No! Smart TOC is extremely lightweight (under 15KB) and doesn’t use jQuery on the frontend. It has minimal impact on your page load time.
-
Can I style the TOC to match my theme?
-
Yes! You can:
1. Change the theme color in settings
2. Add custom CSS to your theme
3. The TOC uses clean HTML with CSS classes for easy styling -
Does it support RTL languages?
-
Yes, Smart TOC fully supports RTL (Right-to-Left) languages like Arabic, Hebrew, and Persian.
-
How do I display numbers before TOC items?
-
Go to Settings Smart TOC Display Settings and check «Show Numbers» option.
Отзывы
Нет отзывов об этом плагине.
Участники и разработчики
«Smart Table of Contents» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
УчастникиПеревести «Smart Table of Contents» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
1.2.0
- Added Gutenberg Block for easy TOC insertion in the block editor
- Added Sidebar Widget for displaying TOC in widget areas
- Added Basic Sticky TOC support
- Added Mobile TOC Modal (floating button and panel for mobile devices)
- Added Copy Anchor Link button for TOC items
- Added Basic Reading Progress Bar
- Added Dynamic Content Support (auto-detect AJAX and Page Builder changes)
- Added Lazy Load TOC Initialization for improved performance
- Added Basic Floating Desktop TOC
- Added Collapsible Sections for nested headings
- Added Hierarchical Numbering support (1, 1.1, 1.1.1)
- Added Estimated Reading Time display
- Added Basic Back-to-Top Button functionality
- Added Page Exclusion Rules (Home, Archive, Search, 404 toggles)
- Added Auto Dark Mode feature to sync with system preferences
- Added Toggle Icon Style setting (Chevron vs Plus/Minus)
- Added Settings UI panel options for the newly included freemium features
- Improved inline TOC copy icon alignment so copy buttons stay on the same line as heading links
- Improved floating panel active heading contrast for both default and dark themes
- Improved theme color contrast handling for very light colors (including white) to keep active links readable
- Made the default TOC preset explicitly gray for consistent rendering (
toc-theme-default) - Updated admin Documentation tab references for newly added freemium settings and CSS classes
1.1.0
- Added counter format setting: choose Decimal, Roman numerals, or None
- Added TOC theme presets: Default, Light, Dark, and Minimal styles
- Added per-post heading level override via the Smart TOC meta box
- Added global heading exclusion by text (comma-separated list in settings)
- Added SiteNavigation Schema JSON-LD output for SEO
- Updated Free Features list and Pro Features list
- Code quality improvements
1.0.9
- Version bump for WordPress.org resubmission
- All changes from 1.0.8 included
1.0.8
- Moved all inline CSS and JavaScript to properly enqueued files (WordPress.org compliance)
- Renamed all generic prefixes from smart_toc to unique aniksmta prefix
- Added Help & Support tab with quick links and system information
- Added load_plugin_textdomain for proper translation loading
- Fixed critical heading ID duplication bug when duplicate headings exist
- Fixed empty heading levels causing invalid regex errors
- Fixed 3-character hex color code handling in theme color processing
- Fixed shortcode content processing order to match WordPress core
- Improved dashboard widget performance with capped 100-post sample
- Added exclude_class setting preservation during settings save
- Improved meta box storage pattern
- Improved toggle button focus states for better accessibility
- Enhanced keyboard navigation support
- Full PHPCS WordPress Coding Standards compliance
- Updated all Pro links to correct URL
1.0.7
- Renamed plugin from «Smart Table of Contents» to «Anik Smart Table of Contents» for distinctive branding
- Updated text domain from smart-table-of-contents to anik-smart-table-of-contents
- Updated all plugin references, URLs, and documentation to reflect new name
- Renamed main plugin file to anik-smart-table-of-contents.php
- Updated translation template (.pot file) with new text domain
1.0.6
- Added Documentation tab in admin settings panel with comprehensive user guide
- Includes Quick Start guide, Settings Reference, Shortcode Usage, Troubleshooting, and FAQ sections
- Improved admin UI with tabbed navigation
- Added Dashboard widget with TOC stats and quick access to settings
- Added review request notice after 7 days of usage
1.0.5
- Fixed text domain mismatch for proper internationalization
- Renamed admin menu to «Smart TOC» for clear branding
- Added PHPCS with WordPress Coding Standards configuration
- Applied WordPress coding standards formatting throughout
- Fixed all PHPCS errors and warnings
- Updated minimum PHP requirement to 7.4
- Code quality improvements and cleanup
1.0.4
- Added missing ABSPATH checks and normalized line endings for Plugin Check compliance
- Bumped internal version constants to ensure cache busting for assets
- Minor documentation updates for WordPress.org submission
1.0.3
- Renamed the translation text domain to anik-smart-table-of-contents to align with the plugin slug
- Updated POT file and text-domain references throughout the admin UI
1.0.2
- Added additional security hardening
- WordPress.org review compliance improvements
1.0.1
- Improved scrolling behavior for last TOC items and removed inner scrollbar
- Added show-number option to frontend output and settings defaults
- Updated documentation links and admin assets to new slug
1.0.0
- Initial release
- Automatic TOC generation
- Smooth scroll navigation
- Collapsible TOC
- Active heading highlight
- Shortcode support
- Theme color customization
- Per-post enable/disable
- Show numbers option
- Multi-language ready




