Alireza Aminzadeh

<p>Aria Auto Table of Contents (SEO Friendly) is a lightweight and powerful WordPress plugin that automatically generates a table of contents for your posts and pages. With built-in Schema.org support and FAQ functionality, this plugin helps improve your SEO and user experience.</p>
<h3>✨ Key Features</h3>
<ul>
<li><strong>Automatic TOC Generation</strong>: Automatically extracts h2 and h3 headings from your content</li>
<li><strong>Gutenberg Block Support</strong>: Easily insert TOC anywhere using the Gutenberg block</li>
<li><strong>SEO Optimized</strong>: Built-in Schema.org ItemList markup for better search engine visibility</li>
<li><strong>FAQ Schema Support</strong>: Automatically detects and adds FAQ schema markup</li>
<li><strong>Customizable</strong>: Control position, minimum headings, numbering, and more</li>
<li><strong>Collapsible TOC</strong>: Users can collapse/expand the table of contents</li>
<li><strong>Smooth Scrolling</strong>: Beautiful smooth scroll animation when clicking TOC links</li>
<li><strong>Active Heading Highlight</strong>: Automatically highlights the current section</li>
<li><strong>RTL Support</strong>: Full support for right-to-left languages</li>
<li><strong>Dark Mode Ready</strong>: Respects user’s system dark mode preference</li>
<li><strong>Responsive Design</strong>: Looks great on all devices</li>
<li><strong>Lightweight</strong>: Minimal impact on page load speed</li>
<li><strong>Developer Friendly</strong>: Clean, extensible code with WordPress coding standards</li>
</ul>
<h3>🎯 Perfect For</h3>
<ul>
<li>Bloggers who write long-form content</li>
<li>Documentation sites</li>
<li>Educational websites</li>
<li>News websites</li>
<li>Any site that wants to improve content navigation</li>
</ul>
<h3>🔧 How It Works</h3>
<ol>
<li>The plugin scans your content for h2 and h3 headings</li>
<li>Automatically generates IDs for headings (if they don’t have one)</li>
<li>Creates a beautiful, accessible table of contents</li>
<li>Adds Schema.org structured data for SEO</li>
<li>Enables smooth scrolling and active section highlighting</li>
</ol>
<h3>📦 What’s Included</h3>
<ul>
<li>TOC Generator with smart heading detection</li>
<li>Gutenberg TOC Block for manual placement</li>
<li>Gutenberg FAQ Block with schema support</li>
<li>Admin settings page with full customization</li>
<li>Schema.org ItemList markup for TOC</li>
<li>Schema.org FAQPage markup (optional)</li>
<li>Beautiful, modern design</li>
<li>Accessibility features (ARIA labels, keyboard navigation)</li>
</ul>
<h3>🌍 Developer Information</h3>
<ul>
<li><strong>Developer</strong>: Alireza Aminzadeh</li>
<li><strong>Website</strong>: <a href="https://ariait.net" rel="nofollow ugc">ariait.net</a></li>
<li><strong>Email</strong>: alireza@aryait.net</li>
<li><strong>Support</strong>: Available through WordPress.org forums</li>
</ul>
<h3>🔗 Links</h3>
<ul>
<li><a href="#" rel="nofollow ugc">GitHub Repository</a></li>
<li><a href="#" rel="nofollow ugc">Documentation</a></li>
<li><a href="#" rel="nofollow ugc">Report Issues</a></li>
</ul>
<h3>Technical Details</h3>
<h3>System Requirements</h3>
<ul>
<li>WordPress 5.8 or higher</li>
<li>PHP 7.4 or higher</li>
<li>Modern browser with JavaScript enabled</li>
</ul>
<h3>Code Standards</h3>
<ul>
<li>Follows WordPress Coding Standards</li>
<li>Fully documented code</li>
<li>Security best practices (nonce verification, data sanitization, etc.)</li>
<li>Translation ready</li>
<li>Accessibility compliant (WCAG 2.1 Level AA)</li>
</ul>
<h3>Performance</h3>
<ul>
<li>Lightweight: < 50KB total assets</li>
<li>Minimal database queries</li>
<li>Efficient caching</li>
<li>No external dependencies</li>
<li>Lazy loading of scripts</li>
</ul>
<h3>Browser Support</h3>
<ul>
<li>Chrome (latest)</li>
<li>Firefox (latest)</li>
<li>Safari (latest)</li>
<li>Edge (latest)</li>
<li>Opera (latest)</li>
<li>Mobile browsers</li>
</ul>
<h3>Developer Features</h3>
<ul>
<li>Clean, object-oriented code</li>
<li>Singleton pattern for main classes</li>
<li>WordPress hooks and filters</li>
<li>Extensible architecture</li>
<li>Well-documented API</li>
<li>Translation ready (i18n)</li>
</ul>
<h3>Privacy Policy</h3>
<p>This plugin does not collect, store, or transmit any user data. All processing happens on your WordPress server.</p>
<h3>Credits</h3>
<p>Developed with ❤️ by Alireza Aminzadeh</p>
<ul>
<li>Website: <a href="https://ariait.net" rel="nofollow ugc">ariait.net</a></li>
<li>Support: WordPress.org forums</li>
</ul>
<h3>License</h3>
<p>This plugin is licensed under the GPLv2 or later.</p>
<p>Copyright (C) 2024 Alireza Aminzadeh</p>
<p>This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>


