robfelty

<p>Collapsing Categories creates an expandable list of categories and<br />
subcategories. It can also expand to show posts. The primary usage is as a<br />
widget, but you can also use the code in your theme manually if you wish (see<br />
installation instructions)</p>
<h3>Options</h3>
<p>Options can be set<br />
from the block panel. If you wish to insert the code into your theme manually<br />
instead of using a widget, you can use the following options. These options<br />
can be given to the <code>collapsCat()</code> function either as an array or in query<br />
style, in the same manner as the <code>wp_list_categories</code> function.</p>
<pre><code>$defaults=array(
   'showPostCount' => true,
   'inExclude' => 'exclude',
   'inExcludeCats' => '',
   'showPosts' => true, 
   'showPages' => false,
   'linkToCat' => true,
   'olderThan' => 0,
   'excludeAll' => '0',
   'catSortOrder' => 'ASC',
   'catSort' => 'catName',
   'postSortOrder' => 'ASC',
   'postSort' => 'postTitle',
   'expand' => '0',
   'defaultExpand' => '',
   'postTitleLength' => 0,
   'accordion' => 0,
   'catfeed' => 'none',
   'taxonomy' => 'category',
   'showPostDate' => false,
   'postDateAppend' => 'after',
   'postDateFormat' => 'm/d',
   'useCookies' => true,
   'showTopLevel' => true,
   'postsBeforeCats' => false,
   'expandCatPost' => true,
   'debug'=>'0'
);
</code></pre>
<ul>
<li>inExclude
<ul>
<li>Whether to include or exclude certain categories
<ul>
<li>‘exclude’ (default) </li>
<li>‘include’</li>
</ul>
</li>
</ul>
</li>
<li>inExcludeCats
<ul>
<li>The categories which should be included or excluded</li>
</ul>
</li>
<li>showPages
<ul>
<li>Whether or not to include pages as well as posts. Default if false</li>
</ul>
</li>
<li>linkToCat
<ul>
<li>1 (true), clicking on a category title will link to the category archive (default)</li>
<li>0 (false), clicking on a category title expands and collapses </li>
</ul>
</li>
<li>catSort
<ul>
<li>How to sort the categorys. Possible values:
<ul>
<li>‘catName’ the title of the category (default)</li>
<li>‘catId’ the Id of the category</li>
<li>‘catSlug’ the url of the category</li>
<li>‘catCount’ the number of posts in the category</li>
<li>‘catOrder’ custom order specified in the categorys settings</li>
</ul>
</li>
</ul>
</li>
<li>catSortOrder
<ul>
<li>Whether categories should be sorted in normal or reverse<br />
order. Possible values:</p>
<ul>
<li>‘ASC’ normal order (a-z 0-9) (default)</li>
<li>‘DESC’ reverse order (z-a 9-0)  </li>
</ul>
</li>
</ul>
</li>
<li>postSort
<ul>
<li>How to sort the posts. Possible values:
<ul>
<li>‘postDate’ the date of the post (default)</li>
<li>‘postId’ the Id of the post</li>
<li>‘postTitle’ the title of the post</li>
<li>‘postComment’ the number of comments on the post</li>
<li>‘postOrder’ sort by menu order</li>
</ul>
</li>
</ul>
</li>
<li>postSortOrder
<ul>
<li>Whether post should be sorted in normal or reverse<br />
order. Possible values:</p>
<ul>
<li>‘ASC’ normal order (a-z 0-9) (default)</li>
<li>‘DESC’ reverse order (z-a 9-0)  </li>
</ul>
</li>
</ul>
</li>
<li>expand
<ul>
<li>The symbols to be used to mark expanding and collapsing. Possible values:
<ul>
<li>‘0’ Triangles (default)</li>
<li>‘1’ + –</li>
<li>‘2’ [+] [-]</li>
<li>‘3’ images (you can upload your own if you wish)</li>
<li>‘4’ custom symbols</li>
</ul>
</li>
</ul>
</li>
<li>customExpand
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be<br />
used to mark expandable link categories</li>
</ul>
</li>
<li>customCollapse
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be<br />
used to mark collapsible link categories</li>
</ul>
</li>
<li>postTitleLength
<ul>
<li>Truncate post titles to this number of characters (default: 0 = don’t<br />
truncate)</li>
</ul>
</li>
<li>accordion
<ul>
<li>When set to true, expanding one category closes all others at that level</li>
</ul>
</li>
<li>catfeed
<ul>
<li>Whether to add a link to the rss feed for a category. Possible values:
<ul>
<li>‘none’ (default)</li>
<li>‘text’ shows RSS</li>
<li>‘image’ shows an RSS icon</li>
</ul>
</li>
</ul>
</li>
<li>taxonomy
<ul>
<li>Type of taxonmy to display. Possible values:
<ul>
<li>‘category’ (default)</li>
<li>‘link_category’</li>
<li>‘post_tag’</li>
<li>‘both’ (categories and tags)</li>
<li>any other registered taxononmy (e.g. recipe press uses recipe-categories)</li>
</ul>
</li>
</ul>
</li>
<li>showPostDate
<ul>
<li>When true, show the date of each post</li>
</ul>
</li>
<li>postDateAppend
<ul>
<li>Show the date before or after the post title. Possible values:
<ul>
<li>‘after’ (default)</li>
<li>‘before’</li>
</ul>
</li>
</ul>
</li>
<li>postDateFormat
<ul>
<li>What format the post date is in. This uses the standard php date<br />
formatting codes</li>
</ul>
</li>
<li>useCookies
<ul>
<li>When true, expanding and collapsing of categories is remembered for each<br />
visitor. When false, categories are always display collapsed (unless<br />
explicitly set to auto-expand). Possible values:</p>
<ul>
<li>1 (true) (default)</li>
<li>0 (false)</li>
</ul>
</li>
</ul>
</li>
<li>showTopLevel
<ul>
<li>When set to false, the top level category will not be shown. This could<br />
be useful if you only want to show subcategories from one particular<br />
top-level category</p>
<ul>
<li>1 (true) (default)</li>
<li>0 (false)</li>
</ul>
</li>
</ul>
</li>
<li>postsBeforeCats
<ul>
<li>When set to true, posts in category X will be ordered before<br />
subcategories of category X</p>
<ul>
<li>1 (true)</li>
<li>0 (false) (default)</li>
</ul>
</li>
</ul>
</li>
<li>expandCatPost
<ul>
<li>When set to true, any category to which a post is assigned will<br />
automatically be expanded on a single post page.</p>
<ul>
<li>1 (true) (default)</li>
<li>0 (false)</li>
</ul>
</li>
</ul>
</li>
<li>showEmptyCat
<ul>
<li>When set to true, empty categories are shown
<ul>
<li>0 (false) (default)</li>
<li>1 (true) </li>
</ul>
</li>
</ul>
</li>
<li>debug
<ul>
<li>When set to true, extra debugging information will be displayed in the<br />
underlying code of your page (but not visible from the browser). Use<br />
this option if you are having problems</li>
</ul>
</li>
</ul>
<h4>Examples</h4>
<pre><code>collapsCat('catSort=ASC&expand=3&inExcludeCats=general,uncategorized')
</code></pre>
<p>This will produce a list with:<br />
* categories shown in alphabetical order<br />
* using images to mark collapsing and expanding<br />
* exclude posts from  the categories general and uncategorized</p>
<pre><code>`
</code></pre>
<p><?php<br />
                    echo '</p>
<ul>‘ . “\n”;<br />
                    if (function_exists(‘collapsCat’)) {<br />
                      collapsCat(array(<br />
                            ‘postSort’ => ‘postDate’,<br />
                            ‘postSortOrder’ => ‘DESC’,<br />
                        ) );<br />
                    } else {<br />
                      wp_get_categories(‘your_options_here’);<br />
                    }<br />
                    echo “</ul>
<p>\n”;<br />
                    ?><br />
    `</p>
