本文详解如何正确获取 WordPress 自定义文章类型（如 blog）下某篇文章所属的全部分类（taxonomy）slug，并拼接为安全、无尾逗号的逗号分隔字符串，用于 HTML 类名与 data 属性。
本文详解如何正确获取 wordpress 自定义文章类型（如 `blog`）下某篇文章所属的全部分类（taxonomy）slug，并拼接为安全、无尾逗号的逗号分隔字符串，用于 html 类名与 data 属性。
在 WordPress 开发中，当使用自定义文章类型（如 blog）配合自定义分类法（如 blog_categories）时，常需将文章所属的多个分类 slug 同时输出到 HTML 元素中——例如作为
的 class 或 data-category 属性值，以支持前端筛选、样式控制或 JS 交互。但若直接在循环中覆盖变量（如 $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');
// 安全处理：检查是否返回有效数组（避免 PHP 警告）
$slugs = array();
if (!is_wp_error($work_category) && !empty($work_category)) {
foreach ($work_category as $category) {
$slugs[] = $category->slug;
}
}
// 拼接为逗号分隔字符串
$slug_list = implode(',', $slugs);
// 输出 HTML —— 务必使用 esc_attr() 过滤输出，防止 XSS
?>
<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()：$slugs[] = $category->slug 累积所有 slug，implode(',', $slugs) 自动处理单/多元素场景（1 个时不加逗号，多个时自然分隔）。
- 错误与空值防护：get_the_terms() 可能返回 WP_Error 或 false，务必用 !is_wp_error() 和 !empty() 双重校验。
- 安全输出：HTML 属性值必须通过 esc_attr() 转义，避免特殊字符（如空格、引号）破坏 DOM 结构或引发安全风险。
- 性能提示：posts_per_page => -1 表示不限数量，但生产环境建议配合分页或缓存机制，避免海量数据查询拖慢页面。
- 替代方案：若仅需前端 JS 可读的分类列表（无需空格/特殊字符），也可改用 JSON 编码：json_encode(wp_list_pluck($work_category, 'slug'))。
遵循以上写法，即可稳定、安全、可扩展地实现“多分类逗号分隔输出”，适用于 Masonry 布局、动态筛选、CSS 按分类着色等多种场景。
