WordPress からの移行

EmDash は WordPress からの完全な移行パスを提供します。CLI なしで管理ダッシュボードから投稿・固定ページ・メディア・タクソノミーをインポートできます。

始める前に

インポート方法

EmDash は WordPress コンテンツのインポートに 3 つの方法をサポートします。

ほとんどの移行では WXR ファイルのアップロードを推奨します。下書き・カスタムフィールド・非公開投稿を含むすべてのコンテンツを取り込めます。

WXR ファイルのインポート

コンテンツの変換

Gutenberg から Portable Text へ

EmDash は Gutenberg ブロックを Portable Text に変換します。

不明なブロックは元の HTML とブロックメタデータ付きで htmlBlock として保存されます。手動で変換するか、カスタム Portable Text コンポーネントで描画できます。

クラシックエディターの内容

クラシックエディターの HTML は Portable Text ブロックに変換されます。インラインスタイル（<strong>、<em>、<a>）は span 上のマークになります。

ステータスの対応

タクソノミーのインポート

カテゴリーとタグは階層を保ったままタクソノミーとしてインポートされます：

WordPress:                    EmDash:
├── Categories (hierarchical) ├── taxonomies table
│   ├── News                  │   ├── category/news
│   │   ├── Local             │   ├── category/local (parent: news)
│   │   └── World             │   ├── category/world (parent: news)
│   └── Sports                │   └── category/sports
└── Tags (flat)               └── content_taxonomies junction
    ├── featured                  ├── tag/featured
    └── breaking                  └── tag/breaking

カスタムフィールドと ACF

投稿メタと ACF フィールドはインポート時に分析されます：

URL リダイレクト

インポート後、EmDash はリダイレクトマップを生成します：

{
	"redirects": [
		{ "from": "/?p=123", "to": "/posts/hello-world" },
		{ "from": "/2024/01/hello-world/", "to": "/posts/hello-world" },
		{ "from": "/category/news/", "to": "/categories/news" }
	],
	"feeds": [
		{ "from": "/feed/", "to": "/rss.xml" },
		{ "from": "/feed/atom/", "to": "/atom.xml" }
	]
}

次に適用できます：

• Cloudflare のリダイレクトルール
• ホスティングのリダイレクト設定
• astro.config.mjs の Astro redirects オプション

概念対応表

WordPress のパターンを EmDash に合わせるときの参考です。

API インポート（上級）

WordPress インポートは管理ダッシュボードと REST API の両方から利用できます。フィールドマッピング・競合解決・進捗表示にはウィザードを推奨します。

プログラムからは /_emdash/api/import/wordpress/ 配下のエンドポイントを使用します。

トラブルシューティング

「XML parsing error」

エクスポートファイルが破損または不完全な可能性があります。WordPress から再エクスポートしてください。

メディアのダウンロード失敗

認証が必要な画像や URL が変わった画像がある場合があります。インポートは続行され、失敗した URL はログに残ります。

フィールド型の競合

既存コレクションに互換性のない型のフィールドがあると、ウィザードが競合を表示します。次のいずれかで対処：

• EmDash のフィールド名を変更
• WordPress 側のマッピングを変更
• コレクションを削除して再作成

大きなエクスポート

100MB を超える場合：

1. WordPress で投稿タイプごとに分割エクスポート
2. ファイルを順番にインポート
3. 信頼性のため CLI の --resume を使用

次のステップ

• Content Import — その他のインポート元と方法
• Plugin Porting — WordPress プラグイン機能の移行
• Working with Content — インポートしたコンテンツの取得と表示