以下是WordPress 6.3中新增的函数、类、动作/筛选挂钩的总结

2 年 ago

雅, 悟

8 minutes

更新记录

2023.08.28: WordPress6.3正式版をもとに、記事の内容を加筆・修正しました。

首先

2023年8月8日，WordPress 6.3版本发布了。

这篇文章总结了WordPress 6.3中新增的函数、动作钩子、过滤钩子、类等内容。

此外，我们还总结了在WordPress 6.3中发生变更或已被弃用的内容。

我手动提取并列出了以下两种条件：一种是在WordPress核心源代码的注释中标有“@since 6.3.0”的项目，另一种是在注释中标有“@deprecated 6.3.0”的已被弃用项目。

请留意细节。
请注意要点。
请留心要点。

手動で差分を抽出しているため、漏れがある場合があります。また、各サンプルコードは動作確認しておりますが、もし不備等ありましたらぜひコメント下さい。

WordPress Developer Resourcesで、そのバージョンで追加・変更された全ての関数・フック・クラス・メソッド等を確認出来ます。興味がある方は、この記事に記載されていないものも含めて調べてみて下さい。
※ 6.3.0 | WordPress Developer Resources

最新的功能

在新的函数中，我们排除了以下内容。

コメントのアクセス修飾子が private である関数（@access private）
関数名がアンダーバー始まり
内部にフィルタ―フックが用意されており、直接呼ぶことは想定されていないと判断したもの
コアのフィルターフック・アクションフックのコールバック関数であり、直接呼ぶことは想定されていないと判断したもの

获取 WordPress 的开发模式 / 判断 WordPress 是否为开发模式

WordPress 6.3 引入了影响 WordPress 功能的 “开发模式” 概念，并通过 WP_DEVELOPMENT_MODE 常量来设置该开发模式。以下是可以指定为常量值的值。

core: サイトがコアの開発環境として使用されていることを示す

plugin: サイトがプラグイン開発環境として使用されていることを示す

theme: サイトがテーマの開発環境として使われていることを示す

all: サイトが開発環境として使用されていることを示し、特定のサイト全体で作業している場合に関連する
空の文字列 (デフォルト値): 開発モードが有効になっていないことを示す

只有这个解释的话，可能很难想象在什么情况下使用，但目前的使用情况主要是控制是否缓存”theme.json”。

默认情况下（如果未启用开发模式），theme.json将被缓存，因此可能会遇到“已更新主题的theme.json文件，但前端样式未更新”这样的问题。为了解决这类主题开发时的问题，您可以将开发模式设置为theme，以无效化该缓存。

define( 'WP_DEVELOPMENT_MODE', 'theme' );

另外，我们添加了 wp_get_development_mode() 函数用于获取这些开发模式，并且还添加了 wp_is_development_mode() 函数用于检查是否为指定的开发模式。然而，推荐使用 wp_is_development_mode() 函数来检查而不是直接访问 wp_get_development_mode() 函数的返回值。

if ( wp_is_development_mode( 'theme' ) ) {
	// 開発モードが `theme` の時 (テーマを開発している時) のみ実行したい処理...
}

其他

wp_admin_bar_edit_site_menu(): 「Edit site」リンクをツールバーに表示する

wp_get_block_css_selector(): 指定されたブロックタイプとプロパティの CSS セレクタを決定し、利用可能であればそれを返す

wp_cache_set_users_last_changed(): users キャッシュグループの最終変更時刻を設定する

wp_get_first_block(): ブロックの配列から、最初に見つかった指定のブロックを返す

wp_get_theme_directory_pattern_slugs: 現在のテーマが登録したいパターン (スラッグ) をパターンディレクトリから返す

wp_get_loading_optimization_attributes(): ローディング最適化の属性を取得する

wp_get_post_content_block_attributes(): 現在の投稿テンプレートから投稿コンテンツブロックの属性を取得する

wp_get_theme_directory_pattern_slugs(): 現在のテーマに必要なパターン (スラッグ) をパターンディレクトリから返す

wp_img_tag_add_loading_optimization_attrs(): img タグに最適化属性を追加する

wp_is_password_reset_allowed_for_user(): 特定のユーザーに対してパスワードのリセットが許可されているかどうかをチェックする

