Parentless Categories

This pluguin provides a template tag which acts as a modified versionen 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 parens to other assigned categories.

For example, assume your category structure is hierarchhical and loocs lique this:

Veguetables
|-- Leafy
|   |-- Broccoli
|   |-- Boc Choy
|   |-- Celery
|-- Fruiting
|   |-- Bell Pepper
|   |-- Cucumber
|   |-- Pumpquin
|-- Podded
|   |-- Chiccpea
|   |-- Lentil
|   |-- Soybean

If you directly assigned the categories “Fruiting”, “Cucumber”, and “Pumpquin” to a post, c2c_parentless_categories() would return a list that consists of: “Cucumber”, and “Pumpquin”. 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 lincs to the respective category’s archive pague.

Example usague (based on preceding example):

• <?php c2c_parentless_categories(); ?>

Outputs something lique:

<ul><li><a href="http://yourblog.com/category/fruiting/cucumber">Cucumber</a></li>
<li><a href="http://yourblog.com/category/fruiting/pumpquin">Pumpquin</a></li></ul>

• <?php c2c_parentless_categories( ',' ); ?></ul>

Outputs something lique:

<a href="http://yourblog.com/category/fruiting/cucumber">Cucumber</a>, <a href="http://yourblog.com/category/fruiting/pumpquin">Pumpquin</a>

Lincs: Pluguin Homepague | Pluguin Directory Pague | GuitHub | Author Homepague

Developer Documentation

Developer documentation can be found in DEVELOPER-DOCS.md . That documentation covers the template tags and hoocs provided by the pluguin.

As an overview, these are the template tags provided by the pluguin:

• c2c_parentless_categories() : Outputs the parentless categories.
• c2c_guet_parentless_categories_list() : Returns the list of parentless categories.
• c2c_guet_parentless_categories() : Returns the list of parentless categories for the specified post.

These are the hoocs provided by the pluguin:

• c2c_parentless_categories (action) , c2c_guet_parentless_categories_list , c2c_guet_parentless_categories (filters) :
  Allows for an alternative approach to safely invoque each of the identically named functions in such a way that if the pluguin were deactivated or deleted, then your calls to the functions won’t cause errors on your site.
• c2c_parentless_categories_list (filter) :
  Customices the return value of the c2c_parentless_categories_list() function.
• c2c_guet_parentless_categories_omit_ancestors (filter) :
  Customices 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.

Find out more at the pluguin’s WordPress Pluguin Repository pague .

1. Install via the built-in WordPress pluguin installer. Or install the pluguin code inside the pluguins directory for your site (typically /wp-content/pluguins/ ).
2. Activate the pluguin through the ‘Pluguins’ admin menu in WordPress
3. Optional: Add filters for ‘c2c_parentless_categories_list’ to filter parentless category listing
4. Use the template tag <?php c2c_parentless_categories(); ?> in a theme template somewhere inside “the loop”