{"id":238212,"date":"2025-07-01T08:50:26","date_gmt":"2025-07-01T08:50:26","guid":{"rendered":"https:\/\/fr.wordpress.org\/plugins\/fyp-table-of-contents\/"},"modified":"2026-01-22T06:28:51","modified_gmt":"2026-01-22T06:28:51","slug":"fyp-table-of-contents","status":"publish","type":"plugin","link":"https:\/\/frp.wordpress.org\/plugins\/fyp-table-of-contents\/","author":14378903,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2.0","stable_tag":"1.2.0","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"FYP Table of Contents","header_author":"Fran\u00e7ois Yerg","header_description":"Generate a table of contents for posts based on headings.","assets_banners_color":"434958","last_updated":"2026-01-22 06:28:51","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/buymeacoffee.com\/francoisyerg","header_plugin_uri":"","header_author_uri":"https:\/\/www.francoisyerg.net","rating":0,"author_block_rating":0,"active_installs":0,"downloads":463,"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":"francoisyerg","date":"2025-07-01 08:55:31"},"1.0.1":{"tag":"1.0.1","author":"francoisyerg","date":"2025-07-17 16:57:22"},"1.1.0":{"tag":"1.1.0","author":"francoisyerg","date":"2025-12-21 07:42:03"},"1.1.1":{"tag":"1.1.1","author":"francoisyerg","date":"2026-01-04 08:27:46"},"1.2.0":{"tag":"1.2.0","author":"francoisyerg","date":"2026-01-22 06:28:51"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3444562,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3444562,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3444562,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3444562,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.1.0","1.1.1","1.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3320444,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3320444,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Boost engagement<\/strong> \u2013 Readers navigate long articles easily, staying on your site longer","2":"3 beautiful templates<\/strong> \u2013 Default, Modern, and Horizontal layouts for any use case","3":"Smooth scrolling<\/strong> \u2013 Professional animated scroll when clicking TOC links","4":"Mobile-perfect<\/strong> \u2013 Collapsible design saves space on smartphones and tablets","5":"SEO benefits<\/strong> \u2013 Structured content Google loves, with potential for featured snippets"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[9441,254454,2859,10851,167393],"plugin_category":[43],"plugin_contributors":[92553],"plugin_business_model":[],"class_list":["post-238212","plugin","type-plugin","status-publish","hentry","plugin_tags-anchor-links","plugin_tags-article-navigation","plugin_tags-navigation-menu","plugin_tags-table-of-contents","plugin_tags-toc-generator","plugin_category-customization","plugin_contributors-francoisyerg","plugin_committers-francoisyerg"],"banners":{"banner":"https:\/\/ps.w.org\/fyp-table-of-contents\/assets\/banner-772x250.png?rev=3444562","banner_2x":"https:\/\/ps.w.org\/fyp-table-of-contents\/assets\/banner-1544x500.png?rev=3444562","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/fyp-table-of-contents\/assets\/icon-128x128.png?rev=3444562","icon_2x":"https:\/\/ps.w.org\/fyp-table-of-contents\/assets\/icon-256x256.png?rev=3444562","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/fyp-table-of-contents\/assets\/screenshot-1.png?rev=3320444","caption":"Boost engagement<\/strong> \u2013 Readers navigate long articles easily, staying on your site longer"},{"src":"https:\/\/ps.w.org\/fyp-table-of-contents\/assets\/screenshot-2.png?rev=3320444","caption":"3 beautiful templates<\/strong> \u2013 Default, Modern, and Horizontal layouts for any use case"}],"raw_content":"\n

Keep Readers Engaged - Show Them What's Coming!<\/strong><\/p>\n\n

Studies show readers are 80% more likely to finish long articles when they can see what's ahead. FYP Table of Contents automatically creates beautiful, clickable navigation that keeps visitors reading and improves your search rankings.<\/p>\n\n

What You'll Get (Real Benefits, Not Technical Features)<\/h4>\n\n

\u2713 Lower Bounce Rate<\/strong> - Readers stay longer when they can navigate easily to topics they care about\n\u2713 Better SEO Rankings<\/strong> - Google loves structured content with clear navigation (featured snippets!)\n\u2713 Increase Reading Time<\/strong> - Visitors explore more sections when they can jump directly to interesting parts\n\u2713 Professional Appearance<\/strong> - Modern designs make your content look polished and well-organized\n\u2713 Mobile-Friendly<\/strong> - Perfect navigation on smartphones where scrolling is tedious\n\u2713 Set and Forget<\/strong> - Add shortcode once or enable automatic placement, works on every heading forever\n\u2713 Faster Page Views<\/strong> - Smart caching means instant loading with zero performance impact<\/p>\n\n

Why Choose FYP Table of Contents Over Others?<\/h4>\n\n

VS Free Alternatives:<\/strong>\n- 3 Beautiful Templates<\/strong> - Others give you 1 basic boring list\n- Smart Caching System<\/strong> - Free plugins regenerate TOC on every page load (slow!)\n- Smooth Scroll Animation<\/strong> - Others just jump to sections (jarring experience)\n- Modern Design<\/strong> - Most plugins look like they're from 2010<\/p>\n\n

VS Premium Plugins ($29-$59):<\/strong>\n- Just as Powerful<\/strong> - Professional templates, smooth scrolling, toggle functionality\n- Same Performance<\/strong> - 12-hour caching and optimized code\n- Easier to Use<\/strong> - Simple shortcode vs complex configuration panels\n- Regular Updates<\/strong> - Actively maintained and WordPress compatible<\/p>\n\n

VS Manual TOC:<\/strong>\n- Save Hours<\/strong> - Automatic vs manually creating and updating links\n- Always Accurate<\/strong> - Updates automatically when you edit headings\n- No Broken Links<\/strong> - IDs are generated automatically\n- Maintenance Free<\/strong> - Add\/remove headings and TOC updates itself<\/p>\n\n

Real-World Use Cases<\/h4>\n\n

\ud83d\udcdd Long-Form Blog Posts<\/strong> - Help readers navigate 2000+ word articles efficiently\n\ud83d\udcda Tutorial & How-To Guides<\/strong> - Let users jump to specific steps they need\n\ud83d\udcc4 Documentation Sites<\/strong> - Essential for technical docs and knowledge bases\n\ud83d\udcf0 News Articles<\/strong> - Improve reader experience on in-depth reporting\n\ud83c\udf93 Educational Content<\/strong> - Students can navigate directly to topics they're studying\n\ud83d\udcbc Business Pages<\/strong> - Make long service or about pages scannable<\/p>\n\n

3 Professional Templates<\/h4>\n\n

No design skills needed - each template is beautifully crafted:<\/p>\n\n

    \n
  1. Default<\/strong> - Clean vertical list perfect for sidebars and in-content placement<\/li>\n
  2. Modern<\/strong> - Stylish design with border and highlight effects<\/li>\n
  3. Horizontal<\/strong> - Compact menu-style layout ideal for top-of-page navigation<\/li>\n<\/ol>\n\n

    Key Features<\/h4>\n\n

    \u2713 Automatic heading detection (H1-H6)\n\u2713 Smooth scroll animation to sections\n\u2713 Collapsible toggle (show\/hide)\n\u2713 Choose which heading levels to include\n\u2713 Custom titles and styling\n\u2713 SEO-friendly anchor links\n\u2713 12-hour smart caching\n\u2713 Works with any theme\n\u2713 Fully responsive design\n\u2713 No JavaScript required (progressive enhancement)\n\u2713 Translation ready<\/p>\n\n

    Simple to Use<\/h4>\n\n
      \n
    1. Add shortcode [fyplugins_table_of_contents]<\/code> to your post or<\/strong> enable automatic placement in settings<\/li>\n
    2. Done! TOC appears automatically when page has 3+ headings<\/li>\n<\/ol>\n\n

      No configuration required<\/strong> - works perfectly with default settings, customize only if you want to.<\/p>\n\n

      Part of the FYPlugins ecosystem \u2013 professional WordPress solutions trusted by thousands of websites.<\/p>\n\n

      Usage<\/h3>\n\n

      Getting Started (2 Minutes)<\/h4>\n\n
        \n
      1. Activate Plugin<\/strong> - Enable FYP Table of Contents<\/li>\n
      2. Choose Placement<\/strong> - In Table of Contents \u2192 Settings<\/strong>, select Display Mode: Automatic - Before content<\/strong> or keep Manual - Shortcode<\/strong><\/li>\n
      3. Select Post Types<\/strong> - Pick which post types should show the automatic TOC (posts, pages, custom types)<\/li>\n
      4. Add Shortcode (optional)<\/strong> - If using manual mode or overriding automatic placement<\/li>\n
      5. Done!<\/strong> - Table of contents appears automatically when content has enough headings<\/li>\n<\/ol>\n\n

        Tip: If automatic mode is on and you add the shortcode manually, the plugin will not duplicate the TOC.<\/p>\n\n

        The plugin automatically detects all headings in your content and creates a clickable navigation menu.<\/p>\n\n

        Common Use Cases<\/h4>\n\n

        Basic blog post TOC:<\/strong>\n [fyplugins_table_of_contents]<\/p>\n\n

        Automatic placement before content (no shortcode needed):<\/strong>\nEnable Display Mode: Automatic - Before content<\/strong> in settings and select the post types.<\/p>\n\n

        Tutorial with modern template:<\/strong>\n [fyplugins_table_of_contents template=\"modern\" title=\"Tutorial Steps\"]<\/p>\n\n

        Quick navigation at top:<\/strong>\n [fyplugins_table_of_contents template=\"horizontal\" title=\"Jump to Section\"]<\/p>\n\n

        Only H2 and H3 headings:<\/strong>\n [fyplugins_table_of_contents included=\"h2,h3\"]<\/p>\n\n

        Documentation with custom styling:<\/strong>\n [fyplugins_table_of_contents template=\"modern\" class=\"docs-toc\"]<\/p>\n\n

        Initially collapsed TOC:<\/strong>\n [fyplugins_table_of_contents default_toggle=\"hide\" title=\"Show Contents\"]<\/p>\n\n

        Shortcode Parameters<\/h3>\n\n

        Main Shortcode:<\/strong> [fyplugins_table_of_contents]<\/code><\/p>\n\n

        All parameters are optional. If not specified, plugin uses smart defaults.<\/p>\n\n

        Display Options<\/h4>\n\n
          \n
        • template<\/strong> \u2013 Visual style: default<\/code> (vertical list), modern<\/code> (styled box), horizontal<\/code> (menu-style)<\/li>\n
        • title<\/strong> \u2013 Heading text (e.g., \"Table of Contents\", \"Jump to Section\", \"On This Page\")<\/li>\n
        • class<\/strong> \u2013 Add custom CSS classes for styling<\/li>\n<\/ul>\n\n

          Content Selection<\/h4>\n\n
            \n
          • included<\/strong> \u2013 Which heading levels to show: h1,h2,h3,h4,h5,h6<\/code> or any combination (default: all)<\/li>\n
          • min_headings<\/strong> \u2013 Minimum headings required to show TOC (default: 3)<\/li>\n<\/ul>\n\n

            User Interaction<\/h4>\n\n
              \n
            • toggle<\/strong> \u2013 Show collapse\/expand button: true<\/code> or false<\/code> (default: true)<\/li>\n
            • default_toggle<\/strong> \u2013 Initial state: show<\/code> (expanded) or hide<\/code> (collapsed) (default: show)<\/li>\n<\/ul>\n\n

              Automatic Placement (Settings)<\/h4>\n\n
                \n
              • Display Mode<\/strong> \u2013 Manual (shortcode) or Automatic (before content)<\/li>\n
              • Post Types<\/strong> \u2013 Choose which post types get the automatic TOC<\/li>\n
              • All other options<\/strong> \u2013 Title, headings, templates, toggle, and min headings are reused for automatic mode<\/li>\n<\/ul>\n\n

                Real-World Examples<\/h4>\n\n

                Long blog post:<\/strong>\n [fyplugins_table_of_contents title=\"What You'll Learn\" template=\"modern\"]<\/p>\n\n

                Technical documentation:<\/strong>\n [fyplugins_table_of_contents included=\"h2,h3,h4\" template=\"default\"]<\/p>\n\n

                Recipe or tutorial:<\/strong>\n [fyplugins_table_of_contents title=\"Recipe Steps\" included=\"h2,h3\" toggle=\"false\"]<\/p>\n\n

                Landing page with horizontal menu:<\/strong>\n [fyplugins_table_of_contents template=\"horizontal\" included=\"h2\"]<\/p>\n\n

                Multiple TOCs on same page:<\/strong>\n [fyplugins_table_of_contents included=\"h2\" title=\"Main Topics\" class=\"main-toc\"]\n [fyplugins_table_of_contents included=\"h3,h4\" title=\"Subsections\" class=\"sub-toc\"]<\/p>\n\n\n

                Automatic Installation (Recommended)<\/h4>\n\n
                  \n
                1. Go to WordPress admin \u2192 Plugins \u2192 Add New<\/strong><\/li>\n
                2. Search for \"FYP Table of Contents\"<\/strong><\/li>\n
                3. Click \"Install Now\"<\/strong> then \"Activate\"<\/strong><\/li>\n
                4. Add shortcode to any post: [fyplugins_table_of_contents]<\/code><\/li>\n<\/ol>\n\n

                  Manual Installation<\/h4>\n\n
                    \n
                  1. Download the plugin ZIP file<\/li>\n
                  2. Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong><\/li>\n
                  3. Upload ZIP and click \"Install Now\"<\/strong><\/li>\n
                  4. Activate the plugin<\/li>\n
                  5. Add shortcode to your content<\/li>\n<\/ol>\n\n

                    Quick Test<\/h4>\n\n

                    Edit any post with multiple headings and add: [fyplugins_table_of_contents]<\/code>\nPublish and view the post to see your automatic table of contents!<\/p>\n\n\n

                    \n

                    Will this work with my theme?<\/h3><\/dt>\n

                    Yes! FYP Table of Contents works with all WordPress themes. It uses clean HTML and CSS that adapts to your theme's styling.<\/p><\/dd>\n

                    Do I need to configure anything?<\/h3><\/dt>\n

                    No! Just add the shortcode and it works. The plugin automatically detects headings and creates the table of contents. Customization is available if you want it.<\/p><\/dd>\n

                    How many headings do I need?<\/h3><\/dt>\n

                    By default, the TOC appears when your content has 3 or more headings. You can change this with the min_headings<\/code> parameter.<\/p><\/dd>\n

                    Can I choose which heading levels to include?<\/h3><\/dt>\n

                    Yes! Use the included<\/code> parameter. For example, included=\"h2,h3\"<\/code> shows only H2 and H3 headings. This is perfect when you want to skip H1 (usually your page title) or only show main sections.<\/p><\/dd>\n

                    Will it slow down my website?<\/h3><\/dt>\n

                    No! The plugin uses smart 12-hour caching, so the table of contents is generated once and reused. Impact on page load is negligible. Most sites see no measurable difference.<\/p><\/dd>\n

                    Does it work on mobile devices?<\/h3><\/dt>\n

                    100% responsive! All templates work beautifully on smartphones and tablets. The collapsible toggle is especially useful on mobile where screen space is limited.<\/p><\/dd>\n

                    Can I have multiple tables of contents on one page?<\/h3><\/dt>\n

                    Yes! Use the shortcode multiple times with different parameters. Great for long articles where you want a main TOC at the top and section-specific TOCs throughout.<\/p><\/dd>\n

                    What happens if I change my headings?<\/h3><\/dt>\n

                    The TOC updates automatically! The 12-hour cache refreshes when you edit the post, so your table of contents is always current.<\/p><\/dd>\n

                    Can I customize the appearance?<\/h3><\/dt>\n

                    Absolutely! Choose from 3 templates, add custom CSS classes, or override styles in your theme. The class<\/code> parameter makes it easy to target specific TOCs with CSS.<\/p><\/dd>\n

                    Does it work with page builders?<\/h3><\/dt>\n

                    Yes! Works with Elementor, Beaver Builder, Divi, Gutenberg, and all major page builders. Just add the shortcode in a text\/shortcode element.<\/p><\/dd>\n

                    Will this help my SEO?<\/h3><\/dt>\n

                    Yes! Table of contents with anchor links helps search engines understand your content structure. It can also generate featured snippets in Google search results (those jump links you see in search).<\/p><\/dd>\n

                    Can I translate it?<\/h3><\/dt>\n

                    Yes! The plugin is translation-ready and includes .pot file for easy translation into any language.<\/p><\/dd>\n\n<\/dl>\n\n\n

                    = 1.2.0 (January 2026) - Automatic table of contents\n- NEW:<\/strong> Automatic placement option with post type targeting (no shortcode needed)\n- UPDATED:<\/strong> FYPlugins Core to version 1.3.6<\/p>\n\n

                    1.1.1 (January 2026) - Framework Update<\/h4>\n\n
                      \n
                    • UPDATED:<\/strong> FYPlugins Core to version 1.3.4<\/li>\n
                    • IMPROVED:<\/strong> Performance optimizations in core framework<\/li>\n
                    • IMPROVED:<\/strong> Better compatibility with WordPress 6.9<\/li>\n<\/ul>\n\n

                      1.1.0 (December 2025) - Major Enhancement Release<\/h4>\n\n
                        \n
                      • NEW:<\/strong> Smart 12-hour caching system for instant loading<\/li>\n
                      • NEW:<\/strong> Smooth scroll animation when clicking TOC links<\/li>\n
                      • NEW:<\/strong> Hierarchical nested list structure (proper ul\/li)<\/li>\n
                      • NEW:<\/strong> Collapsible toggle functionality<\/li>\n
                      • NEW:<\/strong> Excluded headings filtering capability<\/li>\n
                      • NEW:<\/strong> 3 professional templates (Default, Modern, Horizontal)<\/li>\n
                      • FIXED:<\/strong> Inconsistent option keys in admin<\/li>\n
                      • FIXED:<\/strong> Missing shortcode attributes (title, class, toggle, etc.)<\/li>\n
                      • FIXED:<\/strong> Processing flag that caused multiple TOC generation<\/li>\n
                      • IMPROVED:<\/strong> SEO-friendly anchor ID generation<\/li>\n
                      • IMPROVED:<\/strong> Proper CSS and JavaScript asset enqueuing<\/li>\n
                      • IMPROVED:<\/strong> Better mobile responsiveness<\/li>\n<\/ul>\n\n

                        1.0.1 (November 2025) - Performance Update<\/h4>\n\n
                          \n
                        • NEW:<\/strong> Basic caching system for better performance<\/li>\n
                        • NEW:<\/strong> Shortcode detection to prevent unnecessary processing<\/li>\n
                        • IMPROVED:<\/strong> More efficient heading detection<\/li>\n<\/ul>\n\n

                          1.0.0 (October 2025) - Initial Release<\/h4>\n\n
                            \n
                          • Automatic table of contents generation<\/li>\n
                          • Customizable shortcode with parameters<\/li>\n
                          • Responsive design for all devices<\/li>\n
                          • Theme compatibility<\/li>\n
                          • Smart heading detection<\/li>\n
                          • Multiple instances support<\/li>\n<\/ul>","raw_excerpt":"Boost engagement and SEO with automatic table of contents. 3 beautiful templates, smart caching, smooth scrolling. Automatic or manual placement.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/238212","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=238212"}],"author":[{"embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/francoisyerg"}],"wp:attachment":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=238212"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=238212"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=238212"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=238212"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=238212"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=238212"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}