Taxonomy term management in Wordpress - Mini Project: Build & Apply

Taxonomy Term Management in WordPress

📖 Scenario: You are building a WordPress plugin that manages custom taxonomy terms for a blog. You want to create, configure, and display taxonomy terms programmatically.

🎯 Goal: Build a simple WordPress plugin that registers a custom taxonomy, adds terms to it, and displays those terms on a page.

📋 What You'll Learn

Register a custom taxonomy called genre for posts

Add three terms: Fiction, Non-Fiction, and Biography

Retrieve and display all terms of the genre taxonomy

💡 Why This Matters

🌍 Real World

Managing custom categories or tags for posts helps organize content clearly for readers and site admins.

💼 Career

WordPress developers often need to create and manage taxonomies to customize content classification and improve site navigation.

1

Register the custom taxonomy genre

Write code to register a custom taxonomy called genre for the post post type using register_taxonomy. Use the labels 'Genres' for plural and 'Genre' for singular. Place this code inside a function called register_genre_taxonomy and hook it to init action.

Wordpress

<?php
// Your code here

Hint

Use register_taxonomy inside a function hooked to init.

2

Add terms Fiction, Non-Fiction, and Biography

Create a function called add_genre_terms that adds the terms Fiction, Non-Fiction, and Biography to the genre taxonomy using wp_insert_term. Hook this function to init with priority 20.

Wordpress

 'Genres',
        'singular_name' => 'Genre'
    );
    register_taxonomy('genre', 'post', array(
        'labels' => $labels,
        'public' => true,
        'hierarchical' => true
    ));
}
add_action('init', 'register_genre_taxonomy');

// Your code here

Hint

Use wp_insert_term inside a function hooked to init with priority 20.

3

Retrieve all terms from genre taxonomy

Write a function called get_all_genre_terms that uses get_terms to retrieve all terms from the genre taxonomy. Store the result in a variable called $terms.

Wordpress

 'Genres',
        'singular_name' => 'Genre'
    );
    register_taxonomy('genre', 'post', array(
        'labels' => $labels,
        'public' => true,
        'hierarchical' => true
    ));
}
add_action('init', 'register_genre_taxonomy');

function add_genre_terms() {
    wp_insert_term('Fiction', 'genre');
    wp_insert_term('Non-Fiction', 'genre');
    wp_insert_term('Biography', 'genre');
}
add_action('init', 'add_genre_terms', 20);

// Your code here

Hint

Use get_terms with taxonomy set to genre and hide_empty set to false.

4

Display all genre terms on a page

Create a shortcode function called display_genre_terms that calls get_all_genre_terms, loops through the terms, and returns an unordered list (<ul>) of term names. Register this shortcode with the tag show_genres.

Wordpress

 'Genres',
        'singular_name' => 'Genre'
    );
    register_taxonomy('genre', 'post', array(
        'labels' => $labels,
        'public' => true,
        'hierarchical' => true
    ));
}
add_action('init', 'register_genre_taxonomy');

function add_genre_terms() {
    wp_insert_term('Fiction', 'genre');
    wp_insert_term('Non-Fiction', 'genre');
    wp_insert_term('Biography', 'genre');
}
add_action('init', 'add_genre_terms', 20);

function get_all_genre_terms() {
    $terms = get_terms(array(
        'taxonomy' => 'genre',
        'hide_empty' => false
    ));
    return $terms;
}

// Your code here

Hint

Use a shortcode function that returns an unordered list of term names and register it with add_shortcode.

Practice

1. What is the primary purpose of taxonomy terms in WordPress?

easy

A. To handle database backups automatically

B. To create user accounts and manage permissions

C. To store theme settings and customization options

D. To group and organize content for easier filtering and display

Solution

1. Step 1: Understand taxonomy terms role

   Taxonomy terms are used to group content like posts or custom post types for better organization.

2. Step 2: Compare with other options

   User accounts, theme settings, and backups are unrelated to taxonomy terms.

3. Final Answer:

   To group and organize content for easier filtering and display -> Option D

4. Quick Check:

   Taxonomy terms = content grouping [OK]

Hint: Taxonomy terms group content, not users or settings [OK]

Common Mistakes:

• Confusing taxonomy terms with user roles
• Thinking taxonomy terms manage theme options
• Assuming taxonomy terms handle backups

