Select Primary Category

Description

Features:
* Ability to designate a primary category for posts and custom post types.
* Supports custom post types and custom taxonomies with hierarchical structure.
* Category in permalink is the primary category, if one is set.
* Shortcode for displaying posts with a specific primary category.
* CLI command for listing posts with a specific primary category.

Installation

1. Add the plugin folder to WordPress’ plugin directory.
2. Activate the plugin from Admin > Plugins.
3. Start using it.

FAQ

Installation Instructions

1. Add the plugin folder to WordPress’ plugin directory.
2. Activate the plugin from Admin > Plugins.
3. Start using it.

When using the shortcode, do I need to use the primary category’s ID, slug or name?

You can use either of them. E.g. assuming a category with ID 3, slug ‘ground-coffee’ and name ‘Ground Coffee’.
the following shortcode definitions will all work:

[posts_by_primary_category category="3"]
[posts_by_primary_category category="ground-coffee"]
[posts_by_primary_category category="Ground Coffee"]

Developers’ Notes

If you want to fetch posts belonging to a particular category (or, more generally, belonging to a particular term)
you can use this:

if ( class_exists( 'SPC_Queries' ) ) {
    /*
     * Let's fetch 10 published posts with primary category set to category ID 2.
     */
    $spc_queries =  SPC_Infrastructure_Container::get_instance()->get( 'SPC_Queries' );
    $posts = $spc_queries->get_primary_term_posts( 2, array(
        'post_status'    => 'publish',
        'posts_per_page' => 10,
        'post_type'      => 'post',
    ) );
}

You can just as well pass a category slug or name, instead of its ID, if you prefer.

Reviews

Contributors & Developers

Changelog

1.0

• Initial public release.