本文介绍如何使用 php 的 `switch` 语句统一处理多个 acf 自定义字段的短代码逻辑，避免为每个字段重复编写独立函数，显著提升代码可维护性与扩展性。
在 WordPress 中结合 Advanced Custom Fields（ACF）开发短代码时，若为每个字段（如 distance、time、price、location 等）单独编写一个短代码函数，不仅代码冗余严重，后期维护和新增字段也极为低效。理想方案是创建一个通用短代码函数，根据传入的 field 参数值，动态匹配并渲染对应图标、标签与格式化 HTML。
核心思路是：提取 field 属性 → 获取字段值 → 按字段名分类处理 → 统一返回结构化 HTML。推荐使用 switch 语句替代多层 if/elseif，逻辑清晰、易读性强，且便于后续扩展。
以下是优化后的通用短代码实现：
function acf_generic_field_shortcode( $atts ) {
// 默认参数及属性解析
$atts = shortcode_atts( array(
'field' => '',
'post_id' => false,
'format_value' => true
), $atts );
// 字段名必须提供，否则退出
if ( empty( $atts['field'] ) ) {
return '';
}
// 获取 ACF 字段值
$value = get_field( $atts['field'], $atts['post_id'], $atts['format_value'] );
if ( empty( $value ) ) {
return '';
}
// 数组值转为逗号分隔字符串（兼容多选、关系等字段）
if ( is_array( $value ) ) {
$value = implode( ', ', array_map( 'esc_html', $value ) );
} else {
$value = esc_html( $value );
}
// 根据字段名动态生成 HTML（支持大小写不敏感匹配）
$field_key = strtolower( $atts['field'] );
$html = '';
switch ( $field_key ) {
case 'distance':
$html = '<img src="' . esc_url( get_template_directory_uri() . '/assets/images/distance-logo.svg' ) . '" alt="Distance" class="svg-img"><br><p>Distance: ' . $value . '</p>';
break;
case 'time':
$html = '<img src="' . esc_url( get_template_directory_uri() . '/assets/images/time-logo.svg' ) . '" alt="Time" class="svg-img"><br><p>Time: ' . $value . '</p>';
break;
case 'price':
$html = '<img src="' . esc_url( get_template_directory_uri() . '/assets/images/price-logo.svg' ) . '" alt="Price" class="svg-img"><br><p>Price: ' . $value . '</p>';
break;
case 'location':
$html = '<img src="' . esc_url( get_template_directory_uri() . '/assets/images/location-logo.svg' ) . '" alt="Location" class="svg-img"><br><p>Location: ' . $value . '</p>';
break;
// ✅ 新增字段只需在此添加新 case，无需新建函数
default:
// 可选：对未定义字段回退为简洁文本输出
$html = '<p><strong>' . ucfirst( $atts['field'] ) . ':</strong> ' . $value . '</p>';
break;
}
return $html;
}
add_shortcode( 'acf_field', 'acf_generic_field_shortcode' );✅ 使用方式示例（在文章或页面中）：
立即学习“前端免费学习笔记（深入）”；
[acf_field field="distance"] [acf_field field="time" post_id="123"] [acf_field field="price" format_value="false"]
⚠️ 关键注意事项：
- 路径安全：SVG 图标建议存放在主题目录下，并使用 get_template_directory_uri() + esc_url() 构建 URL，防止 XSS 和路径错误；
- 输出转义：所有用户数据（$value）均经 esc_html() 处理，数组元素也逐个转义，保障安全性；
- 容错设计：default 分支确保未知字段仍能安全输出，避免空白或报错；
- 性能友好：仅一次 get_field() 调用，无重复查询；
- 可扩展性：新增字段只需在 switch 中追加 case，无需注册新短代码或修改钩子逻辑。
通过该方案，原本需维护 15+ 个函数的工作，简化为单个健壮、可配置的短代码，大幅提升开发效率与长期可维护性。
