如何通过Hook修改产品Permalink，关联自定义文章类型（CPT）

DevOps 小满

2026-8-4

修改WooCommerce产品永久链接为自定义文章类型（CPT）结构

完全可以通过WordPress钩子实现这个需求，以下是具体操作步骤：

1. 改写产品永久链接生成逻辑

用post_type_link钩子拦截产品的永久链接生成，替换为ACF关联的CPT路径。假设你的ACF关联字段名为related_cpt，CPT的层级结构和示例一致：

function custom_product_permalink($permalink, $post) {
    // 仅对产品类型生效
    if ($post->post_type !== 'product') {
        return $permalink;
    }

    // 获取ACF关联的CPT文章
    $related_cpt = get_field('related_cpt', $post->ID);
    if (!$related_cpt) {
        return $permalink;
    }

    // 提取CPT的路径部分（去掉域名）
    $cpt_permalink = get_permalink($related_cpt->ID);
    $cpt_path = str_replace(home_url('/'), '', $cpt_permalink);

    // 拼接新的产品链接：CPT路径 + 产品slug
    $new_permalink = home_url('/' . $cpt_path . '/' . $post->post_name . '/');

    return $new_permalink;
}
add_filter('post_type_link', 'custom_product_permalink', 10, 2);

2. 添加Rewrite规则识别新URL

用init钩子注册Rewrite规则，确保WordPress能正确解析新结构的URL：

function custom_product_rewrite_rules() {
    // 匹配「域名/CPT父级/CPT子级/产品slug」的结构
    add_rewrite_rule(
        '^([^/]+)/([^/]+)/([^/]+)/?$',
        'index.php?product=$matches[3]',
        'top'
    );
}
add_action('init', 'custom_product_rewrite_rules');

如果你的CPT是单层级结构，可将正则改为^([^/]+)/([^/]+)/?$，对应$matches[2]指向产品slug。