WordPress自定义佣金计算无法保存至ACF字段求助

我正在开发一个WordPress项目，使用Advanced Custom Fields（ACF）处理自定义文章元数据。编写了一个挂钩save_post_vehicles动作的函数，基于“车辆价格”及其他设置计算“佣金”。计算过程正常，但无法将结果保存到车辆自定义文章的ACF字段中。

以下是我的函数代码：

<?php
declare(strict_types=1);

// Set up vehicle_commission calculation and add to vehicle post;
// Use a priority greater than 10
add_action('save_post_vehicles', 'calculate_vehicle_commission', 20, 3);

function calculate_vehicle_commission($post_id, $post, $update) {
// Debugging
error_log("---- Starting Debug ----");
error_log("Hook Fired for Post ID: " . $post_id);

if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
error_log("Skipping due to autosave");
return;
}

// Use get_post_type instead of accessing $post->post_type directly
if (get_post_type($post_id) === 'acf') {
error_log("Skipping due to ACF save");
return;
}

if (wp_is_post_revision($post_id)) {
error_log("Skipping due to post revision");
return;
}

if ($update === false) {
error_log("Skipping due to new post creation");
return;
}

// Use is_wp_error to check for errors
$vehicle_price = get_field('field_60c7ac8043c4b', $post_id);
if (is_wp_error($vehicle_price)) {
error_log("Error getting vehicle price: " . $vehicle_price->get_error_message());
return;
}
error_log("Vehicle Price: {$vehicle_price}");

// Use is_wp_error to check for errors
$commission_settings = get_field('commission', 'option');
if (is_wp_error($commission_settings)) {
error_log("Error getting commission settings: " . $commission_settings->get_error_message());
return;
}

// Use wp_parse_args to merge with default settings
$default_settings = [
'initial_rate' => 0,
'reduced_rate' => 0,
'price_point' => 0,
];
$commission_settings = wp_parse_args($commission_settings, $default_settings);

// Extract settings from array
extract($commission_settings);

error_log("Initial Rate: {$initial_rate}");
error_log("Reduced Rate: {$reduced_rate}");
error_log("Price Point: {$price_point}");

if (!is_numeric($vehicle_price) || !is_numeric($initial_rate) || !is_numeric($reduced_rate) || !is_numeric($price_point)) {
error_log("Validation failed. Data dump: " . print_r([
'vehicle_price' => $vehicle_price,
'initial_rate' => $initial_rate,
'reduced_rate' => $reduced_rate,
'price_point' => $price_point,
], true));
return;
}

$commission = 0;
if ($vehicle_price < $price_point) {
$commission = ($vehicle_price * $initial_rate) / 100;
} else {
$commission = ($vehicle_price * $reduced_rate) / 100;
}

// Use number_format_i18n instead of number_format
$commission = number_format_i18n((float)$commission, 2);

error_log("Calculated Commission: " . $commission);

// Using the field key instead of the field name vehicle_commission
$result = update_field('field_64f0d346807d5', $commission, $post_id);

error_log("Meta Updated: " . ($result ? "1" : "0"));

error_log("---- Ending Debug ----");
}

已尝试的方法：

• 使用update_post_meta()更新字段；
• 检查WordPress和PHP错误日志；
• 使用error_log()输出调试信息。

调试显示钩子已触发，计算也完成，但update_post_meta()似乎无法更新ACF字段。请问可能遗漏了什么？

1. 检查字段键匹配度 #

ACF的update_field()依赖字段键精准匹配，需确认field_64f0d346807d5是“佣金”字段的正确键值——可在ACF字段组编辑页面开启「屏幕选项」中的「字段键」显示，直接查看对应字段的键。

2. 移除格式化字符串的操作 #

number_format_i18n()会生成带千位分隔符的字符串（如1,234.56），而ACF数值字段通常要求存储原始浮点/整数类型，这类格式化字符串可能被ACF判定为无效值而拒绝保存。将代码修改为：

// 替换原格式化代码
$commission = round((float)$commission, 2);

3. 调整钩子优先级或替换钩子 #

save_post_vehicles的执行时机可能早于或同步于ACF自身的保存逻辑，导致你的修改被覆盖：

• 提高钩子优先级至30及以上：add_action('save_post_vehicles', 'calculate_vehicle_commission', 30, 3);
• 改用ACF专属钩子acf/save_post，针对性处理车辆文章类型：

add_action('acf/save_post', 'calculate_vehicle_commission', 20);
function calculate_vehicle_commission($post_id) {
    if (get_post_type($post_id) !== 'vehicles') return;
    // 后续原有逻辑保持不变
}

4. 补充权限检查 #

确保当前操作的用户拥有编辑该自定义文章类型的权限，ACF可能在权限不足时静默拒绝保存，可在函数开头添加：

if (!current_user_can('edit_post', $post_id)) {
    error_log("Insufficient permissions to edit post {$post_id}");
    return;
}

5. 手动更新元数据的正确方式 #

若使用update_post_meta()，需匹配ACF字段对应的元键：

• 数值字段的元键通常是字段名（如vehicle_commission），同时需更新关联的字段键元数据（前缀为_）：

update_post_meta($post_id, 'vehicle_commission', $commission);
update_post_meta($post_id, '_vehicle_commission', 'field_64f0d346807d5');

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