{"id":258676,"date":"2026-01-01T15:18:57","date_gmt":"2026-01-01T15:18:57","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/auto-table-of-contents-seo-friendly\/"},"modified":"2026-01-01T16:56:39","modified_gmt":"2026-01-01T16:56:39","slug":"aria-auto-table-of-contents","status":"publish","type":"plugin","link":"https:\/\/co.wordpress.org\/plugins\/aria-auto-table-of-contents\/","author":15728675,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.4.0","stable_tag":"1.4.0","tested":"6.8.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Aria Auto Table of Contents (SEO Friendly)","header_author":"Alireza Aminzadeh","header_description":"Automatically generate Table of Contents (TOC) with h2-h3 tags, expandable in Gutenberg blocks with schema support","assets_banners_color":"","last_updated":"2026-01-01 16:56:39","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/aryait.net","rating":0,"author_block_rating":0,"active_installs":0,"downloads":173,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4.0":{"tag":"1.4.0","author":"syeedalireza","date":"2026-01-01 16:56:39"}},"upgrade_notice":{"1.2.0":"<p>Security update: Fixed escaping issues for better security. All output variables are now properly escaped.<\/p>","1.1.0":"<p>Updated plugin name and branding. Fixed ownership verification. Requesting new slug reservation.<\/p>","1.0.0":"<p>Initial release of Aria Auto Table of Contents (SEO Friendly). Install to add powerful TOC and FAQ functionality to your WordPress site.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":{"aria-auto-table-of-contents\/faq":{"name":"aria-auto-table-of-contents\/faq","title":"FAQ (SEO)"},"aria-auto-table-of-contents\/toc":{"name":"aria-auto-table-of-contents\/toc","title":"Table of Contents"}},"tagged_versions":["1.4.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Table of Contents display on frontend","2":"Admin settings page","3":"Gutenberg TOC block in editor","4":"Gutenberg FAQ block in editor","5":"Mobile responsive design","6":"Dark mode support","7":"Active heading highlight","8":"Collapsible TOC feature"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1643,1117,186,10851,10852],"plugin_category":[55],"plugin_contributors":[253123],"plugin_business_model":[],"class_list":["post-258676","plugin","type-plugin","status-publish","hentry","plugin_tags-faq","plugin_tags-schema","plugin_tags-seo","plugin_tags-table-of-contents","plugin_tags-toc","plugin_category-seo-and-marketing","plugin_contributors-syeedalireza","plugin_committers-syeedalireza"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/aria-auto-table-of-contents.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<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>\n\n<h3>\u2728 Key Features<\/h3>\n\n<ul>\n<li><strong>Automatic TOC Generation<\/strong>: Automatically extracts h2 and h3 headings from your content<\/li>\n<li><strong>Gutenberg Block Support<\/strong>: Easily insert TOC anywhere using the Gutenberg block<\/li>\n<li><strong>SEO Optimized<\/strong>: Built-in Schema.org ItemList markup for better search engine visibility<\/li>\n<li><strong>FAQ Schema Support<\/strong>: Automatically detects and adds FAQ schema markup<\/li>\n<li><strong>Customizable<\/strong>: Control position, minimum headings, numbering, and more<\/li>\n<li><strong>Collapsible TOC<\/strong>: Users can collapse\/expand the table of contents<\/li>\n<li><strong>Smooth Scrolling<\/strong>: Beautiful smooth scroll animation when clicking TOC links<\/li>\n<li><strong>Active Heading Highlight<\/strong>: Automatically highlights the current section<\/li>\n<li><strong>RTL Support<\/strong>: Full support for right-to-left languages<\/li>\n<li><strong>Dark Mode Ready<\/strong>: Respects user's system dark mode preference<\/li>\n<li><strong>Responsive Design<\/strong>: Looks great on all devices<\/li>\n<li><strong>Lightweight<\/strong>: Minimal impact on page load speed<\/li>\n<li><strong>Developer Friendly<\/strong>: Clean, extensible code with WordPress coding standards<\/li>\n<\/ul>\n\n<h3>\ud83c\udfaf Perfect For<\/h3>\n\n<ul>\n<li>Bloggers who write long-form content<\/li>\n<li>Documentation sites<\/li>\n<li>Educational websites<\/li>\n<li>News websites<\/li>\n<li>Any site that wants to improve content navigation<\/li>\n<\/ul>\n\n<h3>\ud83d\udd27 How It Works<\/h3>\n\n<ol>\n<li>The plugin scans your content for h2 and h3 headings<\/li>\n<li>Automatically generates IDs for headings (if they don't have one)<\/li>\n<li>Creates a beautiful, accessible table of contents<\/li>\n<li>Adds Schema.org structured data for SEO<\/li>\n<li>Enables smooth scrolling and active section highlighting<\/li>\n<\/ol>\n\n<h3>\ud83d\udce6 What's Included<\/h3>\n\n<ul>\n<li>TOC Generator with smart heading detection<\/li>\n<li>Gutenberg TOC Block for manual placement<\/li>\n<li>Gutenberg FAQ Block with schema support<\/li>\n<li>Admin settings page with full customization<\/li>\n<li>Schema.org ItemList markup for TOC<\/li>\n<li>Schema.org FAQPage markup (optional)<\/li>\n<li>Beautiful, modern design<\/li>\n<li>Accessibility features (ARIA labels, keyboard navigation)<\/li>\n<\/ul>\n\n<h3>\ud83c\udf0d Developer Information<\/h3>\n\n<ul>\n<li><strong>Developer<\/strong>: Alireza Aminzadeh<\/li>\n<li><strong>Website<\/strong>: <a href=\"https:\/\/ariait.net\">ariait.net<\/a><\/li>\n<li><strong>Email<\/strong>: alireza@aryait.net<\/li>\n<li><strong>Support<\/strong>: Available through WordPress.org forums<\/li>\n<\/ul>\n\n<h3>\ud83d\udd17 Links<\/h3>\n\n<ul>\n<li><a href=\"#\">GitHub Repository<\/a><\/li>\n<li><a href=\"#\">Documentation<\/a><\/li>\n<li><a href=\"#\">Report Issues<\/a><\/li>\n<\/ul>\n\n<h3>Technical Details<\/h3>\n\n<h3>System Requirements<\/h3>\n\n<ul>\n<li>WordPress 5.8 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<li>Modern browser with JavaScript enabled<\/li>\n<\/ul>\n\n<h3>Code Standards<\/h3>\n\n<ul>\n<li>Follows WordPress Coding Standards<\/li>\n<li>Fully documented code<\/li>\n<li>Security best practices (nonce verification, data sanitization, etc.)<\/li>\n<li>Translation ready<\/li>\n<li>Accessibility compliant (WCAG 2.1 Level AA)<\/li>\n<\/ul>\n\n<h3>Performance<\/h3>\n\n<ul>\n<li>Lightweight: &lt; 50KB total assets<\/li>\n<li>Minimal database queries<\/li>\n<li>Efficient caching<\/li>\n<li>No external dependencies<\/li>\n<li>Lazy loading of scripts<\/li>\n<\/ul>\n\n<h3>Browser Support<\/h3>\n\n<ul>\n<li>Chrome (latest)<\/li>\n<li>Firefox (latest)<\/li>\n<li>Safari (latest)<\/li>\n<li>Edge (latest)<\/li>\n<li>Opera (latest)<\/li>\n<li>Mobile browsers<\/li>\n<\/ul>\n\n<h3>Developer Features<\/h3>\n\n<ul>\n<li>Clean, object-oriented code<\/li>\n<li>Singleton pattern for main classes<\/li>\n<li>WordPress hooks and filters<\/li>\n<li>Extensible architecture<\/li>\n<li>Well-documented API<\/li>\n<li>Translation ready (i18n)<\/li>\n<\/ul>\n\n<h3>Privacy Policy<\/h3>\n\n<p>This plugin does not collect, store, or transmit any user data. All processing happens on your WordPress server.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>Developed with \u2764\ufe0f by Alireza Aminzadeh<\/p>\n\n<ul>\n<li>Website: <a href=\"https:\/\/ariait.net\">ariait.net<\/a><\/li>\n<li>Support: WordPress.org forums<\/li>\n<\/ul>\n\n<h3>License<\/h3>\n\n<p>This plugin is licensed under the GPLv2 or later.<\/p>\n\n<p>Copyright (C) 2024 Alireza Aminzadeh<\/p>\n\n<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>\n\n<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>\n\n<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>\n\n<!--section=installation-->\n<h3>From WordPress Dashboard<\/h3>\n\n<ol>\n<li>Navigate to Plugins &gt; Add New<\/li>\n<li>Search for \"Aria Auto Table of Contents\"<\/li>\n<li>Click \"Install Now\"<\/li>\n<li>Activate the plugin<\/li>\n<li>Go to Settings &gt; Auto TOC SEO to configure<\/li>\n<\/ol>\n\n<h3>Manual Installation<\/h3>\n\n<ol>\n<li>Download the plugin zip file<\/li>\n<li>Extract it to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to Settings &gt; Auto TOC SEO to configure<\/li>\n<\/ol>\n\n<h3>Configuration<\/h3>\n\n<ol>\n<li>Go to Settings &gt; Auto TOC SEO<\/li>\n<li>Configure your preferred settings:\n\n<ul>\n<li>Enable\/disable auto-insert<\/li>\n<li>Choose TOC position<\/li>\n<li>Set minimum number of headings<\/li>\n<li>Customize TOC title<\/li>\n<li>Enable\/disable numbering<\/li>\n<li>Enable\/disable collapsible feature<\/li>\n<li>Enable\/disable Schema.org markup<\/li>\n<\/ul><\/li>\n<\/ol>\n\n<h3>Using Gutenberg Blocks<\/h3>\n\n<h4>TOC Block<\/h4>\n\n<ol>\n<li>Create or edit a post\/page<\/li>\n<li>Click the (+) button to add a new block<\/li>\n<li>Search for \"Table of Contents\"<\/li>\n<li>Insert the block where you want the TOC to appear<\/li>\n<li>Customize the block settings in the sidebar<\/li>\n<\/ol>\n\n<h4>FAQ Block<\/h4>\n\n<ol>\n<li>Create or edit a post\/page<\/li>\n<li>Click the (+) button to add a new block<\/li>\n<li>Search for \"FAQ (SEO)\"<\/li>\n<li>Add your questions and answers<\/li>\n<li>The plugin will automatically add FAQ schema markup<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20does%20the%20plugin%20generate%20the%20table%20of%20contents%3F'><h3>How does the plugin generate the table of contents?<\/h3><\/dt>\n<dd><p>The plugin automatically scans your post\/page content for h2 and h3 heading tags and generates a hierarchical table of contents based on these headings.<\/p><\/dd>\n<dt id='can%20i%20manually%20insert%20the%20toc%3F'><h3>Can I manually insert the TOC?<\/h3><\/dt>\n<dd><p>Yes! You can use the \"Table of Contents\" Gutenberg block to insert the TOC anywhere in your content. This will override the automatic insertion for that post.<\/p><\/dd>\n<dt id='does%20it%20work%20with%20classic%20editor%3F'><h3>Does it work with classic editor?<\/h3><\/dt>\n<dd><p>The plugin works best with Gutenberg (block editor). For classic editor users, the automatic insertion feature will still work, but block insertion requires Gutenberg.<\/p><\/dd>\n<dt id='will%20it%20slow%20down%20my%20site%3F'><h3>Will it slow down my site?<\/h3><\/dt>\n<dd><p>No! The plugin is very lightweight and optimized for performance. It only loads the necessary scripts and styles on pages where the TOC is displayed.<\/p><\/dd>\n<dt id='can%20i%20customize%20the%20appearance%3F'><h3>Can I customize the appearance?<\/h3><\/dt>\n<dd><p>Yes! The plugin includes CSS custom properties that you can override in your theme. You can also modify the settings in the admin panel.<\/p><\/dd>\n<dt id='does%20it%20support%20rtl%20languages%3F'><h3>Does it support RTL languages?<\/h3><\/dt>\n<dd><p>Yes! The plugin includes full RTL support for right-to-left languages like Arabic, Persian, and Hebrew.<\/p><\/dd>\n<dt id='what%20is%20schema.org%20markup%20and%20why%20should%20i%20use%20it%3F'><h3>What is Schema.org markup and why should I use it?<\/h3><\/dt>\n<dd><p>Schema.org markup is structured data that helps search engines understand your content better. It can improve your SEO and make your content eligible for rich snippets in search results.<\/p><\/dd>\n<dt id='can%20i%20disable%20the%20schema%20markup%3F'><h3>Can I disable the Schema markup?<\/h3><\/dt>\n<dd><p>Yes! You can enable\/disable both TOC and FAQ schema markup independently in the plugin settings.<\/p><\/dd>\n<dt id='does%20it%20work%20with%20page%20builders%3F'><h3>Does it work with page builders?<\/h3><\/dt>\n<dd><p>The plugin works best with native WordPress content. Compatibility with page builders may vary depending on how they output content.<\/p><\/dd>\n<dt id='how%20many%20heading%20levels%20does%20it%20support%3F'><h3>How many heading levels does it support?<\/h3><\/dt>\n<dd><p>Currently, the plugin supports h2 and h3 headings. This provides a good balance between detail and simplicity for most content.<\/p><\/dd>\n<dt id='can%20i%20change%20the%20toc%20position%3F'><h3>Can I change the TOC position?<\/h3><\/dt>\n<dd><p>Yes! You can choose to display the TOC before content or after the first paragraph. Use the Gutenberg block for complete control over positioning.<\/p><\/dd>\n<dt id='is%20it%20compatible%20with%20amp%3F'><h3>Is it compatible with AMP?<\/h3><\/dt>\n<dd><p>The plugin uses standard HTML\/CSS\/JavaScript and should be compatible with most AMP implementations, but specific testing is recommended.<\/p><\/dd>\n<dt id='how%20do%20i%20report%20bugs%20or%20request%20features%3F'><h3>How do I report bugs or request features?<\/h3><\/dt>\n<dd><p>Please use the WordPress.org support forum or visit our GitHub repository to report issues or request new features.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.0 - 2024-12-XX<\/h4>\n\n<ul>\n<li>Fixed security issues: Properly escape all output variables<\/li>\n<li>Added owner username to Contributors list<\/li>\n<li>Improved JSON schema output escaping<\/li>\n<\/ul>\n\n<h4>1.1.0 - 2024-10-30<\/h4>\n\n<ul>\n<li>Updated plugin name to \"Aria Auto Table of Contents (SEO Friendly)\"<\/li>\n<li>Changed slug to \"aria-auto-table-of-contents\"<\/li>\n<li>Updated text domain and block namespaces<\/li>\n<li>Fixed ownership verification issues<\/li>\n<\/ul>\n\n<h4>1.0.0 - 2024-10-21<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Automatic TOC generation from h2-h3 headings<\/li>\n<li>Gutenberg TOC block<\/li>\n<li>Gutenberg FAQ block with schema support<\/li>\n<li>Schema.org ItemList markup for TOC<\/li>\n<li>Schema.org FAQPage markup for FAQ<\/li>\n<li>Admin settings page<\/li>\n<li>Collapsible TOC functionality<\/li>\n<li>Smooth scrolling<\/li>\n<li>Active heading highlighting<\/li>\n<li>RTL support<\/li>\n<li>Dark mode support<\/li>\n<li>Responsive design<\/li>\n<li>Accessibility features<\/li>\n<\/ul>","raw_excerpt":"Automatically generate SEO-friendly table of contents from h2-h3 headings with Gutenberg block support and Schema.org markup.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/258676","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=258676"}],"author":[{"embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/syeedalireza"}],"wp:attachment":[{"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=258676"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=258676"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=258676"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=258676"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=258676"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/co.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=258676"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}