WordPressからEmDashへ移行｜失敗を防ぐ確認表

WordPressの記事をEmDashへ移すときは、記事の件数、公開状態、画像の保存先、旧URLを別々に照合します。これらを先に分けておくと、どの差分なら手作業で補え、どの差分なら切り替えを延期すべきかを判断できます。この記事は2026年11月12日に確認した公式資料に基づく移行前の調査です。WordPressからEmDashへの実際の取り込みは未実施で、本文中の件数や記録は架空の例です。

EmDashの特徴やWordPressとの運用上の違いから確認したい方は、EmDashの仕組みと導入判断を先に参照してください。

記事のポイント

• WordPress側の棚卸しから、WXRと専用Exporterのどちらを試すか決める。
• 取り込み後の照合票に、公開状態・本文・画像・旧URLをそれぞれ記録する。
• 非公開原稿の露出や復旧手段の不足があれば、本番の切り替えを延期する。

移行前に移す範囲と方法を決める

WordPressにあるデータと運用を分けて棚卸しする

最初に、投稿、固定ページ、添付メディア、コメント、分類を一覧にします。投稿と固定ページは公開状態や言語ごとに小計を残します。移行対象を絞るときも、何を除外したかが分かるようにします。例えば投稿80件のうち70件を移すなら、残る10件を「下書きで旧側に保管」「統合済み」「公開終了」と理由ごとに数え、移したい原稿が除外に混じっていないかを編集者と確認します。

次に、フォームの送信、会員限定ページ、広告の表示、計測、関連記事、サイト内検索など、読者や運営者が実際に使う機能を確認します。WordPressのテーマやPHPプラグインは別途設計する領域です。プラグインを無効にしたときに本文へ残るショートコードや、テーマが出力していた著者欄も棚卸しに含めます。記事数と読者ができることを両方把握すると、復元が必要な機能を早い段階で特定できます。

記録はページ種別ごとに一行から始め、例外だけ個別に分けます。たとえばお問い合わせページは固定ページ1件に数えつつ、「送信」「受付メール」「担当者への通知」を別の確認項目にします。外部のサービスへつながる機能には、動作を確認できる担当者と、切り替えまでに代替手段が必要かを記入します。検証予定が決まっていないものは「未確認」と書き、既存サイトで使われていないものと区別します。

WXRと専用Exporterを使い分ける

WordPressの標準エクスポートでは、投稿などのデータをWXRというXML形式で出力できます。利用者が移す対象を絞っている場合は、選んだ投稿種別や状態が実際にWXRに入っているかを、最初の少量サンプルで確かめます。特定の投稿だけを出した場合、必要な固定ページや添付情報まで揃うかは出力を見て判断します。WXRに含まれた範囲を記録しておくと、取り込み後に見当たらない項目を切り分けられます。

EmDashのWordPress移行ガイドには専用Exporterを使う経路もあります。管理側でプラグインの導入が許可され、コメントやメニュー、サイトロゴなども対象にしたいときは、対応するExporterの版と出力項目を確認します。公式ガイドには1.2.0以降を前提とする項目があります。WXRという拡張子が同じでも、出力元とバージョン、出力オプションは記録しておくと、別日にやり直すときに条件を揃えられます。

WordPressサイトのURLを入力する経路は、公開REST APIを検出する段階です。その時点でデータを移入したと記録すると、後続の件数照合で起点が分からなくなります。プラグインを追加できない運用なら標準WXRを候補にし、出力から漏れる項目は手作業での再設定や保留へ回します。両経路を比較するときは同じサンプル、同じ照合項目を使い、コメント件数やメニュー階層が必要な場合だけ比較欄に加えます。

画像が取り込める条件を事前に確認する

WXRに記録される添付情報には画像の参照先などが含まれ、画像ファイルそのものは別に取得します。移行先から元の画像にアクセスできることと、移行先のメディア保存先を使えることを事前に確認します。管理者がログインしたブラウザで見える画像でも、移行先サーバーから同じ条件で取得できるかは別の確認項目です。公開画像とログイン制限付きの画像は一覧で区別します。

画像の位置も分けて記録します。同じ記事にアイキャッチ、本文画像、ギャラリーのサムネイルがある場合、アイキャッチが移っても本文の参照に古いURLが残ることがあります。最初のサンプルには、本文画像1点とアイキャッチ1点、可能なら別記事でも使われる画像を含めます。共有画像は「ファイルの数」と「記事から参照する箇所の数」を分けると、二重計上や未置換が見つけやすくなります。

元の画像が期限付きURLだったり、配信ドメインが別だったりする場合は、後から同じURLを再取得できるかも確認します。元の保管場所で正規のファイルを入手できるなら、移行先へ別途登録し、公開前に記事の参照先を照合する方法も候補です。試験データには権利を確認できる自作画像を使い、会員限定や個人情報を含む素材のアクセス制限を緩めずに検証計画を組みます。

