Provides a template tag like the_category() to list categories assigned to a post except those that have a child category also assigned to the post.

Scott Reilly

Peer Categories

List the categories that are peer (i.e. share the same category parent) to all lowest-level assigned categories for the specified post.

This plugin provides a template tag which acts as a modified version of WordPress’s built-in template tag, <code>the_category()</code>. <code>the_category()</code> lists all categories directly assigned to the specified post. <code>c2c_parentless_categories()</code> lists those categories, except for categories that are parents to other assigned categories.
For example, assume your category structure is hierarchical and looks like this:
<pre><code>Vegetables
|-- Leafy
| |-- Broccoli
| |-- Bok Choy
| |-- Celery
|-- Fruiting
| |-- Bell Pepper
| |-- Cucumber
| |-- Pumpkin
|-- Podded
| |-- Chickpea
| |-- Lentil
| |-- Soybean
</code></pre>
If you directly assigned the categories “Fruiting”, “Cucumber”, and “Pumpkin” to a post, <code>c2c_parentless_categories()</code> would return a list that consists of: “Cucumber”, and “Pumpkin”. Notice that since “Fruiting” was a parent to a directly assigned category, it is not included in the list.
By default, categories are listed as an HTML list. The first argument to the template tag allows you to define a custom separator, e.g. to have a simple comma-separated list of categories: <code><?php c2c_parentless_categories( ',' ); ?></code>.
As with categories listed via <code>the_category()</code>, categories that are listed are presented as links to the respective category’s archive page.
Example usage (based on preceding example):
<ul>
<li><code><?php c2c_parentless_categories(); ?></code></li>
</ul>
Outputs something like:
<pre><code><ul><li><a href="http://yourblog.com/category/fruiting/cucumber">Cucumber</a></li>
<li><a href="http://yourblog.com/category/fruiting/pumpkin">Pumpkin</a></li></ul>
</code></pre>
<ul>
<li><code><?php c2c_parentless_categories( ',' ); ?></ul></code></li>
</ul>
Outputs something like:
<pre><code><a href="http://yourblog.com/category/fruiting/cucumber">Cucumber</a>, <a href="http://yourblog.com/category/fruiting/pumpkin">Pumpkin</a>
</code></pre>
Links: <a href="https://coffee2code.com/wp-plugins/parentless-categories/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/parentless-categories/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/parentless-categories/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a>
<h3>Developer Documentation</h3>
Developer documentation can be found in <a href="https://github.com/coffee2code/parentless-categories/blob/master/DEVELOPER-DOCS.md" rel="nofollow ugc">DEVELOPER-DOCS.md</a>. That documentation covers the template tags and hooks provided by the plugin.
As an overview, these are the template tags provided by the plugin:
<ul>
<li><code>c2c_parentless_categories()</code> : Outputs the parentless categories.</li>
<li><code>c2c_get_parentless_categories_list()</code> : Returns the list of parentless categories.</li>
<li><code>c2c_get_parentless_categories()</code> : Returns the list of parentless categories for the specified post.</li>
</ul>
These are the hooks provided by the plugin:
<ul>
<li><code>c2c_parentless_categories</code> (action), <code>c2c_get_parentless_categories_list</code>, <code>c2c_get_parentless_categories</code> (filters) : 
Allows for an alternative approach to safely invoke each of the identically named functions in such a way that if the plugin were deactivated or deleted, then your calls to the functions won’t cause errors on your site.</li>
<li><code>c2c_parentless_categories_list</code> (filter) : 
Customizes the return value of the <code>c2c_parentless_categories_list()</code> function.</li>
<li><code>c2c_get_parentless_categories_omit_ancestors</code> (filter) : 
Customizes the function argument indicating if ancestor categories of all directly assigned categories (even if directly assigned themselves) should be omitted from the return list of categories.</li>
</ul>

Alternatives to Parentless Categories

Top alternatives