2. Which of the following is the correct way to insert a new taxonomy term in WordPress?

easy

A. wp_insert_term('Term Name', 'taxonomy_name');

B. insert_term('Term Name', 'taxonomy_name');

C. add_term('Term Name', 'taxonomy_name');

D. create_term('Term Name', 'taxonomy_name');

Solution

1. Step 1: Identify the correct function name

   The official WordPress function to add a taxonomy term is wp_insert_term().

2. Step 2: Check function parameters

   The function takes the term name and taxonomy slug as parameters, matching wp_insert_term('Term Name', 'taxonomy_name');.

3. Final Answer:

   wp_insert_term('Term Name', 'taxonomy_name'); -> Option A

4. Quick Check:

   Insert term function = wp_insert_term() [OK]

Hint: Remember the prefix 'wp_' for WordPress core functions [OK]

Common Mistakes:

• Using non-existent functions like insert_term
• Omitting the 'wp_' prefix
• Confusing with functions for posts or users

3. What will the following code output if the taxonomy 'genre' has terms 'Fiction' and 'Non-Fiction'?

 $terms = get_terms(['taxonomy' => 'genre', 'hide_empty' => false]);
foreach ($terms as $term) {
    echo $term->name . ', ';
}

medium

A. Array, Array,

B. genre, Fiction, Non-Fiction,

C. Fiction, Non-Fiction,

D. Error: Undefined variable

Solution

1. Step 1: Understand get_terms() output

   The function returns an array of term objects for the 'genre' taxonomy, including 'Fiction' and 'Non-Fiction'.

2. Step 2: Loop and echo term names

   The foreach loop prints each term's name followed by a comma and space, resulting in 'Fiction, Non-Fiction, '.

3. Final Answer:

   Fiction, Non-Fiction, -> Option C

4. Quick Check:

   get_terms() returns term objects with names [OK]

Hint: get_terms() returns objects; access name with ->name [OK]

Common Mistakes:

• Expecting taxonomy name instead of term names
• Trying to print array directly
• Forgetting to set 'hide_empty' to false to get all terms

4. Identify the error in this code snippet for updating a taxonomy term name:

 wp_update_term(123, 'category', ['name' => 'New Name']); 

medium

A. The taxonomy slug 'category' is incorrect for terms

B. No error; this code correctly updates the term name

C. Term ID must be a string, not an integer

D. The third parameter should be a string, not an array

Solution

1. Step 1: Check wp_update_term() parameters

   The function takes term ID (integer), taxonomy slug (string), and an array of args to update.

2. Step 2: Verify usage correctness

   Using term ID 123, taxonomy 'category', and array with 'name' key is correct syntax and usage.

3. Final Answer:

   No error; this code correctly updates the term name -> Option B

4. Quick Check:

   wp_update_term() usage = correct [OK]

Hint: wp_update_term() needs term ID, taxonomy, and args array [OK]

Common Mistakes:

• Passing term ID as string instead of integer
• Using wrong parameter types
• Confusing taxonomy slug with term name

5. You want to add a new term 'Adventure' to the custom taxonomy 'book_genre' only if it does not already exist. Which code snippet correctly achieves this?

hard

A. if (!term_exists('Adventure', 'book_genre')) { wp_insert_term('Adventure', 'book_genre'); }

B. wp_insert_term('Adventure', 'book_genre');

C. if (term_exists('Adventure')) { wp_insert_term('Adventure', 'book_genre'); }

D. wp_update_term('Adventure', 'book_genre');

Solution

1. Step 1: Check if term exists in taxonomy

   Use term_exists('Adventure', 'book_genre') to verify if the term is already present.

2. Step 2: Insert term only if it does not exist

   If the term does not exist (negation), call wp_insert_term('Adventure', 'book_genre') to add it.

3. Final Answer:

   if (!term_exists('Adventure', 'book_genre')) { wp_insert_term('Adventure', 'book_genre'); } -> Option A

4. Quick Check:

   Check existence before insert = safe add [OK]

Hint: Use term_exists() before wp_insert_term() to avoid duplicates [OK]

Common Mistakes:

• Inserting term without checking existence
• Using term_exists() without taxonomy parameter
• Using wp_update_term() to add new term