Version: 1.1.4
Like the_category(), list categories assigned to a post, but excluding assigned categories that have a child category also assigned to
Author: | Scott Reilly (profile at wordpress.org) |
WordPress version required: | 4.6 |
WordPress version tested: | 6.3 |
Plugin version: | 2.2.1 |
Added to WordPress repository: | 12-06-2009 |
Last updated: | 22-08-2023 |
Rating, %: | 0 |
Rated by: | 0 |
Plugin URI: | https://coffee2code.com/wp-plugins/parentless... |
Total downloads: | 5 071 |
Active installs: | 10+ |
Click to start download |
This plugin provides a template tag which acts as a modified version of WordPress’s built-in template tag, the_category()
. the_category()
lists all categories directly assigned to the specified post. c2c_parentless_categories()
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:
Vegetables
|-- Leafy
| |-- Broccoli
| |-- Bok Choy
| |-- Celery
|-- Fruiting
| |-- Bell Pepper
| |-- Cucumber
| |-- Pumpkin
|-- Podded
| |-- Chickpea
| |-- Lentil
| |-- Soybean
If you directly assigned the categories “Fruiting”, “Cucumber”, and “Pumpkin” to a post, c2c_parentless_categories()
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: <?php c2c_parentless_categories( ',' ); ?>
.
As with categories listed via the_category()
, categories that are listed are presented as links to the respective category’s archive page.
Example usage (based on preceding example):
<?php c2c_parentless_categories(); ?>
Outputs something like:
<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>
<?php c2c_parentless_categories( ',' ); ?></ul>
Outputs something like:
<a href="http://yourblog.com/category/fruiting/cucumber">Cucumber</a>, <a href="http://yourblog.com/category/fruiting/pumpkin">Pumpkin</a>
Links: Plugin Homepage | Plugin Directory Page | GitHub | Author Homepage
Developer Documentation
Developer documentation can be found in DEVELOPER-DOCS.md. That documentation covers the template tags and hooks provided by the plugin.
As an overview, these are the template tags provided by the plugin:
c2c_parentless_categories()
: Outputs the parentless categories.c2c_get_parentless_categories_list()
: Returns the list of parentless categories.c2c_get_parentless_categories()
: Returns the list of parentless categories for the specified post.
These are the hooks provided by the plugin:
c2c_parentless_categories
(action),c2c_get_parentless_categories_list
,c2c_get_parentless_categories
(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.c2c_parentless_categories_list
(filter) :
Customizes the return value of thec2c_parentless_categories_list()
function.c2c_get_parentless_categories_omit_ancestors
(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.
FAQ
ChangeLog