WordPress ACF调用字段教程：通过短代码显示自定义字段内容

什么是ACF字段调用？

在使用 WordPress 建站时，很多站长都会安装 ACF（Advanced Custom Fields）插件来扩展文章、页面或产品的数据字段。

例如：

• • 联系电话

• • 公司地址

• • 产品参数

• • SEO信息

• • 客户案例信息

正常情况下，ACF字段需要在主题模板中通过 PHP 代码调用。
但如果只是想在文章、页面或者古腾堡编辑器中显示字段内容，每次修改模板会非常麻烦。
这时候就可以使用自定义短代码来调用 ACF 字段。

实现效果

假设我们创建了一个字段：

字段名称：company_name字段值：深圳XX网络科技有限公司

在文章中输入：

[acf field="company_name"]

前台即可输出：

深圳XX网络科技有限公司

无需修改模板文件。

添加ACF短代码

打开主题的 functions.php 文件。

添加以下代码：

// 自定义ACF短代码，直接显示字段数值（无样式，默认字体）
add_shortcode('my_acf', function($atts) {
    // 解析短代码参数（支持 field="字段名"）
    $atts = shortcode_atts(array(
        'field' => '', // 字段名（必填）
    ), $atts);

    // 1. 检查ACF是否激活
    if (!function_exists('get_field')) {
        return ''; // ACF未激活，不显示任何内容
    }

    // 2. 检查字段名是否填写
    if (empty($atts['field'])) {
        return ''; // 字段名为空，不显示
    }

    // 3. 获取字段值，直接返回纯文本（无额外样式）
    $field_value = get_field($atts['field']);
    return empty($field_value) ? '' : esc_html($field_value);
});

保存后即可使用。

代码说明

• 仅输出字段的纯文本内容，不会添加任何额外样式（继承页面默认字体）；
• 自动兼容 ACF 的基础字段类型（文本、数字、单选等）；
• 包含容错逻辑：ACF 未激活、字段名未填写、字段值为空时，均不会显示错误内容，避免影响页面布局。

在古腾堡编辑器中使用

该短代码支持：

• • 文章内容

• • 页面内容

• • 古腾堡短代码区块

• • Blocksy主题页面

• • WooCommerce自定义页面

只需要插入短代码即可显示对应字段内容。

常见问题：为什么没有显示内容？

请检查：

1. 1. ACF插件是否已安装

1. 1. 字段名称是否正确

1. 1. 当前页面是否存在该字段数据

常见问题：为什么没有显示内容？

这个方法特别适合：

• • 企业官网

• • 产品展示网站

• • Blocksy主题网站

• • WooCommerce商城

• • 自定义内容管理系统

总结

如果需要频繁在页面中展示ACF数据，使用短代码会比修改模板更加方便。
通过自定义短代码，我们可以直接在 WordPress 文章、页面和古腾堡编辑器中调用 ACF 字段内容，无需反复修改主题模板。
对于使用 Blocksy、WooCommerce 或企业官网的站长来说，这是一个非常实用的小技巧。