Project

General

Profile

Actions
Copy link

Feature #16290

closed

Add Table Of Contents Block plug-in

Added by Raffi Khatchadourian over 2 years ago. Updated over 1 year ago.

Status:
Resolved
Priority name:
Normal
Assignee:
Boone Gorges
Category name:
WordPress Plugins
Target version:
2.1.5
Start date:
2022-06-23
Due date:
% Done:

0%

Estimated time:
Deployment actions:

Description

I know there's a TOC+ plug-in, and I use that one extensively. However, it's not great for adding a TOC on a particular page. Instead, it has complex configuration parameters that affect the entire site. Sometimes, I just want a TOC in a particular place. What do you think of this plug-in? https://wordpress.org/plugins/table-of-contents-block

Actions
Copy link
 #1

Updated by Raymond Hoh over 2 years ago

  • Status changed from New to Reporter Feedback

Hi Raffi,

Have you tried the [toc] shortcode with customized arguments? https://wordpress.org/plugins/table-of-contents-plus/#description-header (scroll to the Shortcodes section). You would have to use the Shortcode block when editing, but that should hopefully get you most of the way there.

If the TOC+ shortcode is missing some options and is not adequate enough, let us know.

I've added Scott as a watcher to see if he has any other ideas with regards to generating a TOC.

Actions
Copy link
 #2

Updated by scott voth over 2 years ago

Hi Ray - I don't think we have any other table of contents plugins.

Actions
Copy link
 #3

Updated by Raffi Khatchadourian over 2 years ago

scott voth wrote:

Hi Ray - I don't think we have any other table of contents plugins.

Correct. This is the only one available.

Actions
Copy link
 #4

Updated by Raffi Khatchadourian over 2 years ago

Hi Ray,

Yes, I've tried [toc], however, there is no argument for specifying the levels. Specifically, the level limit is set to 3 globally, but for a particular page, I want it set at 2. Unfortunately, I couldn't figure out a way to do this with the levels (it works with other configuration variables, interestingly). What happens is that on the page with only two levels, even though I use the shortcode, no TOC appears. The plug-in is good at not rendering tables of contents (using [no_toc]) but not so great at rendering them in special cases.

Is this something I should perhaps bring up with the developer?

Raymond Hoh wrote:

Hi Raffi,

Have you tried the [toc] shortcode with customized arguments? https://wordpress.org/plugins/table-of-contents-plus/#description-header (scroll to the Shortcodes section). You would have to use the Shortcode block when editing, but that should hopefully get you most of the way there.

If the TOC+ shortcode is missing some options and is not adequate enough, let us know.

Yes, that is indeed the case. There is no option for level limits for the shortcode.

Actions
Copy link
 #5

Updated by Boone Gorges over 1 year ago

  • Category name set to WordPress Plugins
  • Status changed from Reporter Feedback to Staged for Production Release
  • Assignee set to Boone Gorges
  • Target version set to 2.1.5

I know we're late on this, but given the limitations of our existing TOC plugin, I don't see any harm in adding a standalone block. I've added table-of-contents-block and it will be available for use after the next maintenance release. https://github.com/cuny-academic-commons/cac/commit/4a602825a3ddb9656f7e735ce4d25abed7762b43

Actions
Copy link
 #6

Updated by Boone Gorges over 1 year ago

  • Status changed from Staged for Production Release to Resolved
Actions
Copy link

Also available in: Atom PDF