
本教程详细介绍了如何在wordpress中正确创建和管理自定义文章类型(custom post type)及其关联的自定义分类法(custom taxonomy)。文章将指导您完成注册这些自定义元素、为文章分配分类法,以及如何在单篇文章模板中利用`get_the_terms()`函数准确显示自定义分类法下的分类项,避免使用`the_category()`等标准函数可能导致的错误,并提供关键的注意事项。
WordPress的强大之处在于其可扩展性,自定义文章类型(Custom Post Type, CPT)和自定义分类法(Custom Taxonomy, CT)是实现高度定制化内容管理的关键。CPT允许您创建除文章、页面之外的全新内容类型,例如“产品”、“成员”或“活动”。而CT则允许您为这些CPT创建自定义的分类体系,类似于文章的“分类”和“标签”,但专属于您的自定义内容。
首先,我们需要注册一个名为“成员”(members)的自定义文章类型。这通常在主题的functions.php文件或一个自定义插件中完成。
function register_members_post_type() {
$labels = array(
'name' => '成员',
'singular_name' => '成员',
'all_items' => '所有成员',
'add_new_item' => '添加新成员',
'edit_item' => '编辑成员',
'view_item' => '查看成员',
'search_items' => '搜索成员',
'not_found' => '未找到成员',
'not_found_in_trash' => '回收站中未找到成员',
);
$args = array(
'labels' => $labels,
'public' => true,
'has_archive' => true,
'supports' => array('title', 'editor', 'thumbnail'), // 支持标题、编辑器、特色图片
'menu_icon' => 'dashicons-groups', // 后台菜单图标
'hierarchical' => false, // 是否支持层级结构(如页面)
'query_var' => true, // 允许通过查询变量访问
'rewrite' => array('slug' => 'members'), // 自定义URL重写规则
);
register_post_type('members', $args);
}
add_action('init', 'register_members_post_type');在注册自定义文章类型后,为了确保URL重写规则生效,WordPress需要刷新一次。通常,在开发环境中,当您首次添加或修改CPT/CT注册代码后,访问WordPress后台的“设置”->“固定链接”页面并点击“保存更改”即可手动刷新重写规则。在代码中,不建议在init钩子中每次都调用flush_rewrite_rules(false);,因为它会增加服务器负载。此函数仅在插件激活或主题首次启用时调用一次即可。
接下来,为“成员”自定义文章类型注册一个自定义分类法,例如名为“我的分类”(my_categories)。
function register_members_taxonomy() {
$labels = array(
'name' => '我的分类',
'singular_name' => '我的分类',
'menu_name' => '我的分类',
'all_items' => '所有我的分类',
'edit_item' => '编辑我的分类',
'view_item' => '查看我的分类',
'update_item' => '更新我的分类',
'add_new_item' => '添加新我的分类',
'new_item_name' => '新我的分类名称',
'parent_item' => '父级我的分类',
'parent_item_colon' => '父级我的分类:',
'search_items' => '搜索我的分类',
'popular_items' => '热门我的分类',
'separate_items_with_commas' => '用逗号分隔我的分类',
'add_or_remove_items' => '添加或移除我的分类',
'choose_from_most_used' => '从常用我的分类中选择',
'not_found' => '未找到我的分类',
);
$args = array(
'labels' => $labels,
'public' => true,
'hierarchical' => true, // 是否支持层级结构(如分类)
'show_ui' => true, // 是否在后台显示用户界面
'show_admin_column' => true, // 是否在文章列表页显示分类列
'query_var' => true, // 允许通过查询变量访问
'rewrite' => array('slug' => 'my-categories'), // 自定义URL重写规则
);
// 将 'my_categories' 分类法关联到 'members' 文章类型
register_taxonomy('my_categories', array('members'), $args);
}
add_action('init', 'register_members_taxonomy');重要提示:
在注册了自定义文章类型和分类法之后,您需要在WordPress后台创建一个新的“成员”文章,并在右侧的“我的分类”元框中为其分配一个或多个分类项。如果没有“我的分类”元框,请检查您的分类法注册代码是否有误,或尝试刷新固定链接。
当您尝试在single-members.php(或single.php)模板中使用the_category()函数来显示自定义分类法项时,会发现它不起作用。这是因为the_category()函数专用于显示标准文章的“分类”(category)分类法。
要显示自定义分类法(my_categories)的分类项,您需要使用get_the_terms()函数。此函数接受两个参数:文章ID和分类法slug。
以下是在single-members.php模板中显示“我的分类”项的正确方法:
<?php
if (have_posts()) :
while (have_posts()) : the_post();
?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<header class="entry-header">
<h1><?php the_title(); ?></h1>
</header>
<div class="entry-content">
<?php the_content(); ?>
<?php
// 获取当前文章的 'my_categories' 分类项
$categories = get_the_terms(get_the_ID(), 'my_categories');
// 检查是否获取到分类项
if (!empty($categories) && !is_wp_error($categories)) {
echo '<div class="member-categories">';
echo '<h3>所属分类:</h3>';
echo '<ul>';
foreach ($categories as $cat) {
// $cat 是一个 WP_Term 对象
// 您可以访问 $cat->name (名称), $cat->slug (别名), $cat->term_id (ID) 等属性
echo '<li><a href="' . esc_url(get_term_link($cat->term_id, 'my_categories')) . '">' . esc_html($cat->name) . '</a></li>';
}
echo '</ul>';
echo '</div>';
} else {
echo '<p>暂无所属分类。</p>';
}
?>
</div><!-- .entry-content -->
<footer class="entry-footer">
<?php edit_post_link('编辑', '<span class="edit-link">', '</span>'); ?>
</footer>
</article><!-- #post-## -->
<?php
endwhile;
endif;
?>代码解释:
通过本教程,您应该已经掌握了在WordPress中创建自定义文章类型和自定义分类法,并能够正确地在单篇文章模板中显示这些自定义分类项。关键在于使用get_the_terms()函数而非the_category(),并理解其参数和返回值。遵循这些步骤和最佳实践,将帮助您构建更加灵活和强大的WordPress网站。
以上就是WordPress自定义文章类型及其分类法显示教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号