本文详解如何在 wordpress 自定义查询中正确获取一篇文章所属的所有自定义分类法（taxonomy）的 slug，并合并为无尾逗号的逗号分隔字符串，用于 css 类名和 data 属性，避免仅显示单个分类的常见错误。
本文详解如何在 wordpress 自定义查询中正确获取一篇文章所属的所有自定义分类法（taxonomy）的 slug，并合并为无尾逗号的逗号分隔字符串，用于 css 类名和 data 属性，避免仅显示单个分类的常见错误。
在 WordPress 开发中，当使用 get_the_terms() 获取文章所属的多个分类（如自定义分类法 blog_categories）时，直接在 foreach 循环中反复赋值 $slug = $category->slug 会导致仅保留最后一个分类的 slug——这正是原代码无法显示全部分类的根本原因。正确做法是：先将所有 slug 收集到数组中，再用 implode() 统一拼接。
以下为优化后的完整代码示例，已修复逻辑缺陷，并增强安全性与可维护性：
<?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');
$slugs = array();
if (!is_wp_error($work_category) && !empty($work_category)) {
foreach ($work_category as $category) {
if (isset($category->slug)) {
$slugs[] = sanitize_html_class($category->slug); // 防 XSS，适合作为 class 名
}
}
}
$slug_list = !empty($slugs) ? implode(',', $slugs) : 'uncategorized';
// 输出 HTML：同时应用于 class 和 data-category，且已转义
?>
<div class="portfolio-item <?php echo esc_attr($slug_list); ?>" data-category="<?php echo esc_attr($slug_list); ?>">
<!-- 此处插入文章内容，如 the_title(), the_excerpt() 等 -->
</div>
<?php endwhile;
wp_reset_postdata(); // 每次自定义查询后必须调用
endif;
?>
✅ 关键改进说明：
- 数组收集 + implode()：用 $slugs[] = ... 累积所有 slug，再通过 implode(',', $slugs) 生成标准逗号分隔字符串，天然支持 1 个或 N 个分类（无需额外判断是否加逗号）。
- 错误与空值防护：get_the_terms() 可能返回 WP_Error 或空数组，必须用 !is_wp_error() 和 !empty() 双重校验。
- 安全输出：esc_attr() 确保输出到 HTML 属性中的字符串不引发 XSS；sanitize_html_class() 进一步规范化 slug（如去除特殊字符），保障 CSS 类名有效性。
- 性能提示：若仅需分类 slug（无需对象其他字段），可考虑 wp_get_post_terms( $post_id, 'blog_categories', [ 'fields' => 'slugs' ] )，更轻量。
⚠️ 注意事项：
- 切勿在循环内遗漏 wp_reset_postdata()，否则会影响后续主循环（如页面底部的 the_post()）；
- 若 blog_categories 是自定义分类法，请确保其已在 register_taxonomy() 中正确注册并关联到 blog 自定义文章类型；
- 浏览器开发者工具中检查生成的 class 和 data-category 属性，确认值为 cate1,cate2,cate3 格式，而非重复渲染多个 （原代码因循环位置错误曾导致每个分类都输出一个 div）。
掌握这一模式后，你不仅能精准渲染多分类标识，还可轻松扩展至标签（tags）、产品属性等任意分类法场景。
