MENU

JIN:RからSWELLへAIに移行させた記録|公式プラグイン非対応でも記事を書き換えず、当日中に本番切り替え

JIN:RからSWELLへAIでテーマ移行、記事は書き換えず

運営している約100ページのWordPressサイトを、テーマのJIN:RからSWELLへ移行しました。実際に手を動かしたのはClaude Codeで、レビューはCodex。私は方針を決めて、最後に画面を見て、気になったところを伝える役です。

先に結果を書くと、こうなりました。

  • 午後から子テーマを作り始めて、その日の19:17に本番を切り替え
  • JIN:Rの吹き出し817個、ボックス699個などは、記事本文を書き換えずにそのまま表示
  • 切り替え後の検索データは、全体として下がらず(ただしデータは1週間分)
  • 一方で、PCだけ検索ボタンが消えるミスがあり、気づいたのは2日後の私でした

うまくいった話だけでなく、AIに任せてどこで止まったかもまとめます。

目次

SWELLの乗り換えプラグインはJIN:Rに対応していない

SWELLには、他のテーマから移るときに古いショートコードや装飾を引き継ぐ「乗り換えサポートプラグイン」があります。ただ、SWELL公式の一覧に載っているのはCocoon、AFFINGER5、JIN、SANGO、STORK、THE THORです。

JINはありますが、JIN:Rはありません。名前は似ていても別のテーマなので、そのままでは使えません。

JINはあるのに、JIN:Rはないの!?
じゃあ自分で作るしかないじゃん。

テーマを替えると、JIN:R独自の吹き出しやボックスは表示が崩れたり、ショートコードの文字がそのまま画面に出たりします。公開中の記事を1本ずつ直すのは現実的ではないので、記事はそのままで、SWELLの子テーマ側に「JIN:Rの部品を表示する仕組み」を作ることにしました。

最初に決めた方針は3つだけ

AIに渡した方針はこれだけです。

  1. 見た目は今のJIN:Rに寄せる
  2. 記事は書き換えない
  3. 準備ができしだい切り替える

細かい手順はAIに組ませました。同じ時期に別のサイトをCocoonからSWELLへ移す作業もしていて、「テスト機で予行演習して、子テーマに見た目と設定をまとめて、本番で同じ手順を流す」という型ができていました。

テスト機に本番の写しを作る

まず、本番と同じ状態のテスト機を用意しました。記事の数、画像、プラグインの版まで本番と一致させて、SWELLを入れる直前の状態をスナップショットで保存します。失敗してもすぐ戻せるので、AIに思い切って試させられます。

記事の中のJIN:Rの部品を数える

次に、AIに記事の中身を調べさせました。

部品数
吹き出し817
ボックス699
ブログカード50個以上
ボタン24

吹き出し817個って……。
手で直してたら年越すわ。

この数を見れば、記事を直す選択肢がないのは明らかです。

子テーマでJIN:Rの部品を再現する

子テーマの中身は、大きく次の4つに分かれました。

ファイル役割
inc/jinr-blocks.php吹き出しやプロフィールのショートコード、ボタン、ブログカード、記事一覧
css/jinr-compat.cssJIN:Rの部品の見た目
サイト全体用のCSSフォント、見出し、ヘッダーなどサイト全体の見た目
inc/apply-settings.php と設定のJSONSWELLの設定、メニュー、ウィジェットを有効化のときに読み込む

たとえば吹き出しは、jinr_fukidashi1 のような番号つきのショートコードを子テーマで登録し直しています。JIN:Rのカスタマイザーに残っているアイコン画像や名前を読み出して表示するので、記事を触らなくても同じ人物の吹き出しが出ます。

こだわったのは、JIN:Rのファイルをコピーしないことです。テスト機のJIN:Rで表示を測って、その値でCSSを書き直しました。GA4やSearch Console、AdSenseのタグも、JIN:Rの設定からSWELLの「head内のコード」へ自動で写すようにしています。

見た目は「測って」比べる

見た目の調整は、感覚ではなく数字でやらせました。JIN:Rと子テーマの画面を同じ幅で撮って並べ、同じ文字の大きさを両方のテーマで測ります。

たとえば404ページの見出しは、SWELLが24.3px、JIN:Rが18pxでした。スマホだと記事タイトルの行数まで変わります。こういう差を1つずつ詰めていきました。

SWELLの仕様に合わせる必要があるところもありました。404ページにサイドバーを出したくてget_sidebar()を足しても、SWELLが「404はサイドバーなし」と判定しているので本文の下に回ってしまいます。これはSWELLのフィルターで解決しました。

add_filter( 'swell_is_show_sidebar', function ( $is_show ) {
	return is_404() ? true : $is_show;
} );

Codexのレビューは6回。「誤指摘」も混ざる

子テーマができたら、Codexにレビューを頼みました。1回目だけで、見た目とコードを合わせて約30項目の指摘が出ています。

ただ、そのまま全部直すわけではありません。Claude Codeに、指摘を実物で確かめてから仕分けさせました。

指摘実物を確かめた結果
スマホの一覧の下に、JIN:Rにはないサイドバーが出る本当。スマホでは出さないように修正
設定を読み込み直すと「head内のコード」を丸ごと上書きする本当。足りないタグだけ足す形に修正
吹き出しの中身の枠がない誤り。実物では出ていた
ブログカードで別の記事が出るかもしれない50個以上すべて正しい記事だった。念のため判定だけ固くした

AIのレビューは、当たりも外れも同じ自信の調子で出てきます。別のAIに「本当か確かめて」と挟むのは、かなり効きました。

