Moodle Plugins directory: Table of Contents Generator: Comments

Sunday, 4 June 2023, 8:13 PM - S G

Sun, 04 Jun 2023 12:13:35 GMT

by S G.

@Zabelle Motte
Thank you for the patch.

Installed and tested on Moodle 4.1.3+ (Build: 20230602)

It is working as expected. Will update here and on Github if I see any issues.

Friday, 31 March 2023, 8:17 PM - Zabelle Motte

Fri, 31 Mar 2023 12:17:47 GMT

by Zabelle Motte.

I proposed a patch that seems to make this plugin work on Moodle 4, but do not hesitate to test and to comment.
https://github.com/benchen71/moodle-filter_toc/issues/5

Thursday, 8 April 2021, 3:52 PM - Ben Chenoweth

Thu, 08 Apr 2021 07:52:30 GMT

by Ben Chenoweth.

Hi Zabelle,
Sorry, but I am no longer able to support this plugin. I am not currently working at a place that uses Moodle, so I cannot do the required testing of any changes made to the code. The code itself is located at https://github.com/benchen71/moodle-filter_toc.

Thursday, 8 April 2021, 12:11 AM - Zabelle Motte

Wed, 07 Apr 2021 16:11:23 GMT

by Zabelle Motte.

Great thanks fot this plugin that helps us to make documentation pages with table of content.
We have one suggestion for that plugin.
As far as we use a custom theme, we need to style the "a" tags that support the table of content, so that vertical alignment is correct.
It would be great to a a specific class on "a" tags added in filter.php line (lines 78 et 80).

Kisses

Zabelle

Saturday, 2 May 2020, 12:18 PM - Ben Chenoweth

Sat, 02 May 2020 04:18:22 GMT

by Ben Chenoweth.

Yes, it won't appear here, because this is the course homepage. The TOC filter only applies to in-course content pages.

Saturday, 2 May 2020, 11:03 AM - Ben Chenoweth

Sat, 02 May 2020 03:03:56 GMT

by Ben Chenoweth.

The TOC won't appear on the course outline, just on the individual pages.

Saturday, 2 May 2020, 10:55 AM - Tim Tarbotton

Sat, 02 May 2020 02:55:39 GMT

by Tim Tarbotton.

Hi Ben, thanks for the reply. On the course page I can see the "Table of Contents Generator" under Course Administration > Filters and this is turned on which is why I thought I had to add [contents] as it does not show the TOC at the top of my course page as expected? My course pages are default Moodle pages (nothing fancy) so perhaps there could be a bug with my version of Moodle? I believe i am on Moodle 3.4.2+ (Build: 20180421) - Once again, thanks for the response. Tim

Saturday, 2 May 2020, 10:48 AM - Ben Chenoweth

Sat, 02 May 2020 02:48:48 GMT

by Ben Chenoweth.

It's been a while since I've worked on a Moodle site. My recollection is that if the plugin is enabled, the TOC appears at the top of a page automatically. You only have the add [contents] if you want the TOC to appear elsewhere. The TOC is generated using a Moodle filter, so look for the plugin to appear in the list of filters for a specific page.

Saturday, 2 May 2020, 10:32 AM - Tim Tarbotton

Sat, 02 May 2020 02:32:07 GMT

by Tim Tarbotton.

Hi there, i have installed your plugin and its enabled. I was expecting this TOC to appear at the top of my course pages but I can't seem to see it? I am not a developer but wondered how exactly do you add [contents] to the top of the page? I definitely have a range of h1 h2 h3 h4 text on the course page. Is there somewhere in the Moodle course menu or site admin I can do this? Or do I add it within an activity? Sorry if this is a silly question, It may be beyond my depth of knowledge. Appreciate the help. Tim

Tuesday, 20 November 2018, 8:35 AM - Ben Chenoweth

Tue, 20 Nov 2018 00:35:03 GMT

by Ben Chenoweth.

The instructions for modifying the CSS are given above. You have to add to your custom CSS, using the .toc class. For example,

/* Hide bullets in TOCs */
.toc ul {
list-style: none;
}

There are no bugs that I am aware. My only guess is that all of the headings on your page are h4 headings. So when you remove h4 from the settings, there are no headings left to generate a TOC.

Monday, 19 November 2018, 4:38 PM - Sa Ku

Mon, 19 Nov 2018 08:38:02 GMT

by Sa Ku.

Also, when I remove h4 from the settings, the entire TOC disappears from the topic. This happens when I try to make changes to global and local settings. Is that a known bug?

Monday, 19 November 2018, 4:34 PM - Sa Ku

Mon, 19 Nov 2018 08:34:00 GMT

by Sa Ku.

@Ben: Thanks for your reply. Can you please help me understand is how and where to update the [contents] and how to modify the CSS of the TOC?

Monday, 19 November 2018, 2:39 PM - Ben Chenoweth

Mon, 19 Nov 2018 06:39:04 GMT

by Ben Chenoweth.

Sa Ku, that's an interesting suggestion, but it is not currently possible at the moment. The only customisation regarding placement of the TOC is to put

[contents]

where you want the TOC to appear on the page itself.

Monday, 19 November 2018, 1:29 PM - Sa Ku

Mon, 19 Nov 2018 05:29:38 GMT

by Sa Ku.

How to change the location of the TOC? For instance, I would like to add this to the Right side block and as a floating one.

Friday, 29 September 2017, 7:23 PM - David Mudrák

Fri, 29 Sep 2017 11:23:28 GMT

by David Mudrák.

I am happy to announce that Ben Chenoweth became a new maintainer of this plugin and hopefully will be able to release an update for more recent Moodle versions soon. Good luck Ben, and thanks for your offer to maintain this!