現場で遭遇した「編集できないWordPressサイト」をブロックエディター対応にした話

WordCamp Kansai 2025 のセッションスライドです。
https://kansai.wordcamp.org/2025/
https://kansai.wordcamp.org/2025/session/how-i-converted-a-uneditable-wordpress-site-to-the-block-editor/

WordPressサイトの運用でよくある「編集画面で変更しても反映されない」問題。

page-{slug}.phpにハードコーディングされた内容や、ページタイトル、アイキャッチ、カテゴリー、コンテンツ部分が全部ACFで定義されたカスタムフィールドになっているなど、現場で遭遇したレガシーな実装をAIの力も借りながら、ブロックエディター対応にした実際の事例をお話ししました。

AIコーディングの様子
https://youtu.be/CNOFeFp3aBY?si=A8mqszgJAxEHLcyy

ACFのメタデータに登録されているタイトル・コンテンツ等を移植するプラグイン
https://github.com/rocket-martue/custom-bulk-action

Transcript

1. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
2. $name = ほんだとしゆき 京都府生まれ。香川県高松市在住。
 音大卒業後、いくつかの職を経て、 現在はフリーランスのうぇぶ屋さんをしています。
 WordPress を使ったサイト構築、メンテナンス、 セキュリティ対応、制作会社の WordPress 関連の 相談役などをしています。 まーちゅう @RocketMartue 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
3. $name = ほんだとしゆき まーちゅう @RocketMartue WordCamp Ogijima 2018 / 2020 実行委員 Kagawa WordPress Meetup のオーガナイザー 日本語 WordPress 
 サポートフォーラムのモデレーター WordCamp Kansai 2024 当日スタッフ WordCamp Kansai 2025 実行委員 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
4. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき 「こんな経験、ありませんか？」
5. よくある現場の悩み 前任者が作ったWordPressサイト、仕組みが謎 管理画面で編集しても反映されない クライアントから「更新できない」と連絡が... WordPress触れる開発者が社内にいない → 今日は、こんなサイトを救った実例をお話しします 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
6. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき 「ある日、制作会社から相談が...」
7. 相談内容 「サーチコンソールにindexされないので見てほしい」 「できればブロックエディターが使えるようにしたい」 よくある相談だな... → 調査開始 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
8. xmlサイトマップを 確認してみる /furisode-blog/ %e8%87%aa%e5%8b%95%e4%b8%8b%e6%9b%b8%e 3%81%8d-872/ /photo-gallery/ %e8%87%aa%e5%8b%95%e4%b8%8b%e6%9b%b8%e 3%81%8d-479/ /announcement/ %e8%87%aa%e5%8b%95%e4%b8%8b%e6%9b%b8%e 3%81%8d-252/ 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
9. デコード後 /furisode-blog/自動下書き-872/ /photo-gallery/自動下書き-479/ /announcement/自動下書き-252/ 投稿タイトルすべてが「自動下書き」  え...全部「自動下書き」！？ 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
10. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき テーマファイルを見てみる
11. single-announcement.php テーマファイルを見てみる 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
12. trait-display.php テーマファイルを見てみる 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
13. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
14.  普段見てるWordPressと全然違うやん！ 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
15. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき 管理画面を見てみる
16. 実際の管理画面 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
17. 実際の管理画面 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
18. カスタム投稿タイプで発覚した問題 投稿タイトル → の「title」フィールド アイキャッチ → の「thumbnail」フィールド 本文内容 → の「content」フィールド カテゴリー → の「category」フィールド ACF ACF ACF ACF ※ ACF ＝ Advanced Custom Fields WordPress標準機能が全て カスタムフィールドで再実装されていた！ 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
19. 固定ページで発覚した問題 固定ページのハードコーディング <?php ?> div h1 h1 p p div <?php ?> ; = 会社概要 私たちは... ; get_header get_footer () () < > < > </ > < > </ > </ > class <!-- 以下、HTMLが直書き --> "about-page" 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
20. 固定ページで発覚した問題 何が問題か HTMLがテーマファイルに直書き the_content() が呼ばれていない ブロックエディターで編集しても無視される でもエディター自体は動く → テーマテンプレートの修正が必要 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
21. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき これからお話すること
22. なぜこんなサイトが生まれるのか 何が問題なのか どう解決したのか AIをどう活用したのか これからお話すること 同じような問題を抱える方の参考になれば！ 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
23. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき 編集できないWordPressサイトとは？
24. 編集できないWordPressサイトとは？ 定義 固定ページの内容が変更できない 管理画面から内容を変更しても反映されない 表示はできても運用・更新が困難 非開発者には理解できない複雑な構成 結果  運用コスト増加  開発者依存  更新サイクル遅延 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
25. 現場で多発するレガシー実装の例 ハードコーディング page-{slug}.php に直接HTMLを記述 → 管理画面での編集が不可能 カスタムフィールドの乱用 今回のケースは両方のハイブリッド！ 標準機能を使わず全てカスタムフィールド化 → プラグイン連携不可、一貫性喪失 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
26. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき  ハードコーディング  ACF再定義  反映不具合 問題の深掘り レガシー実装の本質を掘り下げ、なぜ問題となるのかを
 技術的な視点から検証します。
