cclin Smart Table of Contents

By Chance Lin

0+ active installationsVersion 1.0.2

A lightweight, reading-focused Table of Contents (TOC) plugin optimized for long-form articles, documentation, and structured content.

Description

cclin Smart Table of Contents is a lightweight and flexible TOC plugin built specifically for long-form content, tutorials, and documentation-style websites.

This plugin focuses on reading experience, content structure, and navigation clarity, making it ideal for blogs, technical articles, and knowledge bases.

Key Features

  • Automatically extract headings from H2 to H6 (configurable)
  • Clean and structured hierarchical TOC output
  • Automatic heading numbering (1, 1.1, 1.1.1)
  • Smooth scroll navigation
  • Scrollspy support (active heading highlight while scrolling)
  • Multiple display positions:
    • Inline TOC at the top of content
    • Fixed sidebar TOC
  • Independent expand/collapse behavior for different TOC modes
  • Auto insert TOC into content
  • Support for custom post types
  • Gutenberg-compatible (works seamlessly with block editor content)
  • Fully internationalized (i18n ready)
  • Lightweight, clean OOP architecture

Designed for

cclin Smart Table of Contents is especially suitable for:

  • Long-form blog posts
  • Technical tutorials
  • Documentation websites
  • Knowledge bases
  • Structured academic or research content

Customization

Instead of requiring users to write custom CSS, the plugin provides structured options such as:

  • Heading levels selection
  • Numbering toggle
  • Display position control
  • Sticky offset settings
  • Expand / collapse behavior

This ensures both flexibility and safety while maintaining performance and compatibility.

Third-Party Libraries

This plugin bundles the following third-party library:

  • Select2 (https://github.com/select2/select2)
    License: MIT
    License file included in: /assets/vendor/select2/LICENSE

Installation

  1. Upload the plugin folder cclin-smart-toc to /wp-content/plugins/
  2. Activate the plugin through the “Plugins” menu in WordPress
  3. Go to Settings → cclin Smart TOC to configure options

FAQ

Does this plugin support Gutenberg?

Yes. The TOC is automatically rendered on the frontend and works with Gutenberg blocks.

Can I control which headings are included?

Yes. You can select which heading levels (H2–H6) should be included.

Can I disable automatic insertion?

Yes. You can disable auto-insert and use manual placement instead.

Screenshots

Changelog

1.0.2

  • Fix CSS layout issue

1.0.1

  • Remove Custom CSS feature
  • Improve security compliance
  • Minor code cleanup

1.0.0

  • Initial release