WordPress 7.2 で画像処理がブラウザ側に広がる|自作プラグインのコードで影響を確かめた

  • URLをコピーしました!

11月17日に、WordPress 7.2 の変更について、開発者向けの解説(Dev Note)が2本出ました。

1本はメディアの変更、もう1本は jQuery 4 への準備です。

私は投稿のタイトルから OGP 画像を自動で作るプラグイン「Coverpeek」を wordpress.org で公開しています。

画像を扱うプラグインなので、7.2 の変更で困ることがないか、コードを読んで確かめてみました。

先に断っておくと、手元の環境はまだ WordPress 7.1 で、7.2 では動かしていません。

この記事はコードを読んで確かめた範囲の話です。


目次

ひとことで

  • 7.2 では人がブラウザから画像をアップロードしたとき、縮小版(サブサイズ)をブラウザで作る場面が増えます。ただし、今のところ対象は Chrome と Edge だけです
  • jQuery は7.2 で jQuery Migrate 3.6.0 が入り、jQuery 4 への準備が始まります
  • Coverpeek はコードを読んだ範囲では、どちらの影響も受けませんでした

7.2 のメディアの変更

ブラウザで縮小版を作る場面が広がる

WordPress は画像をアップロードすると、サムネイルや中サイズなど、いくつかの縮小版を作ります。

これまではサーバーの PHP(GD や Imagick)が作っていました。

7.1 で、この処理をブラウザでする仕組みが入りました。

アップロードした元の画像を REST API で送り、縮小版はブラウザが WebAssembly(wasm-vips)で作って、あとから送ります。

サーバーの負担が減り、サーバーの画像ライブラリの違いで結果が変わることもなくなります。

ただ、7.1 でこの仕組みが動くのはブロックエディタでアップロードしたときだけでした。

7.2 では次の画面からのアップロードも同じ仕組みになります。

  • メディアライブラリ(グリッド表示)
  • 「新規メディアファイルを追加」の画面
  • メディアの選択画面(画像ブロックの「メディアライブラリ」ボタン、アイキャッチの設定など)

対象は Chrome と Edge だけ

この仕組みが動くのは今のところ Chromium 137 以降のブラウザ(Chrome・Edge)だけです。

Firefox と Safari ではこれまでどおりサーバーで処理します。

つまり、同じサイトでも、アップロードした人のブラウザによって、縮小版を作る場所が変わります。

そのほかの変更

  • アニメーション GIF・WebP: ブラウザで処理したときは縮小版もアニメーションしたまま作られる。ファイルは静止画より大きくなる
  • 保存時の自動添付: ブロックエディタで投稿を保存したとき、どの投稿にも添付されていない画像ブロックの画像が、その投稿に添付される(添付ファイルのページを有効にしているサイトでは動かない)
  • マルチサイト: 縮小版もサイトの容量の制限の対象になる
  • crossorigin の書き換えをやめた: 7.1 ではエディタの画面に crossorigin="anonymous" を自動で付けていた。CDN に置いたメディアが読み込めなくなる問題があったため、7.2 でやめた

ブラウザでの処理を止めたいときは次のフィルターを使います。

add_filter( 'wp_client_side_media_processing_enabled', '__return_false' );

アニメーションした縮小版だけを止めたいときはwp_generate_animated_image_subsizes フィルターで false を返します。

プラグインやテーマで気を付けるところ

開発者向けの解説から、プラグインやテーマを作る人が確かめておきたい点を抜き出しました。

  • アップロードの見分け方: ブラウザで処理するときはアップロードが async-upload.php ではなく REST API を通る。$_POST['action'] が upload-attachment かどうか、DOING_AJAX が定義されているかどうかで見分けているコードは、この経路のアップロードに気づけない
  • 縮小版が通るフィルター: 元の画像はこれまでどおり wp_handle_upload_prefilter を通る。ブラウザで作った縮小版は wp_handle_sideload_prefilter を通る
  • 非推奨になった関数: 7.1 で入った wp_start_cross_origin_isolation_output_buffer() と wp_add_crossorigin_attributes() が非推奨になる。前者の代わりは wp_send_document_isolation_policy_header()。後者に代わりはなく、呼び出しを消せばよい
  • プラグイン独自の画面: ブラウザで処理するのは WordPress 本体が準備した画面だけ。プラグインの設定画面などでメディアの選択画面を開いても、これまでどおりサーバーで処理される

jQuery 4 への準備

