WordPress文章保存后高级数据同步：正确使用钩子处理ACF字段

/**
 * 在文章及其所有元数据保存后，同步 award_category 文章到 WooCommerce 产品。
 *
 * @param int      $post_id     文章ID。
 * @param WP_Post  $post_object 文章对象。
 * @param bool     $update      是否为更新操作。
 * @param WP_Post  $post_before 更新前的文章对象 (新文章为 null)。
 */
function sync_award_category_to_product( $post_id, $post_object, $update, $post_before ) {
    // 1. 确保只处理 'award_category' 类型的文章
    if ( 'award_category' !== $post_object->post_type ) {
        return;
    }

    // 2. 避免在处理草稿、自动保存或回收站中的文章
    if ( in_array( $post_object->post_status, array( 'draft', 'auto-draft', 'inherit', 'trash' ) ) ) {
        return;
    }

    $product_id = 0; // 初始化产品ID

    // 3. 检查是否已存在同名的WooCommerce产品
    $existing_product = get_page_by_path( $post_object->post_name, OBJECT, 'product' );

    if ( $existing_product ) {
        $product_id = $existing_product->ID;
    } else {
        // 4. 如果不存在，则创建新的WooCommerce产品
        $new_product_id = wp_insert_post( array(
            'post_title'  => $post_object->post_title, // 使用传入的 $post_object 的标题
            'post_type'   => 'product',
            'post_status' => 'publish',
        ) );

        if ( ! is_wp_error( $new_product_id ) ) {
            $product_id = $new_product_id;
        } else {
            // 错误处理：记录日志
            error_log( 'Failed to create WooCommerce product for award category ' . $post_id . ': ' . $new_product_id->get_error_message() );
            return;
        }
    }

    // 5. 确保产品ID有效
    if ( ! $product_id ) {
        error_log( 'Product ID not found or created for award category ' . $post_id );
        return;
    }

    // 6. 获取ACF字段数据。
    // 假设 'all_fields' 是一个返回数组的ACF字段，其中包含 'description' 键。
    // 如果 'description' 是一个独立的ACF字段，可以直接使用 get_field('description', $post_id)。
    $award_category_acf_fields = get_field( 'all_fields', $post_id );

    // 7. 检查是否成功获取ACF字段且包含 'description'
    if ( is_array( $award_category_acf_fields ) && isset( $award_category_acf_fields['description'] ) ) {
        // 8. 更新WooCommerce产品的描述字段
        update_field( 'description', $award_category_acf_fields['description'], $product_id );
    } else {
        error_log( 'ACF field "description" not found or "all_fields" is not an array for award category ' . $post_id );
    }
}

// 注册钩子，优先级为10，接受4个参数
add_action( 'wp_after_insert_post', 'sync_award_category_to_product', 10, 4 );

/**
 * 在文章元数据更新后，同步 award_category 文章到 WooCommerce 产品。
 * 此钩子在任何文章元数据更新时触发，需谨慎判断。
 *
 * @param int    $meta_id      更新的元数据条目ID。
 * @param int    $post_id      文章ID。
 * @param string $meta_key