ものしり

Article

WordPress から EmDash へ移行する前に知っておきたい 7 つのこと

WordPress から EmDash へ移行する前に知っておきたい 7 つのこと(ものしり 記事)

・ 小林 誠 ・ 基準: 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 でもダウンロードできます。

「EmDash 実践ガイド」を読む →

WordPress サイトの移行をご検討の方は、移行依頼フォームからご相談ください。