如何编写仅在博客分类X、Y、Z触发的WordPress自定义函数？

Hey there, let's break down how to make your custom WordPress function only fire when you're dealing with posts in categories X, Y, or Z. This is a super common use case, and WordPress has built-in conditional functions to handle this cleanly without messy workarounds.

Core Idea #

The key is to wrap your custom function logic inside a conditional check that verifies we're either viewing a single post in one of your target categories, or browsing the category archive page for those categories. We'll use WordPress hooks (filters or actions) alongside conditional tags to make this happen.

Example 1: Filter Post Content Only in Target Categories #

Let's say you want to add a custom note at the end of posts in categories X, Y, Z. Here's how to do it with the the_content filter:

// Register our function to the content filter
add_filter( 'the_content', 'my_category_specific_content_mod' );

function my_category_specific_content_mod( $content ) {
    // Define your target categories here — use IDs, slugs, or names (slugs/IDs are more reliable)
    $target_cats = array( 'category-x-slug', 'category-y-slug', 45 ); // Replace with your X/Y/Z values

    // Check if we're on a single post page AND the post is in one of our target categories
    if ( is_singular( 'post' ) && in_category( $target_cats ) ) {
        // Your custom logic goes here — this adds a note to the end of the post
        $custom_note = '<div class="category-exclusive-note">📌 This content is only shown in categories X, Y, or Z!</div>';
        $content .= $custom_note;
    }

    // Always return the modified content — filters require this to work!
    return $content;
}

Example 2: Load Scripts/Styles Only in Target Categories #

If you need to enqueue scripts or styles exclusively for these categories (e.g., a custom gallery script), use the wp_enqueue_scripts action:

add_action( 'wp_enqueue_scripts', 'my_category_specific_assets' );

function my_category_specific_assets() {
    $target_cats = array( 'category-x-slug', 'category-y-slug', 45 );

    // Check if we're on a target category archive OR a single post in one of the target categories
    if ( is_category( $target_cats ) || ( is_singular( 'post' ) && in_category( $target_cats ) ) ) {
        // Enqueue your custom script
        wp_enqueue_script(
            'custom-category-script',
            get_template_directory_uri() . '/js/category-specific.js',
            array( 'jquery' ), // Dependencies
            '1.0.0', // Version
            true // Load in footer
        );
    }
}

Key Details to Remember #

• Conditional Tags:
  • in_category($target_cats): Checks if the current single post belongs to any of the target categories. Works with arrays of IDs, slugs, or names.
  • is_category($target_cats): Checks if we're viewing the archive page for any of the target categories.
  • is_singular('post'): Ensures we only run the logic on single post pages (exclude archives, search results, etc.) unless you want it elsewhere.
• Reliable Category Identifiers: Use category IDs or slugs instead of names — names can change or have capitalization issues, while IDs/slugs stay consistent.
• Return Values for Filters: Always return the modified data (like $content in the first example) — if you forget, your filter will break the output.

Advanced: Check for Child Categories #

If you want the function to trigger for child categories of X/Y/Z too, add this helper function and update your conditional check:

// Helper function to check if a post is in a child category of the target
function post_is_in_descendant_category( $cats, $_post = null ) {
    foreach ( (array) $cats as $cat ) {
        // Get all child categories of the target cat
        $descendants = get_term_children( (int) $cat, 'category' );
        if ( $descendants && in_category( $descendants, $_post ) ) {
            return true;
        }
    }
    return false;
}

// Update your conditional to include child categories:
if ( is_singular( 'post' ) && ( in_category( $target_cats ) || post_is_in_descendant_category( $target_cats ) ) ) {
    // Your custom logic here
}

内容的提问来源于stack exchange，提问作者Pierre W Bertrand