Taco Table of Contents

Taco Table of Contents is a lightweight and performant plugin that automatically generates a Table of Contents (TOC) for your long-form content.

You can choose to have the TOC automatically inserted before or after your content, or place it manually with a shortcode. It features a modern skeleton loading state and automatic scroll highlighting.

Key Features:

Flexible Placement: Automatically insert TOC before/after content or manually via [taco_toc].

Auto-Detection: Automatically scans <h1> through <h6> tags (configurable).

Collapsible Headings: Optionally select which headings should collapse under their parent tag by default

Scroll Spy: Highlights the active section in the TOC as the user scrolls down the page.

Skeleton Loader: Displays a smooth loading animation while the JavaScript calculates heading positions.

Modern Admin UI: Easy to use settings page with built-in help guide.

Smart Scrolling: Automatically jumps to the correct heading on page load if a hash is present in the URL.

Upload the taco-table-of-contents folder to the /wp-content/plugins/ directory.

Activate the plugin through the ‘Plugins’ menu in WordPress.

Go to Settings > Taco TOC to configure the plugin.

(Optional) Choose “Auto Insert – Before Content” to show the TOC on all allowed post types immediately.

How do I display the Table of Contents?

You can either:

Go to Settings > Taco TOC and set “Display Location” to “Before Content”.

Or use the shortcode [taco_toc] inside any post or page.

The TOC is empty, why?

Ensure your post has headings (e.g., H2, H3).

Check Settings > Taco TOC and ensure the “Content Selector” matches your theme’s content wrapper class (e.g., .entry-content, .post-content, #main).

Can I use the shortcode even if Auto Insert is enabled?

Yes, the shortcode will always work. If you use the shortcode on a page where auto-insert is also active, you might see two tables.

1.8.1

Fix readme

1.8.0

Feature: Added Collapsible Headings functionality. You can now define which headings collapse by default under their parent tag.

Synced internal version tracking.

1.7.0

UI/UX Overhaul: Redesigned the admin settings page for a modern look.

Added a “Help” sidebar in the settings page.

Added assets/css/taco-admin.css for admin styling.

1.6.0

Added Auto-Insert functionality (Before/After content).

Added option to select which headings (H1-H6) to include.

Removed Smooth Scroll option in favor of native behavior + JS offset correction.

Added support for multiple TOC instances on a single page.

1.5.1

Refactored codebase into standard WordPress plugin structure.

Separated CSS and JS assets.

1.0.0

Initial release.