Table of Contents Generator

@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.

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

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.

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

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

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

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

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.

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

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.

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?

@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?

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.

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.