WP互換性カタログ

非推奨 出荷 機械照合 機械抽出 since 7.2.0

ソース #

挙動変更 出荷 照合（要確認） 手動

absint() のシグネチャが absint( $maybeint ): int になり、整数範囲を超える有限の float はオーバーフローではなく PHP_INT_MAX を返すようになった。NAN/INF は従来どおり 0。
通常の利用では影響しないが、巨大な数値やオーバーフロー後の値に依存したテスト・ID 計算があれば確認すること。

absint

ソース #

挙動変更 出荷 照合（要確認） 手動

wp_create_application_password アクションに wp_application_password_created_notification() が登録され、アプリケーションパスワードが追加されるとそのユーザーにメールが送られる。
プログラムでアプリケーションパスワードを大量発行するプラグイン（連携・プロビジョニング系）は意図しないメールが飛ぶ。抑止は wp_send_application_password_created_email フィルター、文面変更は wp_application_password_created_email フィルターで行う。

WP_Application_Passwords::create_new_application_password wp_create_application_password wp_send_application_password_created_email wp_application_password_created_email

roadmap-to-7-2 ソース #

挙動変更 出荷 要目視 手動

WP_Theme_JSON::convert_custom_properties() が、var:preset|color|... などのプリセット参照のスラッグを、生成される CSS カスタムプロパティ名に合わせてケバブケース化するようになった。
キャメルケースなどのスラッグを持つプリセットを var:preset| で参照しているテーマ・ブロックスタイルは、出力される var(--wp--preset--...) の名前が変わる。これまで参照が解決されず壊れていたケースが直る方向の変更だが、旧名に合わせた手書き CSS がないか確認すること。

