如何在 ACF 短代码中通过字段名动态输出不同格式的值？

本文介绍一种基于 php `switch` 语句的通用 acf 短代码方案，只需一个函数即可适配多个自定义字段（如 distance、time 等），自动匹配图标、标签和 html 结构，避免重复编写 15+ 个冗余短代码。

在 WordPress 中结合 Advanced Custom Fields（ACF）开发短代码时，若为每个字段（如 distance、time、location、price 等）单独编写短代码函数，不仅代码冗余度高、维护困难，也违背 DRY（Don’t Repeat Yourself）原则。理想的解决方案是：复用同一短代码函数，根据传入的 field 参数动态决定渲染逻辑。

PHP 的 switch 语句正是为此类多分支条件判断而生——它比嵌套 if/else if 更清晰、更易扩展，且执行效率更高。以下是一个优化后的通用 ACF 短代码实现：

function acf_generic_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 '';
    }

    // 若值为数组，转为逗号分隔字符串（抑制警告使用 @ 已不推荐，改用 is_array + implode）
    if ( is_array( $value ) ) {
        $value = implode( ', ', array_map( 'esc_html', $value ) );
    } else {
        $value = esc_html( $value );
    }

    // 根据 field 名称动态生成结构化 HTML（支持扩展）
    $output = '';
    switch ( strtolower( $atts['field'] ) ) {
        case 'distance':
            $output = '@@##@@<br><p>Distance: ' . $value . '</p>';
            break;

        case 'time':
            $output = '@@##@@<br><p>Time: ' . $value . '</p>';
            break;

        case 'location':
            $output = '@@##@@<br><p>Location: ' . $value . '</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1461" title="VIVA"><img
                                                                                src="https://img.php.cn/upload/ai_manual/000/000/000/175680148246307.png" alt="VIVA"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1461" title="VIVA">VIVA</a>
                                                                        <p>一个免费的AI创意视觉设计平台</p>
                                                                </div>
                                                                <a href="/ai/1461" title="VIVA" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div>';
            break;

        case 'price':
            $output = '<span class="price-label">?</span> <strong>Price:</strong> ' . $value;
            break;

        default:
            // 可选：对未定义字段回退为简洁文本输出
            $output = '<p><strong>' . ucfirst( $atts['field'] ) . ':</strong> ' . $value . '</p>';
            break;
    }

    return $output;
}
add_shortcode( 'acf', 'acf_generic_shortcode' );

✅ 使用方式示例：

[acf field="distance"]  
[acf field="time" post_id="123"]  
[acf field="location" format_value="false"]

? 关键优化点说明：

• ✅ 安全强化：使用 esc_url()、esc_html() 防止 XSS；get_template_directory_uri() 替代硬编码路径，提升主题兼容性；
• ✅ 健壮性提升：strtolower() 统一字段名大小写，避免因 Distance / DISTANCE 匹配失败；
• ✅ 可维护性强：新增字段只需在 switch 中追加一个 case，无需新建函数或短代码；
• ✅ 默认兜底：default 分支确保未知字段仍能安全输出，避免空白或报错；
• ⚠️ 注意：请将 SVG 图标实际存放于主题 /assets/images/ 目录下，并确认路径正确；如使用子主题，请改用 get_stylesheet_directory_uri()。

该方案将原本需维护 15+ 个函数的工程，压缩为单一、高内聚、易扩展的短代码入口，大幅提升开发效率与长期可维护性。