Directory / plugin

Raoa ToC Linker

v1.0.0 · by RaoaTech

Automatically Generate a Table of Contents for Posts and Pages. Supports auto-insert, shortcode, and a sidebar widget.

View on WordPress.org

About this plugin

Raoa ToC Linker makes long-form WordPress content easier to scan. It reads headings from rendered post content, assigns stable anchor IDs, and builds a navigable table of contents.

You can insert the table of contents automatically, place it with a shortcode, or show it in a sidebar widget. Authors can override behavior per post. Readers get smooth scrolling, optional URL hashes, a collapsible list, and widget highlighting for the section in view.

Features

  • Automatic heading detection from rendered HTML (the_content)
  • Compatible with the Classic Editor, the block editor, and Elementor output (no Elementor PHP dependency)
  • Auto-insert before the first heading, after the first paragraph, or after a chosen paragraph
  • Shortcode [raoa_toc_linker] with attributes for title, levels, theme, and more
  • Sidebar widget with optional sticky positioning and active-section highlight
  • Appearance presets (Default, Minimal, Bordered, Dark, Custom colors)
  • Hierarchical or flat lists, optional counters, collapsible toggle
  • Per-post enable, heading levels, and insert mode (Classic meta box and block editor)
  • Smooth scroll with offset, optional URL hashes, and respect for reduced motion
  • Developer actions, filters, and helper functions

Shortcode

[raoa_toc_linker]

Optional attributes include title, levels, hierarchical, counter, theme, collapsible, hidden, smooth_scroll, anchors, offset, class, and label.

Privacy

Raoa ToC Linker does not send data to remote services. It does not track readers. Settings are stored in the WordPress options table; per-post overrides are stored as post meta.

Plugin tags