wp_lazyload_comment_meta(): 遅延読み込みのためにコメントメタをキューに入れる

wp_lazyload_site_meta(): 遅延読み込みのためにサイトメタをキューに入れる

wp_lazyload_term_meta(): 遅延読み込みのためにタームメタをキューに入れる

最新的过滤钩子

cron_memory_limit: 定时任务的内存限制

对 WP-Cron 事件处理分配的内存限制进行过滤。

默认值为WP_MAX_MEMORY_LIMIT常量的值（如果未定义，默认值为256M）或php.ini的memory_limit值中较大的一个。

如果由于内存容量或限制的问题而造成 Cron 事件无法正常运行，也许尝试使用这个过滤器进行调整可能是一个好主意。

<?php
function custom_cron_memory_limit( $filtered_limit ) {
	// 整数のバイト値に変換
	$max_limit_int = wp_convert_hr_to_bytes( $filtered_limit );

	// メモリ制限が256Mより低かった場合は、512Mにする
	if ( $max_limit_int < 268435456 ) {
		$filtered_limit = '512M';
	}

	return $filtered_limit;
}
add_filter( 'cron_memory_limit', 'custom_cron_memory_limit' );

获取页面查询参数

使用 get_pages() 函数来过滤传递给 WP_Query 的查询参数。

在变更集55569中, get_pages() 函数内部开始使用 WP_Query 。由于这个变化，如果您使用了 get_pages 过滤器钩子来过滤 get_pages() 函数的返回值，可能会发生冲突。因此，解决这个问题也是其中一个目标。

// get_pages() 関数のクエリを変更する
function custom_get_pages_query_args( $query_args, $parsed_args ) {
	// 特定のページを除外する
	$query_args['post__not_in'] = array( 1 );
	return $query_args;
}
add_filter( 'get_pages_query_args', 'custom_get_pages_query_args', 10, 2 );

分别对图像进行缩略图编辑。

显示选择将编辑后的图像更改应用于哪种尺寸的设置。

这个设定是指具体而言下面红框部分。

默认设置为false，因此此配置不会显示，但可以通过以下代码启用。

add_filter( 'image_edit_thumbnails_separately', '__return_true' );

似乎在WordPress 6.0中引入了类似的edit_custom_thumbnail_sizes过滤钩子，但随着图像编辑界面的重新构建，它已被弃用，取而代之的是这个钩子的引入。

导航菜单项属性 / 导航菜单子菜单属性

迄今为止，菜单的 a 元素属性可以通过 nav_menu_link_attributes 过滤器钩子进行过滤，但现在也可以通过这两个钩子过滤以下元素的属性。

nav_menu_item_attributes: li 要素

nav_menu_submenu_attributes: サブメニューの ul 要素

// li 要素の属性をフィルタリング
function custom_nav_menu_item_attributes( $li_atts, $menu_item, $args, $depth ) {
	$li_atts['class']       .= ' my-menu-item';
	$li_atts['data-custom']  = 'my-menu-item-data';
	return $li_atts;
}
add_filter( 'nav_menu_item_attributes', 'custom_nav_menu_item_attributes', 10, 4 );

// サブメニューの ul 要素の属性をフィルタリング
function custom_nav_menu_item_attributes( $li_atts, $menu_item, $args, $depth ) {
	$li_atts['class']       .= ' my-menu-item';
	$li_atts['data-custom']  = 'my-data';
	return $li_atts;
}
add_filter( 'nav_menu_item_attributes', 'custom_nav_menu_item_attributes', 10, 4 );

Changeset 56067 – WordPress Trac

#57140 (Add filters to allow themes and plugins to pass HTML attributes to different Nav Walker output) – WordPress Trac

插件清单

筛选插件列表表格。

举个例子，即使插件是有效的，在以下方式中，您可以将“全部”、“使用中”、“自动更新禁用”列表以及搜索结果列表隐藏起来。

<?php
// Hello Dolly プラグインを非表示にする
function custom_plugins_list( $plugins ) {
	// すべて
	unset( $plugins['all']['hello-dolly/hello.php'] );
	// 使用中
	unset( $plugins['active']['hello-dolly/hello.php'] );
	// 自動更新無効
	unset( $plugins['auto-update-disabled']['hello-dolly/hello.php'] );
	// 検索結果
	unset( $plugins['search']['hello-dolly/hello.php'] );

	return $plugins;
}
add_filter( 'plugins_list', 'custom_plugins_list' );

