
本教程详细指导如何在wordpress自定义文章类型(cРТ)中正确定义和显示自定义分类法术语。文章将涵盖自定义分类法的注册、刷新重写规则的注意事项,以及如何使用`get_the_terms()`函数替代`the_category()`来在单篇文章页面上有效展示自定义分类信息,避免常见错误。
在WordPress开发中,自定义文章类型(Custom Post Types, CPT)和自定义分类法(Custom Taxonomies)是扩展网站功能的强大工具。然而,许多开发者在尝试显示自定义分类法术语时,可能会遇到诸如the_category()函数无法正常工作的问题。本文将提供一个全面的指南,演示如何正确地注册自定义文章类型和自定义分类法,并在单篇文章页面上准确地展示它们关联的分类术语。
为了确保自定义分类法能够被正确识别和使用,其注册过程需要一些关键的细节。一个常见的错误是自定义分类法的名称与WordPress内置的分类法名称冲突,或者在显示时使用了错误的函数。
首先,我们来定义一个名为“Members”的自定义文章类型和一个名为“My Categories”的自定义分类法。
// 将以下代码添加到你的主题的 functions.php 文件或自定义插件中
/**
* 注册自定义文章类型:成员 (Members)
*/
function register_members_cpt() {
$labels = array(
'name' => 'Members',
'singular_name' => 'Member',
'all_items' => 'All members',
);
$args = array(
'labels' => $labels,
'public' => true,
'has_archive' => true,
'supports' => array('title', 'editor', 'thumbnail'),
'menu_icon' => 'dashicons-groups',
'query_var' => true, // 确保查询变量可用
'rewrite' => array('slug' => 'members'), // 定义URL重写规则
// 'hierarchical' => true, // 如果需要父子关系,可启用
);
register_post_type('members', $args);
}
add_action('init', 'register_members_cpt');
/**
* 注册自定义分类法:我的分类 (My Categories)
*/
function register_my_categories_taxonomy() {
$labels = array(
'name' => 'My Categories',
'singular_name' => 'My Category',
'menu_name' => 'My Categories',
'all_items' => 'All My Categories',
'parent_item' => 'Parent My Category',
'parent_item_colon' => 'Parent My Category:',
'new_item_name' => 'New My Category Name',
'add_new_item' => 'Add New My Category',
'edit_item' => 'Edit My Category',
'update_item' => 'Update My Category',
'view_item' => 'View My Category',
'separate_items_with_commas' => 'Separate my categories with commas',
'add_or_remove_items' => 'Add or remove my categories',
'choose_from_most_used' => 'Choose from the most used my categories',
'popular_items' => 'Popular My Categories',
'search_items' => 'Search My Categories',
'not_found' => 'Not Found',
'no_terms' => 'No my categories',
'items_list' => 'My Categories list',
'items_list_navigation' => 'My Categories list navigation',
);
$args = array(
'labels' => $labels,
'public' => true,
'hierarchical' => true, // 设为true表示是层级分类(如常规分类),false表示标签式(如常规标签)
'show_ui' => true,
'show_admin_column' => true, // 在文章列表页显示此分类
'query_var' => true,
'rewrite' => array('slug' => 'my-categories'), // 定义URL重写规则
);
// 'my_categories' 是自定义分类法的内部名称(slug),必须是唯一的。
// array('members') 表示这个分类法适用于 'members' 这个自定义文章类型。
register_taxonomy('my_categories', array('members'), $args);
}
add_action('init', 'register_my_categories_taxonomy');注意事项:
在完成上述代码后,请确保在WordPress后台:
现在,最关键的一步是在自定义文章类型 members 的单篇文章模板文件 (single-members.php) 中显示这些自定义分类法术语。
the_category() 函数是为WordPress内置的 category 分类法设计的,因此它无法用于显示自定义分类法术语。我们需要使用 get_the_terms() 函数来获取当前文章的自定义分类法术语。
在你的 single-members.php 文件中,可以这样修改代码:
<?php
if (have_posts()) :
while (have_posts()) : the_post();
// 显示文章标题和内容
the_title('<h1>', '</h1>');
the_content();
// 获取当前文章的 'my_categories' 分类法术语
// 第一个参数是文章对象或文章ID,第二个参数是自定义分类法的slug
$categories = get_the_terms(get_the_ID(), 'my_categories');
// 检查是否有分类术语,并且不是WordPress错误对象
if (!empty($categories) && !is_wp_error($categories)) {
echo '<h2>Assigned My Categories:</h2>';
echo '<ul>';
foreach ($categories as $cat) {
// $cat 是一个 WP_Term 对象,包含 term_id, name, slug 等属性
// 为了更好的用户体验,可以为分类术语添加链接
$term_link = get_term_link($cat->term_id, 'my_categories');
if (!is_wp_error($term_link)) {
echo '<li><a href="' . esc_url($term_link) . '">' . esc_html($cat->name) . '</a></li>';
} else {
echo '<li>' . esc_html($cat->name) . '</li>';
}
}
echo '</ul>';
} else {
echo '<p>No custom categories assigned.</p>';
}
endwhile;
endif;
?>代码说明:
通过遵循上述步骤,你现在应该能够在WordPress自定义文章类型中成功地定义和显示自定义分类法术语了。为了确保你的WordPress项目健壮且易于维护,请牢记以下最佳实践:
以上就是WordPress自定义文章类型中显示自定义分类法术语的完整指南的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号