
本教程详细介绍了如何在wordpress中为自定义文章类型获取并显示其关联的自定义分类法术语,以及如何根据这些术语筛选文章。文章强调应使用get_terms()函数替代get_categories()来处理自定义分类法,并利用wp_query的tax_query参数实现精确的文章筛选,同时提供了完整的代码示例和最佳实践。
在WordPress中,"分类"(Category)和"标签"(Tag)是两种内置的分类法(Taxonomy),用于组织文章(Post)。当开发者创建自定义文章类型(Custom Post Type, CPT)时,通常也会为其注册自定义分类法,以实现更灵活的内容组织。例如,如果注册了一个名为pdf的自定义文章类型,并为其注册了一个名为pdf_cat的自定义分类法,那么pdf_cat就是专门用于pdf文章类型的“分类”。
需要明确的是,WordPress核心函数get_categories()专门用于获取默认的category分类法中的术语(terms)。当尝试获取自定义分类法中的术语时,直接使用get_categories()并传入post_type参数是无效的,因为它不会识别自定义分类法。正确的做法是使用get_terms()函数。
根据您在functions.php中的代码片段,您已经为pdf文章类型注册了一个名为pdf_cat的自定义分类法:
$args = array(
'label' => 'category', // 这里的label只是后台显示,不代表分类法slug
'public' => true,
'show_ui' => true,
'show_in_nav_menus' => true,
'show_admin_column' => true,
'hierarchical' => true,
'query_var' => true
);
register_taxonomy('pdf_cat', 'pdf', $args);这里的关键是register_taxonomy('pdf_cat', 'pdf', $args);,它定义了自定义分类法的slug为pdf_cat,并将其关联到pdf文章类型。
要获取pdf_cat分类法中的所有术语,应该使用get_terms()函数。此函数允许您指定要查询的分类法slug。
以下是获取并显示pdf_cat分类法中所有术语的示例代码:
<?php
$args = array(
'taxonomy' => 'pdf_cat', // 指定自定义分类法slug
'hide_empty' => false, // 是否隐藏没有关联文章的术语
'orderby' => 'name', // 按名称排序
'order' => 'ASC', // 升序
);
$categories = get_terms($args); // 注意这里是get_terms
if (!empty($categories) && !is_wp_error($categories)) {
echo '<select>'; // 示例:在一个下拉菜单中显示
foreach ($categories as $category) {
// 使用get_term_link获取术语链接,并进行URL转义
$term_link = get_term_link($category);
if (!is_wp_error($term_link)) {
echo '<option value="' . esc_attr($category->slug) . '">'; // value可以是slug或ID
echo '<a class="ctg" href="' . esc_url($term_link) . '">' . esc_html($category->name) . '</a>';
echo '</option>';
}
}
echo '</select>';
} else {
echo '<p>未找到任何PDF分类。</p>';
}
?>代码解析:
当需要根据自定义分类法中的某个术语来筛选并显示文章时,不能使用cat参数(该参数仅适用于默认的category分类法),而应该使用WP_Query中的tax_query参数。
以下是如何根据pdf_cat分类法中的特定术语来查询pdf文章类型的示例:
<?php
// 假设我们从URL或其他方式获取到当前需要筛选的分类术语
// 例如,如果是在一个自定义分类归档页面,可以通过get_query_var('term')获取slug
// 或者通过get_query_var('taxonomy')获取当前分类法slug
$current_term_slug = get_query_var('term'); // 获取当前分类术语的slug
$taxonomy_slug = 'pdf_cat'; // 你的自定义分类法slug
// 验证并获取分类术语对象
$current_term = null;
if ($current_term_slug) {
$current_term = get_term_by('slug', $current_term_slug, $taxonomy_slug);
}
if ($current_term && !is_wp_error($current_term)) {
$paged = get_query_var('paged', 1); // 获取当前页码,用于分页
$posts_per_page = 15; // 每页显示的文章数量
$args = array(
'post_type' => 'pdf', // 指定自定义文章类型
'posts_per_page' => $posts_per_page,
'paged' => $paged,
'tax_query' => array( // 使用tax_query进行分类法筛选
array(
'taxonomy' => $taxonomy_slug, // 指定自定义分类法slug
'field' => 'term_id', // 可以是 'term_id', 'slug', 'name'
'terms' => $current_term->term_id, // 指定要筛选的术语ID
'operator' => 'IN', // 术语匹配操作符
),
),
// 'orderby' => 'date', // 可以添加其他查询参数
// 'order' => 'DESC',
);
$custom_query = new WP_Query($args); // 使用WP_Query进行查询
if ($custom_query->have_posts()) :
echo '<h2>' . esc_html($current_term->name) . '分类下的PDF文件</h2>';
echo '<ul>';
while ($custom_query->have_posts()) : $custom_query->the_post();
echo '<li><a href="' . esc_url(get_permalink()) . '">' . esc_html(get_the_title()) . '</a>以上就是WordPress自定义文章类型:正确获取和筛选自定义分类法术语的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号