Useful Plugin Categories: TOC

Easy Table of Contents

Basic Details

Plugin Author(s): Steven Zahm

Free Version?: Yes

Premium Version?: No

My Rating: ★★★★★

General Description & Notes

By the Connections plugin author.
Fork of Table of Contents Plus by Michael Tran (not updated as of this writing)
Testing out today, 10/24/2020

From the Repository:

Features

  • Automatically generate a table of contents for your posts, pages and custom post types by parsing its contents for headers.
  • Supports the <!--nextpage--> tag.
  • Supports the Rank Math plugin.
  • Works with the Classic Editor, Gutenberg, Divi, Elementor, WPBakery Page Builder and Visual Composer page editors.
  • Optionally enable for pages and/or posts. Custom post types are supported, as long as their content is output with the the_content() template tag.
  • Optionally auto insert the table of contents into the page, selectable by enabled post type.
  • Provides many easy to understand options to configure when and where to insert the table of contents.
  • Many options are available to configure how the inserted table of contents appears which include several builtin themes. If the supplied themes do no meet you needs, you can create your own by choosing you own colors for the border, background and link color.
  • Multiple counter bullet formats to choose from; none, decimal, numeric and roman.
  • Choose to display the table of contents hierarchical or not. This means headings of lower priority will be nested under headings of higher priority.
  • User can optionally hide the table of contents. You full control of this feature. It can be disabled and you can choose to have it hidden by default.
  • Supports smooth scrolling.
  • Selectively enable or disabled the table of contents on a post by post basis.
  • Choose which headings are used to generate the table of contents. This too can be set on a post by post basis.
  • Easily exclude headers globally and on a post by post basis.
  • If you rather not insert the table of contents in the post content, you can use the supplied widget and place the table of contents in your theme‚Äôs sidebar.
  • The widgets supports being affixed or stuck on the page so it is always visible as you scroll down the page. NOTE: this is an advanced option since every theme is different, you might need support from your theme developer to learn what the correct item selector to use in the settings to enable this feature.
  • The widget auto highlights the sections currently visible on the page. The highlight color is configurable.
  • Developer friendly with many action hooks and filters available. More can be added by request on Github. Pull requests are welcomed.

Minor Problem Detected 2/4/2022 (on FTO site)

I sent this in the WP forum:

I have separated a page into six pages (using the “nextpage” tag), and I’m using the Table of Contents widget for that page (in left sidebar).

The table of contents is being generated correctly. However, the TOC link for the “current/active” page is not consistently displaying as “active” (bold). When I view source, the “active” class has not been added to the LI tag.

This is an intermittent problem. Sometimes, if I refresh my browser, the list item DOES display as active. Also, sometimes the list item for a specific page will display as active, while it does NOT at other times.

Thoughts?

Pros

  1. Simple, intuitive. You can either automatically embed TOC in a post type or add via meta box on case-by-case basis
  2. Supports CPTs that use the_content() for displaying content (Aritcles works in nwbdocs)

Notable Installations

  1. nwbdocs - Trying out at 10/24/20 on LCC Annual Membership doc article