Simple Sticky TOC

Beskrivelse

Simple Sticky TOC automatically generates a sticky table of contents for single posts or pages by parsing <h2>, <h3>, and <h4> tags. It is lightweight, mobile-friendly, and works without jQuery.

Features:
– Automatically detects and anchors h2–h4 headings
– Sticky TOC with vertical layout on desktop
– Sticky toggleable TOC on mobile
– Built-in RTL support (positioning + layout)
– Option to disable TOC on individual posts
– Option to customize TOC layout from your theme
– Auto-generated anchor IDs for headings
– Clean CSS, pure JavaScript, no jQuery

Theme Override Support

To override the default markup or styles:

  1. Copy the default template files from the plugin:

    • frontend/partials/toc-template.php
    • assets/css/toc.css
    • assets/js/toc.js
  2. Paste them into your theme inside the following folder:

    • your-theme/simple-sticky-toc/

Supported override files:

  • simple-sticky-toc/toc-template.php – custom TOC markup
  • simple-sticky-toc/toc.css – custom styles
  • simple-sticky-toc/toc.js – custom JS behavior

Skærmbilleder

  • Sticky TOC on desktop
  • Toggleable TOC on mobile
  • Admin panel for depth control
  • TOC layout in RTL mode

Installation

  1. Upload the plugin folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. The TOC will appear automatically above your post content.

FAQ

Can I choose which heading levels are used?

Yes. Go to Settings BNDDSGN_Simple Sticky TOC and select the depth (h2, h2–h3, or h2–h4).

Can I disable TOC on some posts?

Yes, there’s a checkbox in the post editor sidebar to disable it per-post.

Can I change the layout or style?

Yes, copy toc-template.php, toc.css, or toc.js into your theme folder (simple-sticky-toc/) and customize freely.

Is this plugin compatible with RTL sites?

Yes, it automatically adjusts alignment and layout.

Does it work with block themes (FSE)?

Yes.

Anmeldelser

Der er ingen anmeldelser for denne widget.

Bidragsydere & udviklere

“Simple Sticky TOC” er open source-software. Følgende personer har bidraget til dette plugin.

Bidragsydere

Ændringslog

1.0.1

  • Unified unique prefixes for all plugin functions, classes, constants, and options to prevent conflicts.
  • Updated Contributors field to bonddesign.
  • Updated Stable tag to match the release version.
  • Removed macOS hidden files (.DS_Store, __MACOSX) from the distribution package.

1.0.0

  • Initial release
  • Auto-injects sticky TOC from headings (h2–h4)
  • Responsive layout with sticky toggle button on mobile
  • Per-post disable option
  • Customizable template, CSS, and JS via theme override
  • RTL support for layout and direction
  • Clean structure (no jQuery)