{"id":271468,"date":"2026-03-10T06:22:19","date_gmt":"2026-03-10T06:22:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/custom-toc\/"},"modified":"2026-03-10T06:22:04","modified_gmt":"2026-03-10T06:22:04","slug":"supplyist-toc-block","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/supplyist-toc-block\/","author":23376629,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"1.0.0","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Supplyist TOC Block","header_author":"Supplyist Dev","header_description":"A minimal Gutenberg block that dynamically generates a Table of Contents from post headings (H2..Hn).","assets_banners_color":"f49b8e","last_updated":"2026-03-10 06:22:04","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/supplyist.com\/p\/custom-payment\/","header_plugin_uri":"https:\/\/supplyist.com\/p\/toc-block-plugin-for-wordpress\/","header_author_uri":"http:\/\/supplyist.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":106,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"suppress","date":"2026-03-10 06:22:04"}},"upgrade_notice":{"1.0.0":"<p>Initial stable release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3478802,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3478802,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1536x500.png":{"filename":"banner-1536x500.png","revision":3478802,"resolution":"1536x500","location":"assets","locale":""},"banner-768x250.png":{"filename":"banner-768x250.png","revision":3478802,"resolution":"768x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"ctb\/custom-toc":{"name":"ctb\/custom-toc","title":"Ctb Custom Toc"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3478802,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3478802,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Screenshot of the block in editor.","2":"Example of a generated \"Table of Contents\"."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[151844,19897,1753,10851,10852],"plugin_category":[43],"plugin_contributors":[248914],"plugin_business_model":[],"class_list":["post-271468","plugin","type-plugin","status-publish","hentry","plugin_tags-gutenberg-block","plugin_tags-headings","plugin_tags-navigation","plugin_tags-table-of-contents","plugin_tags-toc","plugin_category-customization","plugin_contributors-suppress","plugin_committers-suppress"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/supplyist-toc-block\/assets\/icon-128x128.png?rev=3478802","icon_2x":"https:\/\/ps.w.org\/supplyist-toc-block\/assets\/icon-256x256.png?rev=3478802","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/supplyist-toc-block\/assets\/screenshot-1.png?rev=3478802","caption":"Screenshot of the block in editor."},{"src":"https:\/\/ps.w.org\/supplyist-toc-block\/assets\/screenshot-2.png?rev=3478802","caption":"Example of a generated \"Table of Contents\"."}],"raw_content":"<!--section=description-->\n<p>Add the <strong>Table of Contents Block<\/strong> anywhere in your Gutenberg editor. It scans H2\u2013H6 headings in the post content and builds a nested, clickable table of contents. Links automatically work by adding IDs to headings.<\/p>\n\n<p>No configuration needed. Works on single posts and pages (not archives or category listings).<\/p>\n\n<ul>\n<li>No theme editing required\nYou can activate the plugin on any site.<\/li>\n<li>Compatible with Gutenberg \/ Classic Editor\nIt processes the final rendered HTML.<\/li>\n<li>SEO-friendly\nIDs are based on sanitize_title(), the same function WP uses for slugs.<\/li>\n<li>Works with headings that already have IDs\nIt does not overwrite existing IDs.<\/li>\n<\/ul>\n\n<p><strong>Example:<\/strong>\n- Structure Your Content - Write your post or page using semantic headings (H2, H3, etc.)\u2014just like you normally would.\n- Insert the Table of Contents Block - Add the \"Table of Contents Block\" anywhere in your editor (e.g., right after the introduction).\n- 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.<\/p>\n\n<h3>Key Features<\/h3>\n\n<ul>\n<li>Server-side generated Table of Contents<\/li>\n<li>Automatically detects H2\u2013H6 headings<\/li>\n<li>Generates nested lists based on heading hierarchy<\/li>\n<li>Automatically adds IDs to headings when missing<\/li>\n<li>Lightweight and simple<\/li>\n<li>Useful for:\n\n<ul>\n<li>Adding a Table of Contents to a post or page<\/li>\n<li>Generating heading IDs<\/li>\n<li>Linking to sections within content<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h3>Why use this plugin?<\/h3>\n\n<ul>\n<li>Smart Parsing: Supports H2 through H6 headings<\/li>\n<li>Clean Output: Uses standard HTML lists for maximum theme compatibility<\/li>\n<li>Non-intrusive: Does not modify existing heading IDs<\/li>\n<li>Lightweight &amp; Fast<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to <code>\/wp-content\/plugins\/supplyist-toc-block\/<\/code>, or install directly from the WordPress plugin directory.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Add the \"Custom Table of Contents\" block anywhere in your editor.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20does%20%22supplyist%20toc%20block%22%20generate%20a%20table%20of%20contents%3F\"><h3>How does \"Supplyist TOC Block\" generate a Table of Contents?<\/h3><\/dt>\n<dd><p>The plugin scans your headings and builds a hierarchical, scroll-linked table of contents on the front end.<\/p><\/dd>\n<dt id=\"does%20this%20conflict%20with%20seo%20plugins%3F\"><h3>Does this conflict with SEO plugins?<\/h3><\/dt>\n<dd><p>If you already use SEO plugins, those may also output Table of Contents. You should avoid duplication.<\/p><\/dd>\n<dt id=\"how%20does%20%22heading%20id%20insertion%22%20work%3F\"><h3>How does \"heading ID insertion\" work?<\/h3><\/dt>\n<dd><ol>\n<li>Scans the content after it is loaded.<\/li>\n<li>Detects all H2, H3, H4, H5, and H6 headings.<\/li>\n<li>Generates a slug (URL-friendly string).<\/li>\n<li>Inserts it as the heading\u2019s id=\"\" attribute.<\/li>\n<\/ol><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"A simple Gutenberg block that automatically generates a nested table of contents from post headings.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/271468","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=271468"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/suppress"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=271468"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=271468"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=271468"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=271468"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=271468"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=271468"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}