WordPress Vehica主题：API同步车辆数据无法显示在前端列表

问题背景 #

• 外部API车辆数据获取正常，已通过debug.log验证
• 通过API同步的vehica_car类型文章在WordPress后台“Vehica Cars”中可见，但前端列表无显示
• 已确认vehica_car是注册的文章类型（通过get_post_types()输出验证）

数据同步流程 #

1. 获取API数据：使用wp_remote_post获取数据并解析JSON响应
2. 同步到WordPress：创建或更新vehica_car类型文章，设置元数据、特色图片
3. 调试操作：debug.log确认文章插入/更新成功，手动调用同步函数vehica_sync_products()后问题依旧

核心同步函数代码 #

function vehica_sync_products() {
    require_once(ABSPATH . 'wp-admin/includes/media.php');
    require_once(ABSPATH . 'wp-admin/includes/file.php');
    require_once(ABSPATH . 'wp-admin/includes/image.php');

    $api_products = vehica_fetch_api_products();
    if (!$api_products) {
        error_log('No data received from API');
        return;
    }

    foreach ($api_products as $product) {
        $slug = sanitize_title($product['URL Slug']);
        $existing_post = get_page_by_path($slug, OBJECT, 'vehica_car');

        $post_data = [
            'post_title'   => sanitize_text_field($product['Title']),
            'post_content' => wp_kses_post($product['Content'] ?? 'No description available.'),
            'post_type'    => 'vehica_car',
            'post_status'  => 'publish',
            'post_name'    => $slug,
            'meta_input'   => [
                'vehica_price'       => floatval($product['Vehica Currency 6656 2384'] ?? 0),
                'vehica_model'       => sanitize_text_field($product['Model'] ?? ''),
                'vehica_year'        => intval($product['Tahun'] ?? 2023),
                'vehica_mileage'     => floatval($product['Jarak Tempuh'] ?? 0),
                'vehica_fuel_type'   => sanitize_text_field($product['Jenis Bahan Bakar'] ?? ''),
                'vehica_transmission'=> sanitize_text_field($product['Transmisi'] ?? ''),
                'vehica_condition'   => sanitize_text_field($product['Kondisi'] ?? ''),
            ]
        ];

        if ($existing_post) {
            $post_data['ID'] = $existing_post->ID;
            $post_id = wp_update_post($post_data, true);
        } else {
            $post_id = wp_insert_post($post_data, true);
        }

        if (!is_wp_error($post_id) && !empty($product['Galeri'])) {
            $gallery = explode(', ', $product['Galeri']);
            if (!empty($gallery[0])) {
                $image_id = media_sideload_image($gallery[0], $post_id, '', 'id');
                if (!is_wp_error($image_id)) {
                    set_post_thumbnail($post_id, $image_id);
                }
            }
        }
    }
}

// Debugging post types
add_action('init', function() {
    $post_types = get_post_types();
    error_log(print_r($post_types, true)); 
});

// Running sync manually
add_action('init', function() {
    vehica_sync_products();
});

额外上下文 #

• debug.log已启用，确认文章同步操作无错误
• 后台可见导入的文章，但前端Vehica列表不展示

可能的原因及解决方向 #

1. 缺失主题必需的元数据/分类
   Vehica主题可能依赖额外的自定义字段（如品牌vehica_brand、车辆分类vehica_category）或分类法，手动创建的车辆会自动关联这些，但API导入时未处理。建议对比后台手动创建的车辆元数据，补充缺失的字段或分类关联。

2. 主题特定的可见性设置
   部分主题会用自定义字段控制车辆是否在前端展示（如vehica_is_active），即使文章状态为publish，若该字段未设置也会被隐藏。检查后台文章的Vehica专属设置选项卡，确认必要的可见性开关已开启。

3. 缓存未更新
   WordPress缓存、服务器缓存或浏览器缓存可能导致前端未加载新数据。尝试清除所有缓存后刷新页面测试。

4. 元数据键名不匹配
   你设置的元数据键名可能与主题实际使用的不一致（比如vehica_price是否是主题识别的正确字段）。可以通过get_post_meta($手动创建的车辆ID, '', true)导出所有元数据，对比导入的键名确保完全一致。

5. 图片元数据未生成
   media_sideload_image导入图片后，可能未生成主题所需的图片尺寸元数据，导致前端筛选排除无有效图片的车辆。可在设置特色图片后调用wp_generate_attachment_metadata($image_id, get_attached_file($image_id))确保元数据生成。

6. 前端查询条件限制
   Vehica前端列表的WP_Query可能包含额外筛选条件（如特定分类、元数据阈值），导入的文章不符合这些条件。可以通过打印前端查询参数（如var_dump($query->query_vars)），对比导入文章的属性是否满足要求。

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