本文详解如何在wordpress主题开发中正确获取一篇文章所属的所有自定义分类（taxonomy）的slug，并拼接为逗号分隔的字符串，避免仅显示单个分类的常见错误。
本文详解如何在wordpress主题开发中正确获取一篇文章所属的所有自定义分类（taxonomy）的slug，并拼接为逗号分隔的字符串，避免仅显示单个分类的常见错误。
在WordPress中，使用 get_the_terms() 获取文章所属的多个分类时，若直接在循环中反复赋值 $slug = $category->slug，最终只会保留最后一个分类的 slug —— 这正是原始代码中“只显示一个分类”的根本原因。正确做法是：先将所有分类 slug 收集到数组中，再通过 implode() 合并为字符串。
以下是优化后的完整实现代码（已适配 WordPress 最佳实践）：
<?php $mi_args = array(
'post_status' => 'publish',
'posts_per_page' => -1, // 推荐用 -1 替代 99999，语义更清晰且性能更优
'post_type' => 'blog',
);
$mi_query = new WP_Query($mi_args);
if ($mi_query->have_posts()) :
while ($mi_query->have_posts()) : $mi_query->the_post();
$portfolio_url = get_post_meta(get_the_ID(), 'portfolio_url_portfolio-url', true);
$hover_color = get_post_meta(get_the_ID(), 'hove_color_hover-color', true);
// 获取当前文章在 'blog_categories' 自定义分类法下的所有术语对象
$work_category = get_the_terms(get_the_ID(), 'blog_categories');
// 初始化空数组用于存储 slug，并做容错处理
$slugs = array();
if (!is_wp_error($work_category) && !empty($work_category)) {
foreach ($work_category as $category) {
if (isset($category->slug) && !empty($category->slug)) {
$slugs[] = sanitize_html_class($category->slug); // 安全过滤，适合作为 CSS 类名
}
}
}
// 拼接为逗号分隔字符串；若无分类则为空字符串
$slug_list = !empty($slugs) ? implode(',', $slugs) : '';
// 输出 HTML：注意使用 esc_attr() 防止 XSS，且 class 和 data-category 均应转义
?>
<div class="portfolio-item <?php echo esc_attr($slug_list); ?>" data-category="<?php echo esc_attr($slug_list); ?>">
<!-- 此处可插入文章标题、缩略图等内容 -->
<h3><?php the_title(); ?></h3>
</div>
<?php endwhile;
wp_reset_postdata(); // 必须调用，恢复全局 $post 对象
endif;
?>
✅ 关键改进点说明：
- 数组收集 + implode()：取代覆盖式赋值，确保所有分类 slug 均被保留；
- 安全过滤：sanitize_html_class() 确保 slug 可安全用作 CSS 类名（自动移除特殊字符、转换空格为连字符等）；
- 严格容错：检查 get_the_terms() 是否返回 WP_Error 或空数组，避免 PHP 警告；
- 输出转义：esc_attr() 保障 class 和 data-category 属性内容符合 HTML 规范，防止注入风险；
- 性能提示：posts_per_page => -1 比超大数字更规范，但生产环境建议配合分页或缓存机制，避免海量数据查询。
? 扩展建议：
如需按特定顺序（如字母序或分类ID）排列分类，可在 foreach 前对 $work_category 使用 wp_list_sort()；若需中文名称而非 slug，可改用 $category->name 并配合 esc_html() 输出。
掌握这一模式，即可灵活应用于标签（post_tag）、自定义分类法等多种场景，大幅提升 WordPress 主题与插件的健壮性与可维护性。
