WordPressから移行する

EmDashはWordPressからコンテンツを移行します。管理ダッシュボードを通じて投稿、ページ、メディア、タクソノミーをインポートします。

始める前に

インポート方法

EmDashはWordPressコンテンツをインポートするための3つの方法をサポートしています：

WXRファイルアップロードは、ほとんどの移行に推奨されます。下書き、カスタムフィールド、非公開投稿を含むすべてのコンテンツをキャプチャします。

WXRファイルインポート

コンテンツ変換

GutenbergからPortable Textへ

EmDashはGutenbergブロックを構造化コンテンツ形式であるPortable Textに変換します。

不明なブロックは、元のHTMLとブロックメタデータを持つhtmlBlockとして保存されます。手動でレビューして変換するか、カスタムPortable Textコンポーネントを作成してレンダリングできます。

クラシックエディターのコンテンツ

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

ステータスマッピング

タクソノミーインポート

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

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

WordPressの投稿メタと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を通じて利用可能です。最高のエクスペリエンスのために管理ダッシュボードインポートウィザードを使用してください — フィールドマッピング、競合解決、進行状況追跡を提供します。

インポートAPIエンドポイントは、プログラマティックアクセスのために/_emdash/api/import/wordpress/配下にあります。

トラブルシューティング

「XML解析エラー」

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

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

一部の画像は認証の背後にあるか、移動されている可能性があります。インポートは続行され、失敗したURLは手動処理のためにログに記録されます。

フィールドタイプの競合

既存のコレクションに互換性のないタイプのフィールドがある場合、インポートウィザードは競合を表示します。次のいずれかを行います：

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

大きなエクスポート

100MBを超えるエクスポートの場合、以下を検討してください：

1. WordPressで投稿タイプを個別にエクスポート
2. 各ファイルを順次インポート
3. 信頼性のためにCLIで--resumeを使用

次のステップ

• コンテンツインポート — その他のインポートソースと方法
• プラグインの移植 — WordPressプラグイン機能を移行
• コンテンツの操作 — インポートしたコンテンツをクエリおよびレンダリング