Simple Sticky TOC

Beschrijving

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

Schermafbeeldingen

Installatie

  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.

Beoordelingen

Er zijn geen beoordelingen voor deze plugin.

Bijdragers & ontwikkelaars

“Simple Sticky TOC” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

Vertaal “Simple Sticky TOC” in je eigen taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

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)