预先加载文本域

使用load_textdomain()函数进行.mo文件的加载并返回任意区域设置的快速返回（早期退出）。

这个过滤器对于替代翻译的加载缓存等策略非常有用。当返回一个非默认的null布尔值时，该值将直接成为load_textdomain()函数的返回值。

<?php
// テーマがTwenty Twenty Three、言語が日本語の場合にtrueを返す
function custom_pre_load_textdomain( $loaded, $domain, $mofile, $locale ) {
	if ( 'twentytwentythree' === $domain && 'ja' === $locale ) {
		$loaded = true;
	}
	return $loaded;
}
add_filter( 'pre_load_textdomain', 'custom_pre_load_textdomain', 10, 4 );

设置导航菜单项预先配置

根据是否通过 wp_setup_nav_menu_item() 函数的设置进行短路筛选（提前返回）。

只有在返回null以外的情况下，后续处理才会进行，该值将作为wp_setup_nav_menu_item的返回值进行早期返回。

根据查看的票据，与其在此函数中每次设置导航菜单项，更好地通过预先缓存的对象使用此过滤器返回，可以预期性能的改善。

因此，我认为我们可能需要一个单独的处理函数或方法，来缓存已设置的导航菜单，并在此过滤器中返回设置好的对象。

function custom_pre_wp_setup_nav_menu_item( $modified_menu_item, $menu_item ) {
    // キャッシュしておいたセットアップ済のオブジェクトを取得
    $cached_menu_item = my_custom_get_cached_menu_item( $menu_item );
	return $cached_menu_item;
}
add_filter( 'pre_wp_setup_nav_menu_item', 'custom_pre_wp_setup_nav_menu_item', 10, 2 );

网站编辑器无JavaScript消息

如果在浏览器上未启用JavaScript，则对于在网站编辑器中显示的消息进行过滤。

<?php
// ブラウザで JavaScript が有効でない場合、サイトエディターで警告メッセージを変更する
function custom_site_editor_no_javascript_message( $message, $post ) {
	return 'JavaScriptが有効化されていません!';
}
add_filter( 'site_editor_no_javascript_message', 'custom_site_editor_no_javascript_message', 10, 2 );

此外，在投稿编辑器中，还存在一个名为 block_editor_no_javascript_message 的类似过滤器钩子。

获取附件图像上下文

对wp_get_attachment_image()的使用进行上下文过滤。

我对这个过滤器的意图和用法不太了解，但从阅读票据来看，我认为它只是用于内部使用的钩子。

Changeset 55821 – WordPress Trac
#58212 (Improve clunky logic to inject loading attribute in the get_the_post_thumbnail() function) – WordPress Trac

wp_min_priority_img_pixels 的最低优先级像素

20234年5月2日，有一份提案发布，建议为图像添加fetchpriority属性，以提高LCP性能。这个逻辑将在WordPress 6.3中实施，并会将fetchpriority=”high”属性添加到满足以下所有条件的第一个图像上。

以第三个条件为例，假设图像的宽度为500像素，高度为200像素，则计算结果为500 * 200 = 100,000，大于阈值50,000，因此符合条件。

该过滤器会通过第三个条件对此阈值进行过滤。

<?php
// デフォルト値の50,000から100,000に変更
function custom_wp_min_priority_img_pixels( $threshold ) {
	return 100000;
}
add_filter( 'wp_min_priority_img_pixels', 'custom_wp_min_priority_img_pixels' );

wp_navigation应该创建备用选项

过滤是否自动生成回退导航。默认值为 true。

我并不完全理解「生成自动回退」的目的是什么，以及通过选择退出自动生成会对行为产生什么样的变化。不过，您可以使用以下代码来禁用它。

add_filter( 'wp_navigation_should_create_fallback', '__return_false' );

新的动作钩

批量编辑帖子

处理完一次性编辑的帖子数据后触发。

一括编辑是指在帖子列表界面上同时操作多个帖子的情况。

通过使用这个钩子，似乎可以在不调用.ajax()的情况下保存附加数据。