Aria Auto Table of Contents (SEO Friendly)

Automatically generate SEO-friendly table of contents from h2-h3 headings with Gutenberg block support and Schema.org markup.

Marc Tönsing

<p>Add a Table of Contents block to your posts and pages. The TOC is a nested list of links to all heading found in the post or page. To use it, simply add a block and search for “SimpleTOC” or just “TOC”.</p>
<p>The maximum depth of the toc can be configured in in the blocks’ sidebar among many other options. There can hide the headline “Table of Contents” and add your own by using a normal heading block.</p>
<p><a href="https://demo.tastewp.com/simpletoc" rel="nofollow ugc">Spin up</a> a new WordPress instance with the SimpleTOC plugin already installed.</p>
<h4>User Feedback</h4>
<blockquote>
<p>“It is lightweight, stable, and fully compatible with WordPress Full Site Editing. A reliable solution that integrates seamlessly and performs exactly as expected.”<br />
  — <a href="https://wordpress.org/support/topic/good-job-1889/" rel="ugc">@js100 on wordpress.org</a></p>
<p>“Does the job perfectly, and adds no bloat.”<br />
  — <a href="https://wordpress.org/support/topic/does-the-job-perfectly-and-adds-no-bloat/" rel="ugc">@clicknathan on wordpress.org</a></p>
<p>“Simple yet powerful. Great plugin that does exactly what you need.”<br />
  — <a href="https://wordpress.org/support/topic/simple-yet-powerful-106/" rel="ugc">@mixey on wordpress.org</a></p>
</blockquote>
<h4>Accessibility</h4>
<p>This plugin is designed & developed for WCAG 2.2 level AA conformance. The plugin is tested with assistive technology and intended to be accessible, however some third party plugins or themes may affect the individual accessibility on a given website. If you find an accessibility issue, please <a href="https://github.com/mtoensing/simpletoc/issues" rel="nofollow ugc">let us know</a> and we’ll try to address it promptly.<br />
Hidden TOCs use native <code><details></code> and <code><summary></code> semantics without extra ARIA references that require custom IDs.</p>
<h4>Features</h4>
<ul>
<li>Designed for Gutenberg.</li>
<li>Zero configuration: Add the SimpleTOC block to your post and that’s it. </li>
<li>Minimal and valid HTML output.</li>
<li>Utilizes the browser’s built-in details tag for a collapsible interface.</li>
<li>No JavaScript or CSS by default. Optional features such as the accordion menu, smooth scrolling, or box style add minimal assets only when enabled.</li>
<li>Optional box style for the TOC with a default gray background.</li>
<li>Style SimpleTOC with Gutenberg’s native group styling options.</li>
<li>Inherits the style of your theme.</li>
<li>Smooth scrolling effect using CSS. </li>
<li>Accessibility built-in by following web standards.</li>
<li>Optional ARIA Label and navigation role attributes.</li>
<li>Translated in <a href="https://translate.wordpress.org/projects/wp-plugins/simpletoc/" rel="nofollow ugc">multiple languages</a>. Including German, Japanese, Chinese (Taiwan), Dutch, Brazilian Portuguese, French, Spanish and Latvia.</li>
<li>Ideal for creating a Frequently Asked Questions section on your website.</li>
</ul>
<h4>Customization</h4>
<ul>
<li>Administrators can utilize global settings to supersede the individual block settings.</li>
<li>Add background and text color with Gutenberg groups.</li>
<li>Native block support for wide and full width.</li>
<li>Control the maximum depth of the headings.</li>
<li>Choose between an ordered, bullet HTML list. Or indent the list.</li>
<li>Enable a box style and choose a box color directly in the block sidebar.</li>
<li>Select a heading level or turn it into a paragraph.</li>
<li>Disable the h2 heading of the TOC block and add your own.</li>
</ul>
<h4>Compatibility</h4>
<ul>
<li>GeneratePress and Rank Math support.</li>
<li>Works with popular AMP plugins.</li>
</ul>
<h4>How to contribute</h4>
<p>SimpleTOC is open-source and developed on <a href="https://github.com/mtoensing/SimpleTOC" rel="nofollow ugc">GitHub Pages</a>. If you find a bug or have an idea for a feature please feel free to contribute and create a pull request.</p>
<h3>Credits</h3>
<p>This plugin is forked from <a href="https://github.com/pdewouters/gutentoc" rel="nofollow ugc">pdewouters</a> and uses code from <a href="https://github.com/shazahm1/Easy-Table-of-Contents" rel="nofollow ugc">Easy-Table-of-Contents</a></p>
<p>Many thanks to <a href="https://tomjn.com" rel="nofollow ugc">Tom J Nowell</a> and and Sally CJ who both helped me a lot with my questions over at wordpress.stackexchange.com</p>
<p>And many more thanks to all the <a href="https://github.com/mtoensing/simpletoc/graphs/contributors" rel="nofollow ugc">developers on GitHub</a> who helped me making SimpleTOC what it is today!</p>
<p>Thanks to Quintus Valerius Soranus for inventing the Table of Contents around 100 BC.</p>