下書き・非公開・予約の扱いを先に決める

EmDash公式のWordPress向け資料では、取り込み処理の対象になった公開済み投稿は公開済みに対応し、下書き、承認待ち、非公開、予約などは下書きに対応すると説明しています。実際にどの投稿が出力と取り込みの対象になるかは経路や選択条件にも依存します。移行元で予定時刻が設定されていても、同じ時刻に公開される前提で切り替えず、編集担当者が再確認する一覧を作ります。

特に公開状態の判定は管理画面とサイト表示を分けます。公開された記事は記事URLと一覧の両方に出るかを調べ、下書き扱いにした記事は通常の閲覧者で一覧や直接URLから見えないかを確認します。新しいURLを推測してアクセスできるか、検索機能やフィードに露出するかも、その機能を使うサイトでは確認対象です。権限のあるプレビューで見えることは一般公開と別の欄に記録します。

日付と公開状態は別に比較します。表示する元公開日と予約し直す日時、サイト設定上のタイムゾーン、確認に使った時刻を分けておくと、日付だけ一致したケースを見落としにくくなります。予約原稿を扱う場合、切り替え前後でどちらを正とするかも決めます。たとえば旧側での予約を残す運用なら、新側で同じ原稿を予約し直す前に二重公開の扱いを編集担当者と確認します。

バックアップと権限を確認して試験データを作る

試験の前に、WordPressのデータベースとアップロード領域をどこから復元できるかを確認します。変更したテーマや独自設定が必要なら、その配置と記録も揃えます。記事を出力したWXRは移入に使い、元サイトの復旧に必要な資材は別に保管します。担当を分けている場合は、誰が復旧を決め、誰が保存先を確認できるかも書きます。

EmDash公式の移行資料では、取り込み操作に必要な権限として import:execute が案内されています。作業を分ける場合は、旧WordPressから出力する人、EmDashへ取り込む人、一般閲覧で判定する人を区別します。認証が必要な方法では、既存の管理者権限を流用する前に用途と有効範囲を確認し、アクセスキーやパスワードを照合票やスクリーンショットに貼りません。検証記録は使用した権限の種類だけ残せば再現の判断に使えます。

最初の試験セットは自作の投稿と画像だけで組み、公開状態の異なる記事を一つずつ混ぜます。日本語のタイトル、長い見出し、表、本文リンク、代替テキストなど、実サイトで落としたくない要素を意図的に含めます。元サイトの更新が続く場合は、棚卸しした時刻を記録します。後から追加された投稿や修正を移入漏れと混同しないよう、差分を照合できる形にしておきます。

試験移行の結果を照合して切り替えを判断する

件数を種類・状態・除外理由ごとに照合する

出力前の件数、WXRなどの出力に入った件数、移入後に確認した件数を三列に分けます。公開と下書きを混ぜて集計すると、公開2件が下書き2件として入っていても総数で一致してしまいます。想定例として、元が公開2、下書き1、予約1の場合、予約を下書きへ回す計画なら新側の期待値は公開2、下書き2です。新側が公開3、下書き1なら総数4でも状態の内訳が想定と異なります。

元のIDやスラッグ、移行後のIDやURLも一緒に記録します。旧記事IDを新側のIDにそのまま使えると見込んで連携すると、画像や関連記事の紐付けを間違えることがあります。識別にはタイトルだけでなく、旧URLなど重複しにくい項目を使います。タイトルが同じ改訂版や言語別のページがある場合は、対応を決めてから照合すると判断のやり直しを減らせます。

不一致があったら、対象外、出力なし、処理時のスキップ、変換後の状態差、確認できていないものに分けます。移入結果が不明なまま同じファイルをもう一度取り込む前に、新側の実データと結果表示を照合します。どこまで処理されたかによっては、再取り込みで重複する可能性を確認する必要があります。原因が確定していない行は保留のまま残し、後から見た人が処理を再開できるメモを付けます。

本文とブロックを公開画面で点検する

件数を確認したら、移した記事の表示を元記事と見比べます。最初の数件は、段落、見出し、リスト、リンク、引用、画像、表、埋め込みなどを含むものを選びます。元のWordPressでショートコードやプラグインに依存していた部分は、読者が見ていた出力を控えておくと、移行後に表示すべき内容を判断できます。ソースが変換できたかと読者が同じ作業をできるかを別々に確認します。