/var:preset\|[a-z-]+\|[^"]*[A-Z_]/

ソース #

DB 出荷 要目視 手動

Media Editor Modal の系譜管理の一環で、画像の切り抜き・編集から新規作成された添付ファイルに、編集チェーンの起点となる添付 ID が _wp_attachment_edit_root_id として保存される。取得は wp_get_edit_root_attachment_id()。起点が完全削除されるとこのメタは一括削除される。
メディアの複製・移行・同期プラグインは、このメタの ID を移行先で付け替えないと誤った添付を指すことがある。

wp_get_edit_root_attachment_id /_wp_attachment_edit_root_id/

roadmap-to-7-2 ソース #

エディタ/JS 出荷 要目視 手動

jquery-migrate ハンドルのバンドル版が 3.6.0 に上がった（jQuery 本体は 3.7.1 のまま）。
非推奨 jQuery API を使う管理画面スクリプトは、SCRIPT_DEBUG 時のコンソール警告の内容・件数が変わる可能性がある。古い jQuery API に依存したコードがあれば警告を確認すること。

jquery-migrate

ソース #

挙動変更 予告 要目視 手動

通知メール（trunk 入り済み）以外に、非 HTTPS 環境での判定の見直し、default_role に危険な値を設定できないようにする制限、Cookie の SameSite 属性対応が予定されている。
default_role を管理者相当の権限グループに設定するプラグインや、認証 Cookie を独自に発行・検証するプラグインは影響を受ける可能性がある。

default_role

roadmap-to-7-2 #

挙動変更 予告 要目視 手動

ログイン済みでも高権限の管理操作の前に再認証を求める「sudo モード」の初期作業が始まった。提案と対象操作は未公開。
管理画面の操作を自動化しているプラグインや、プラグイン/ユーザー管理画面をリモート操作するツールは、再認証プロンプトで処理が止まる可能性がある。提案公開後に再評価すること。

roadmap-to-7-2 #

挙動変更 予告 要目視 手動

クラシックウィジェット画面の管理モードを減らすため、アクセシビリティモード（widgets-access）の削除がロードマップに挙がっている。trunk ではまだ残っている。
このモードの URL パラメータや画面構造を前提にしたウィジェット系プラグインは、削除後の挙動を確認すること。

/widgets-access/

roadmap-to-7-2 #

CSS/DOM 予告 要目視 手動

カスタム状態の作業として、Navigation Link と Tabs ブロックに -current 状態、Navigation Link に color・border・spacing のブロックサポートを追加する予定。
現在ページのメニュー項目をテーマ CSS で装飾している場合、ブロックサポート由来のクラスやインラインスタイルが加わって詳細度・見た目が変わる可能性がある。

core/navigation-link

roadmap-to-7-2 #

エディタ/JS 予告 要目視 手動

Gutenberg の React 19 対応（型、依存、レンダリング修正）は大半が入ったが、ロードマップ上 7.2 での完全移行は「見込み薄」とされている。将来リリースでの移行に備えた周知。
react-dom の旧 API（render 等）や React 18 前提の挙動に依存するブロック・管理画面 UI は、引き続き移行準備を進めること。

react react-dom

roadmap-to-7-2 #

機能 予告 要目視 手動

プラグインが API キー等をオプションに平文保存している現状を改め、暗号化必須の Secrets API（wp_set_secret() / wp_get_secret() / wp_delete_secret() / wp_import_option_as_secret()、値オブジェクト WP_Secret、manage_secrets 権限、secrets.php ドロップイン）を 7.2 に入れる提案。UI は 7.3。trunk には未コミットで、Beta 1 までにコミットか 7.3 送りかが決まる。
既存コードを壊すものではないが、同名の関数・クラスを独自定義しているプラグインは衝突する。API キーを扱うプラグインは移行（import）計画を検討すること。

/function\s+wp_(set|get|delete)_secret\s*\(|class\s+WP_Secret\b/

proposal-a-secrets-api-for-wordpress-7-2 roadmap-to-7-2 #

機能 ドロップ 要目視 手動

7.0・7.1 で見送られたリアルタイム共同編集は、7.2 では意図的にロードマップから外された。ブラウザ間で直接同期する方式から、サーバーが編集者の帰属・権限確認・マージを担う「サーバー主導」方式への転換が検討されており、候補の同期エンジンは探索段階でコア入りの準備はできていない。
関連する Presence API も機能プラグイン段階。7.2 で共同編集が入る前提の対応は不要。

roadmap-to-7-2 moving-to-a-server-aware-approach-for-collaboration presence-api-whats-new #

非推奨 出荷 機械照合 機械抽出 since 7.1.0

ソース #

非推奨 出荷 機械照合 機械抽出 since 7.0.0

ソース #

非推奨 出荷 機械照合 機械抽出 since 7.1.0

ソース #

非推奨 出荷 機械照合 手動

@wordpress/reusable-blocks（wp-reusable-blocks）のコンポーネントとデータ API が呼び出し時に非推奨警告を出す。将来は @wordpress/nux と同様に no-op 化される予定。
同期パターン（旧再利用ブロック）の取得・更新は core-data の標準エンティティメソッドへ移行すること。

@wordpress/reusable-blocks wp-reusable-blocks

miscellaneous-block-editor-changes-in-wordpress-7-1 #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

挙動変更 出荷 照合（要確認） 手動

解決後の Ability メタデータには常に bool の public が含まれ（既定 false）、show_in_rest は show_in_rest ?? public ?? false で決まる。コア Ability（core/get-site-info, core/get-user-info, core/get-environment-info）は public を使うようになり、core/get-user-info が新たに REST から発見可能になった。
また wp_before_execute_ability / wp_after_execute_ability は最後の引数に WP_Ability を追加で受け取る（既存コールバックはそのまま動く）。メタデータのキー有無で判定しているコードや、REST に出る Ability 一覧を前提にしたクライアントは確認すること。

wp_register_ability_args wp_before_execute_ability wp_after_execute_ability

a-unified-public-exposure-flag-for-abilities-in-wordpress-7-1 abilities-api-improvements-in-wordpress-7-1 #

挙動変更 出荷 照合（要確認） 手動

media_library_infinite_scrolling フィルターの既定値が false から true に変わり、メディアライブラリのグリッド表示とメディアモーダルが既定で無限スクロールになった。ユーザーはプロフィールで個別に無効化でき、ユーザーメタ infinite_scrolling に文字列 'true' / 'false' で保存される。
優先順位はフィルター > ユーザー設定 > 既定値。「さらに読み込む」ボタン前提の UI 拡張をしているプラグインは確認し、旧挙動を全員に強制するならフィルターで false を返すこと。無限スクロールは既知のアクセシビリティ上の後退とされている。

media_library_infinite_scrolling

media-library-infinite-scrolling-is-now-enabled-by-default-with-a-per-user-opt-out accessibility-improvements-in-wordpress-7-1 #

挙動変更 出荷 照合（要確認） 手動

wp_get_abilities() は category / namespace / meta などで絞り込める $args を受け取るようになり、新フィルター wp_get_abilities_item_include と wp_get_abilities_result が引数なしの呼び出しでも適用される。
引数なしの呼び出しが「登録済み全件」を意味しなくなったため、未加工の登録内容が必要なら WP_Abilities_Registry::get_all_registered() を使うこと。REST の一覧も wp_get_abilities() 経由になり namespace でも絞り込める。

wp_get_abilities → WP_Abilities_Registry::get_all_registered

filtering-registered-abilities-with-wp_get_abilities-in-wordpress-7-1 #

CSS/DOM 出荷 照合（要確認） 手動

7.1 では集中モード以外のとき、投稿エディタとサイトエディタでもツールバーが表示される。左上の W ロゴ／サイトアイコンは戻るボタン（シェブロン）に置き換わった。サイトエディタでツールバーが出るのは新しい挙動。
admin_bar_menu でノードを追加しているプラグインは、サイトエディタやクライアントサイド遷移で正しく動くか確認すること。エディタで出したくなければ get_current_screen() の is_block_editor() や id で判定して追加をスキップする。

admin_bar_menu

consistent-navigation-in-wordpress-7-1-with-persistent-toolbar #

非推奨 出荷 照合（要確認） 手動

安定版の cloneSanitizedBlock / sanitizeBlockAttributes が追加され、__experimental 版は動作するもののコンソールに非推奨警告を出す。
wp.blocks または @wordpress/blocks から呼んでいる箇所を安定版に置き換えること。

/__experimental(?:CloneSanitizedBlock|SanitizeBlockAttributes)\b/

miscellaneous-block-editor-changes-in-wordpress-7-1 #

エディタ/JS 出荷 照合（要確認） 手動

TextControl, SelectControl, InputControl, RangeControl, ComboboxControl, FontSizePicker など多数のフォームコントロールは 40px 高が既定となり、__next40pxDefaultSize は実行時に無視される。__next40pxDefaultSize={ false } で 36px に戻すこともできない。
BorderBoxControl, BorderControl, FontSizePicker, ToggleGroupControl の size プロップも無効。高さ 36px 前提のレイアウトや CSS を持つ設定画面・インスペクターは表示崩れを確認し、不要になったプロップを削除すること。Button は対象外。

/__next40pxDefaultSize|size=['"]__unstable-large['"]/

editor-components-updates-in-wordpress-7-1 #

挙動変更 出荷 要目視 手動

/wp-json/wp-abilities/v1/abilities のレスポンスに含まれる input / output スキーマは wp_prepare_json_schema_for_client() で整形され、プロパティ単位の required は親の required 配列に移り、sanitize_callback / validate_callback / arg_options は除去され、空オブジェクトの default は {} になる。
WP_Ability::get_input_schema() の戻り値は従来どおりなので、REST 経由のスキーマと PHP 側のスキーマを比較・依存しているクライアントは差異に注意すること。

WP_Ability::get_input_schema WP_Ability::get_output_schema /wp-abilities/v1/

json-schema-preparation-for-client-compatibility-in-wordpress-7-1 #

CSS/DOM 出荷 要目視 手動

theme.json の settings.blocks.<block> や wp_theme_json_data_* フィルターで定義したブロックレベルプリセットのユーティリティクラス（.has-*-color, -background-color, -font-size など）は、ブロックセレクタが :where() で包まれ詳細度 0-1-0 になった。
トップレベルとブロックレベルのプリセットの間に割り込む !important 付きの独自 CSS を書いているテーマ・プラグインは優先順位が変わる可能性がある。

miscellaneous-block-editor-changes-in-wordpress-7-1 #

エディタ/JS 出荷 要目視 手動

@wordpress/blocks の pasteHandler() 内部で使う Markdown 変換が showdown から marked（CommonMark / GFM 準拠）に置き換わった。
API の変更はないが、エッジケースの変換結果が変わり得る。pasteHandler() を直接呼んでいるコードは代表的な Markdown 入力で生成ブロックを再確認すること。

/\bpasteHandler\s*\(/

miscellaneous-block-editor-changes-in-wordpress-7-1 #

機能 ドロップ 照合（要確認） 手動

7.1 で core/freeform をインサーターから隠し、wp_classic_block_supports_inserter フィルターで戻せるようにする変更が一度マージされたが、リリース前に取り消された。Classic ブロックは従来どおりインサーターに表示される。
wp_classic_block_supports_inserter フィルターは 7.1 に存在しない。ベータ期間中にこのフィルターを使ったコードは削除してよい（Enable Classic Block プラグインもクローズ予定）。

wp_classic_block_supports_inserter

the-classic-block-stays-in-the-inserter-for-wordpress-7-1 hiding-the-classic-block-from-the-inserter-in-wordpress-7-1 wordpress-7-1-field-guide #

機能 ドロップ 要目視 手動

ロードマップでは管理バーの Dashicons を wordpress/icons の SVG に置き換え、「Howdy」表記を削除する予定だったが、7.1.0 の管理バーは従来どおり（Howdy も残っている）。置き換えは 7.1 リリース後も提案段階で、wp_get_icon() を使ったパッチがレビュー中。
#wpadminbar の .ab-icon:before など Dashicons 前提の CSS は 7.1 では壊れないが、次期リリースで影響を受ける可能性がある。

#wpadminbar .ab-icon

roadmap-to-7-1 replacing-dashicons-in-the-admin-bar-and-menu #

機能 ドロップ 要目視 手動

読み取り専用のコア Ability 3 種と show_in_abilities フラグを追加するマージ提案は、7.1.0 のコードに含まれていない。7.1 で入ったのは既存 3 種（core/get-site-info など）のスキーマ整備と fields 入力のみ。
これらの Ability が存在する前提の AI・MCP 連携は、wp_get_ability() の戻り値を確認して分岐すること。

merge-proposal-expanding-wordpress-core-abilities roadmap-to-7-1 #

機能 ドロップ 要目視 手動

Design System Theming のマージ提案のうち、7.1 で入ったのは wp-theme スタイルシート（デザイントークン）と wp-theme スクリプト（ThemeProvider）などの基盤と、サイトエディタへの管理画面配色の反映だけ。管理画面全体への適用は今後のリリースで検討される。
管理画面の見た目が 7.1 で全面的に変わる前提の対応は不要。

wordpress-7-1-field-guide merge-proposal-design-system-theming design-system-theming-in-wordpress-7-1 #

機能 ドロップ 要目視 手動

新しい投稿タイプ wp_knowledge と、その上に構築する Guidelines 機能のマージ提案は 7.1 に含まれず、Gutenberg プラグインで継続している。7.1.0 のコードに wp_knowledge は存在しない。
Guidelines をコア機能として前提にしたプラグインは、引き続き Gutenberg プラグインの有無で分岐すること。

wordpress-7-1-field-guide merge-proposal-guidelines-built-on-knowledge roadmap-to-7-1 #

機能 ドロップ 要目視 手動

ロードマップにあった過去の投稿を振り返るダッシュボードウィジェット「On This Day」は 7.1 に含まれなかった。議論は Trac #65801 で継続。
ダッシュボードウィジェットの並びや ID を前提にしたコードへの影響はない。

wordpress-7-1-field-guide roadmap-to-7-1 #

機能 ドロップ 要目視 手動

7.1 は React 18.3 のまま出荷された。Gutenberg 23.3 で一度 React 19 に上げたが、react/jsx-runtime を自前でバンドルしたプラグインなどとの非互換で差し戻され、Gutenberg 23.4 以降の実験フラグとして継続している。
将来に備え、react/jsx-runtime をバンドルせず WordPress 提供の react-jsx-runtime を外部化すること、文字列 ref や関数コンポーネントの defaultProps など React 19 で削除された API を使わないことを確認しておくとよい。

react-jsx-runtime

react-19-punted-beyond-wordpress-7-1-experiment-in-gutenberg roadmap-to-7-1 wordpress-7-1-field-guide #

機能 ドロップ 要目視 手動

7.0 で削除されたリアルタイム共同編集は、7.1 サイクルでアウトリーチによる広範なテストが行われたが、最終リリースでは有効化されなかった。引き続き Gutenberg プラグイン（設定 > 投稿設定）で試せる。
投稿ロック（_edit_lock）前提の処理は 7.1 でも従来どおり。共同編集を前提とした対応はまだ不要。

wordpress-7-1-field-guide announcing-a-collaborative-editing-outreach-effort-for-7-1 roadmap-to-7-1 #

機能 ドロップ 要目視 手動

ロードマップでは、オブジェクトキャッシュとページキャッシュを検出したサイトで投機的読み込みの既定 eagerness を conservative から moderate に上げる予定だったが、7.1.0 の既定は conservative のまま。
代わりに WP_SPECULATIVE_LOADING_DEFAULT_MODE / WP_SPECULATIVE_LOADING_DEFAULT_EAGERNESS 定数（または同名の環境変数）でホスティング側が既定値を変えられるようになった。

WP_SPECULATIVE_LOADING_DEFAULT_EAGERNESS WP_SPECULATIVE_LOADING_DEFAULT_MODE

roadmap-to-7-1 #

機能 ドロップ 要目視 手動

ロードマップで Playlist・Tabs と並んで予定されていた Table of Contents ブロックは 7.1.0 に含まれていない（Playlist と Tabs は出荷）。
目次ブロックをコア提供と見なして独自実装を外す判断はまだしないこと。

roadmap-to-7-1 #

機能 ドロップ 要目視 手動

is_email() / sanitize_email() で非 ASCII のメールアドレスを受け付け、WP_Email_Address クラスを追加する変更は trunk に [62482] でマージされテスト募集も行われたが、7.1.0 のコードには含まれていない（wp_is_unicode_email / WP_Email_Address が存在しない）。
メールアドレスが ASCII のみである前提は 7.1 でも維持される。将来の導入に備え、マルチバイト文字を含むメールアドレスの扱いは引き続き注視すること。

call-for-testing-unicode-email-addresses roadmap-to-7-1 #

非推奨 出荷 機械照合 機械抽出 since 7.0.0

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

挙動変更 出荷 照合（要確認） 手動

get_the_author_posts_link() / the_author_posts_link() と wp_list_authors() の出力から「Posts by ○○」の title 属性がデフォルトで削除された。get_the_author_link() / the_author_link() は新引数 $use_title_attr で削除可能（デフォルトは従来どおり付与）。
the_author_posts_link フィルタには第2・第3引数（表示名と旧 title テキスト）が追加された。title 属性をセレクタや JS で参照しているテーマ・テストは修正が必要。

get_the_author_posts_link the_author_posts_link wp_list_authors get_the_author_link the_author_link the_author_posts_link

removing-title-attributes-in-author-link-functions accessibility-improvements-in-wordpress-7-0 #

挙動変更 出荷 照合（要確認） 手動

Settings > Connectors 画面と Connectors API が追加され、AI プロバイダーの API キーを環境変数 → PHP 定数（{PROVIDER_ID}_API_KEY、例 ANTHROPIC_API_KEY）→ DB オプション（connectors_ai_{id}_api_key）の順に参照する。DB 保存のキーは暗号化されない。
独自用途で同名の定数・環境変数を定義しているプラグインは、そのキーがコアの AI Client からも使われる点に注意。Akismet も組み込みコネクタとして wordpress_api_key / WPCOM_API_KEY が画面に表示される。
コネクタのメタデータ変更は wp_connectors_init アクション内でのみ可能（unregister → register）。

ANTHROPIC_API_KEY connectors_ai_anthropic_api_key wp_connectors_init /\b(ANTHROPIC|OPENAI|GOOGLE)_API_KEY\b/

introducing-the-connectors-api-in-wordpress-7-0 wordpress-7-0-field-guide #

挙動変更 出荷 照合（要確認） 手動

add_theme_support( 'html5', array( 'script', 'style' ) ) の script/style 引数は 7.0 で非推奨かつ未使用になり、テーマのサポート有無にかかわらず <script> / <style> に type 属性や CDATA ラッパーが付かなくなった。
出力 HTML の type="text/javascript" 等に依存するパーサ・テスト・正規表現置換は見直すこと。

/type=['"]text/(javascript|css)['"]|current_theme_supports\s*\(\s*['"]html5['"]\s*,\s*['"](script|style)/

wordpress-7-0-field-guide #

挙動変更 出荷 照合（要確認） 手動

新関数 wp_get_image_alttext() により wp_read_image_metadata() の結果に alt が加わり、アップロード時に IPTC の Alt Text が _wp_attachment_image_alt に保存されるようになった。
代替テキストを自動生成・上書きするプラグイン（AI alt 生成など）は、既に値が入っているケースを考慮すること。

wp_read_image_metadata wp_get_image_alttext wp_read_image_metadata /_wp_attachment_image_alt/

accessibility-improvements-in-wordpress-7-0 wordpress-7-0-field-guide #

挙動変更 出荷 照合（要確認） 手動

plugins_list フィルタで追加したカスタムステータスが、プラグイン一覧画面の絞り込みタブとして表示されるようになった。ラベルは新フィルタ plugins_list_status_text で変更でき、未指定ならステータスのスラッグがそのまま表示される。
plugins_list に独自キーを足しているプラグインは、意図しないタブが出ないか確認すること。

plugins_list plugins_list_status_text

wordpress-7-0-field-guide #

CSS/DOM 出荷 照合（要確認） 手動

スクリーンリーダーが隠しテキストを1文字ずつ読み上げる問題への対策として、管理画面の .screen-reader-text に word-break: normal !important が追加された。
同クラスを上書きしているプラグインの CSS は影響を確認すること。

.screen-reader-text

accessibility-improvements-in-wordpress-7-0 wordpress-7-0-field-guide #

エディタ/JS 出荷 照合（要確認） 手動

@wordpress/dataviews の view 設定で groupByField: 'status' は groupBy: { field, direction, showLabel } に置き換えられた。
DataViews を npm から同梱しているプラグインは、7.0 世代のパッケージへ更新する際に view 設定を書き換えること。

@wordpress/dataviews /groupByField/

dataviews-dataform-et-al-in-wordpress-7-0 #

エディタ/JS 出荷 照合（要確認） 手動

これまでは @wordpress/interactivity-router の読み込み完了まで state.url が undefined で、その後 window.location.href がセットされていたが、7.0 ではディレクティブ処理時にサーバーで値が入り、最初のクライアントナビゲーションまで変化しない。
初期の undefined → URL の変化を「ナビゲーション」として扱っていた、あるいはそれを除外するガードを書いていたストアは挙動を確認すること。

/store\s*\(\s*['"]core/router['"]/

changes-to-the-interactivity-api-in-wordpress-7-0 #

挙動変更 出荷 要目視 手動

設定 > 一般の「新規ユーザーのデフォルト権限グループ」から administrator と editor が除外され、既にどちらかが設定されている場合は Site Health が警告する。
除外ロールは default_role_dropdown_excluded_roles フィルタで変更可能。会員サイト等で default_role を高権限に設定する運用・プラグインは確認が必要。

default_role default_role_dropdown_excluded_roles

wordpress-7-0-field-guide #

CSS/DOM 出荷 要目視 手動

新規ユーザーの既定 admin_color が fresh から modern になり、管理ヘッダー・カスタマイザー・マルチサイトのサインアップ等の配色・コントラスト・タイポグラフィが変更された。さらに管理メニューにクロスドキュメント View Transitions が付いた。
旧配色の色コードや管理画面の既存スタイルにハードコードで合わせた独自管理画面は見た目を確認し、可能なら CSS 変数／配色スキームに追従させること。

wordpress-7-0-field-guide accessibility-improvements-in-wordpress-7-0 #

エディタ/JS 出荷 要目視 手動

新しい customCSS ブロックサポートが全ブロックで既定有効になり、style.css 属性に CSS を保存し、フロントでは最外要素に has-custom-css と wp-custom-css-{hash} クラスが付与される（edit_css 権限のユーザーのみ編集可）。
サーバーレンダリングのブロックは最初の HTML 要素に WP_HTML_Tag_Processor でクラスが注入されるため、最外要素が標準 HTML 要素でないブロックや生 HTML を出すブロックは "supports": { "customCSS": false } でオプトアウトすること。

.has-custom-css

custom-css-for-individual-block-instances-in-wordpress-7-0 wordpress-7-0-field-guide #

エディタ/JS 出荷 要目視 手動

すべてのコンポーネントから下マージンが削除され、これまで __nextHasNoMarginBottom でオプトインしていたマージンなしスタイルが既定になった。
コンポーネントの既定マージンに頼ってレイアウトしていた設定画面・サイドバーは間隔が詰まるため、VStack などで明示的に余白を付けること。__nextHasNoMarginBottom 指定は不要になる。

@wordpress/components /__nextHasNoMarginBottom/

wordpress-7-0-field-guide #

エディタ/JS 出荷 要目視 手動

Dev Note によれば 7.0 は全管理画面で @wordpress/core-abilities を読み込み、REST（/wp-abilities/v1/）経由でサーバー登録済みのアビリティをクライアントの core/abilities ストアへ自動登録する。
管理画面の REST リクエストが増える点と、wp_register_ability() で登録したアビリティがクライアントからも実行可能になる点（permission_callback の確認）に留意。

@wordpress/core-abilities wp_register_ability

client-side-abilities-api-in-wordpress-7-0 #

エディタ/JS 出荷 要目視 手動

core/verse ブロックのタイトルが「Poetry」に変更された。ブロック名やマークアップは変わらないため保存済みコンテンツへの影響はない。
エディタ上のタイトル文字列で Verse ブロックを探す E2E テストやドキュメント・ヘルプは更新が必要。

core/verse

roster-of-design-tools-per-block-wordpress-7-0 #

機能 ドロップ 要目視 手動

マージ提案では REST エンドポイント＋JS API も対象だったが、7.0 のコアに入ったのは PHP API（wp_ai_client_prompt()）のみ。
ブラウザから AI を呼ぶ場合は wordpress/wp-ai-client パッケージを使うか、機能ごとに専用の REST エンドポイントを自作する必要がある（後者が推奨）。

proposal-for-merging-wp-ai-client-into-wordpress-7-0 introducing-the-ai-client-in-wordpress-7-0 #

機能 ドロップ 要目視 手動

ブラウザ側で画像最適化を行う Client-side Media Processing は Beta 1〜5 に含まれていたが、画像最適化とパッケージサイズの問題から Beta 6 で revert され、7.1 以降に持ち越された。
7.0 のアップロードは従来どおりサーバー側（GD/Imagick）で処理されるため、画像サイズ生成フックに依存するプラグインへの影響はない。

wordpress-7-0-beta-6 wordcamp-asia-2026-core-committers-meeting planning-for-7-0 #

機能 ドロップ 要目視 手動

計画では投稿エディタを無条件に iframe 化する予定だったが、7.0 では強制されない（Gutenberg プラグイン 22.6 以降ではクラシックテーマでも強制）。
ただし iframe 化の判定条件は 7.0 で変わっているので editor_js:post-editor-iframe-inserted-blocks を参照。apiVersion 3 への移行は引き続き推奨。

iframed-editor-changes-in-wordpress-7-0 planning-for-7-0 #

機能 ドロップ 要目視 手動

計画にあった Playlist ブロックは Field Guide から言及が削除され（5/17 の編集）、7.0.0 では core/playlist ブロックは登録されていない。
7.0 で Playlist ブロックが使える前提の案内・パターンは作らないこと。

wordpress-7-0-field-guide planning-for-7-0 #

機能 ドロップ 要目視 手動

7.0 の計画に React 19 への移行が挙がっていたが、7.0.0 の react / react-dom ハンドルは 18.3.1 のまま。
React 19 はその後 Gutenberg 側でも一度 revert され、実験的機能扱いとなっている。7.0 対応のために React 19 前提の書き換えは不要。

planning-for-7-0 react-19-upgrade-in-wordpress #

機能 ドロップ 要目視 手動

Yjs ベースのリアルタイム共同編集は Dev Note・Beta 告知（WP_ALLOW_COLLABORATION 定数、HTTP ポーリング）まで出たが、2026-05-08 に 7.0 から削除が決定され RC3 以降のビルドには含まれない。
sync.providers JS フィルタや WP_ALLOW_COLLABORATION 定数を前提にしたコード、および「メタボックスがあると共同編集が無効になる」前提の対応は 7.0 では不要（7.0.0 のソースにも該当定数は存在しない）。
メタボックスを show_in_rest 付き post meta へ移行する作業自体は将来の再導入に備えて有効。

/sync\.providers|WP_ALLOW_COLLABORATION/

rtc-removed-from-7-0 dev-chat-agenda-may-13-2026 real-time-collaboration-in-the-block-editor building-a-custom-sync-provider-for-real-time-collaboration extending-the-7-0-cycle #

機能 ドロップ 要目視 手動

計画段階で挙がっていたテンプレート管理の改善（テーマ切り替えをまたいだテンプレートパーツの保持など）は、7.0 サイクル中に revert され 7.1 以降へ持ち越された。
テンプレートパーツは引き続きアクティブテーマに紐づく（ナビゲーションオーバーレイも同様の既知の制約あり）。

wordcamp-asia-2026-core-committers-meeting planning-for-7-0 #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

エディタ/JS 出荷 機械照合 手動

data-wp-ignore はコンテキスト継承やクライアントナビゲーションを壊すため 6.9 で非推奨となり、今後のバージョンで削除予定。
使用箇所を削除すること。あわせて、同種ディレクティブを複数付与するための一意ID構文（data-wp-on--click---my-id）が導入された。

@wordpress/interactivity /data-wp-ignore/

changes-to-the-interactivity-api-in-wordpress-6-9 #

引数非推奨 出荷 照合（要確認） 機械抽出 since 6.9.0

ソース #

引数非推奨 出荷 照合（要確認） 機械抽出 since 6.9.0

ソース #

挙動変更 出荷 照合（要確認） 手動

esc_url() / esc_url_raw() / sanitize_url() は、スキームのない URL に対し $protocols の先頭要素が 'https' なら https:// を付与する。
従来 array( 'https' ) のみを渡すと空文字になっていたケースが、6.9 では https:// 付き URL を返すようになる。
既定（$protocols 未指定）の挙動は変わらない。

esc_url esc_url_raw sanitize_url

url-escaping-functions-can-support-https-as-the-default-protocol-in-wordpress-6-9 #

挙動変更 出荷 照合（要確認） 手動

fetch_feed() は (get|set)_transient() ではなく (get|set)_site_transient() でフィードをキャッシュする。マルチサイトでは
全サイトでキャッシュが共有される。また 6.7 以降壊れていたフィードキャッシュ（SimplePie 更新起因）が修正された。
フィードのトランジェントを直接読み書き・削除しているコードは保存先の変更に注意すること。

fetch_feed WP_Feed_Cache_Transient

miscellaneous-developer-focused-changes-in-6-9 wordpress-6-9-frontend-performance-field-guide #

挙動変更 出荷 照合（要確認） 手動

外観＞メニューで投稿・固定ページを検索する _wp_ajax_menu_quick_search() のクエリに search_columns => array( 'post_title' ) が追加され、
本文は検索対象外になった。従来の全文検索に戻すには新設の wp_ajax_menu_quick_search_args フィルターで search_columns を unset する。

_wp_ajax_menu_quick_search wp_ajax_menu_quick_search_args

admin-menu-search-query-changed #

挙動変更 出荷 照合（要確認） 手動

mbstring や PCRE の Unicode サポートがない環境でも一貫した UTF-8 処理を行う _wp_scan_utf8() ベースのフォールバックが入り、
mb_strlen()/mb_substr() のフォールバック結果が変わる場合がある。wp_check_invalid_utf8( $text, true ) は従来 false を返していたが、
不正バイト列を置換文字に置き換えて返すようになった。新規コードは wp_is_valid_utf8() / wp_scrub_utf8() を使い、
utf8_encode()/utf8_decode() は一時的なポリフィルなので mb_convert_encoding() に移行すること。

wp_check_invalid_utf8 → wp_scrub_utf8 utf8_encode → mb_convert_encoding utf8_decode → mb_convert_encoding

modernizing-utf-8-support-in-wordpress-6-9 #

挙動変更 出荷 照合（要確認） 手動

wp_mail( $to, $subject, $message, $headers, $attachments, $embeds ) となり、cid: 参照のインライン画像を添付できる。
各画像は wp_mail_embed_args フィルターで調整できる。wp_mail() を pluggable で丸ごと置き換えているプラグインは
$embeds 引数と wp_mail_embed_args を扱わないと、この機能を使う他プラグインのメールで画像が欠落する。

wp_mail wp_mail_embed_args /function\s+wp_mail\s*\(/

prettier-emails-supporting-inline-embedded-images #

CSS/DOM 出荷 照合（要確認） 手動

見出しの背景パディングのセレクタが h1〜h6.has-background から :where(.wp-block-heading).has-background に変わった（詳細度は 0-1-1 のまま）。
テーマが見出しブロック以外の h 要素に has-background を付けて既定パディングに頼っていた場合、パディングが消えるので明示的に指定すること。

.has-background .wp-block-heading core/heading /h[1-6][^{]*\.has-background/

heading-block-css-specificity-fix-in-wordpress-6-9 #

CSS/DOM 出荷 照合（要確認） 手動

@wordpress/components の SelectControl は、既定クラス components-select-control と className プロップを内部の
components-input-base 要素ではなくルートの components-base-control に付与するようになった。
内部構造を前提にしたカスタムCSS（例: .components-select-control の子孫セレクタ）は修正が必要。

.components-select-control @wordpress/components

miscellaneous-editor-changes-in-wordpress-6-9 #

エディタ/JS 出荷 照合（要確認） 手動

フィールドの isValid は関数 ( item, context ) => boolean から { required, elements, custom } のルールオブジェクトに変わった
（custom は同期・非同期でエラーメッセージ文字列か null を返す）。DataForm の検証は validity プロップによる制御型になり、
isItemValid ユーティリティは削除され useFormValidity フックに置き換えられた。npm パッケージを更新するプラグインは移行が必要。

@wordpress/dataviews /isItemValid|isValid\s*:\s*\(/

dataviews-dataform-et-al-in-wordpress-6-9 #

エディタ/JS 出荷 照合（要確認） 手動

絵文字検出スクリプトは <head> のインラインスクリプトから、フッターのインラインスクリプトモジュールに変わり、設定は
script#wp-emoji-settings の JSON として出力される。window._wpemojiSettings は DOMContentLoaded までに設定されるが、
それ以前に参照するコードは JSON から読むよう修正すること。remove_action( 'wp_head', 'print_emoji_detection_script', 7 ) による無効化は引き続き有効。

print_emoji_detection_script /_wpemojiSettings/

wordpress-6-9-frontend-performance-field-guide #

挙動変更 出荷 要目視 手動

PHPMailer 6.9.1→6.11.1、SimplePie 1.8.0→1.9.0、Sodium Compat 1.21.1→1.23.0 に更新され、getID3 に PHP 8.5 対応パッチが入った。
これらのクラスを直接利用・継承しているプラグインは動作確認すること。個別の削除・非推奨は extracted を参照。

WP_PHPMailer SimplePie

miscellaneous-developer-focused-changes-in-6-9 #

挙動変更 出荷 要目視 手動

unfiltered_html を持たないユーザーの wp_kses() は数値文字参照をアンエスケープしなくなり、一部の HTML5 セマンティックタグが許可された。
get_url_in_content() は Tag Processor ベースになり常にデコード済みの href を返す。set_modifiable_text() は SCRIPT 内容に
<script / </script を含む更新を拒否し、set_attribute() は構文文字を直接文字参照にエスケープする。
クラシックテーマの画像ブロック処理も PCRE から HTML API に置き換わった。出力文字列を厳密比較するテストや後処理は確認すること。

wp_kses get_url_in_content WP_HTML_Tag_Processor::set_modifiable_text WP_HTML_Tag_Processor::set_attribute

updates-to-the-html-api-in-6-9 #

挙動変更 出荷 要目視 手動

path データ付きスタイルをインライン化する既定上限（styles_inline_size_limit）が 40KB になり、外部CSSファイルだった
スタイルが <style> として出力される場面が増える。CSS の外部ファイル化を前提にしたキャッシュ・最適化系プラグインは確認すること。
また wp_oembed_add_discovery_links() はスクリプト・スタイルより前（wp_head 優先度4）に出力されるようになった。
oEmbed リンクを消すには remove_action ではなく oembed_discovery_links フィルターの使用が推奨される。

styles_inline_size_limit wp_oembed_add_discovery_links oembed_discovery_links

wordpress-6-9-frontend-performance-field-guide #

挙動変更 出荷 要目視 手動

Interactivity API を使うブロック（コア外のカスタムブロック含む）の viewScriptModule と comment-reply スクリプトは既定で
fetchpriority="low" が付与され、依存モジュールや modulepreload にも伝播する。スクリプト／スクリプトモジュールの $args に
fetchpriority、スクリプトモジュールに in_footer が追加された。読み込み順・優先度に依存するコードは確認すること。

wp_register_script_module wp_enqueue_script_module WP_Script_Modules::set_fetchpriority comment-reply

wordpress-6-9-frontend-performance-field-guide #

挙動変更 出荷 要目視 手動

template_include 適用後に wp_before_include_template アクションが発火し、そこで出力バッファが開始される
（wp_template_enhancement_output_buffer フィルター等にコールバックがある場合や、クラシックテーマのオンデマンドCSSで使用）。
独自に ob_start() でページ全体をバッファしていたキャッシュ・最適化プラグインは二重バッファになるため動作確認すること。
このフィルター／wp_finalized_template_enhancement_output_buffer アクション内で ob_start() を呼ぶと Fatal、アクション内での echo は出力されない。
バッファは wp_should_output_buffer_template_for_enhancement フィルターで強制的に無効化できる。

wp_before_include_template wp_template_enhancement_output_buffer wp_finalized_template_enhancement_output_buffer wp_template_enhancement_output_buffer_started wp_should_output_buffer_template_for_enhancement

wordpress-6-9-frontend-performance-field-guide #

挙動変更 出荷 要目視 手動

TTFB 改善のため _wp_cron() は shutdown アクションで実行されるようになった。cron の起動タイミングや、
リクエスト前半で cron が走ることを前提にしたコードは確認すること。ALTERNATE_WP_CRON 環境で壊れる問題は RC4 で修正済み（#64315）。

_wp_cron wp_cron ALTERNATE_WP_CRON

wordpress-6-9-frontend-performance-field-guide wordpress-6-9-release-candidate-4 #

CSS/DOM 出荷 要目視 手動

コアのブロックテーマ TT2・TT5 のスタイルシートはミニファイ版（style.min.css）が既定で読み込まれ、インライン化の対象にもなった。
style.css を直接編集している場合や、そのハンドルの出力形式（外部ファイル）に依存するコードは反映されないので注意。
変更は Site Editor か子テーマで行うこと。

wordpress-6-9-frontend-performance-field-guide #

CSS/DOM 出荷 要目視 手動

レイアウトシフト防止のため、Video ブロックの <video> に動画の width/height 属性とインラインの aspect-ratio が追加され、
ブロックCSSで height:auto が指定された。動画サイズを独自CSSで制御しているテーマは表示を確認すること。

core/video

wordpress-6-9-frontend-performance-field-guide #

エディタ/JS 出荷 要目視 手動

どのバリエーションの isActive にも一致しないブロックは、isActive を持たない isDefault: true のバリエーションがあればそれがアクティブと判定される
（block / transform スコープのみ、inserter には適用されない）。ブロック名・アイコン表示やバリエーション判定に依存するコードは確認すること。

@wordpress/blocks /getActiveBlockVariation|isDefault\s*:/

miscellaneous-editor-changes-in-wordpress-6-9 #

エディタ/JS 出荷 要目視 手動

ブロックを非表示にでき、metadata.blockVisibility=false のブロックはフロントのマークアップから完全に除去される（資産も dequeue）。
ほぼ全ブロックで既定有効のため、非表示にされると困るブロック（レイアウト必須の要素など）は block_type_metadata フィルターで
supports.visibility を false にすること。parse_blocks() でブロックを解析するコードは非表示属性を考慮すること。

block_type_metadata /blockVisibility/

ability-to-hide-blocks #

エディタ/JS 出荷 要目視 手動

クライアントナビゲーション時にスタイルシートの差し替えとスクリプトモジュールの読み込みが行われるようになった。ブロック以外で手動登録した
スクリプトモジュールは WP_Interactivity_API::add_client_navigation_support_to_script_module() で対応を明示しないと読み込まれない。
getServerState() / getServerContext() は遷移ごとに完全に上書きされ、前ページにしかないプロパティは消える。
インタラクティブ領域内の data-wp-router-region も更新対象になった。router を使うプラグインは遷移時の挙動を確認すること。

@wordpress/interactivity-router WP_Interactivity_API::add_client_navigation_support_to_script_module /getServer(State|Context)\s*\(|data-wp-router-region/

interactivity-apis-client-navigation-improvements-in-wordpress-6-9 #

機能 ドロップ 要目視 手動

ログイン中など nocache のページでも bfcache を効かせる改善は 6.9 のパフォーマンス計画にあったが、
Clear-Site-Data ヘッダーに関する Chromium のバグで punt され、7.0 以降で再検討となった。

roadmap-to-6-9 wordpress-6-9-frontend-performance-field-guide #

機能 ドロップ 要目視 手動

ロードマップでは新ブロックとして Accordion・Terms Query・Stretchy Type・Icon が挙げられていたが、Beta 1 の新ブロック一覧と
Field Guide に Icon ブロックはなく、6.9 には含まれない（Stretchy Type はブロックではなく fitText サポートとして出荷）。

core/icon

roadmap-to-6-9 wordpress-6-9-beta-1 #

機能 ドロップ 要目視 手動

ロードマップではコンテンツ編集中心の簡易サイト編集モードが予告されていたが、Beta 1 の機能一覧・Field Guide のいずれにも記載がなく、
6.9 で出荷された形跡はない（明示的なドロップ告知はなく、情報源からの推定）。

roadmap-to-6-9 wordpress-6-9-beta-1 #

機能 ドロップ 要目視 手動

ロードマップと Beta 1 では「スラッグごとに複数テンプレート、下書き、有効化／無効化、テーマ切り替え時の保持」を予告していたが、
Beta 3 で見つかった不具合により Beta 4 でテンプレート有効化機能が revert され、7.0 に回された。6.9 の最終版には入っていない。

wordpress-6-9-beta-4 wordpress-6-9-beta-1 roadmap-to-6-9 #

エディタ/JS 出荷 機械照合 手動

BorderBoxControl・BorderControl・BoxControl が正式名でインポートできるようになり、__experimental 付きのエクスポートは非推奨になった。正式名に置き換えること。

@wordpress/components /__experimental(BorderBoxControl|BorderControl|BoxControl)\b/

updates-to-user-interface-components-in-wordpress-6-8 #

エディタ/JS 出荷 機械照合 手動

__experimentalNavigatorProvider → Navigator、Screen / Button / BackButton → Navigator.Screen 等、__experimentalUseNavigator → useNavigator に置き換えること。__experimentalNavigatorToParentButton と goToParent は非推奨となり、BackButton / goBack と同じ挙動になった。

@wordpress/components /__experimental(Navigator\w*|UseNavigator)\b|goToParent/

updates-to-user-interface-components-in-wordpress-6-8 #

エディタ/JS 出荷 機械照合 手動

select( 'core/block-editor' ).getSettings().__unstableIsPreviewMode を参照すると非推奨警告が出る。isPreviewMode に置き換えること。

@wordpress/block-editor /__unstableIsPreviewMode/

miscellaneous-block-editor-changes-in-wordpress-6-8 #

エディタ/JS 出荷 機械照合 手動

@wordpress/block-editor の __experimentalLinkControl は引き続き動くが非推奨警告が出る。__experimentalLinkControlSearchInput / SearchResults / SearchItem も非推奨。LinkControl に移行すること。

@wordpress/block-editor /__experimentalLinkControl/

miscellaneous-block-editor-changes-in-wordpress-6-8 wordpress-6-8-release-candidate-4 #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

削除 出荷 機械照合 機械抽出

ソース #

挙動変更 出荷 照合（要確認） 手動

これまで should_load_separate_core_block_assets は「コアブロックCSSの個別読み込み」と「ページ内のブロックのアセットだけを読み込む」の2役を担っていたが、後者は新フィルター should_load_block_assets_on_demand（wp_should_load_block_assets_on_demand()）に分離された。後方互換で旧フィルターは両方に効き続ける。
旧フィルターでオンデマンド読み込みを制御しているプラグイン・テーマは新フィルターへの移行を検討すること。ブロックテーマは両方ともデフォルト有効。

should_load_separate_core_block_assets wp_should_load_separate_core_block_assets should_load_block_assets_on_demand

new-filter-should_load_block_assets_on_demand-in-6-8 #

挙動変更 出荷 照合（要確認） 手動

count_user_posts() の SQL 結果がキャッシュされるようになった（posts の last_changed で無効化）。投稿を直接 SQL で書き換えるなど、通常の API を経由しない更新をした直後に件数を取得するコードは古い値を得る可能性がある。

count_user_posts

wordpress-6-8-performance-improvements #

挙動変更 出荷 照合（要確認） 手動

get_calendar() は $args 配列（initial / display / post_type）を受け取るようになった。旧形式の ( $initial, $display ) も後方互換で受け付けるが、bool 型の場合のみ解釈されるため 0/1 などの非 bool 値を渡しているコードは意図どおり動かない可能性がある。新フィルター get_calendar_args も追加された。

get_calendar get_calendar_args /get_calendar\s*\(\s*[^)\s]/

wordpress-6-8-field-guide #

挙動変更 出荷 照合（要確認） 手動

Text Domain / Domain Path ヘッダーを持つプラグイン・テーマは、WordPress.org 非掲載でも load_plugin_textdomain() / load_theme_textdomain() なしで翻訳が自動読み込みされるようになった。
独自の読み込み順や翻訳ファイルの差し替えに依存しているコードは、意図しない翻訳が先に読み込まれないか確認すること。6.8 未満をサポートする間は従来の呼び出しを残す。

load_plugin_textdomain load_theme_textdomain

i18n-improvements-6-8 #

挙動変更 出荷 照合（要確認） 手動

register_post_type() に embeddable 引数が追加され、未指定時は public の値を継承する。oEmbed の可否は新関数 is_post_embeddable() で判定されるため、public でない投稿タイプは埋め込みできなくなる。
非公開投稿タイプの埋め込みに依存している場合は embeddable => true を明示するか、is_post_embeddable フィルターを使うこと。

register_post_type is_post_embeddable is_post_embeddable

miscellaneous-developer-changes-in-wordpress-6-8 #

挙動変更 出荷 照合（要確認） 手動

PHPMailer のエラーメッセージを翻訳するため、PHPMailer を継承した WP_PHPMailer が導入され、phpmailer_init に渡されるインスタンスもこのクラスになった。
グローバル $phpmailer を独自インスタンスに差し替えたり、クラス名を厳密比較しているコードは確認すること。

WP_PHPMailer phpmailer_init /\$phpmailer\s*=\s*new|get_class\s*\(\s*\$phpmailer/

i18n-improvements-6-8 #

CSS/DOM 出荷 照合（要確認） 手動

loop・autoplay・muted などが loop="1" ではなく loop と出力されるようになった。出力 HTML を正規表現で解析したり、[loop="1"] のような属性セレクタで CSS/JS を当てているコードは修正すること。

wp_video_shortcode wp_audio_shortcode /(loop|autoplay|muted)="1"|\[(loop|autoplay|muted)=["']?1/

miscellaneous-developer-changes-in-wordpress-6-8 #

CSS/DOM 出荷 照合（要確認） 手動

Navigation ブロックでサブメニュー付き項目のテキストも <span class="wp-block-navigation-item__label"> で包まれるようになった。子要素構造を前提にしたセレクタや JS（firstChild がテキストノード等）は確認すること。

.wp-block-navigation-item__label core/navigation-submenu

miscellaneous-block-editor-changes-in-wordpress-6-8 #

エディタ/JS 出荷 照合（要確認） 手動

ブロック登録 API が parent 設定を配列に正規化し、文字列などを渡すとエディターが警告を表示する。block.json や registerBlockType で parent を文字列指定している場合は配列にすること。

@wordpress/blocks /["']?parent["']?\s*:\s*["']/

miscellaneous-block-editor-changes-in-wordpress-6-8 #

エディタ/JS 出荷 照合（要確認） 手動

アクセシビリティ上の問題から ButtonGroup は非推奨になった。ToggleGroupControl への移行を推奨。

@wordpress/components /\bButtonGroup\b/

updates-to-user-interface-components-in-wordpress-6-8 #

エディタ/JS 出荷 照合（要確認） 手動

RadioGroup を使うと非推奨警告が出る。RadioControl または ToggleGroupControl に移行すること。

@wordpress/components /\bRadioGroup\b/

updates-to-user-interface-components-in-wordpress-6-8 #

挙動変更 出荷 要目視 手動

コア投稿タイプの add_new_item などのラベルが「Add New Post」から「Add Post」のように変更された（翻訳文字列も変わる）。ラベル文字列で画面要素を探す E2E テストや、gettext フィルターで既存文字列を置換しているコードは更新すること。

gettext /Add New (Post|Page|Media|User|Item)/

wordpress-6-8-field-guide accessibility-improvements-in-wordpress-6-8 #

挙動変更 出荷 要目視 手動

メニュー画面でカスタムリンクを追加する際、カスタマイザーと同じ部分的な URL 検証が行われるようになった。一般的な URL パターンでない href（独自プレースホルダー等）を入れる運用は受け付けられなくなる可能性がある。

miscellaneous-developer-changes-in-wordpress-6-8 #

挙動変更 出荷 要目視 手動

以前は高ビット深度画像のリサイズ結果を 8bit に落としていたが、6.8 からは元のビット深度（例 12bit）のまま出力される。ファイルサイズや下流処理に影響する場合は image_max_bit_depth フィルターで 8 に制限できる。

image_max_bit_depth

miscellaneous-developer-changes-in-wordpress-6-8 #

挙動変更 出荷 要目視 手動

誤ったパスワードを入力した際、パスワードフォームにエラーメッセージが表示されるようになり、the_password_form フィルターに第3引数 $invalid_password が渡されるようになった。フォームを独自に差し替えているテーマは表示を確認すること。

the_password_form get_the_password_form

accessibility-improvements-in-wordpress-6-8 #

挙動変更 出荷 要目視 手動

editor-styles をサポートするか theme.json を持つクラシックテーマで、外観メニューにスタイルブックが追加された。これに伴いクラシックテーマのパターン一覧は「外観 > パターン」から「外観 > デザイン > パターン」に移動した。
管理メニューを remove_submenu_page() 等で操作しているプラグインや、メニュー位置を前提とした手順書は確認すること。

add_theme_support /add_theme_support\s*\(\s*['"]editor-styles/

miscellaneous-developer-changes-in-wordpress-6-8 roadmap-to-6-8 #

挙動変更 出荷 要目視 手動

ユーザープロフィールの rich_editing 切り替えは、現在無効化されているユーザーにのみ表示されるようになった。ユーザーメタ rich_editing 自体は引き続き有効で、update_user_option() 等で設定できる。
プロフィール画面のこのチェックボックスに依存する管理画面カスタマイズや手順書は見直すこと。

/rich_editing/

miscellaneous-developer-changes-in-wordpress-6-8 accessibility-improvements-in-wordpress-6-8 #

CSS/DOM 出荷 要目視 手動

管理画面の多数の title 属性、the_shortlink() の title、カレンダーウィジェット列見出しの title が削除された。投稿者未設定の一覧では空リンクの代わりに「—」が表示され、クラシックエディターの「Text」タブは「Code」に改名された。
title 属性やタブ文言をセレクタ・E2E テストの手がかりにしているコードは更新すること。

the_shortlink

accessibility-improvements-in-wordpress-6-8 #

CSS/DOM 出荷 要目視 手動

フロントと管理画面の body に有効テーマ名の wp-theme-<name>（子テーマ時は wp-child-theme-<name> も）が付き、単一投稿表示では wp-singular が付くようになった。
同名クラスを独自に付与・スタイリングしているテーマやプラグインは衝突がないか確認すること。

body_class admin_body_class /wp-theme-|wp-child-theme-|wp-singular/

miscellaneous-developer-changes-in-wordpress-6-8 #

CSS/DOM 出荷 要目視 手動

管理画面・バンドルテーマ・ブロックライブラリの .screen-reader-text は clip-path: inset(50%) のみで隠すようになった。通常は影響しないが、.screen-reader-text を再表示するリセット CSS で clip だけを解除している場合は clip-path: none も指定すること。

.screen-reader-text /screen-reader-text[^{]*\{[^}]*clip\s*:/

changes-to-the-screen-reader-text-class-in-wordpress-6-8 accessibility-improvements-in-wordpress-6-8 #

エディタ/JS 出荷 要目視 手動

BorderBoxControl, BorderControl, BoxControl, ComboboxControl, CustomSelectControl, DimensionControl, FontSizePicker, FormTokenField, InputControl, NumberControl, RangeControl, SelectControl, TextControl, ToggleGroupControl, UnitControl などで __next40pxDefaultSize を指定していないと非推奨警告が出る。
各コンポーネントに __next40pxDefaultSize を付けて 40px 高さに移行し、レイアウトを確認すること。

@wordpress/components /<(BorderBoxControl|BorderControl|BoxControl|ComboboxControl|CustomSelectControl|DimensionControl|FontSizePicker|FormFileUpload|FormTokenField|InputControl|NumberControl|RangeControl|SelectControl|TextControl|ToggleGroupControl|TreeSelect|UnitControl)\b/

updates-to-user-interface-components-in-wordpress-6-8 #

エディタ/JS 出荷 要目視 手動

Modal の閉じるボタンが small（24px）から compact（32px）になった。headerActions にボタンを追加している場合は size="compact" を指定して揃えること。

@wordpress/components /headerActions/

updates-to-user-interface-components-in-wordpress-6-8 #

エディタ/JS 出荷 要目視 手動

クリアボタンを「閉じる」ボタンとして使う onClose プロップは非推奨。必要なら別途閉じるボタンを UI に追加すること。

@wordpress/components

updates-to-user-interface-components-in-wordpress-6-8 #

エディタ/JS 出荷 要目視 手動

mapSelect 内で map() 等により毎回新しいオブジェクトを返すと、SCRIPT_DEBUG 有効時にコンソール警告が出る。動作は変わらないが不要な再レンダリングの原因なので、必要な値だけを select し、加工は useSelect の外で行うこと。

@wordpress/data

data-a-helpful-performance-warning-for-developers-in-the-useselect-hook #

動作要件 出荷 要目視 手動

hash 拡張が $required_php_extensions に加わり、インストール・アップグレード時にチェックされるようになった。通常の PHP ビルドには含まれるため影響はまれだが、hash を無効化した特殊な環境ではアップグレードが止まる。

wordpress-6-8-field-guide #

機能 予告 要目視 手動

6.8 は withSyncEvent() と非推奨警告の導入のみで、ハンドラー間でメインスレッドに譲る非同期化そのものは「次のリリース」に予告された。6.8 時点では挙動は変わっていない。

interactivity-api-best-practices-in-6-8 wordpress-6-8-performance-improvements #

エディタ/JS ドロップ 要目視 手動

ブロックテーマでは常に iframe でコンテンツを描画する変更が 6.8 に入ると告知されたが、RC 期間中（2025-04-01）に差し戻された。6.8 では従来どおりの条件で iframe 化される。将来再導入される可能性があるため、editor の iframe 内で動かない CSS/JS は引き続き対応を進めること。

miscellaneous-block-editor-changes-in-wordpress-6-8 #

機能 ドロップ 要目視 手動

ロードマップで完了目標とされた Gallery ブロックのライトボックスは、Interactivity API 節が「Not on track」とされ、6.8.0 の core/gallery にも実装されていない。

roadmap-to-6-8 #

機能 ドロップ 要目視 手動

ロードマップでは 6.8 の主眼とされたが、同節は「Not on track for WordPress 6.8」とされ、Dev Notes・Field Guide にも記載がない。6.8 で使えると誤認しないこと。

roadmap-to-6-8 #

機能 ドロップ 要目視 手動

ロードマップで Interactivity API の目標として挙げられた Query・Search ブロックのインスタント検索は、Interactivity API 節が「Not on track」とされ 6.8 では出荷されていない。

roadmap-to-6-8 #

挙動変更 出荷 機械照合 手動

Interactivity API のストアデータは script_module_data_@wordpress/interactivity フィルタで出力され、script 要素の ID が wp-interactivity-data から wp-script-module-data-@wordpress/interactivity に変わった。
この JSON を DOM から直接読んでいるコードは更新が必要。関連する WP_Interactivity_API のメソッド非推奨は extracted 側に記録済み。

/wp-interactivity-data/

updates-to-script-modules-in-6-7 #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since 6.7.0

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

非推奨 出荷 機械照合 機械抽出 since unknown

ソース #

エディタ/JS 出荷 機械照合 手動

block.json の属性プロパティ __experimentalRole は role に安定化された（content / local）。
@wordpress/block-editor の __experimentalHasContentRoleAttribute セレクタは非推奨かつ private 化、@wordpress/blocks の __experimentalGetBlockAttributesNamesByRole は getBlockAttributesNamesByRole に安定化された。
これらを使っている箇所を新名称に置き換えること。

@wordpress/block-editor @wordpress/blocks /__experimentalRole|__experimentalHasContentRoleAttribute|__experimentalGetBlockAttributesNamesByRole/

miscellaneous-block-editor-changes-in-wordpress-6-7 #

エディタ/JS 出荷 機械照合 手動

__experimentalNavigator*（→ Navigator / Navigator.Screen 等、ToParentButton と goToParent() は BackButton / goBack() と同じ挙動に）、__experimentalUseNavigator（→ useNavigator）、
__experimentalAlignmentMatrixControl（→ AlignmentMatrixControl）、__experimentalBoxControl（→ BoxControl）、__unstableComposite 系（→ Composite）が非推奨になった。
Button の __experimentalIsFocusable は accessibleWhenDisabled に改名（旧名も動作継続）。安定版の名前へ移行すること。

@wordpress/components /__experimentalNavigator\w*|__experimentalUseNavigator|__experimentalAlignmentMatrixControl|__experimentalBoxControl|__unstableComposite\w*|__experimentalIsFocusable/

editor-components-updates-in-wordpress-6-7 #

削除 出荷 機械照合 機械抽出

ソース #

挙動変更 出荷 照合（要確認） 手動

ブロック設定に Attributes パネルが追加され、サーバー側で register_block_bindings_source() したソースもエディタに自動で登録・表示される。
UI 操作可否は canUpdateBlockBindings 設定（既定は edit_block_binding 権限＝投稿タイプ編集/テーマオプション編集）で決まり、block_editor_settings_all で上書きできる。
独自ソースを持つプラグインは、エディタ側で registerBlockBindingsSource() による上書き登録が必要か確認すること。

register_block_bindings_source block_editor_settings_all

block-bindings-improvements-to-the-editor-experience-in-6-7 #

挙動変更 出荷 照合（要確認） 手動

block.json で supports.multiple を false にしたフックブロックは、コンテキスト（テンプレート・パーツ・パターン等）ごとに最大1つしか挿入されなくなった。
また core/template-part への firstChild / lastChild 挿入が動作するようになった。
hooked_block_types フィルタで自前の重複チェックをしている場合は不要になり、宣言済みだが効いていなかった template-part 指定は 6.7 から実際に挿入される。

hooked_block_types core/template-part /"blockHooks"/

updates-to-block-hooks-in-wordpress-6-7 #

挙動変更 出荷 照合（要確認） 手動

HTML API の has_class() / add_class() / remove_class() がドキュメントモードに従うようになり、標準モード（既定）ではクラス名をバイト単位で照合する。
これまで一致していた FULL-WIDTH と full-width のような大文字小文字違いが一致しなくなる場合がある。
あわせて remove_class() は前置空白も除去し、set_attribute() は更新を拒否した場合に false を返すようになった。戻り値や照合結果に依存するコードを確認すること。

WP_HTML_Tag_Processor::has_class WP_HTML_Tag_Processor::add_class WP_HTML_Tag_Processor::remove_class WP_HTML_Tag_Processor::set_attribute

updates-to-the-html-api-in-6-7 #

挙動変更 出荷 照合（要確認） 手動

_wp_image_editor_choose() の結果が image_editor グローバルキャッシュグループに1日保存されるようになった。
wp_image_editors フィルタで独自エディタを追加し、test() や supports_mime_type() の結果が実行時に変わるプラグインでは、古い選択結果が使われ得る。

wp_image_editors _wp_image_editor_choose

wordpress-6-7-performance-improvements #

CSS/DOM 出荷 照合（要確認） 手動

wp-login.php に screen-reader-text の h1 が追加され、ロゴ側の h1 には wp-login-logo クラスと role="presentation" が付いた。
#login h1 a のようなセレクタでロゴを差し替えている CSS が意図通りに当たらない回帰（#62410）が報告され、6.7.1 で修正された。カスタムログインロゴを持つ場合は表示を確認すること。

login_enqueue_scripts .wp-login-logo /#login\s+h1|\.login\s+h1/

wordpress-6-7-1-rc1-is-now-available #

エディタ/JS 出荷 照合（要確認） 手動

BaseControl, CheckboxControl, ComboboxControl, DimensionControl, FocalPointPicker, FormTokenField, RangeControl, SearchControl, SelectControl, TextControl, TextareaControl, ToggleControl, ToggleGroupControl, TreeSelect で、
__nextHasNoMarginBottom を指定していない場合にコンソールへ非推奨警告が出るようになった。将来マージンは削除されるため、__nextHasNoMarginBottom={ true } を付けてレイアウトを調整すること。

@wordpress/components /<(BaseControl|CheckboxControl|ComboboxControl|DimensionControl|FocalPointPicker|FormTokenField|RangeControl|SearchControl|SelectControl|TextControl|TextareaControl|ToggleControl|ToggleGroupControl|TreeSelect)\b/

editor-components-updates-in-wordpress-6-7 #

エディタ/JS 出荷 照合（要確認） 手動

CustomSelectControl が Ariakit ベースに書き直された（downshift 依存を削除）。公開 API に破壊的変更はないが、トリガーボタンの role が button から combobox に変わり、
__experimentalShowSelectedHint と options[].__experimentalHint は接頭辞なしの名前に安定化された。DOM/role に依存する E2E テストや CSS は確認すること。

@wordpress/components /CustomSelectControl|__experimentalShowSelectedHint|__experimentalHint/

editor-components-updates-in-wordpress-6-7 #

エディタ/JS 出荷 照合（要確認） 手動

useResizeObserver はコールバックを第1引数に取り、ref 用のセッターを返す新 API になった。従来の使い方（戻り値の要素を描画する形）はレガシー扱いで非推奨。
新しい呼び出し形式に移行すること。

@wordpress/compose /useResizeObserver\s*\(/

miscellaneous-block-editor-changes-in-wordpress-6-7 #

挙動変更 出荷 要目視 手動

admin_email 宛にメールを送る際、同じメールアドレスのユーザーが存在すればそのユーザーのロケールで送信されるようになった。
管理者向け通知メールの文面言語を前提にしているプラグイン（件名で判定するフィルタ等）は挙動が変わる可能性がある。

admin_email

i18n-improvements-6-7 #

挙動変更 出荷 要目視 手動

theme.json 由来のブロック単位スタイル（WP_Theme_JSON::compute_style_properties の結果）が transient にキャッシュされるようになった。
theme.json 関連フィルタの結果をリクエストごとに変えているプラグインでは、出力 CSS が更新されないように見える場合がある。

wp_theme_json_data_theme /wp_theme_json_data_(default|blocks|theme|user)/

wordpress-6-7-performance-improvements #

挙動変更 出荷 要目視 手動

edit_posts 権限を持つユーザーに、グローバルスタイルの生データへの読み取りアクセスが許可された。
REST API のグローバルスタイル応答を権限で制御・前提にしているプラグインは確認すること。

WP_REST_Global_Styles_Controller

miscellaneous-block-editor-changes-in-wordpress-6-7 #

挙動変更 出荷 要目視 手動

Imagick が HEIC に対応している環境では、HEIC アップロードが自動的に JPEG へ変換される（元ファイルは添付ページからダウンロード可能）。
アップロード後の MIME タイプ・ファイル名を前提にしているプラグインは影響を受ける。無効化するには image_editor_output_format フィルタから image/heic を外す。

image_editor_output_format

automatic-conversion-of-heic-images-to-jpeg-in-wordpress-6-7 wordpress-6-7-release-candidate-5 #

CSS/DOM 出荷 要目視 手動

ブロックインスペクターのコントロール間の標準余白が 16px に変わった。BaseControl ベースのコントロールは自動で追従するが、
独自コントロールや下マージンを上書きしている場合は 16px に合わせて調整すること。

miscellaneous-block-editor-changes-in-wordpress-6-7 #

CSS/DOM 出荷 要目視 手動

Media & Text ブロックで「Crop image to fill」有効時も CSS background-image ではなく img 要素（is-image-fill-element クラス）で描画されるようになった。
.wp-block-media-text__media の background-image を前提にしたテーマ CSS や JS は見直すこと。

core/media-text .wp-block-media-text__media

miscellaneous-block-editor-changes-in-wordpress-6-7 #

エディタ/JS 出荷 要目視 手動

templateLock / lock が contentOnly のブロックでは、ブロック変換メニューとバリエーション切替が表示されなくなった（トップレベルではブロックスタイルは選べる）。
contentOnly ロックしたパターンやテンプレートで変換操作を前提にしている場合は見直すこと。

/contentOnly/

miscellaneous-block-editor-changes-in-wordpress-6-7 #

エディタ/JS 出荷 要目視 手動

Query Loop の表示件数・オフセット・最大ページ数の設定がツールバーからインスペクターへ移動し、投稿/固定ページ内では Query Type 設定が非表示で posts を既定とする。
テンプレート上では posts per page が継承される。Posts List バリエーションは削除されたため、これに依存するパターンや拡張は確認すること。

core/query

miscellaneous-block-editor-changes-in-wordpress-6-7 #

エディタ/JS 出荷 要目視 手動

新しい Zoom Out モードでは「メインコンテンツ」以外のブロックが編集不可になり、メインは core/post-content、なければ tagName が main の core/group で判定される。
テーマはテンプレートのメイン領域を tagName main の Group で包むこと。また zoom-out エディタモードはキャンバスの縮小と切り離された。

core/group core/post-content

developer-notes-for-zoom-out-in-wordpress-6-7 #

機能 ドロップ 要目視 手動

ロードマップで Interactivity API による Gallery ブロックのライトボックス対応が予告されたが、6.7.0 の gallery ブロックにライトボックス処理は含まれていない。

core/gallery

roadmap-to-6-7 #

機能 ドロップ 要目視 手動

ロードマップで HTML API への querySelector() 相当の追加が予告されたが、6.7 の HTML API Dev Note には含まれず出荷されていない。

roadmap-to-6-7 updates-to-the-html-api-in-6-7 #

機能 ドロップ 要目視 手動

ロードマップではテンプレートとテンプレートパーツの登録 API が予告されたが、出荷された register_block_template() はブロックテンプレートのみ対象でテンプレートパーツは登録できない。
テンプレートパーツは従来どおりフィルタ等で対応する必要がある。

roadmap-to-6-7 new-plugin-template-registration-api-in-wordpress-6-7 #

機能 ドロップ 要目視 手動

ロードマップで予告された Query・Search ブロックのインスタント検索は、6.7 の Field Guide・Dev Notes に記載がなく出荷されていない。

roadmap-to-6-7 #

機能 ドロップ 要目視 手動

ロードマップでタイポグラフィ系ブロックサポートの _experimental 接頭辞除去が予告されたが、6.7.0 でも __experimentalFontFamily 等の名前のままである。
block.json では引き続き __experimental 付きのキーを使うこと。

/__experimentalFontFamily|__experimentalFontWeight|__experimentalLetterSpacing|__experimentalTextTransform/

roadmap-to-6-7 #