本教程详细介绍了如何在WordPress中为自定义文章类型（Custom Post Type, CPT）创建并正确显示自定义分类法（Custom Taxonomy）。文章涵盖了自定义文章类型和分类法的注册、关键参数配置（包括重写规则），以及如何在单篇自定义文章模板中利用`get_the_terms()`函数替代标准`the_category()`函数，以确保自定义分类法术语能够被准确获取和展示。
在WordPress开发中，自定义文章类型（CPT）和自定义分类法（Custom Taxonomy）是扩展网站功能、组织内容不可或缺的工具。它们允许开发者创建高度定制化的内容结构，例如“产品”、“成员”或“活动”等，并为这些内容定义独特的分类体系。然而，初学者在尝试显示自定义分类法术语时，常会遇到一些挑战，特别是当错误地使用适用于标准文章分类的函数时。本教程将引导您完成从注册到显示的完整过程。
一、 注册自定义文章类型 (Custom Post Type)
首先，我们需要注册一个自定义文章类型。以“成员（Members）”为例，我们将在functions.php文件中添加以下代码。请注意，这里我们引入了query_var和rewrite参数，并建议在开发阶段使用flush_rewrite_rules()来确保URL重写规则的更新。
function members_post_type() { $args = array( 'labels' => array( 'name' => '成员', 'singular_name' => '成员', 'all_items' => '所有成员' ), 'public' => true, 'has_archive' => true, 'supports' => array('title', 'editor', 'thumbnail'), 'menu_icon' => 'dashicons-groups', 'query_var' => true, // 允许通过查询变量访问 'rewrite' => array('slug' => 'members'), // 定义URL重写规则 ); register_post_type('members', $args); // 注意：flush_rewrite_rules(false) 应仅在注册CPT或分类法后执行一次， // 不应在每次页面加载时运行。通常在主题激活或插件激活时调用。 // 在开发阶段，为方便测试，可以暂时放在这里，但部署前应移除或妥善处理。 flush_rewrite_rules(false); }add_action('init', 'members_post_type');
关键参数解释：
labels: 定义了管理界面中显示的各种文本标签。public: 设置为true使CPT在前端可见，并允许通过URL访问。has_archive: 设置为true为CPT启用归档页面。supports: 定义CPT支持的编辑器功能，例如标题、内容编辑器、特色图片等。menu_icon: 设置CPT在WordPress后台菜单中的图标。query_var: 设为true后，WordPress会创建一个查询变量，以便您可以使用WP_Query来查询此CPT。rewrite: 定义了此CPT的URL重写规则。例如，’slug’ => ‘members’意味着单篇成员文章的URL可能形如yourdomain.com/members/post-name/。flush_rewrite_rules(false): 这个函数用于更新WordPress的URL重写规则。当您注册新的CPT或分类法时，WordPress需要知道如何处理这些新的URL结构。重要提示： 这个函数会消耗资源，不应该在每次页面加载时都调用。通常，它只在主题激活或插件激活时调用一次，或者在开发过程中手动刷新。
二、 注册自定义分类法 (Custom Taxonomy)
接下来，我们将为“成员”CPT注册一个自定义分类法。为了避免与WordPress内置的“分类（Categories）”混淆，我们建议使用一个独特的名称，例如“我的分类（My Categories）”，并为其指定一个唯一的别名（slug）。
function members_taxonomys() { $args = array( 'label' => '我的分类', // 在管理界面显示的标签 'public' => true, 'hierarchical' => true, // 设置为true使其像常规分类一样具有层级结构 'rewrite' => array('slug' => 'my_categories'), // 定义URL重写规则 ); // 注册分类法 'my_categories' 并将其关联到 'members' 文章类型 register_taxonomy('my_categories', array('members'), $args);}add_action('init', 'members_taxonomys');
关键参数解释：
label: 在WordPress管理界面中显示的分类法名称。public: 设置为true使其在前端可见。hierarchical: 设置为true允许此分类法像标准分类一样拥有父子层级结构；如果设置为false，则像标签一样没有层级。rewrite: 定义了此分类法的URL重写规则。register_taxonomy(‘my_categories’, array(‘members’), $args): 第一个参数是分类法的唯一别名（slug），第二个参数是此分类法将关联的CPT或文章类型数组。
三、 创建内容并分配自定义分类法术语
完成上述注册后，请在WordPress后台：
导航到“成员” -> “添加新成员”。在右侧边栏，您应该会看到一个新的元框，标题为“我的分类”。创建一些分类法术语（例如，“管理层”、“技术团队”、“销售团队”），并将它们分配给您创建的成员文章。
四、 在单篇自定义文章模板中显示自定义分类法术语
这是最关键的一步。WordPress的the_category()函数专门用于显示标准文章的分类。对于自定义分类法，您需要使用get_the_terms()函数来获取分配给当前文章的分类法术语。
在您的single-members.php模板文件（如果不存在，请创建它）中，使用以下代码来显示“我的分类”下的术语：
<?php // 获取当前文章的 'my_categories' 分类法术语 $categories = get_the_terms(get_the_ID(), 'my_categories'); if (!empty($categories) && !is_wp_error($categories)) { echo '我的分类:
'; echo '- '; foreach ($categories as $cat) { // $cat 是一个 WP_Term 对象 // 可以访问 $cat->name (名称), $cat->slug (别名), $cat->term_id (ID) 等属性 echo '
- term_id, 'my_categories') . '">' . esc_html($cat->name) . ' '; } echo '
代码解释：
get_the_terms(get_the_ID(), ‘my_categories’):get_the_ID(): 获取当前循环中的文章ID。’my_categories’: 这是您在register_taxonomy()函数中定义的自定义分类法的唯一别名（slug）。!empty($categories) && !is_wp_error($categories): 这是一个重要的检查，确保get_the_terms()函数成功返回了结果，并且没有发生WordPress错误。foreach ($categories as $cat): 遍历获取到的所有分类法术语。每个$cat变量都是一个WP_Term对象，包含了该术语的所有信息。$cat->name: 访问分类法术语的名称。get_term_link($cat->term_id, ‘my_categories’): 生成指向该分类法术语归档页面的链接。
五、 注意事项与最佳实践
分类法别名（Slug）的唯一性： 确保您的自定义分类法别名是唯一的，并且不要与WordPress内置的分类法（如category或post_tag）冲突。flush_rewrite_rules()的调用时机： 如前所述，这个函数不应该在每次页面加载时运行。最佳实践是在主题激活、插件激活或更新CPT/分类法注册代码后，手动访问WordPress后台的“设置” -> “固定链接”页面，点击“保存更改”按钮，这也会自动刷新重写规则。错误处理： 总是对get_the_terms()等可能返回空值或WP_Error对象的函数进行检查，以避免页面出现PHP警告或错误。链接生成： 使用get_term_link()而不是手动构建链接，可以确保链接的正确性和兼容性。安全性： 在输出任何动态内容时，使用esc_html()等WordPress的转义函数，以防止跨站脚本（XSS）攻击。
总结
通过遵循本教程的步骤，您将能够成功地为自定义文章类型注册自定义分类法，并将其术语正确地显示在您的WordPress网站前端。关键在于理解the_category()和get_the_terms()之间的区别，并正确配置自定义文章类型和分类法的参数，特别是URL重写规则。掌握这些技能将极大地提升您在WordPress中构建复杂内容结构的能力。
以上就是WordPress自定义文章类型分类法显示教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1336874.html
微信扫一扫 
支付宝扫一扫 
