WooCommerce不同父分类下重名子分类Slug自动追加父分类名称的原因及修改方案咨询

Great question—this is a super common pain point for apparel stores dealing with repeated category names across Men/Women/Kids lines. Let’s break this down step by step.

Why This Happens #

First, remember that WooCommerce is built on WordPress’s core taxonomy system, which requires globally unique slugs for all terms (including product categories). By default, WordPress would just append a number to duplicate slugs (like shoes-2), but WooCommerce overrides this behavior for product categories to make slugs more semantically meaningful. Instead of random numbers, it appends the parent category’s slug to avoid conflicts—hence why your Women > Shoes ends up with shoes-women instead of a generic numbered suffix.

The core logic here is that WooCommerce assumes a unique global slug is better for SEO and URL clarity, but it doesn’t account for use cases where repeated subcategory names across parent groups are standard (like apparel).

How to Modify the Rule (Make Slugs Unique Per Parent) #

To let subcategory slugs only need to be unique within their parent category (not globally), we can hook into WordPress’s wp_unique_term_slug filter to override the default behavior. Here’s a tested code snippet you can use:

add_filter('wp_unique_term_slug', 'custom_unique_product_cat_slug', 10, 4);
function custom_unique_product_cat_slug($slug, $term, $original_slug, $taxonomy) {
    // Only target WooCommerce product categories
    if ($taxonomy !== 'product_cat') {
        return $slug;
    }

    $parent_id = $term->parent;
    // Keep global uniqueness for top-level categories
    if (empty($parent_id)) {
        return $slug;
    }

    // Check if the original slug is already used in this parent category
    $existing_terms = get_terms(array(
        'taxonomy' => $taxonomy,
        'slug' => $original_slug,
        'parent' => $parent_id,
        'fields' => 'ids',
        'exclude' => array($term->term_id) // Skip current term if updating an existing one
    ));

    // No duplicates found? Use the original slug
    if (empty($existing_terms)) {
        return $original_slug;
    }

    // If duplicates exist, append a number suffix (like WordPress's default behavior)
    $suffix = 2;
    while (true) {
        $new_slug = $original_slug . '-' . $suffix;
        $check_terms = get_terms(array(
            'taxonomy' => $taxonomy,
            'slug' => $new_slug,
            'parent' => $parent_id,
            'fields' => 'ids'
        ));
        if (empty($check_terms)) {
            return $new_slug;
        }
        $suffix++;
    }
}

What This Code Does: #

• Targeted Scope: Only affects WooCommerce product categories, so other taxonomies (like post categories or product tags) keep their default behavior.
• Top-Level Exception: Still enforces global uniqueness for parent categories (e.g., you can’t have two top-level "Men" categories), which makes sense for your store structure.
• Parent-Level Uniqueness: For subcategories, it only checks if the slug is used within the same parent category. So Men > Shoes can have shoes, and Women > Shoes can also have shoes without conflict.
• Fallback Suffix: If you accidentally create two "Shoes" subcategories under the same parent (e.g., two Men > Shoes), it appends a number (like shoes-2) to keep slugs unique.

Important Notes: #

1. Existing Slugs: If you already have slugs like shoes-women, you’ll need to manually update them to shoes (and set up 301 redirects for those URLs to avoid broken links).
2. Code Placement: Add this to a custom plugin (recommended, so it doesn’t get lost when you update your theme) or your theme’s functions.php file.
3. Backup First: Always back up your database before modifying code that affects taxonomy slugs.

内容的提问来源于stack exchange，提问作者Faye D.