I collect content without permission for WP Struggles*. Please visit the original sites, especially to share and comment.
Ever wrote a “post series” on your blog? If you did, you probably needed to add the links of the other parts of the series into the latest post you wrote. Each time you finished a new part, you had to update the link list of the other parts. There has to be an easier way, right?
There is. In this article, we’re going to learn how to create the “post series” functionality by using the the taxonomies and shortcodes.
The article contains 3 parts:
- Creating the taxonomy
- Creating the shortcode
- Adding the taxonomies and using the shortcode
I’ll explain almost every line of code, so you can develop it any way you like.
Step 1 Creating the Plugin File
This barely counts as a step: We’ll just create the plugin file and fill in the details of the plugin:
Save this little chunk of code in the fileor any name you like, into the folder /wp-content/plugins/post-series/.
Step 2 Setting Up Our New Taxonomy: “Series”
WordPress has a not-so-new functionality to create “taxonomies” so we can create more kinds of “classification groups” just like tags or categories (which are the built-in taxonomies of WordPress). We’re going to set up a new taxonomy called “Series” and we’ll be using this new taxonomy in our post series to help us.
First, we need to create a function to register the taxonomy. Let’s call it
Take note that we also added an action to make the function run when WordPress is ready.
Next, we’ll be using the native
register_taxonomy() function to create our taxonomy. But before that, we should set up the “labels” of the taxonomy:
We didn’t use all the labels – You can find a full reference of taxonomy labels in our article Taking WordPress Custom Taxonomies to the Next Level.
We can register the taxonomy now:
Congratulations, you just created the first half of your plugin! Now, let’s get to the second half…
Step 3 Creating the Shortcode:
In this step, we’re going to build the
[series] shortcode. With this shortcode, we’ll be able to insert the list of the series’ posts. We’ll also be able to customize the shortcode with some attributes like “
limit” and “
future” which will all be optional.
Let’s start by creating our function:
We now have an empty shortcode with 7 optional attributes! We’ll get to know them while writing the rest of the code but I should explain them now:
slug– The slug of the series, defaults to nothing
id– The ID of the series, defaults to nothing
title– The title of the output, defaults to nothing
title_wrap– The HTML tag to wrap the title with, defaults to “
list– The HTML tag to wrap the post list with, defaults to “
limit– The maximum number of posts, defaults to
future– The option to include the future posts or not, defaults to “
Next, we’ll code the “find the proper taxonomy” part:
slug” and the “
id” work in cooperation but they’re both optional: The shortcode will first look for the “
slug“, then it’ll look for the “
id“. If there’s no slug and no ID either, the shortcode will try to get the “series” taxonomy of the post that contains the shortcode.
Now, let’s code the “create the title (if it’s specified)” part:
There will be no title if the “
title” attribute is not specified. There will be a title with the
<h3> tag if the “
title_wrap” attribute is not specified. You should change the default of the attribute to something else (like
<h4>) if you use something else as subheadings.
Let’s get to the “display the future posts or not” part now:
I strongly recommend that you leave the “
future” attribute “
on” but if you don’t want to list the titles of your future posts (not drafts), you can set it to “
All right, we finished coding the attribute parts (except “
limit“). We can now get to the part where we get the posts:
- The ‘
tax_query‘ argument is defined by the
$tax_queryvariable which we created just a minute ago in the “find the proper taxonomy” part.
- The ‘
posts_per_page‘ argument is defined by the “
limit” attribute of the shortcode.
- The ‘
orderby‘ and ‘
order‘ arguments are defined to get the posts listed chronologically – the newest post will be at the bottom of the list.
- The ‘
post_status‘ argument is defined by the
$post_statusvariable which we also created above, in the “display the future posts or not” part.
Now we’re done with fetching the posts, we can put everything together and create the post list!
And the final code of our shortcode’s function will be like this:
Conclusion: Usage Examples
Usage is pretty simple:
- Create your “series” from the Posts » Series page (as if you’re creating new categories),
- Assign your posts to those “series” while writing (as if you’re choosing categories),
- Use the
[series]shortcode wherever you want!
You probably noticed this: You can use the shortcode without any attributes – if you’re using it inside your series’ posts:
But if you want to include series in pages or in a post which is not assigned to the series you’re including, you can use the “
slug” or the “
Finally, you can limit the number of posts shown, you can set a title and its heading tag, you can change the list to an ordered (numbered) list and you can prevent the future posts to be shown:
[series title="More WordPress Theme Lists" title_wrap="h4" limit="5" list="ol" future="off"]
I don’t want to paste the 100+ lines of the full source code here (the tutorial is already long) but you can download the plugin we created from here. Hope you like it!
*My WP sites serve as my reference collections and notes for everything I do or have interest in for my use only. I use copied content on this MultiSite network toni-two.com and my ESL MultiSite at toni-esl.com.