WordPress自定义文章类型分类法显示教程-php教程-PHP中文网

WordPress自定义文章类型分类法显示教程

心靈之曲

发布： 2025-11-20 11:31:02

原创

793人浏览过

wordpress自定义文章类型分类法显示教程

本教程详细介绍了如何在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');

登录后复制

关键参数解释：

mybatis语法和介绍中文WORD版

本文档主要讲述的是mybatis语法和介绍；MyBatis 是一个可以自定义SQL、存储过程和高级映射的持久层框架。MyBatis 摒除了大部分的JDBC代码、手工设置参数和结果集重获。MyBatis 只使用简单的XML 和注解来配置和映射基本数据类型、Map 接口和POJO 到数据库记录。相对Hibernate和Apache OJB等“一站式”ORM解决方案而言，Mybatis 是一种“半自动化”的ORM实现。感兴趣的朋友可

查看详情

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 if (have_posts()) : ?>
    <?php while (have_posts()) : the_post(); ?>
        <h1><?php the_title(); ?></h1>
        <?php the_content(); ?>

        <?php
        // 获取当前文章的 'my_categories' 分类法术语
        $categories = get_the_terms(get_the_ID(), 'my_categories');

        if (!empty($categories) && !is_wp_error($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="' . get_term_link($cat->term_id, 'my_categories') . '">' . esc_html($cat->name) . '</a></li>';
            }
            echo '</ul>';
        }
        ?>
    <?php endwhile; ?>
<?php endif; ?>

登录后复制

代码解释：

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中文网其它相关文章！