27. page-{slug}.php の問題 コンテンツをテーマファイルに直書き 内容変更のたびに開発者がファイルを直接編集 標準化されていないアプローチ → 開発者が変わると修正困難（技術的負債） → 運用コストが増大 → WordPressの管理画面から編集できない 何が問題か？ 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
28. カスタムフィールド乱用の弊害 ページタイトル アイキャッチ カテゴリ 本文 　→　カスタムフィールド 　→　カスタムフィールド 　→　カスタムフィールド 　→　カスタムフィールド 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
29. カスタムフィールド乱用の弊害 全てをカスタムフィールド化 • 結果 標準WordPress機能が機能しない プラグインとの互換性低下 記事編集の一貫性喪失 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
30. 具体的な問題：反映されないケース タイトル変更が反映されない 本文コンテンツが無視される アイキャッチ画像の不一致 キャッシュ問題の併発 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
31. 具体例 問題1：タイトル変更が反映されない get_the_title() ではなく 固定文字列が テンプレートにハードコード 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
32. 具体例 問題2：本文コンテンツが無視される the_content() を使わず コンテンツが テーマファイルにべた書き 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
33. 具体例 カスタムフィールドの を参照 標準機能が上書きされている 画像ID 問題3：アイキャッチの不一致 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
34. 具体的な問題：反映されないケース タイトル変更が反映されない 本文コンテンツが無視される アイキャッチ画像の不一致 キャッシュ問題の併発 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき  これらが複合的に発生 ↓ 運用担当者混乱
35. なぜこのような実装が生まれるのか？ 開発体制や納期による妥協 要件定義の曖昧さ、カスタマイズ要求 過去資産の踏襲で技術的負債が積み重なる WordPress 標準仕様の理解不足 WordPress を触れるエンジニアが居ない 「とりあえず動けばいい」 「後で直せばいい」 「前がこうだったから」 「こういうものだと思ってた」 「誰も直せない」 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
36. 放置した場合の影響 運用面 技術面 ビジネス面 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
37. 運用面 運用担当者の負担増 サイト管理コスト増大 SEOへの間接的影響 ユーザー体験の悪化 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
38. 技術面 技術的負債の蓄積 セキュリティ対応の困難化 WordPress本体の更新リスク 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
39. ビジネス面 更新スピードの低下 機会損失の拡大 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
40. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき  移行戦略  工程  AIの利用 解決アプローチ 問題解決に向けた戦略・工程を 実際にあったケースを元に紹介します。
41. 制作会社の要望 サーチコンソールにindexされるようにしたい
 ブロックエディターが使えるようにしたい → SEOプラグイン連携必須 → WordPress標準機能への移行 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
42. 独自実装されたテーマ 投稿タイトルやアイキャッチ/カテゴリ/本文まで
 カスタムフィールド化
 基本要素がカスタムフィールドで再定義されている 標準WordPress機能が機能していないので、
 SEOプラグインとの連携ができない状態 問題点 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
43. A. テーマを丸ごと入れ替え B. 既存テーマを改修 C. 段階的にデータ移行 検討した選択肢 → 選択：Cの段階的データ移行 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
44. 移行方針の全体像 ゴール設定 カスタムフィールドのデータ
 → WordPress標準機能へ移植 SEOプラグイン連携を実現 ブロックエディターを使用可能に 期間：3ヶ月 体制：1名（+AI活用） 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