SimpleTOC – Table of Contents Block

This is the simplest plugin which works perfectly what it is meant for.

Awesome Plugin

<p>I like the plugin a lot. It's simple. It works pretty well and has a few configurations but not too many. Thanks for it!<br />(I am using it to learn Wordpress blocks development, which coming from PHP I think it's quite a challenge. Blocks change the development weight from PHP to JS/React a lot!)</p>

Simple TOC it's just ... simple


Creating and maintaining a plugin requires a significant amount of effort and dedication. It is not a task that can be undertaken by everyone, as it requires an individual with a genuine interest and energy to deliver a product that evolves from being good enough to becoming a perfect product.



We encountered some challenges while using your plugin, but we were pleased to discover that the issue was addressed before we could even report it. We would like to express our sincere appreciation for your active development efforts, which have resulted in the release of version 6.0.2.


Lightweight, effective, actively-maintained


I tested 8-10 table of contents plugins for keyboard and screen reader accessibility and this plugin was by far the best. There was one issue with the accordion that caused a problem for screen reader users, so I opened a support forum thread and the developer released a fix within a few hours. Wow!



This plugin is easy to use, has great HTML markup, and it's refreshing to find a developer who takes accessibility seriously. I'd give it 10 stars if I could. Don't even look for another table of contents plugin.


Great plugin that prioritizes accessibility!


If you add this block/plugin and try to use Back to Top feature in GeneratePress it will turn something that works into something that takes 15s to scroll to very top.



At first I thought maybe I needed to create a function to change the speed but nope, it's this plugin....


Does not have GeneratePress Support — Adds Lag / Delay to Back to Top


Simple, easy to style, to the point and most importantly – works in FSE templates out of the box. No annoying nags in the WP Admin. Thanks!


Works in FSE templates


This is an excellent plugin that easily adds table of contents in your posts / pages and it provides links to the relevant headings.



Does exactly what I want and I would highly recommend it if you are looking for an easy to use tale of contents block plugin.



Thanks so much for sharing.


Great plugin that works really well


Comparing this to the "Table Of Contents Block" by WPDeveloper, I prefer this one because:




It just works automatically.



It has less options, but just enough to do what you need.



It adds nothing to the frontend to cause bloat. No CSS, no JS. At least not right out of the box. Additional settings can be enabled that will add these, but it's nice that we have the option!




This is an example of what a well-written plugin should be.


Does the job perfectly, and adds no bloat

SEO-friendly Table of Contents Gutenberg block. No JavaScript or CSS by default.

Aria Auto Table of Contents (SEO Friendly) vs SimpleTOC – Table of Contents Block