Carbon Fields问题：选中的分类未关联至WordPress文章

问题原因 #

Carbon Fields的association字段仅负责将选中的分类ID存储为文章自定义元数据（post meta），不会自动更新WordPress原生的文章-分类关联关系（即wp_term_relationships数据表）。而侧边栏的原生分类选择器直接操作该关联表，因此能正常生效。

问题场景截图 #

• 关联字段选择界面：
• 保存后文章未关联分类（编辑页）：
• 保存后文章未关联分类（列表页）：
• 原生侧边栏选择分类正常：

修复方案 #

根据需求选择以下两种处理方式：

方式1：同步关联字段到原生分类（推荐，保证数据一致性） #

添加代码监听文章保存事件，读取Carbon Fields关联字段的值，自动更新文章的原生分类关联：

use Carbon_Fields\Container;
use Carbon_Fields\Field;

add_action( 'carbon_fields_register_fields', 'crb_attach_post_fields' );
function crb_attach_post_fields() {
  
  Container::make( 'post_meta', 'Post settings' )
      ->where( 'post_type', '=', 'post' )
      ->add_fields( array(
          Field::make( 'association', 'crb_category', 'Category' )              
              ->set_types( array(
                  array(
                      'type'      => 'term',
                      'taxonomy'  => 'category',
                  )
              ) )
      ));
}

add_action( 'after_setup_theme', 'crb_load' );
function crb_load() {
    require_once( 'vendor/autoload.php' );
    \Carbon_Fields\Carbon_Fields::boot();
}

// 新增：同步关联字段选择到原生分类
add_action( 'save_post', 'crb_sync_category_to_post', 10, 2 );
function crb_sync_category_to_post( $post_id, $post ) {
    // 跳过自动保存、草稿、修订版
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) return;
    if ( in_array( $post->post_status, array( 'draft', 'auto-draft' ) ) ) return;
    if ( wp_is_post_revision( $post_id ) ) return;

    // 仅处理文章类型
    if ( $post->post_type !== 'post' ) return;

    // 获取Carbon Fields关联字段的值
    $selected_terms = carbon_get_post_meta( $post_id, 'crb_category' );
    
    // 提取分类ID数组
    $term_ids = array();
    if ( !empty( $selected_terms ) ) {
        foreach ( $selected_terms as $term ) {
            $term_ids[] = $term['id'];
        }
    }

    // 更新文章分类关联（第三个参数false表示替换现有分类，改为true则追加）
    wp_set_post_terms( $post_id, $term_ids, 'category', false );
}

方式2：仅使用自定义字段存储（无需同步原生分类） #

若不需要同步到原生分类，仅需在前端直接读取自定义字段的值来展示分类：

// 在文章模板中调用示例
$selected_terms = carbon_get_post_meta( get_the_ID(), 'crb_category' );
if ( !empty( $selected_terms ) ) {
    echo '<div class="custom-post-categories">';
    foreach ( $selected_terms as $term ) {
        $term_obj = get_term( $term['id'], 'category' );
        if ( !is_wp_error( $term_obj ) ) {
            echo '<a href="' . esc_url( get_term_link( $term_obj ) ) . '">' . esc_html( $term_obj->name ) . '</a>';
        }
    }
    echo '</div>';
}

验证步骤 #

1. 将代码添加到主题的functions.php文件或自定义插件中
2. 重新编辑文章，通过Carbon Fields选择分类并保存
3. 检查文章侧边栏的分类是否已同步，或前端是否正确显示自定义字段中的分类

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