・ 小林 誠 ・ 基準: EmDash 1.3.1(確認日 2026-10-29)
WordPress から EmDash へ移るとき、いちばん多い誤解は「記事をインポートすれば終わり」というものです。EmDash のインポート機能が引き受けるのは、あくまでコンテンツ(と一部の設定)です。見た目、機能、URL は別に作り直すことになります。
この記事では、書籍「EmDash 実践ガイド」の第 11 章から、移行を始める前に押さえておきたい要点を 7 つに絞って紹介します。
1. 移行は「データ・見た目・機能・URL」の 4 つに分けて考える
WordPress は、投稿、テーマ、プラグイン、wp-admin、URL の書き換えルールまでを一体で提供してきました。EmDash は Astro のサイトに CMS が組み込まれた構成で、コードとデータが別々にデプロイされます。そのため、移行では次の 4 つを別々に移します。
- データ: 投稿、ページ、メディア、分類。インポート機能の担当です。
- 見た目: テーマ。PHP のテーマではなく、Astro プロジェクトとして作り直します。
- 機能: プラグイン。不要なものを除き、残りを作り直します。
- URL: 設計事項です。変更した全ルートにリダイレクトを用意します。
2. 向いているケースと、慎重になるべきケース
記事とページが中心で、プラグイン依存が少ないサイトは、移行に向いています。すでに Astro や Cloudflare で運用していて、フロントエンドを自由に作りたい場合もそうです。
一方で、次のようなサイトは慎重に見積もってください(いずれも一般論です)。
- WooCommerce のように、商取引(商品・カート・決済・注文)が中核にある。
- ページビルダーで組んだページが大量にある。
- WPML や Polylang の多言語構造をそのまま保ちたい。
- 編集者が wp-admin の操作に強く依存している。
3. 着手前に棚卸しをする
何が移り、何が移らないかを事前に把握しておくと、手戻りが減ります。公式の手順も、現在のパーマリンク構造、リダイレクト、メニュー、有効な投稿タイプ、タクソノミー、移行後も保持したいプラグイン所有のフィールドを、先に記録するよう求めています。
特に、カスタムフィールド(ACF など)、ショートコード、プラグインが担っている役割、既存のリダイレクトルールは、見落としやすい項目です。
4. インポート元は WXR と EmDash Exporter。URL だけでは取り込めない
EmDash の管理画面には、WordPress からのインポート元が 3 種類あります。
- WXR: WordPress の Tools → Export で作る XML。標準機能だけで使えます。
- EmDash Exporter: WordPress に入れるプラグイン。下書きなど認証が必要なデータや、カスタム meta・ACF、SEO の値、サイト設定も取り込めます。
- サイト URL だけ: 公開 REST API を調べるだけで、取り込みはできません。WordPress の検出と公開件数の確認までです。
カスタム meta や ACF が重要なサイトでは、Exporter を使う意味が大きくなります。WXR は標準フィールド以外の meta を自動ではコピーせず、「別途変換が必要かもしれないもの」の一覧を出すだけです。Exporter は 1.2.0 より古いと、コメントやメニューが何も報告されないまま取り込まれないので、バージョンを確認してください。
5. 取り込まれても、そのままでは使えないもの
本文は Gutenberg でも従来の HTML でも、Portable Text に変換されます。ただし、次の点は手作業での確認が要ります。
- 公開状態: publish 以外(下書き、承認待ち、非公開、予約、ゴミ箱)はすべて draft になります。意味は再現されないので、公開前に全件を確認します。
- サーバー側描画ブロック(Latest Posts など): 中身のない HTML ブロックとして入り、画面には何も出ません。
- ACF のリレーションなど: JSON として入りますが、指す先は EmDash のエントリではなく WordPress の ID のままです。
- 多言語: WXR にはロケールと翻訳グループが含まれないため、すべて既定ロケールに入ります。
メディアの実体は WXR に入っていないため、別のステップでコピーします。WordPress のオリジンを動かしたままにしておく必要があります。
6. URL とリダイレクトは先に設計する
WordPress は rewrite rules で URL を決めていましたが、Astro ではルートが明示的なファイルになります。旧 URL を完全に維持するか、整理してリダイレクトで繋ぐかを決め、変更した全パーマリンクについて、切り替え前にリダイレクトを用意します。
EmDash の管理画面の Redirects では 301・302・307・308、410 Gone などを扱えます。404 になったリクエストの記録も見られるので、切り替え後の取りこぼしを拾えます。なお、リダイレクト管理プラグインのルールを自動で取り込む機能は、公式のインポートにはありません。書き出して登録し直します。
7. 切り替えは「戻せる形」で行う
切り替えは DNS やルーティングの向き先を変えるだけにして、WordPress 側には手を加えないでおきます。そうすれば、問題が出たときは向き先を戻すだけで済みます。
- 新サイトが問題なく動き、ロールバックが不要になるまで、WordPress の環境と DB・uploads のバックアップを残す。
- 切り替え後に EmDash 側で増えたデータ(コメント、フォーム送信、新規記事)は WordPress に戻らない。判断の期間と扱いを先に決める。
- メディアの URL が WordPress を指したままの記事がないか確認してから、オリジンを止める。
- 移行用の認証情報(アプリケーションパスワード、マイグレーションキー)と Exporter は、終わったら失効・削除する。
まとめ
EmDash のインポートは、コンテンツの下ごしらえです。データ、見た目、機能、URL を分けて考え、棚卸しと検証を丁寧に行えば、移行の見通しはかなり立てやすくなります。
より詳しい手順(インポート対応表、メディア、プラグインとテーマの移植、検証と切り替えの手順、理解度チェック)は、第 11 章 WordPress からの移行で読めます。書籍全体は無料で、ブラウザで読めるほか、EPUB でもダウンロードできます。
WordPress サイトの移行をご検討の方は、移行依頼フォームからご相談ください。