WordPress Custom Post Type Permalinks插件404问题及链接结构需求求助

Hey there, let’s tackle that frustrating 404 issue you’re facing with your custom post types (CPTs) when using the Custom Post Type Permalinks plugin. It’s weird that taxonomies work perfectly but CPTs throw 404s—let’s break down the most reliable fixes step by step, based on common WordPress permalink pitfalls.

1. Double-Check Your CPT Registration Arguments #

First up, make sure your custom post type is registered with the right parameters to support taxonomy-integrated permalinks. These are easy to overlook but critical:

• The rewrite array needs 'with_front' => false (to avoid inheriting your site’s base permalink prefix like /blog/) and a 'slug' that aligns with your plugin’s structure (e.g., %your_taxonomy_slug%/your-cpt).
• Set has_archive to true (or a custom slug) — even single CPT posts rely on this for proper rewrite routing.
• Confirm public and publicly_queryable are both true—if either is false, WordPress won’t route requests to your CPT.

Here’s a snippet of a correctly registered CPT:

register_post_type('product', array(
    'public' => true,
    'publicly_queryable' => true,
    'rewrite' => array(
        'slug' => '%product_category%/product',
        'with_front' => false
    ),
    'has_archive' => true,
    // Add other required args (labels, supports, etc.)
));

2. Verify the Plugin’s CPT Permalink Settings #

Head to Settings → Permalinks and scroll down to the Custom Post Type Permalinks section:

• For your problematic CPT, ensure the permalink structure uses the correct taxonomy placeholder, like %product_category%/%postname%/
• Double-check that you’ve selected the right taxonomy from the dropdown (mixing slugs here is a common 404 trigger)
• Save the settings again—even if they look correct, re-saving forces WordPress to refresh rewrite rules, which might not have happened when you first set up the plugin.

3. Flush Rewrite Rules (The Right Way) #

This is the go-to first fix, but let’s make sure you do it properly:

• Go to Settings → Permalinks, select any structure (even the same one you’re using), and click "Save Changes". Do this twice if needed—sometimes the first save doesn’t fully clear cached rules.
• If that doesn’t work, flush rules programmatically (add this to your theme’s functions.php temporarily, then remove it after):

add_action('init', function() {
    flush_rewrite_rules(true);
});

Note: Don’t leave this code in permanently—it runs on every page load and will slow down your site.

4. Hunt for Rewrite Rule Conflicts #

Your theme or another plugin might be adding conflicting rewrite rules that override the plugin’s settings. Here’s how to debug:

• Use a plugin like Rewrite Rules Inspector (from the WordPress repo) to view all active rewrite rules. Look for a rule matching your CPT’s expected structure (e.g., product_category/your-cpt/post-name). If it’s missing, that’s a problem.
• Temporarily deactivate other plugins one by one, flushing rewrite rules after each. If the 404 goes away, you’ve found the conflicting plugin.
• Switch to a default theme like Twenty Twenty-Four—if the permalink works, your theme’s custom rewrite code is the culprit. Check your theme’s functions.php for add_rewrite_rule or register_post_type calls that might be overriding settings.

5. Manually Add the Rewrite Rule (As a Last Resort) #

If the plugin isn’t generating the correct rule, you can add it manually. Drop this into your theme’s functions.php or a custom plugin:

add_action('init', function() {
    add_rewrite_rule(
        '^([^/]+)/product/([^/]+)/?$',
        'index.php?product_category=$matches[1]&product=$matches[2]',
        'top'
    );
});

Replace product, product_category with your actual CPT and taxonomy slugs. After adding this, flush rewrite rules again.

Final Checks #

• Test the permalink in an incognito window to avoid cached results.
• If you’re still stuck, temporarily add var_dump($GLOBALS['wp_rewrite']->rules); to a test page to see if your custom rule is present in the rewrite rules array.

内容的提问来源于stack exchange，提问作者skylab