如何在前端表单中修改Listing的ACF自定义字段值？

方案一：手动整合现有表单处理ACF字段保存 #

步骤1：修正前端输入框的name属性 #

将输入框的name属性改为与ACF字段名完全一致，避免因字段名不匹配导致无法识别：

<!-- 公司成立年份字段 -->
<div class="col-lg-12 col-md-12">
  <div class="form-group">
    <label>Année de création</label>
    <input class="form-control" name="annee_de_creation" type="number" placeholder="2004" value="<?php the_field( 'annee_de_creation' ); ?>">
  </div>
</div>

<!-- 员工数量字段 -->
<div class="col-lg-12 col-md-12">
  <div class="form-group">
    <label>Nombre d'employés</label>
    <input class="form-control" name="nombre_d’employes" type="number" placeholder="50" value="<?php the_field( 'nombre_d’employes' ); ?>">
  </div>
</div>

步骤2：添加后端保存逻辑 #

找到主题中处理编辑表单提交的PHP代码（通常在functions.php或专门的表单处理文件内），在默认字段（邮箱、电话等）的保存逻辑后，添加ACF字段的保存代码：

// 仅处理POST请求且验证用户登录状态
if ($_SERVER['REQUEST_METHOD'] === 'POST' && is_user_logged_in()) {
    // 获取当前编辑的Listing ID（若主题通过URL参数传递ID，需改为$listing_id = intval($_GET['listing_id'])）
    $listing_id = get_the_ID();
    
    // 验证用户编辑权限
    if (!current_user_can('edit_post', $listing_id)) {
        wp_die('无编辑权限');
    }

    // 保存公司成立年份（添加基础数据验证）
    if (isset($_POST['annee_de_creation'])) {
        $valid_year = intval($_POST['annee_de_creation']);
        if ($valid_year >= 1900 && $valid_year <= date('Y')) {
            update_field('annee_de_creation', $valid_year, $listing_id);
        }
    }

    // 保存员工数量（添加基础数据验证）
    if (isset($_POST['nombre_d’employes'])) {
        $valid_employees = intval($_POST['nombre_d’employes']);
        if ($valid_employees > 0) {
            update_field('nombre_d’employes', $valid_employees, $listing_id);
        }
    }
}

方案二：使用ACF官方的acf_form()实现 #

如果手动整合成本高，推荐用ACF自带的acf_form()方法，它会自动处理字段渲染、验证和保存，只需正确配置参数：

步骤1：加载ACF表单头部脚本 #

在编辑页面模板的最顶部（get_header()之前）添加代码，确保ACF的前端表单资源正常加载：

<?php acf_form_head(); ?>
<?php get_header(); ?>

步骤2：渲染ACF编辑表单 #

在现有表单的合适位置（或替换原有表单）添加以下代码：

<?php
$listing_id = get_the_ID();

acf_form(array(
    'post_id'           => $listing_id, // 绑定当前编辑的Listing
    'field_groups'      => array('group_123456'), // 替换为你的ACF字段组ID（在字段组编辑页URL中查看，格式为group_xxxxxx）
    'form'              => true,
    'return'            => get_permalink($listing_id), // 提交后返回当前编辑页
    'html_before_fields' => '<div class="form-container">', // 适配主题表单容器样式
    'html_after_fields'  => '</div>',
    'submit_value'      => __('保存修改', 'your-theme'), // 自定义提交按钮文字
));
?>

常见问题排查 #

1. 字段名不匹配：确认输入框name属性与ACF字段名完全一致，注意法语特殊字符’不要打错。
2. Listing ID错误：保存字段时必须传递正确的Listing（Post）ID，否则会保存到错误对象上。
3. 权限不足：通过current_user_can('edit_post', $listing_id)验证当前用户是否拥有编辑权限。
4. 字段组设置：确保ACF字段组的位置规则正确（需设置为显示在你的Listing自定义文章类型上）。

内容的提问来源于stack exchange，提问作者Moerip