This post is part of a series called The Beginner’s Guide to WordPress Taxonomies.
The Beginner’s Guide to WordPress Taxonomies: Themes or Plugins?
Throughout this series, we've been taking a look at WordPress taxonomies: what they are, how they work, how to differentiate them between the different types that exist, and how they're stored in the underlying database.
The only thing we've yet to do is actually put together a plugin that demonstrates how to use the API to implement our own custom taxonomies. So in this post, we're going to do exactly that. 
Recall from the first post in this series:
Taxonomy is one of those words that most people never hear or use. Basically, a taxonomy is a way to group things together.
And throughout this series, we've been using photography and videography as our examples of classifications. So for the plugin that we're going to build, we'll include both hierarchical and non-hierarchical taxonomies relevant to both of these classifications.
  1. The hierarchical taxonomies will include base taxonomies of Photographsand Videos.
  2. The non-hierarchical taxonomy will be for specifying the type of film that was used. This may be Black and White, Color, Sepia, or whatever color you would like to specify.
Finally, the plugin is going to work with the existing standard post type that ships with WordPress. This should give the most flexibility as it relates to building a plugin, demonstrating the concepts, and using it in your own installation.
For the purposes of the example plugin, we're going to be calling it My Custom Taxonomies and we'll be building it in the following stages:
  1. We'll prepare the core plugin file that has the proper header text necessary to display the plugin in the WordPress dashboard.
  2. We'll setup the code necessary for executing the core plugin.
  3. We'll write code that will introduce both the Photographs and Videos taxonomy.
  4. We'll write code that will introduce the Film Type taxonomy.
  5. We'll then test the full plugin.
Before doing anything else, go ahead and create a directory in wp-content/pluginscalled my-custom-taxonomies and introduce a file called my-custom-taxonomies.php.
My Custom Taxonomies Directory
Within the file, add the following code comment block:
At this point, you should be able to login to the WordPress dashboard, see the name of the plugin, and activate it. Of course, nothing will actually happen since we haven't done anything with the source code yet.
Next, we need to create another file that will be used to actually power the plugin. This will be based on object-oriented programming principles so we'll create a file called class-my-custom-taxonomies.php.
Don't worry about populating it with any source code just yet. Let's return back tomy-custom-taxonomies.php and add a conditional to make sure that the core plugin file can't be run outside of the WordPress environment.
Place this directly under the code comment that we provided above.
At this point, we're ready to write code that will actually drive the plugin. So let's define the class and a basic function for initialization:
After that, let's return to my-custom-taxonomies.php and add a code to include the file as well as a method that will create an instance of the class and execute it:
Now we have everything we need to begin actually setting up our hooks and callbacks to create our custom taxonomies.
At this point, we're ready to begin introducing our taxonomies. We'll first focus on our two hierarchical taxonomies - Photographs and Videos.
In the body of the class of class-my-custom-taxonomies.php file, add the following function:
This function is responsible for creating the Photographs taxonomy and will be called from within the init function when the time is right.
Now, let's do the same thing for Videos:
Let's call these two from within the init function. We do this by registering these functions with the init hook as provided by WordPress:
Here, we should be able to head over to Add New Post and see our new taxonomy options visible in the dashboard. If not, double-check your code against that which is shared above.
Photograph and Video Categories
Now that we've introduced our hierarchical taxonomies, let's move on to introducing our Film Type - or our non-hierarchical - taxonomy.
This really isn't that much different from the code we've written up to this point. Really, the main difference is that instead of specifying hierarchical as true, we'll set it as false.
This will result in a different type of user interface element that looks more like tags rather than the category options that you see above.
Finally, add the following line to the init method along with the rest of the hooks:
Notice that is functions more like tags that categories. Again, to reiterate, that's one of the main differences in hierarchical and non-hierarchical taxonomies.
Now we're ready to give the plugin a spin. Assuming you've followed everything correctly throughout this tutorial, then you should be able to create a new post, stamp it with a type of Photograph or a type of Video as well as a type of Film and have it persist the changes after saving or updating your post.
If not, double-check your code with what's referenced here and with what's referenced in the associated GitHub repository.
That wraps up The Beginner's Guide to WordPress Taxonomies. Throughout the series, we've taken a broad look at a definition of what taxonomies are, the role they play in WordPress, and we've even implemented a few of our own.
At this point, you should have a solid understanding of the concept and how to proceed with including them in your next project.
If not, don't hesitate to leave questions, comments, or general feedback in the field below.

0 comments:

Post a Comment

 
Top
Blogger Template