Contents
- 1 注意点
- 2 関数
- 3 フィルターフック
- 3.1 media_date_column_time
- 3.2 plugin_install_description
- 3.3 edit_custom_thumbnail_sizes
- 3.4 wp_admin_bar_show_site_icons
- 3.5 the_author_link
- 3.6 ★register_{$post_type}_post_type_args / register_{$taxonomy}_taxonomy_args
- 3.7 pre_wp_filesize / wp_filesize
- 3.8 ★wp_content_img_tag
- 3.9 term_exists_default_query_args
- 3.10 ★wp_is_large_user_count
- 3.11 ★send_retrieve_password_email / retrieve_password_notification_email
- 4 アクションフック
- 5 クラス
- 6 アップデートされた関数
- 7 アップデートされたフィルタ―フック
- 8 非推奨となった関数
はじめに
2022年5月24日にWordPress 6.0がリリースされました。
この記事では、PHPコードに焦点を絞り、新たに追加された関数・アクション/フィルタ―フック・クラスをまとめたものです。
あわせて、WordPress6.0でアップデートされた関数・クラス・アクション/フィルタ―フック、および非推奨となったものも最後にまとめています。
条件として、WordPress本体のソース内で「PHPファイルの中で、コメントに @since 6.0.0
と記載があるもの」を手動で抽出してリストアップしました。
注意点
- マイナーリリースにより、仕様が若干変わる可能性があります。最新の仕様は、WordPressの開発リポジトリまたはWordPress.orgのリリースニュース(Make WordPress Core)などで確認してください。
- 独断で「これは使えそう」「重要そう」と思った項目については、★マークを付けています。
関数
関数に関しては、以下のものを除外しています。
- コメントのアクセス修飾子がprivateのもの(
@access private
) - 関数名がアンダーバー始まり
- おそらく内部的な利用にとどまるもの
- 内部にフィルタ―フックが用意されており、直接呼ぶ事は想定されていないもの
wp_recursive_ksort
配列を再帰的に辿り、キーをアルファベット順にソートします。
フィルターフック
media_date_column_time
メディアライブラリをリスト表示にした時の日付(登録日時)をフィルタリングします。
before:

after:

- Changeset 52950 – WordPress Trac
- #42942 (Provide a post_date_column_time hook for media files) – WordPress Trac
plugin_install_description
「プラグインを追加」ページで、プラグインカードに表示される説明文をフィルタリングします。

- Changeset 53074 – WordPress Trac
- #55480 (Add filter to modify description in plugin card) – WordPress Trac
edit_custom_thumbnail_sizes
メディアの編集ページで、変更をどの画像サイズに適用するかを選択するラジオボタン一覧に、カスタム画像サイズを選択肢として追加する事が出来ます。
デフォルトでは以下のように、「すべての画像サイズ」「サムネイル」「サムネイル以外の全サイズ」の三つから選択する事が出来ます。

ここに、add_image_size
などで追加したカスタム画像サイズを選択肢として表示する場合は、このフィルターで true
を返却します。

または、カスタム画像サイズのうち一部を選択肢としたい場合は、配列で返却します。
※カスタム画像サイズの選択肢が表示されるのは、add_image_size
関数でカスタム画像サイズを定義した後にアップロードされた画像に限られます。
- Changeset 53161 – WordPress Trac
- #28277 (Add ability to apply image edits to custom image sizes) – WordPress Trac
wp_admin_bar_show_site_icons
マルチサイトにおいて、管理画面のツールバーに表示されるサイトアイコンをフィルタリングします。
デフォルトはtrue(アイコンを表示する)ですが、以下の記述で無効化する事が出来ます。
大量のサイトがある場合のページパフォーマンス改善のために追加されたフックのようです。
before:

after:

- Changeset 53100 – WordPress Trac
- #54447 (Site Icons on My Sites in multisite network causing performance issue) – WordPress Trac
投稿者のURLをフィルタリングします。
ユーザー情報の「サイト」項目が設定されており、get_the_author_link
または the_author_link
が実行された時に、このフィルタを通過します。
★register_{$post_type}_post_type_args / register_{$taxonomy}_taxonomy_args
特定の投稿タイプまたはタクソノミーを登録するためのパラメータをフィルタリングします。
これまでは、register_post_type_args
や register_taxonomy_args
フィルターフックを使って、第二引数( $post_type
or $taxonomy
) によって処理を切り分けていたと思いますが、フィルターフック名で特定の投稿タイプ・タクソノミーをフィルタリング出来るようになりました。
- Changeset 53126 – WordPress Trac
- #53212 (add post_type-specific version of the register_post_type_args filter) – WordPress Trac
pre_wp_filesize / wp_filesize
PHPの filesize
関数のラッパーである wp_filesize
関数にある二つのフィルターです。
pre_wp_filesize
は filesize
関数で処理される前、wp_filesize
は filesize
関数で処理された後に通ります。
特別な理由がない限り、この二つのフックを使う機会は無いような気がします。
★wp_content_img_tag
コンテンツ内の img
タグをフィルタリングします。
コンテンツ内の img
タグは、wp_filter_content_tags
関数によって処理され、width
/ height
/ srcset
/ loading
属性等が付与されます。
このフィルタを使用する事で、コンテキストに応じて最終的な画像の出力データを変更する事が出来ます。
- Changeset 53028 – WordPress Trac
- Changeset 53149 – WordPress Trac
- #55347 (There should be filter for image tag in wp_filter_content_tags()) – WordPress Trac
term_exists_default_query_args
タームが存在するかどうかチェックする時のパラメータをフィルタリングします。
このフィルターフックは、タームが存在するかどうかチェックする term_exists
関数内に追加されており、内部的に get_terms
のパラメータをフィルタリングするためのもののようです。
このフィルターフックについては、どのようなケースで使用するのか読みとれませんでした。
★wp_is_large_user_count
登録ユーザー数に基づいて、「サイトを大規模なものとみなすかどうか」をフィルタリングします。
マルチサイトにおいては、「大規模ネットワークとみなすかどうか」を判断する wp_is_large_network
があり、大規模ネットワークとみなされた場合、いくつかの処理がスキップまたは延期されるようです。 (10000ユーザー以上または10000サイト以上)
シングルサイトにおいても同じような概念が導入され、登録ユーザー数を指標とし、大規模サイトとみなされた場合は、管理画面の動作負荷改善のために、いくつかの処理がスキップまたは変更されます。
調べた限りでは、大規模サイトとみなされた場合( wp_is_large_user_count
が true
の場合)、以下のような変更が入るようです。
投稿・固定ページ一覧の「クイック編集」メニューで、「投稿者」プルダウンが表示されなくなる

