Exclude headings

[grappler]

Hello, I am working on a project where we don't all of headings add to the TOC as they are not related.

The simple text looks like this. When the shortcode is processed it outputs a title.

[testshortcode header="Test Heading"]

<h2>1. Allgemeine Voraussetzungen</h2>
<h2>2. Fördertätigkeit</h2>
<h3>2.1 Werkbeiträge</h3>

My initial idea was to add a filter so that I could remove heading from $post_content before it was processed for heading. What do you think of adding a filter to line 150 of class-content-toc.php ?

Do you have another idea how I could exclude certain headings?

[dashaluna]

@grappler by certain headings, do you mean a specific level of heading? For example, you want all headings h2 to show but not h3. If so you can do it by specifying headers attribute on the shortcode, for example:
[hm_content_toc title="TOC title" headers="h2"]

Otherwise, let me know more details on how and why specific headers should be excluded in your use case; and I'll have a think.

[grappler]

@dashaluna The heading could be h2 or h3. One of the title is part of little box on the side and the other is an unrelated title at the bottom of the page. I hope that makes sense.

[dashaluna]

@grappler sorry, I don't understand. Could you explain how your headings are marked up in the post/page content and what outcome you'd like to have in the TOC. Hopefully that will be better. The screenshot by itself is too little for me to understand what's going on.

With shortcode's headers attribute you can list any header level elements that you do want to generate TOC for. So, for example:

• [hm_content_toc title="TOC title" headers="h2"] will generate TOC for h2 headers only
• [hm_content_toc title="TOC title" headers="h2, h3"] will generate TOC for h2 and h3 headers only

[grappler]

@dashaluna For example this is our content:

<div class="content-box bg-cd-1 floatright">
<a name="heading-1" class="hm-content-toc-anchor"><h4>Wichtige Informationen für Gesuchstellende</h4></a>
<p>Merkblatt für Beitragsempfängerinnen und -empfänger</p>
</div>
<h2>1. Allgemeine Voraussetzungen</h2>
<h2>2. Fördertätigkeit</h2>
<h3>2.1 Werkbeiträge</h3>
<h4>2.1.1 Publikationen</h4>
<h4>Kontakte</h4>

We would like to exclude <h4>Wichtige Informationen für Gesuchstellende</h4> and <h4>Kontakte</h4> as it is not related to the main content but we can't exclude the h4 as it is being used in the main content. I hope this makes better sense.

[dashaluna]

@grappler oh right, I see. You can use hm_content_toc_single_item filter to test if a TOC item is the heading you want to exclude and return empty string for that.

Let me know if that worked for you and I will close the issue.

[grappler]

As a last resort it could work but that would mean I need to know what the titles are beforehand and the number of titles will accumulate across multiple pages and if I the user changes the title I would need to update the code respectively.

The titles we do not want come from two shortcodes that we are using. My initial ideas was to filter for these shortcodes.

Preferably I would remove the filter in class-content-toc.php#L144 but it is not so easy as it is an anymous function.