WordPress自定义文章类型和自定义分类共用同一个根路径slug的方法

美工学习 · 发表于 2023-12-2 10:21:38

亲注册登录道勤网-可以查看更多帖子内容哦！（包涵精彩图片、文字详情等）请您及时注册登录-www.daoqin.net

您需要登录才可以下载或查看，没有账号？立即注册

x

在 wordpress中如果注册一个自定义文章类型（Custom Post Type），并且同时为这个类型注册一个自定义分类法（Custom Taxonomy），两者使用同一个根slug，访问这个类型的页面就会发生404报错。

这个slug具体指什么呢？举例说明：

https://www.my-site.com/product/123.html
https://www.my-site.com/product/term-name

复制代码

以上URL分别作为product类型页面的详情页和分类列表页，URL中的product就是根slug。在使用register_post_type注册product文章类型的时候，代码体现为：

add_action('init', 'create_product_post_type', 0);
function create_product_post_type() {
register_post_type('product', array(
'label' => 'Products',
'public' => true,
'show_ui' => true,
'show_in_menu' => true,
'capability_type' => 'post',
'hierarchical' => false,
'rewrite' => array('slug' => 'product'), //注意此行
'supports' => array('title','editor','thumbnail'),
'labels' => array (
'name' => 'Products',
'singular_name' => 'Product',
'menu_name' => 'Products'
)
)
);
}

复制代码

注意第11行的rewrite参数，就为此自定义类型指定了根slug，即形成如下url：

https://www.my-site.com/product/123.html

复制代码

再来注册自定义分类法，这里的分类法名称为product_category：

add_action( 'init', 'create_product_taxonomies', 0 );
function create_product_taxonomies() {
register_taxonomy(
'product_category',
'product',
array(
'labels' => array(
'name' => 'Product Category'
),
'rewrite' => array('slug' => 'product'),//注意此行
'show_ui' => true,
'show_tagcloud' => false,
'hierarchical' => true
)
);
}

复制代码

注意第10行的rewrite参数，为此自定义分类指定了根slug，即形成如下url：

https://www.my-site.com/product/term-name

复制代码

但实际上我们注册完毕后，前端页面会在自定义分类的URL产生404报错。

假如去掉第10行代码，默认的slug会变成product_category，即分类名称，这时候url会变成

https://www.my-site.com/product_category/term-name

复制代码

这样虽然不会报错，但url比较难看，也不利于seo。

要解决这个问题，需要在注册自定义类型的时候，修改参数如下：

add_action('init', 'create_product_post_type', 0);
function create_product_post_type() {
register_post_type('product', array(
'label' => 'Products',
'public' => true,
'show_ui' => true,
'show_in_menu' => true,
'capability_type' => 'post',
'hierarchical' => false,
'rewrite' => array('slug' => 'product/%product_category%'), //注意参数修改
'has_archive' => 'product', //注意此行为添加的
'supports' => array('title','editor','thumbnail'),
'labels' => array (
'name' => 'Products',
'singular_name' => 'Product',
'menu_name' => 'Products'
)
)
);
}
add_action( 'init', 'create_product_taxonomies', 0 );
function create_product_taxonomies() {
register_taxonomy(
'product_category',
'product',
array(
'labels' => array(
'name' => 'Product Category'
),
'rewrite' => array('slug' => 'product'), //这里维持原样
'show_ui' => true,
'show_tagcloud' => false,
'hierarchical' => true
)
);
}

复制代码

最后，在post_type_link钩子上添加代码根据类型名称替换实际生成的url：

add_filter('post_type_link', 'custom_type_link', 1, 3);
function custom_type_link( $link, $post = 0 ){
if ( false !== strpos( $link, '%product_category%' ) ) {
$taxonomy_terms = get_the_terms( $post->ID, 'product_category' );
if( is_array($taxonomy_terms) ){
foreach ( $taxonomy_terms as $term ) {
if ( ! $term->parent ) {
$link = str_replace( '%product_category%', $term->slug, $link );
}
}
}
}
return $link;
}

复制代码

如此，两个url就能和平共处了。这个问题的修复逻辑是这样的：因在两处注册rewrite的时候使用同一个slug名，会造成rewrite冲突，产生404报错，那么我们就避免使用相同的slug，把第一处的slug改成’product/%product_category%’绕开这个问题。在实际生成url的时候再把类型名替换’%product_category%’字符串，从而解决问题。

道勤主机提供365天*24小时全年全天无休、实时在线、零等待的售后技术支持。竭力为您免费处理您在使用道勤主机过程中所遇到的一切问题! 如果您是道勤主机用户，那么您可以通过QQ【792472177】、售后QQ【59133755】、旺旺【诠释意念】、微信：q792472177免费电话、后台提交工单这些方式联系道勤主机客服！如果您不是我们的客户也没问题，点击页面最右边的企业QQ在线咨询图标联系我们并购买后，我们为您免费进行无缝搬家服务，让您享受网站零访问延迟的迁移到道勤主机的服务！