=== Supplyist TOC Block ===
Contributors: suppress
Donate link: https://supplyist.com/p/custom-payment/
Tags: toc, table of contents, headings, gutenberg block, navigation
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple Gutenberg block that automatically generates a nested table of contents from post headings.

== Description ==

Add the **Table of Contents Block** anywhere in your Gutenberg editor. It scans H2–H6 headings in the post content and builds a nested, clickable table of contents. Links automatically work by adding IDs to headings.

No configuration needed. Works on single posts and pages (not archives or category listings).

* No theme editing required
You can activate the plugin on any site.
* Compatible with Gutenberg / Classic Editor
It processes the final rendered HTML.
* SEO-friendly
IDs are based on sanitize_title(), the same function WP uses for slugs.
* Works with headings that already have IDs
It does not overwrite existing IDs.

**Example:**
- Structure Your Content - Write your post or page using semantic headings (H2, H3, etc.)—just like you normally would.
- Insert the Table of Contents Block - Add the "Table of Contents Block" anywhere in your editor (e.g., right after the introduction).
- Let It Work Automatically - The plugin scans your headings, builds a hierarchical, scroll-linked table of contents in real time, and updates dynamically as you edit.

### Key Features
* Server-side generated Table of Contents
* Automatically detects H2–H6 headings
* Generates nested lists based on heading hierarchy
* Automatically adds IDs to headings when missing
* Lightweight and simple
* Useful for:
  * Adding a Table of Contents to a post or page
  * Generating heading IDs
  * Linking to sections within content

### Why use this plugin?
* Smart Parsing: Supports H2 through H6 headings
* Clean Output: Uses standard HTML lists for maximum theme compatibility
* Non-intrusive: Does not modify existing heading IDs
* Lightweight & Fast

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/supplyist-toc-block/`, or install directly from the WordPress plugin directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Add the "Custom Table of Contents" block anywhere in your editor.

== Frequently Asked Questions ==

= How does "Supplyist TOC Block" generate a Table of Contents? =
The plugin scans your headings and builds a hierarchical, scroll-linked table of contents on the front end.

= Does this conflict with SEO plugins? =
If you already use SEO plugins, those may also output Table of Contents. You should avoid duplication.

= How does "heading ID insertion" work? =
1. Scans the content after it is loaded.
2. Detects all H2, H3, H4, H5, and H6 headings.
3. Generates a slug (URL-friendly string).
4. Inserts it as the heading’s id="" attribute.

== Screenshots ==

1. Screenshot of the block in editor.
2. Example of a generated "Table of Contents".

== Changelog ==
= 1.0.0 =
* Initial release.

== Upgrade Notice ==
= 1.0.0 =
Initial stable release.