3回目からは、子テーマだけでなく本番の手順書とスクリプトも見てもらいました。そこで止める理由として出たのがこの3つです。

  • WordPressが起動しなくなったときの戻し方がない
  • 本番とテスト機の照合が甘い
  • データベースの控えを、本当に入れ戻せるか分からない

どれも、言われてみれば怖いやつです。WordPressを使わずに戻す緊急手順を作り、照合の項目を増やし、控えのデータベースを試しに入れ戻して確かめました。6回目で「切り替えてよい」が出ました。

「戻せるか試した?」って聞かれると、たしかに試してないんだよね。

テスト機で「切り替え→戻す→もう一度切り替え」

本番と同じスクリプトで、次の流れをテスト機で通しました。

  1. SWELLに切り替える
  2. JIN:Rに戻す
  3. もう一度切り替える
  4. わざと重大なエラーを起こして、緊急の手順で戻す

ここで「もう一度切り替えると、ウィジェットの置き場所がずれる」という不具合が見つかりました。本番でやり直すことになってから気づいていたら、かなり焦ったと思います。子テーマを直して解消しました。

19:17、本番を切り替え

本番の作業は、Claude CodeがSSHでサーバーに入り、用意したPHPスクリプトを実行する形です。このサーバーにはwpコマンドがないので、スクリプトでwp-load.phpを読み込み、WordPress標準のswitch_theme()で切り替えました。

データベースを直接書き換えるのは、WordPressが起動しなくなったときの緊急の戻し方だけです。本番では書き換えない試運転まで確かめて、実際には使わずに済みました。

本番での流れはこうです。

  • 切り替え直前にデータベースと.htaccessの控えを取る
  • 本番とテスト機を25項目で照合(すべて一致)
  • 切り替えて、設定の確認が「すべて設定どおり」になるのを確認
  • 主要ページが正常に開き(HTTP 200)、存在しないページは「見つかりません」(HTTP 404)になることを確認
  • GA4、AdSense、Search Console、LinkSwitchのタグが1回ずつ入っていることを確認
  • PHPのエラーが出ていないことを確認

途中で「記事の広告の枠が0個」と出てヒヤッとしましたが、本番では広告の印の付け方がテスト機と違うだけでした。数え直したら、テスト機と同じ10個です。

それでも検索ボタンが消えていた

切り替えから2日後、自分でサイトを見ていて「トップページから検索できない気がする」と思い、AIに聞きました。

原因は、SWELLに切り替えたときの設定の誤りで、PCで見たときだけ検索ボタンが出ない状態になっていたことです。スマホの虫眼鏡は出ていました。テスト機で直して確かめてから、本番に入れました。

25項目の照合も「すべて設定どおり」も通っていたのに、なぜ残ったのか。単純で、入れた設定そのものが間違っていたら「設定どおり」は通るからです。ページが200で返ることと、ボタンがあることは別の話でした。

全部OKって言ってたのに、検索ボタンないじゃん……。

自動の確認は「壊れていないこと」を見るのは得意でも、「前にあったものがなくなっていること」には弱いです。最後に人が普通に使ってみる工程は、省かないほうがいいと思いました。

切り替え後の検索データ

切り替えの前後を、Search ConsoleとGA4で比べました。

1日あたり切り替え前(10/17〜10/30)切り替え後(11/1〜11/7)変化
クリック41.051.9+26%
表示回数1,8782,121+13%
平均順位8.147.830.31上昇
GA4の自然検索102.9121.7+18%

数字は増えていますが、切り替え前の2週間がやや低めで、その前の週は1日50.4クリックありました。増えたというより、元の水準に戻ったくらいに見ています。切り替え後のデータはまだ1週間分で、祝日も入っています。

切り替え直後の4日分で見ると、クリックが半分以下になった記事は4本ありました。比べられた3本はタイトルの本体も説明文も変わっておらず、順位の低下も0.5未満で、原因は特定できていません。少なくとも、テーマ変更で全体が崩れた様子はありませんでした。

後片付け:JIN:R本体を外しても差はゼロ

1週間ほどたってから、テスト機でJIN:R本体を外して、全101ページを比較しました。表示はすべて同じです。あわせて、記事の区切り線を1本だけ直しました。子テーマの中でJIN:Rのファイルに頼っていないことが、ここで確認できました。

まとめ:人がやるのは方針と、最後に使ってみること

今回の役割分担はこんな感じでした。

担当やったこと
私方針を決める、見た目を確認する、切り替えを決める、実際に使ってみる
Claude Code調査、子テーマの作成、見た目の測定、予行演習、本番の切り替え
Codex子テーマと手順書のレビュー(6回)

公式プラグインがないテーマでも、部品の数を調べて子テーマに再現すれば、記事を書き換えずに移行できます。JIN:Rで「SWELLに移りたいけど記事が多すぎる」という人には、この方法が現実的だと思います。

AIが一番助けてくれたのは、子テーマを書く速さより、「戻せるか試した?」のような確認を面倒がらずに全部やってくれたことでした。その上で検索ボタンは私が見つけたので、最後の人の目はやっぱり必要です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

こんにちは、「雑記.com」運営者のTakaです。
実際に買った・使った・困った・直した・試した経験をもとに、IT・ガジェット・投資・教育などの実体験やトラブル解決をまとめています。
使ってわかったこと、試行錯誤した過程、解決までの具体的な手順を、日々の選択や困りごとの解決に役立つ形で紹介します。

目次