ACF 嵌套字段数据插入技巧：高效复制字段组数据

2024-12-26 06:22:03

嵌套字段数据插入技巧

问题剖析

在处理自定义字段（例如 Advanced Custom Fields, ACF）时，经常需要将数据从一个地方复制到另一个地方。特别是在使用嵌套字段，或者说字段组时，数据插入可能会变得复杂。例如，将某个文章的自定义字段组的数据，复制到另一个文章的对应字段组。直接使用 $meta_input 并不能将整个数组直接复制过去，这导致目标文章的字段组虽然存在，但内容却是空的。具体问题就出在 $meta_input 的结构与字段组期望的结构不匹配。实际上，ACF会将字段组内的字段存储为带有前缀的独立元数据条目。

解决方法一：手动构建 `meta_input`

最直接的方法就是将嵌套字段展开，手动构建目标 meta_input 数组。每一个嵌套的子字段都需要一个单独的键值对，并且键需要符合 ACF 字段命名的规则，也就是包含父字段组的名称前缀，通常格式是 <父字段组名称>_<子字段名称>。

操作步骤：

获取源文章的字段值，即包含嵌套字段组的数组。
遍历嵌套字段组，构建新的 $meta_input 数组。键需使用 <父字段组名称>_<子字段名称> 的格式。
将新的 $meta_input 数组传递给 wp_insert_post 函数。

代码示例：

<?php
function insert_data_with_nested_fields($source_post_id) {
  $source_fields = get_fields($source_post_id);

    if(!$source_fields) {
      return;
    }

    $meta_input = [];
    
    if (isset($source_fields["author"])) {
      $meta_input["author"] = $source_fields["author"];
    }
  
  // 手动展开 primary_info 字段组
    if(isset($source_fields["primary_info"])){
      $primary_info = $source_fields["primary_info"];

        if (isset($primary_info["full_name"])) {
          $meta_input["primary_info_full_name"] = $primary_info["full_name"];
        }

        if (isset($primary_info["short_name"])) {
            $meta_input["primary_info_short_name"] = $primary_info["short_name"];
        }
      }

  $result = wp_insert_post([
    "post_type"   => "institution",
    "post_title"  => get_post($source_post_id)->post_title,
    "post_status" => "publish",
    "meta_input"  => $meta_input,
    ]);

    return $result;
}
// 使用示例
$new_post_id = insert_data_with_nested_fields(123); // 假设 123 是源文章ID

这个方案虽然直接，但在字段组内包含很多字段时，需要大量的手动构建代码。每次字段修改或添加都需要同步更新代码，增加了维护成本，且容易出错。

解决方法二：使用 `update_field` 函数

ACF 提供 update_field 函数，可以更加方便的处理嵌套字段，避免了手动展开数组的过程。使用该函数可以直接将数组形式的字段数据，更新到相应的字段组，同时它也处理了字段组字段的存储结构，自动完成嵌套数据扁平化处理。

操作步骤:

获取源文章的字段值。
使用 wp_insert_post 函数创建新的文章，无需在 meta_input 中包含嵌套字段数据。
获取新文章的 ID。
针对需要复制的嵌套字段组，使用 update_field 函数，并传入新文章的ID、字段组的键名以及源字段组的数据数组。

代码示例：

<?php
function insert_data_with_update_field($source_post_id) {
    $source_fields = get_fields($source_post_id);

    if(!$source_fields){
        return;
    }


    $new_post_id = wp_insert_post([
        "post_type"   => "institution",
        "post_title"  => get_post($source_post_id)->post_title,
        "post_status" => "publish",
    ]);

   if (isset($source_fields["author"])) {
    update_field('author', $source_fields['author'], $new_post_id);
    }
    
    // 使用 update_field 函数更新整个 primary_info 字段组
     if (isset($source_fields["primary_info"])) {
    update_field('primary_info', $source_fields["primary_info"], $new_post_id);
   }


    return $new_post_id;
}
// 使用示例
$new_post_id = insert_data_with_update_field(123); // 假设 123 是源文章ID