Upgrade to Pro — share decks privately, control downloads, hide ads and more …

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

Avatar for Rocket Martue Rocket Martue
November 04, 2025
41

 現場で遭遇した「編集できない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

Avatar for Rocket Martue

Rocket Martue

November 04, 2025
Tweet

Transcript

  1. $name = ほんだとしゆき まーちゅう @RocketMartue WordCamp Ogijima 2018 / 2020

    実行委員 Kagawa WordPress Meetup のオーガナイザー 日本語 WordPress 
 サポートフォーラムのモデレーター WordCamp Kansai 2024 当日スタッフ WordCamp Kansai 2025 実行委員 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  2. カスタム投稿タイプで発覚した問題 投稿タイトル → の「title」フィールド アイキャッチ → の「thumbnail」フィールド 本文内容 → の「content」フィールド

    カテゴリー → の「category」フィールド ACF ACF ACF ACF ※ ACF = Advanced Custom Fields WordPress標準機能が全て カスタムフィールドで再実装されていた! 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  3. 固定ページで発覚した問題 固定ページのハードコーディング <?php ?> div h1 h1 p p div

    <?php ?> ; = 会社概要 私たちは... ; get_header get_footer () () < > < > </ > < > </ > </ > class <!-- 以下、HTMLが直書き --> "about-page" 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  4. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき  ハードコーディング  ACF再定義 

    反映不具合 問題の深掘り レガシー実装の本質を掘り下げ、なぜ問題となるのかを
 技術的な視点から検証します。
  5. 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき  移行戦略  工程 

    AIの利用 解決アプローチ 問題解決に向けた戦略・工程を 実際にあったケースを元に紹介します。
  6. 1ヶ月目 現状調査 方針決定 & ├─ Week  コードベースの調査 1 ├─ Week -

    依存関係の洗い出し 2 3 └─ Week  移行方針の策定 4 3ヶ月の移行計画 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  7. 2ヶ月目 段階的移行 テスト & ├─ Week - 優先度の高いページから移行開始 5 6 ├─

    Week  データ移行プラグインの開発 7 └─ Week  テスト環境での検証 8 3ヶ月の移行計画 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  8. 3ヶ月目 最終調整 運用移行 & ├─ Week - : 残りのページの移行 9 10

    ├─ Week :   運用者向けトレーニング 11 └─ Week :  本番環境への適用 監視 12 & 3ヶ月の移行計画 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  9. テーマ依存を解消 Step 1:カスタム投稿タイプの独立 問題:テーマで register_post_type  → テーマ変更時に投稿が消える 解決:独立プラグイン化 テーマの register_post_type

    をオフ 専用プラグインで登録 メリット テーマ変更に強い 再利用可能 管理が容易 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  10. Visual Sutudio Code GitHub Copilot (Agentモード) WPCS (WordPress Coding Standards)

    AI活用による効率化 使用ツール 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき
  11. 理由は分かるけれど... 開発体制や納期による妥協 要件定義の曖昧さ、カスタマイズ要求 過去資産の踏襲で技術的負債が積み重なる WordPress 標準仕様の理解不足 WordPress を触れるエンジニアが居ない 「とりあえず動けばいい」 「後で直せばいい」

    「前がこうだったから」 「こういうものだと思ってた」 「誰も直せない」 後で、絶対誰かが苦労します! こうならないように、予防しておくのが最善 2025/11/02 WordCamp Kansai 2025 ほんだとしゆき