<h3>Demo</h3>
<p>I use this plugin in my blog at http://robfelty.com</p>
<h3>CAVEAT</h3>
<p>Currently this plugin relies on Javascript to expand and collapse the links.<br />
If a user’s browser doesn’t support javascript they won’t see the links to the<br />
posts, but the links to the categories will still work (which is the default<br />
behavior in wordpress anyways)</p>


Collapsing Categories


	doesn't work with WP 4.9.1
	the code is terrible: it adds a big, ugly javascript in page with the widget html content. Never seen such an horror before.


Amateur work, avoid it.

doesn't work, bad coding

Adds a widget which uses Javascript to dynamically expand or collapse the set of posts for each category.

LuckyWP

<p>Creates SEO-friendly table of contents for your posts, pages or custom post types. Great customizable appearance.</p>
<h4>Features</h4>
<ul>
<li>Automatical insertion a table of contents (configure post types and position).</li>
<li>SEO-friendly: table of contents code is ready to use by Google for snippets on result page.</li>
<li>Insert by shortcode, Gutenberg block or widget.</li>
<li>Button on toolbar of the classic editor.</li>
<li>Gutenberg block into “Common Blocks”.</li>
<li>Setting the minimum number of headings to display table of contents.</li>
<li>Setting the depth of headings for table of contents.</li>
<li>Skip headings by level or text.</li>
<li>Hierarchical or linear view.</li>
<li>Numeration items: decimal or roman numbers in order or nested.</li>
<li>Customizable appearance: width, float, title font size and weight, items font size, colors.</li>
<li>Color schemes (dark, light, white, transparent, inherit from theme) and the ability to override colors.</li>
<li>Toggle Show/Hide (optionally)</li>
<li>Customizable labels.</li>
<li>Smooth scroll (optionally).</li>
<li>Setting offset top for smooth scroll.</li>
<li>Wrap table of contents with <!–noindex–> tag (optionally).</li>
<li>Pretty hash in URL (like <code>example.com/faq/#how_do_this</code>).</li>
<li>RTL support.</li>
<li>Available override global settings for a particular post.</li>
<li>Highly compatible with WordPress themes and plugins.</li>
</ul>
<h4>Auto Insert</h4>
<p>For automatical insertion a table of contents in a posts, select option “Auto Insert Table of Contents” in the plugin settings (tab “Auto Insert”).</p>
<p>Supported positions:</p>
<ul>
<li>before first heading;</li>
<li>after first heading;</li>
<li>after first block (paragraph or heading);</li>
<li>top of post content;</li>
<li>bottom of post content.</li>
</ul>
<p>You can also select post types to which the table of contents will be automatically added.</p>
<h4>Manual Insert</h4>
<p>For manual insertion a table of content in a posts, use one of the ways:</p>
<ul>
<li>button “Table of Contents” on toolbar in classic editor;</li>
<li>gutenberg block “Table of Contents”;</li>
<li>shortcode <code>[lwptoc]</code>.</li>
</ul>
<h4>Pretty hash in URL</h4>
<p>By default, hash generated as heading text (for example, <code>#How_Do_This</code>). You can change hash format in global settings, tab “Misc.”.</p>
<p>For non-English websites it is recommended to enable the <code>Intl</code> PHP extension.</p>
<h3>Compatibility</h3>
<p>LuckyWP Table of Contents was successfully tested with the following plugins:</p>
<ul>
<li>Elementor Page Builder</li>
<li>Beaver Builder and Beaver Builder Themer Add-On</li>
<li>WPBakery Page Builder</li>
<li>Oxygen</li>
<li>WordPress Multilingual Plugin (WPML), <a href="https://wpml.org/plugin/luckywp-table-of-contents/" rel="nofollow ugc">officially confirmed</a></li>
<li>Rank Math, <a href="https://rankmath.com/compatibility/luckywp-table-of-contents/" rel="nofollow ugc">officially confirmed</a></li>
<li>WP Rocket</li>
<li>Toolset Views and Toolset Access</li>
</ul>
<h3>Hooks</h3>
<h4>Filters <code>lwptoc_before</code>, <code>lwptoc_after</code></h4>
<p>Use for add custom HTML before/after the table of contents.</p>
<p>Example:</p>
<pre><code>add_filter('lwptoc_before', function ($before) {
    return '<p>Example text before TOC.</p>' . $before;
});
</code></pre>
<h4>Filter <code>lwptoc_shortcode_tag</code></h4>
<p>Use this filter for change shortcode tag name <code>[lwptoc]</code>.</p>
<p>Example:</p>
<pre><code>add_filter('lwptoc_shortcode_tag', function ($tag) {
    return 'toc';
});
</code></pre>
<h4>Filter <code>lwptoc_heading_id</code></h4>
<p>Use for modify heading ID.</p>
<p>Example:</p>
<pre><code>add_filter('lwptoc_heading_id', function ($id, $label) {
    return $id;
}, 10, 2);
</code></pre>


LuckyWP Table of Contents

It does what one expects it to do and offers tons of useful options if one wants to tweak something. Simply great!

Really nice


Tried many ToC plugins, this one is great because it looks clean, and correctly handles the default state whether it's opened or closed!


Great plugin!

This is a great plugin! Initially, I wasn't sure about installing a plugin that automatically installs table of contents on every posts, instead of selected the posts I want to show the TOC on. After using it, I came to the conclusion that:
1/ It's much better if you may uninstall the plugin, it won't require removing code from posts;
2/ The options ensure you will make TOC available on posts that realy need it. It's very well thought.

Creates SEO-friendly table of contents for your posts/pages. Works automatically or manually (via shortcode, Gutenberg block or widget).

Collapsing Categories vs LuckyWP Table of Contents