もう1本の解説は jQuery の話です。

WordPress 本体の jQuery は次の順で jQuery 4 に移る予定だそうです。

  1. 7.2: jQuery Migrate 3.6.0 を入れる。jQuery 4 でなくなる機能を使っていると、警告が出るようになる
  2. 7.3: jQuery 本体と jQuery UI を新しい版にする(テストの結果しだい)
  3. 2027年末(7.5 か 7.6): jQuery Migrate を、既定で無効にする(影響を調べたうえで決める)

jQuery 本体の 4.1 と、3.x が今後は重大な修正だけになる話は11月19日のまとめで紹介しました。

WordPress の場合は本体が読み込む jQuery がこの予定で切り替わっていきます。

Coverpeek のコードで確かめたこと

ここからが本題です。

Coverpeek の仕組みと、7.2 の変更が関係しそうなところを、4つに分けて確かめました。

Coverpeek が画像を「実際のファイル」として保存する仕組みにした理由は、こちらに書いています。

1. 画像を作る処理 → 影響なし

Coverpeek は投稿を保存したとき(save_post)に、サーバーの PHP(GD)でタイトル入りの画像を作ります。

作った画像は、wp_upload_bits() で保存し、wp_insert_attachment() で登録し、wp_generate_attachment_metadata() で縮小版を作ります。

すべてサーバーの中の処理です。

7.2 で変わるのは「人がブラウザからアップロードしたとき」の経路です。

このプラグインの画像はブラウザのアップロードを通らないので、縮小版もこれまでどおりサーバーで作られます。

アップロードを $_POST['action'] や DOING_AJAX で見分けるコードもありませんでした。

2. 設定画面の背景画像の選択 → 影響なし(のはず)

設定画面では背景にする画像を wp.media のメディアの選択画面から選べるようにしています。

7.2 でブラウザで処理するのは WordPress 本体が準備した画面のメディアの選択画面だけです。

この設定画面はプラグイン独自の画面なので、ここからアップロードしても、これまでどおりサーバーで処理されるはずです。

背景画像はget_attached_file() で元のファイルを読んで使っています。

メディアライブラリで先に(Chrome から)アップロードした画像を選んでも、元のファイルの扱いは変わりません。

アニメーション GIF を背景に選んだ場合も、GD が読むのは元のファイルのうち最初のコマだけなので、これまでと同じです。

3. 保存時の自動添付 → 影響なし

7.2 で自動で添付されるのは本文の画像ブロックの画像だけです。

プラグインが作る画像はアイキャッチで、登録するときにもともと投稿に添付しています。

4. jQuery → 影響なし

管理画面の JavaScript では jQuery を使っています。

使っているのは $()、.on()、.val()、.attr()、.css()、.find()、.append() など、基本的な書き方だけでした。

jQuery 4 でなくなった書き方($.trim()、$.isArray()、$.isFunction() など)や、以前から非推奨とされている書き方(.bind()、.click( function … ) のような書き方など)をファイル全体で検索しましたが、見つかりませんでした。

まだ確かめていないこと

コードを読むだけでは分からないところも残っています。

  • メディアライブラリのグリッドで、Coverpeek が作った画像に「自動生成」のバッジを付けています。グリッドの描画の変化を見張って付ける作りなので、7.2 でアップロードの仕組みが変わっても表示が崩れないかは、動かして見ないと分かりません
  • readme の「Tested up to」は今は 7.1 です。7.2 の正式版が出たら、実際に動かして確かめてから上げる予定です

判断基準のまとめ

自分のプラグインやテーマが 7.2 の影響を受けるかは次の点で見分けられそうです。

  • 画像をサーバーの中で作って登録しているだけなら、ブラウザでの処理の影響は受けにくい
  • アップロードを $_POST['action'] や DOING_AJAX で見分けているなら、REST API の経路にも対応させる
  • 縮小版に手を加えるフィルターを使っているなら、wp_handle_sideload_prefilter も確かめる
  • アニメーション GIF の縮小版が静止画である前提の処理があれば、見直す
  • jQuery は4 でなくなった書き方を検索し、7.2 で jQuery Migrate の警告が出ないかを確かめる

Coverpeek の紹介ページを作ったときの話はこちらです。

出典

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

この記事を書いた人

Web制作会社にてフロントエンド業務に携わる一方、個人でブログを書いたりサイト制作やシステム構築にいそしむ。元家具職人。
https://rcwas.com/

目次