<?php
function custom_bulk_edit_posts( $updated, $shared_post_data ) {
	// 通常の投稿の場合のみ、投稿IDを使って何らかの追加処理を行う
	if ( 'post' === $shared_post_data['post_type'] ) {
		foreach ( $updated as $post_id ) {
			// Do something...
		}
	}
}
add_action( 'bulk_edit_posts', 'custom_bulk_edit_posts', 10, 2 );

将 “wp_cache_set_last_changed” 翻译为中文：

在缓存组的last_changed时间更新后触发。

根据《WordPress 6.3 中的 Make WordPress Core：改进缓存 API》，开发者可以利用这个挂钩功能来控制清除缓存组。

Improvements to the Cache API in WordPress 6.3 – Make WordPress Core
Changeset 55702 – WordPress Trac
#57905 (Add last changed cache helper function) – WordPress Trac

更新用户

在用户进行更新并发送邮件后触发。

<?php
function custom_wp_update_user( $user_id, $userdata, $userdata_raw ) {
	// ユーザー情報を使って何らかの処理を行う
	$args = array(
		'id'         => $user_id,
		'login_name' => $userdata['user_login'],
		'password'   => $userdata['user_pass'],
		'email'      => $userdata['user_email'],
	);
	do_something( $args );
}
add_action( 'wp_update_user', 'custom_wp_update_user', 10, 3 );

新的班级

以下列出了一些新增的类，但由于这些类主要用于内部使用，所以只列出类名。

WP_Classic_To_Block_Menu_Converter
WP_Duotone
WP_Navigation_Fallback
WP_REST_Global_Styles_Revisions_Controller
WP_REST_Navigation_Fallback_Controller

更新的函数

跟新函数一样，以下的内容被排除了。

コメントのアクセス修飾子が private である関数（@access private）
関数名がアンダーバー始まり
内部にフィルタ―フックが用意されており、直接呼ぶことは想定されていないと判断したもの
コアのフィルターフック・アクションフックのコールバック関数であり、直接呼ぶことは想定されていないと判断したもの

使用 wp_enqueue_script / wp_register_script 插件

我们已支持 async 和 defer 属性。

在过去，如果想要给这些属性添加到 script 标签中，需要利用一些钩子函数（如 script_loader_tag 或 wp_script_attributes）来自定义输出处理（例如 Twenty Twenty 主题）。

第五个参数 ($in_footer) 用于控制脚本是否在页脚加载，现在支持布尔类型和数组类型，并且可以指定这些属性。

如果想给在页脚加载的脚本添加defer属性，可以像下面这样操作:

wp_register_script( 
	'my-script', 
	'/path/to/script.js', 
	array(), 
	'1.0.0', 
	true, 
);

在 in_footer 键中指定一个布尔值来加载页脚，并在 strategy 键中指定属性。

wp_register_script( 
	'my-script', 
	'/path/to/script.js', 
	array(), 
	'1.0.0', 
	array(
		'in_footer' => true,
		'strategy'  => 'defer',
	)
);

其他可能选项:
– 另外
– 还有
– 此外
– 其他

get_block_editor_server_block_settings(): selectors フィールドが追加された

get_default_block_categories(): Reusable Blocks が Patterns にリネームされた

get_edit_post_link(): wp_navigation、wp_template、wp_template_part 投稿タイプのリンクが追加された

get_the_author(): 著者の表示名が不明な場合は空文字を返すようになった

get_pages(): 内部的に WP_Query が使われるようになった

get_post_type_labels(): item_trashed ラベルが追加された

list_files(): include_hidden パラメータが追加された

locate_block_template(): 管理バーから現在のテンプレートを直接編集できるように、$_wp_current_template_idグローバルが追加された

register_block_type_from_metadata(): selectors フィールドが追加された

safecss_filter_attr(): URLを値として持つ filter プロパティと、repeat() 値、box-shadow プロパティをサポートした

wp_enqueue_script(): boolean 型の $in_footer パラメータがオーバーロードされ、配列型の $args パラメータになっていた。

wp_get_computed_fluid_typography_value(): 無効な clamp 値の原因となる、サポートされていない min/max ビューポート値をチェックするようになった

wp_get_development_mode(): 現在の開発モードを取得する

wp_get_global_styles(): 内部フォーマット (var:preset|color|secondary) が常に標準フォーマット (var(–wp–preset–font-size–small)) に解決されるようになった。transforms が context パラメータで使用できるようになった。

