The great category conundrum.

It all started on one December-ish looking morning. It was the year of our lord 2013 and the snow was nowhere to be found, keeping that mind, there was a slight smell of bugs in the air. You know the type I'm talking about? The ones that don't let you sleep at night and make you go to bed at 2AM. Those kind of bugs. Thankfully the so-called "bug", I am going to describe in the rows below, is not one of those.

This was a simple one. One that started from the bottom, from the inner core of all that is holly and peaceful. So what is then?

How in the world do you get a category that has a certain parent for a post (either specific post or the current one)? Yes it's a simple question but if you close enough you'll see that none of the WordPress inner core function offer a direct solution.

Well after a long quest on the realm of the interwebs I came across many that claimed they had the answer but all of them were shams. In the end I managed to gather enough knowledge to come up with a slight deviation of a solution I found along my voyage. You can check it out below.

// Save the names and the IDs of the parent categories you want in an array
$parents = array(
   'NAME_OF_PARENT_CATEGORY' => ID_OF_THE_CATEGORY
);
// The the categories of the current post
$categories = get_the_terms( $post->ID, 'category' );

// Output parent categories and their children
foreach( $parents as $parent_name => $parent_id ):
    // Output the parent name
    echo $parent_name;
    // Create an array to hold the children
    $links = array();
    foreach( $categories as $category ):
        if( $parent_id == $category->parent ):
            // Put the category link in the array
            $links[] = '<a href="' . get_term_link( $category ) . '">' . $category->name . '</a>';
        endif;
    endforeach;
    // Join everything and output it
    echo join( ', ', $links );
 endforeach;

Ok, now let's try to understand this snippet of code. For the sake of this tutorial lets say we have a review website that covers places to eat, places to drink and places to have fun. Each one of those categories is a general one, and we have a business that is categorized with restaurants (that has the parent, places to eat) and others, like location and availability, that have different parents. So we have 3 categories on the same post and we need to output only the one that belongs to places to eat.

1. First we create an array for the parents, because maybe we have multiple categories and we need the children for all of them.
2. Ok, after that we get all the categories of the current post (eg. restaurant, location, availability).
3. We go through the parent categories that we set up on step one (eg. places to eat, places to drink, places to have fun).
4. While we are doing that we build another array where we will keep the children.
5. The next step is to go through all the categories of the current post and check if the parent of each category matches one that is available in the array we created at step one. If we find one than we add it to the array of children.
6. Joining everything is the second to last step that we need to do.
7. Finally we can output our result.

And that's it. Simple, right? I hope you enjoyed this short, simple tutorial.

Let me know if you found another solution in the comments.

Until next time, code long and prosper!

Stefan