ユーザー一覧ページで、権限でフィルタリングするリンクの横に人数が表示されなくなる

デフォルトの閾値は 10000
ですが、ユーザー数が増えて管理画面が重いと感じる場合は、この閾値を下げてみるとよいかもしれません。
- Changeset 53011 – WordPress Trac
- #38741 (Introduce the concept of a large site in order to speed up the Users screen when there are many users) – WordPress Trac
★send_retrieve_password_email / retrieve_password_notification_email
ユーザにパスワードリセット用メールを送信する関数(retrieve_password
)に追加されたフィルターフックです。
今回追加された2つのフックを含めると、retrieve_password
関数には以下のようなフィルターフックが存在する事になります。
フィルターフック名 | 説明 |
---|---|
lostpassword_user_data | ユーザーデータをフィルタリングする |
lostpassword_errors | パスワードリセット要求時のエラーをフィルタリングする |
send_retrieve_password_email(新規追加) | パスワードリセット用メールを送信するかどうかをフィルタリングする |
retrieve_password_title | パスワードリセット用メールの件名をフィルタリングする |
retrieve_password_message | パスワードリセット用メールの本文をフィルタリングする |
retrieve_password_notification_email(新規追加) | パスワードリセット用メールのデータ全体をフィルタリングする |
send_retrieve_password_email
の使用例
retrieve_password_notification_email
の使用例
- Changeset 52604 – WordPress Trac
- #54690 (Add ability to filter whole notification email in retrieve_password) – WordPress Trac
アクションフック
★registered_post_type_{$post_type} / registered_taxonomy_{$taxonomy}
特定の投稿タイプまたはタクソノミーが登録された後に発火します。
これまでは、registered_post_type
や registered_taxonomy
アクションフックを使って、第一引数( $post_type
or $taxonomy
) のスラッグによって処理を切り分けていたと思いますが、アクションフック名で特定の投稿タイプ・タクソノミーをフィルタリング出来るようになりました。
同様のフックとして、前述の register_{$post_type}_post_type_args
/ register_{$taxonomy}_taxonomy_args
フィルターフックがありますが、これは register_post_type
で指定されたパラメータを変更するためのフックです。
一方、registered_post_type_{$post_type}
/ registered_taxonomy_{$taxonomy}
アクションフックは、登録された投稿タイプ・タクソノミーのオブジェクト(WP_Post_Type
)に対して発火する、という違いがあります。
多少フックの書き方は変わるものの、どちらのフックを使っても同じようなことは出来ると思います。
- Changeset 53126 – WordPress Trac
- #53212 (add post_type-specific version of the register_post_type_args filter) – WordPress Trac
クラス
クラスに関しては、一般的な開発ではほぼ使わないであろう事、また自分が詳しく解説出来る自信がありませんので、各クラスの冒頭のコメント欄を翻訳した文章のみ記載しておきます。
WP_REST_Block_Patterns_Controller
REST APIでブロックパターンにアクセスするためのコアクラス
WP_REST_Block_Pattern_Categories_Controller
REST APIでブロックパターンカテゴリーにアクセスするためのコアクラス
アップデートされた関数
影響が大きそうな関数のみをピックアップしています。
size_format
バイト数をフォーマットする関数ですが、より大きな単位(PB / EB / ZB / YB)をサポートするようになりました。
まとめると、以下の単位がサポートされます。
スラッグ | 名前 |
---|---|
YB | ヨタバイト |
ZB | ゼタバイト |
EB | エクサバイト |
PB | ペタバイト |
TB | テラバイト |
GB | ギガバイト |
MB | メガバイト |
KB | キロバイト |
B | バイト |
validate_current_theme
現在有効なテーマが必須ファイルを含んでいるかどうかをチェックする関数ですが、ブロックテーマでは/templates/index.html
(または /block-templates/index.html
) が存在すれば、index.php
が無くてもこの関数は true
を返すようになりました。
つまり、ブロックテーマにおいて、index.php
を含める事が必須ではなくなりました。
アップデートされたフィルタ―フック
影響が大きそうなものは特に無し
非推奨となった関数
無し