45. 1ヶ月目　現状調査 方針決定 & ├─ Week 　コードベースの調査 1 ├─ Week - 依存関係の洗い出し 2 3 └─ Week 　移行方針の策定 4 3ヶ月の移行計画 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
46. 2ヶ月目　段階的移行 テスト & ├─ Week - 優先度の高いページから移行開始 5 6 ├─ Week 　データ移行プラグインの開発 7 └─ Week 　テスト環境での検証 8 3ヶ月の移行計画 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
47. 3ヶ月目　最終調整 運用移行 & ├─ Week - : 残りのページの移行 9 10 ├─ Week : 　 運用者向けトレーニング 11 └─ Week : 　本番環境への適用 監視 12 & 3ヶ月の移行計画 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
48. テーマ依存を解消 Step 1：カスタム投稿タイプの独立 問題：テーマで register_post_type 　→ テーマ変更時に投稿が消える 解決：独立プラグイン化 テーマの register_post_type をオフ 専用プラグインで登録 メリット テーマ変更に強い 再利用可能 管理が容易 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
49. 稼働中のサイトなのでローカルで作業している間にも 新しい記事がどんどん投稿される 記事を保存すると自動的にWordPress標準に移植する仕組み save_post フックで自動移植 Step 2：データを自動的に移植する 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
50. カスタムフィールドの タイトルを 通常のタイトルに保存 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
51. カスタムフィールドのサムネイル画像を アイキャッチ画像に保存 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
52. Step 3：一括移植プラグイン 既存記事を一括移植できるプラグインを作成する。 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
53. 記事一覧の一括操作で チェックを入れた記事を 一括移植するプラグイン 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
54. ブロックエディターの内容が表示されるように テーマのテンプレートファイルに the_content(); を追加 Step 4：テンプレートファイルの修正 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
55. ACF (Advanced Custom Fields) の設定を変更 Step 5：ブロックエディターを表示 変更前 変更後 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
56. ACFの設定を変更 変更前： 変更後： ※ ACF ＝ Advanced Custom Fields 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
57. 非公開の固定ページ を用意 フロント側 のコンテンツを の編集画面にコピペ レイアウト調整 すべてのコンテンツをコピーして の編集画面に貼り付け page-(B).php を削除 (A) (B) (A) (B) Step 6：固定ページを再構築 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
58. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき AI活用による効率化 どのようにAIを活用したのかを紹介します。
59. Visual Sutudio Code GitHub Copilot (Agentモード) WPCS (WordPress Coding Standards) AI活用による効率化 使用ツール 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
60. GitHub Copilot 活用のコツ モードの使い分け Agent ： 複数ファイルの一括修正など Edit ：部分的な修正 Ask ： 質問・相談 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
61. Agent モードで、いきなりコードの編集をさせたくない時は 「◦◦したいので、作業計画を立てて」 「MDファイルにまとめて」 「作業計画に沿ってコードを書いて」 作業計画を提示されたら その後 GitHub Copilot を使用する時の工夫 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
62. ポイント いきなりコード書かせない 計画を先に立てさせる 一気にやらせない 人間がレビュー GitHub Copilot を使用する時の工夫 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
63. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき AIで実装している時の様子 時間があれば、GitHub Copilot の動画を流します。
64. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
65. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき まとめ
66. 理由は分かるけれど... 開発体制や納期による妥協 要件定義の曖昧さ、カスタマイズ要求 過去資産の踏襲で技術的負債が積み重なる WordPress 標準仕様の理解不足 WordPress を触れるエンジニアが居ない 「とりあえず動けばいい」 「後で直せばいい」 「前がこうだったから」 「こういうものだと思ってた」 「誰も直せない」 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
67. 理由は分かるけれど... 開発体制や納期による妥協 要件定義の曖昧さ、カスタマイズ要求 過去資産の踏襲で技術的負債が積み重なる WordPress 標準仕様の理解不足 WordPress を触れるエンジニアが居ない 「とりあえず動けばいい」 「後で直せばいい」 「前がこうだったから」 「こういうものだと思ってた」 「誰も直せない」 後で、絶対誰かが苦労します！ こうならないように、予防しておくのが最善 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
68. 今日お伝えしたこと 編集できないWordPressサイトについて
 → 現場で多発している問題 レガシー実装には理由がある
 → 責めるのではなく理解しよう 段階的移行で解決する
 → リスクを抑えて確実に AIは強力な味方
 → でも人間の判断が重要 予防が最善策
 → 標準機能を優先する設計を 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
69. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき 最後に
70. WordPress の Mission 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
71. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき 困っている人の 参考になれば幸いです 質問・ご相談はお気軽に @RocketMartue ご清聴ありがとうございました！
72. Thanks! 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき