如何将Prismic网站迁移至WordPress？求相关资源与解决方案

一、数据导出与结构解析 #

• 批量导出 Prismic 内容：调用 Prismic Content API 的 GET /api/v2/documents/search 接口，通过设置 pageSize=100 分页拉取所有文档。返回的 JSON 数据中，核心内容存于 data 字段，type 字段对应你在 Prismic 后台定义的自定义类型（如 blog_post、page）。
• 解析陌生结构：对照 Prismic 后台的「自定义类型」配置表，逐一匹配导出数据里的字段。比如你定义了「博客文章」类型，data 下的 title「正文」「封面图」等子字段，就是对应内容的存储位置，按自定义类型分类整理数据集即可。

二、迁移到 WordPress 的实操步骤 #

1. 匹配 WordPress 内容结构 #

如果 Prismic 有非默认的内容类型，在 WordPress 中注册对应的自定义文章类型，示例代码可添加到主题 functions.php：

function register_prismic_post_types() {
  register_post_type('blog_post', [
    'labels' => ['name' => __('博客文章')],
    'public' => true,
    'has_archive' => true,
    'supports' => ['title', 'editor', 'thumbnail']
  ]);
}
add_action('init', 'register_prismic_post_types');

同时用自定义字段（可借助 Advanced Custom Fields 插件或代码），对应 Prismic 里的自定义字段。

2. 数据转换与导入 #

• 小数据量手动迁移：直接复制 Prismic 导出的标题、正文到 WordPress 对应文章/页面，媒体文件单独下载后上传到 WordPress 媒体库，替换内容里的旧链接。
• 大数据量脚本批量导入：编写 PHP 脚本批量处理，示例片段：

// 加载 WordPress 环境
require_once('wp-load.php');
// 读取 Prismic 导出的 JSON 文件
$prismic_docs = json_decode(file_get_contents('prismic_export.json'), true);

foreach ($prismic_docs as $doc) {
  // 创建文章
  $post_id = wp_insert_post([
    'post_title' => $doc['data']['title'],
    'post_content' => $doc['data']['content'],
    'post_type' => $doc['type'],
    'post_status' => 'publish'
  ]);
  // 赋值自定义字段
  update_post_meta($post_id, 'prismic_custom_field', $doc['data']['custom_field']);
}

3. 媒体资源处理 #

提取 Prismic 导出数据里的媒体链接，批量下载后上传到 WordPress 媒体库，再用 SQL 批量替换内容中的旧链接：

UPDATE wp_posts SET post_content = REPLACE(post_content, 'https://your-prismic-domain.com/assets/', 'https://your-wp-domain.com/wp-content/uploads/2024/05/');

三、关键注意事项 #

• 先在测试环境完成迁移验证，确认内容格式、链接、自定义字段均正常后，再同步到生产环境。
• Prismic 的「切片（Slices）」内容需转换为 WordPress 区块或短代码，比如文本切片转段落区块、图片切片转图片区块。
• 迁移后同步固定链接结构，避免 SEO 流量损失。

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