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.

WPJoli

<p><strong>Joli Table Of Contents</strong> is the most customizable and performance-focused table of contents plugin for WordPress. It works out of the box for beginners — thanks to a built-in <strong>Onboarding Wizard</strong> — and offers deep control for advanced users and developers.</p>
<p>Easily insert a table of contents into all your posts with either the <strong>Auto-insert</strong>, the Gutenberg <strong>Block</strong>, or the <strong>Shortcode</strong>.</p>
<p><a href="https://wpjoli.com/docs/joli-table-of-contents/" title="Joli Table Of Contents Documentation" rel="nofollow ugc">📖 Documentation</a> | <a href="https://wpjoli.com/joli-table-of-contents/" title="Joli Table Of Contents Pro" rel="nofollow ugc">⭐ Get PRO</a></p>
<h3>🚀 Why Joli Table Of Contents?</h3>
<h3>✅ Beginner-Friendly Onboarding Wizard</h3>
<p>After activation, a <strong>step-by-step setup wizard</strong> walks you through the most important settings — no configuration headaches, no reading documentation. You’ll have a working, good-looking TOC in minutes.</p>
<h3>🎨 Instant Customization with the Color Palette System</h3>
<p>The new <strong>Color Palette</strong> makes customization effortless. Set just the <strong>Accent color</strong> and it automatically propagates across your entire TOC — that’s 90% of the visual work done in a single click. Fine-tune everything else at your own pace.</p>
<h3>🧠 Smart Heading Detection</h3>
<p>Joli Table Of Contents accurately detects headings from <strong>third-party shortcodes and blocks</strong> that don’t appear directly in the editor but are rendered on the front end. Since v3, you can now choose between <strong>Content</strong> scope (default — prevents unwanted headings from appearing) and <strong>Extended</strong> scope for advanced use cases.</p>
<h3>🆕 Gutenberg Block with Inline Editing</h3>
<p>Use the dedicated <strong>Gutenberg Block</strong> to insert a table of contents anywhere in your post. The block lets you <strong>hide or edit specific headings</strong> inline — no settings page needed.</p>
<h3>⚡ Performance First</h3>
<p>No jQuery dependency. Minified CSS and JavaScript. Conditional style loading based on active settings — only the code you need is loaded. Built for fast websites.</p>
<h3>🔁 Migrate from Another TOC Plugin — Without Touching Your Content</h3>
<p>Already using <strong>Easy Table of Contents</strong>, <strong>LuckyWP Table of Contents</strong>, or another plugin? You can switch to Joli TOC <strong>without updating a single shortcode</strong> across your posts.</p>
<p>Use the built-in filter to map Joli TOC to your existing shortcode tag:</p>
<pre><code>add_filter('jolitoc_shortcode_tag', function(){ return 'toc'; });
</code></pre>
<p>This works with any custom tag, so your existing <code>[toc]</code> (or any other) shortcodes continue to work immediately after switching.</p>
<h3>✨ Key Features</h3>
<p><strong>Design & Themes:</strong><br />
* Professional looking themes (Default, Original, Hero, + all legacy themes)<br />
* Dark mode support for v3 themes<br />
* Color Palette system — set one color, style the whole TOC<br />
* Fully customizable: padding, margin, borders, fonts, colors, icons<br />
* Custom CSS support<br />
* CSS variable architecture for deep theming<br />
* Custom theme engine (create your own theme)</p>
<p><strong>Insertion methods:</strong><br />
* Auto-insert (by post type and position)<br />
* Gutenberg Block<br />
* Shortcode <code>[joli-toc]</code></p>
<p><strong>Auto-insert positions:</strong><br />
* Before/After the content<br />
* Before/After H1<br />
* Before first H2 / After first H2<br />
* After first paragraph</p>
<p><strong>Headings & Detection:</strong><br />
* Detect headings from third-party blocks and shortcodes<br />
* Heading scope: Content (default) or Extended<br />
* Show headings by custom depth (H2 to H6)<br />
* Hide or edit specific headings via the block<br />
* Disable headings by text or CSS class</p>
<p><strong>Navigation & UX:</strong><br />
* Reading time estimate <em>(new in v3)</em><br />
* Hierarchical or Flat view<br />
* Multiple numbering styles (with regional number support)<br />
* Customizable numbering separator and suffix<br />
* Smooth scrolling<br />
* Folding/unfolding with animation<br />
* Pretty URL hash (e.g. <code>mysite.com/article/#section-title</code>)<br />
* Latin & non-latin character support<br />
* Multilingual hash transliteration<br />
* Responsive — hover events work as touch on mobile</p>
<p><strong>Other:</strong><br />
* Import / Export settings<br />
* Import presets for quick setup<br />
* Custom CSS section<br />
* Fully responsive<br />
* <code></code> multi-page support<br />
* RTL support<br />
* WPML compatible<br />
* No jQuery<br />
* Developer hooks (<a href="https://wpjoli.com/docs/joli-table-of-contents/developer-hooks/" rel="nofollow ugc">see full list</a>)</p>
<h3>⭐ What’s New in v3</h3>
<h3>🧙 Onboarding Wizard</h3>
<p>New users are greeted with a <strong>step-by-step onboarding wizard</strong> that configures the most important settings for their site — without needing to touch advanced options.</p>
<h3>🎨 Color Palette System</h3>
<p>A brand-new <strong>reusable color palette</strong> makes customization fast and consistent. Define your Accent color once and watch it style your entire TOC automatically.</p>
<h3>🖼 New & Updated Themes</h3>
<p>v3 ships with new and upgraded themes: <strong>Default</strong> (replaces Basic Light/Dark), <strong>Original</strong>, and <strong>Hero</strong> — all with dark mode support and theme-specific style variants.</p>
<h3>🎛 Redesigned Settings Page</h3>
<p>The admin interface has been fully redesigned with:<br />
* A <strong>search bar</strong> to quickly find any setting<br />
* A <strong>Live Preview</strong> panel — see your changes in real time<br />
* A <strong>Quick Settings Panel</strong> for the most common options<br />
* Better color pickers with palette support<br />
* Session checker to prevent lost changes</p>
<h3>📐 New Style Options</h3>
<p>New styling controls include: header border style/width/radius/color, numbering badge colors, base font size, and toggle button styles.</p>
<h3>🔢 Improved Numbering System</h3>
<p>The numbering engine has been upgraded to behave like a proper list — including support for <strong>regional numbering</strong> formats. Hexadecimal and binary modes have been removed.</p>
<h3>📍 TOC Alignment</h3>
<p>Choose between <strong>left, center, and right</strong> alignment for the entire TOC block.</p>
<h3>📖 Reading Time Estimate</h3>
<p>Automatically display an estimated reading time inside the TOC header.</p>
<h3>🔒 PRO Features</h3>
<p><a href="https://wpjoli.com/joli-table-of-contents/" rel="nofollow ugc"><strong>Get Joli Table Of Contents Pro <span aria-hidden="true" class="wp-exclude-emoji">→</span></strong></a></p>
<p><strong>Premium Themes:</strong></p>
<p><strong>Widgets:</strong><br />
* 🆕 <strong>Timeline TOC</strong> — display the TOC as a visual timeline on the side of the screen, with proportionally spaced markers<br />
* ✅ <strong>Floating TOC Widget</strong> — follows the user as they scroll, shows the active section<br />
* ✅ <strong>Slide-Out TOC Widget</strong> — fixed panel on the side of the screen<br />
* ✅ <strong>Sticky Sidebar TOC</strong> — TOC in a sidebar widget that sticks while scrolling<br />
* ✅ <strong>Progress Bar Widget</strong> — reading progress indicator at the top of the page</p>
<p><strong>PRO-only customization:</strong><br />
* ⭐ <strong>Collapsible headings</strong><br />
* ⭐ <strong>View more button</strong> (Partial fold)<br />
* ⭐ Independent top-level heading styling<br />
* Separator between top-level headings<br />
* Multi-columns mode<br />
* Per-device TOC visibility (in-content vs. sidebar)<br />
* Fade past headings</p>
<p><strong>Advanced auto-insert rules:</strong><br />
* Filter by post type, post title, or post ID<br />
* Exclude specific posts by title or ID<br />
* Different settings per post type (theme, layout, everything)</p>
<p><strong>Custom Post Type support</strong> with per-post-type settings.</p>
<h3>🔧 Shortcode</h3>
<p>Insert the TOC anywhere using the shortcode:</p>
<pre><code>[joli-toc]
</code></pre>
<p><strong>Migrating from another plugin?</strong> Keep your existing shortcode tag without updating any content:</p>
<pre><code>add_filter('jolitoc_shortcode_tag', function(){ return 'toc'; });
</code></pre>
<p>This is compatible with shortcode tags used by <strong>Easy Table of Contents</strong>, <strong>LuckyWP Table of Contents</strong>, and others.</p>
<h3>🎣 Developer Hooks</h3>
<p>Joli Table Of Contents provides a full set of action and filter hooks for developers.</p>
<p><a href="https://wpjoli.com/docs/joli-table-of-contents/developer-hooks/" rel="nofollow ugc">View all available hooks <span aria-hidden="true" class="wp-exclude-emoji">→</span></a></p>
<p><strong>Common examples</strong> (add to your theme’s <code>functions.php</code>):</p>
<p>Disable auto-insert globally:<br />
    add_filter(‘joli_toc_disable_autoinsert’, function(){ return true; });</p>
<p>Disable JS or CSS:<br />
    add_filter(‘joli_toc_disable_js’, function(){ return true; });<br />
    add_filter(‘joli_toc_disable_styles’, function(){ return true; });</p>
<p>Customize the TOC title dynamically:<br />
    add_filter(‘joli_toc_toc_title’, function( $title ){ return ‘My Custom Title’; });</p>
<h3>🔌 More Plugins by WPJoli</h3>
<ul>
<li><a href="https://wordpress.org/plugins/smart-auto-featured-image/" rel="ugc">Smart Auto Featured Image</a></li>
<li><a href="https://wordpress.org/plugins/zenform/" rel="ugc">ZenForm</a></li>
<li><a href="https://wordpress.org/plugins/joli-faq-seo/" rel="ugc">Joli FAQ SEO</a></li>
<li><a href="https://wordpress.org/plugins/joli-clear-lightbox/" rel="ugc">Joli CLEAR Lightbox</a></li>
</ul>

Joli Table Of Contents

The best Table of Contents plugin for WordPress. Auto or manual insert, Gutenberg Block, beautiful themes, onboarding wizard, and deep customization.

Aria Auto Table of Contents (SEO Friendly) vs Joli Table Of Contents