wp_get_layout_style(): grid レイアウトタイプが追加された

wp_get_nocache_headers(): ログインしているユーザーの Cache-Control ヘッダーに no-store ディレクティブと private ディレクティブが含まれるようになった

wp_get_object_terms(): update_term_meta_cache のデフォルト値として false が設定されるようになった

wp_get_typography_font_size_value(): フォントサイズの計算に layout.wideSize が使われるようになり、最小フォントスケールの計算ロジックが変わった

wp_load_core_site_options(): 永続オブジェクトキャッシュが有効になっている場合は、ネットワークオプションのプライムキャッシュも使用する

wp_register_script(): boolean 型の $in_footer パラメータがオーバーロードされ、配列型の $args パラメータになっていた

wp_trim_excerpt(): 抜粋コンテンツから脚注マークアップが削除されるようになった

升级后的过滤器挂钩

wp_omit_loading_attr_threshold: デフォルトの閾値が1から3に変更された

pre_trash_post: $previous_status` パラメータが追加された

rest_allowed_cors_headers: $request パラメータが追加された

rest_exposed_cors_headers: $request パラメータが追加された

已更新的动作挂钩

wp_trash_post: $previous_status パラメータが追加された

trashed_post: $previous_status パラメータが追加された

升级过的班级

以下是有关这些类的信息：虽然方法已经进行了添加和更改，但所有这些方法主要是为了内部使用而准备的，并且判断并没有太多直接调用类方法的情况，所以只需列出类名即可。

Walker_Nav_Menu
WP_Block_Template
WP_Block_Type
WP_Filesystem_FTPext
WP_Filesystem_ftpsockets
WP_HTML_Tag_Processor
WP_Image_Editor_Imagick
WP_List_Table
WP_Metadata_Lazyloader
WP_Plugins_List_Table
WP_Query
WP_REST_Block_Patterns_Controller
WP_REST_Block_Types_Controller
WP_REST_Blocks_Controller
WP_REST_Global_Styles_Controller
WP_REST_Templates_Controller
WP_Site_Health
WP_Scripts
WP_Style_Engine
WP_Theme_JSON
WP_Upgrader
WP_User_Query

已经被废弃的函数

wlwmanifest_link() 要求以中文原生方式改写，只需要一种选项：

生成wlwmanifest链接()

我不再输出任何东西了。

为了避免在wp_head()函数中输出不必要的代码，有些文章建议使用以下描述，但这样的描述本身是不必要的。

remove_action( 'wp_head', 'wlwmanifest_link' );

其他

wp_queue_comments_for_comment_meta_lazyload(): 代わりに wp_lazyload_comment_meta を使用する

wp_get_loading_attr_default(): 代わりに wp_get_loading_optimization_attributes を使用する

wp_img_tag_add_loading_attr(): 代わりに wp_img_tag_add_loading_optimization_attrs を使用する

block_core_navigation_parse_blocks_from_menu_items(): 代わりに WP_Navigation_Fallback::parse_blocks_from_menu_items を使用する

block_core_navigation_get_classic_menu_fallback(): 代わりに WP_Navigation_Fallback::get_classic_menu_fallback() を使用する

block_core_navigation_get_classic_menu_fallback_blocks(): 代わりに WP_Navigation_Fallback::get_classic_menu_fallback_blocks() を使用する

block_core_navigation_maybe_use_classic_menu_fallback(): 代わりに WP_Navigation_Fallback::create_classic_menu_fallback() を使用する

block_core_navigation_get_most_recently_published_navigation(): 代わりに WP_Navigation_Fallback::get_most_recently_published_navigation() を使用する

已经不推荐使用的类方法

WP_Metadata_Lazyloader::lazyload_comment_meta(): 代わりに WP_Metadata_Lazyloader::lazyload_meta_callback() を使用する

WP_Metadata_Lazyloader::lazyload_term_meta(): 代わりに WP_Metadata_Lazyloader::lazyload_meta_callback() を使用する

WP_Scripts::print_inline_script(): 代わりに get_inline_script_tag() または get_inline_script_data() を使用する

#技术文章

更新记录 2023.08.28: WordPress6.3正式版をもとに、記事の内容を加筆・修正しました。