WordPressでテーマを変更すると「画像サイズが合わない」「新しいデザインにサムネイルがフィットしない」といった問題がよく起こります。
実際、私もテーマを切り替えたときに「過去記事のアイキャッチがバラバラに見える」状態になってしまい、見た目が崩れて困ったことがありました。
そんなときに便利なのが wp-cli の wp media regenerate コマンド です。
これを使えば、アップロード済みの画像ファイルから新しいサイズのサムネイルを一括生成できます。
サムネイル再生成とは？
WordPressは画像をアップロードするときに、テーマやプラグインで指定されたサイズのサムネイルを自動生成します。
しかしテーマを変えたり、functions.php に新しい画像サイズを追加した場合、既存の画像には新サイズが作られていません。
結果として「新しいデザインで古い画像だけ小さすぎる／大きすぎる」という不揃いな状態が発生します。
このときに再生成を行うことで、既存の画像も新しいルールに合わせたサムネイルを生成できるわけです。
基本コマンド
サムネイル再生成の基本は以下のコマンドです。
wp media regenerate
これを実行すると、すべてのメディアファイルに対してサムネイルを作り直します。
よく使うオプション
進行状況を表示する
wp media regenerate --yes
--yes→ 確認をスキップして一気に処理開始
処理が大量になる場合、これを付けないと「続行しますか？」と聞かれるので、バッチ的に流すときは --yes が便利です。
特定のIDだけ再生成
wp media regenerate 123 456
投稿IDを指定すると、その画像だけ再生成できます。
テーマ全体ではなく「崩れた画像だけ直したい」ときに使えます。
古いサムネイルを削除してから再生成
wp media regenerate --skip-delete
デフォルトでは古いサムネイルを削除してから作り直します。
もし既存のサムネイルを残したいなら --skip-delete を付けます。
実際に使ってみて
私のサイトでは、テーマを切り替えた直後にアイキャッチの見た目が崩れていました。
再生成を実行したら数分で全記事のサムネイルが新テーマにフィット。
「全部手で差し替えなきゃ…」と思っていたので、このコマンドのありがたさを痛感しました。
ただし数千件のメディアがあると処理に時間がかかるので、サーバー負荷が少ない時間帯に実行するのがベストです。
まとめ
- テーマ変更や画像サイズ追加後はサムネイルがずれることがある
wp media regenerateで既存画像のサムネイルを一括再生成できる--yesや ID指定などのオプションで柔軟に使える- 大量処理はサーバー負荷に注意
WordPressのテーマ変更時に「画像が揃わない」と悩んだら、ぜひこのコマンドを試してみてください。
一括処理で管理画面もスッキリし、サイト全体が整いますよ。
コメント