Taxonomies
- About Taxonomies
- Adding a Taxonomy
- Custom plural form
- Apply: Post Types
- Example 1: using addPostType()
- Example 2: Using apply()
- Hierarchical
- Setting a custom slug
- Setting and Getting the ID
- Forms and Fields
- Example 1: Publisher with custom field
- Arguments
About Taxonomies
WordPress taxonomies are used to create relationships between posts and custom post types. For example, "tags" are used to created a relationship between posts that share a common topic. "Categories" do the same but are hierarchical and can even share relationships within themselves.
Don't let the complexities of taxonomies scare you though. TypeRocket makes using them simple and easy so you can quickly reap the benefits of custom taxonomies.
Adding a Taxonomy
You can create a custom taxonomy with the tr_taxonomy()
function. Using the tr_taxonomy()
function will take care of the basic settings for you including pluralizing labels.
Take a look at creating a Publisher
taxonomy you can use for a "books" post type.
<?php // functions.php
tr_taxonomy('Publisher');
This one line of code adds the taxonomy to the admin, sets all the correct labels in the navigation and applicable places, and implements the required WordPress hooks.
Custom plural form
In some cases, you will not want TypeRocket to manage the grammar for the taxonomies plural form.
You can set your own by supplying it as the second argument when creating the taxonomy.
tr_taxonomy('Publisher', 'Publishers');
Apply: Post Types
To add a custom taxonomy to a post type you can use the addPostType()
method or the apply()
method.
Example 1: using addPostType()
<?php // functions.php
$pub = tr_taxonomy('Publisher');
$pub->addPostType('book');
Example 2: Using apply()
<?php // functions.php
$pub = tr_taxonomy('Publisher');
$book = tr_post_type('Book');
$pub->apply($book);
Hierarchical
To make a hierarchical taxonomy use the setHierarchical()
method.
$pub->setHierarchical();
Setting a custom slug
By default, TypeRocket will use the taxonomy ID as the slug for the URL rewrite rules. You can change the slug with the setSlug()
method.
$pub->setSlug('publishers');
Setting and Getting the ID
The ID is used to specify the name that WordPress associates with your taxonomy. It is also registered under the ID. When you register "Publisher" with TypeRocket the id is set to "publisher".
You can change the ID using the setId()
method.
$pub->setId('book_publisher');
Get the ID
$pubId = $pub->getId();
Forms and Fields
There is a single place to add custom content within the <form>
element for each taxonomy. You can open up this sections with the method: setMainForm()
for placement on the taxonomy creation and editing pages.
Example 1: Publisher with custom field
Take a look at opening up a content section and adding a custom field. Note, when you make a custom field for taxonomy terms you must create a model and controller for TypeRocket to save the data as expected.
You can make a controller and model quickly with the Galaxy CLI.
php galaxy make:model -c term Publisher
Finally, in your code.
<?php
$pub = tr_taxonomy('Publisher');
$book = tr_post_type('Book')->setIcon('book');
$pub->apply($book);
$pub->setMainForm(function() {
$form = tr_form();
echo $form->text('Company');
});
Arguments
There are five methods to set and get arguments. Arguments are used when the taxonomy is being registered. All arguments can be found in the WordPress codex.
These methods are: getArguments()
, setArguments()
, getArgument()
, setArgument()
and removeArgument()
.
getArguments()
returns the full array of arguments.setArguments()
takes an array of arguments.getArgument()
return an argument by its key.setArgument()
sets an argument by a key.removeArgument()
removes an argument by its key.
Take a look at using all the methods without effecting the already set values.
$args = $pub->getArguments();
$args = array_merge( $args, array( 'public' => true ) );
$pub->setArguments( $args );
$public = $pub->getArgument( 'public' );
$pub->removeArgument( 'public' );
$pub->setArgument( 'public', $public );