具体的には、冒頭、記事の途中、末尾から意味のある箇所を選び、見出しの階層とテキスト、リンク先、表の列順を比較します。例えば機種比較表の列が1列ずれた場合は、デザインの差より先に各データがどの機種に紐づいたかを調べます。外部動画やフォームが表示されない場合は、再設定が可能か、説明とリンクで代替できるかを担当者と決めます。本文に埋め込んだ計測や広告を使うサイトでは、読者向け表示と必要な計測の両方を照合対象に加えます。

モバイルでだけ表が見切れる、画像の説明が消える、注記が本文に混ざるといった表示差もあります。最初のサンプルでは通常の画面幅と狭い画面幅で確認し、違いを「意味が変わる」「操作できない」「装飾の差」に分けて記録します。全記事を逐一比較できない場合は、同じ構造を持つ記事を束にし、頻出するブロックや問い合わせにつながるページから優先して確認します。

画像ファイルと参照先を照合する

公開ページに画像が見えたら、その画像の参照先を確認します。旧WordPressや旧CDNの画像を引き続き読み込んでいる場合、元サイト側の画像を消すと新しい記事にも影響します。移行先にコピーする方針なら、新側で管理するメディアを参照しているか確認します。旧CDNを維持する方針なら、契約や管理主体、URL維持期間を記録し、切り替え後の依存先として扱います。

アイキャッチと本文画像、一覧用のサムネイルを別々に調べます。同じ画像でも、本文の元画像だけ新URLで、サイズ別の候補や一覧表示だけ旧URLが使われる場合があります。確認項目には画像のファイル名、記事内の位置、出力される参照、実際に画像を開けるか、代替テキストを含めます。見た目が似ていて取り違えやすい場合は、題材、表示サイズ、余白などを元の画像と照合します。

取得できなかった画像は、まず新側の記事がどの参照先を使っているか、元側のファイルを許可された方法で取得できるかを見ます。その上で新しい画像の登録、参照の修正、対象記事の公開保留などを選びます。画像の一部が落ちた時点で全体をやり直すと、すでに確認した記事やメディアに再照合が必要になるので、対象と影響範囲が分かる単位で対応します。

旧URLと公開導線を点検する

移行前に旧URLの一覧を作り、移行後の対応先と照合します。よく読まれる記事、問い合わせページ、広告や外部からリンクされているページなどから始めます。カテゴリを含むパス、末尾のスラッシュ、URLに日本語が入るページは、実際の旧URLを記録しておくと対応表に落とし込めます。移行先の管理画面でスラッグが同じでも、サイト側のルート構成によって記事のパスが変わることがあります。

想定例として、旧側の「お知らせ一覧」と「個別記事」を新側でそれぞれ対応させます。記事を統合する場合は、旧ページの話題が統合先に含まれているかを見ます。読者が特定の表を読みに来たリンクなら、統合先でその表を見つけられることまで確認します。変換した本文の内部リンクに旧URLが残ると、新サイト内を回遊中に旧側へ戻るので、本文とナビゲーションの両方を確認対象にします。

検索向けのリダイレクト、canonical、サイトマップの具体的な判定は、EmDash移行前のSEO確認票を参照してください。すでにAstroでサイトを運営している場合の組み込みや公開反映は、既存AstroにEmDashを追加して公開表示を確認した手順で扱っています。WordPressから移した個々のページについては、今回の対応表に旧URL、移行先、公開状態、照合担当を記録します。

本番へ進める条件と切り戻す条件を決める

本番切り替えの条件は、照合表を作る段階で決めます。公開状態が想定どおりで、主要記事の本文・画像が確認でき、重要な旧URLの対応先が決まり、問い合わせや計測など継続が必要な機能を確認できたら、切り替え日を検討できます。確認できていない項目は、どの読者や運用に影響するか、暫定対応が成立するかを担当者と確認します。

切り替え後に起こり得る問題も、誰が何を見たら止めるかまで決めます。例えば非公開原稿が閲覧できる場合、主要な問い合わせが送信できない場合、旧URLの重要な一群が行き止まりになる場合は、切り替えを維持できる条件から外れます。旧WordPressをいつまで維持するか、どの状態に戻せば閲覧を復旧できるか、旧側で発生した更新をどう扱うかを先に確認します。実際の戻し方は構成に依存するため、作業担当の復旧計画に具体化します。

最初の一歩は、公開2件、下書き1件、予約1件、画像2点という小さな想定で、自分のサイトに必要な判定項目を選ぶことです。試験を行ったら日時、EmDashとExporterの版、移行元と移行先の役割、差分の担当者を残します。重要な差分が残るときは修正後の対象を絞って再照合し、原因が確認できていない場合は、移行日の変更や元サイトの維持を選べるようにします。

主な参照資料はEmDash公式のWordPress移行ガイドです。あわせてEmDash公式の取り込みの仕様とWordPressから移る際の状態対応、WordPress公式のエクスポート画面の説明を照合しました。