From 1ab90c07e91398b01b72171b80b37a11699a967b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9?= <583546+oandregal@users.noreply.github.com> Date: Wed, 14 Sep 2022 17:05:24 +0200 Subject: [PATCH] Rename all global_styles_* filters to theme_json_* --- .../filters/global-styles-filters.md | 14 +++++++------- .../class-wp-theme-json-resolver-6-1.php | 6 +++--- .../class-wp-theme-json-resolver-gutenberg.php | 4 ++-- 3 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/reference-guides/filters/global-styles-filters.md b/docs/reference-guides/filters/global-styles-filters.md index 6cbe94ad235354..37df9970db4f99 100644 --- a/docs/reference-guides/filters/global-styles-filters.md +++ b/docs/reference-guides/filters/global-styles-filters.md @@ -1,11 +1,11 @@ # Global Styles Filters -WordPress 6.1 has introduced some server-side filters to hook into the data provided to Global Styles & Settings: +WordPress 6.1 has introduced some server-side filters to hook into the `theme.json` data provided at the different data layers: -- `global_styles_default`: hooks into the default data provided by WordPress -- `global_styles_blocks`: hooks into the data provided by the blocks -- `global_styles_theme`: hooks into the data provided by the theme -- `global_styles_user`: hooks into the data provided by the user +- `theme_json_default`: hooks into the default data provided by WordPress +- `theme_json_blocks`: hooks into the data provided by the blocks +- `theme_json_theme`: hooks into the data provided by the theme +- `theme_json_user`: hooks into the data provided by the user Each filter receives an instance of the `WP_Theme_JSON_Data` class with the data for the respective layer. To provide new data, the filter callback needs to use the `update_with( $new_data )` method, where `$new_data` is a valid `theme.json`-like structure. As with any `theme.json`, the new data needs to declare which `version` of the `theme.json` is using, so it can correctly be migrated to the runtime one, should it be different. @@ -14,7 +14,7 @@ _Example:_ This is how to pass a new color palette for the theme and disable the text color UI: ```php -function filter_global_styles_theme( $theme_json ){ +function filter_theme_json_theme( $theme_json ){ $new_data = array( 'version' => 2, 'settings' => array( @@ -38,5 +38,5 @@ function filter_global_styles_theme( $theme_json ){ return $theme_json->update_with( $new_data ); } -add_filter( 'global_styles_theme', 'filter_global_styles_theme' ); +add_filter( 'theme_json_theme', 'filter_theme_json_theme' ); ``` diff --git a/lib/compat/wordpress-6.1/class-wp-theme-json-resolver-6-1.php b/lib/compat/wordpress-6.1/class-wp-theme-json-resolver-6-1.php index f05a4b1f752548..45cf6fc4743878 100644 --- a/lib/compat/wordpress-6.1/class-wp-theme-json-resolver-6-1.php +++ b/lib/compat/wordpress-6.1/class-wp-theme-json-resolver-6-1.php @@ -61,7 +61,7 @@ public static function get_core_data() { * * @param WP_Theme_JSON_Data_Gutenberg Class to access and update the underlying data. */ - $theme_json = apply_filters( 'global_styles_default', new WP_Theme_JSON_Data_Gutenberg( $config, 'default' ) ); + $theme_json = apply_filters( 'theme_json_default', new WP_Theme_JSON_Data_Gutenberg( $config, 'default' ) ); $config = $theme_json->get_data(); static::$core = new WP_Theme_JSON_Gutenberg( $config, 'default' ); @@ -92,7 +92,7 @@ public static function get_user_data() { * * @param WP_Theme_JSON_Data_Gutenberg Class to access and update the underlying data. */ - $theme_json = apply_filters( 'global_styles_user', new WP_Theme_JSON_Data_Gutenberg( $config, 'custom' ) ); + $theme_json = apply_filters( 'theme_json_user', new WP_Theme_JSON_Data_Gutenberg( $config, 'custom' ) ); $config = $theme_json->get_data(); return new WP_Theme_JSON_Gutenberg( $config, 'custom' ); } @@ -114,7 +114,7 @@ public static function get_user_data() { * * @param WP_Theme_JSON_Data_Gutenberg Class to access and update the underlying data. */ - $theme_json = apply_filters( 'global_styles_user', new WP_Theme_JSON_Data_Gutenberg( $config, 'custom' ) ); + $theme_json = apply_filters( 'theme_json_user', new WP_Theme_JSON_Data_Gutenberg( $config, 'custom' ) ); $config = $theme_json->get_data(); static::$user = new WP_Theme_JSON_Gutenberg( $config, 'custom' ); diff --git a/lib/experimental/class-wp-theme-json-resolver-gutenberg.php b/lib/experimental/class-wp-theme-json-resolver-gutenberg.php index a3f9538056cb66..643e7e5df9b321 100644 --- a/lib/experimental/class-wp-theme-json-resolver-gutenberg.php +++ b/lib/experimental/class-wp-theme-json-resolver-gutenberg.php @@ -44,7 +44,7 @@ public static function get_theme_data( $deprecated = array(), $settings = array( * * @param WP_Theme_JSON_Data_Gutenberg Class to access and update the underlying data. */ - $theme_json = apply_filters( 'global_styles_theme', new WP_Theme_JSON_Data_Gutenberg( $theme_json_data, 'theme' ) ); + $theme_json = apply_filters( 'theme_json_theme', new WP_Theme_JSON_Data_Gutenberg( $theme_json_data, 'theme' ) ); $theme_json_data = $theme_json->get_data(); static::$theme = new WP_Theme_JSON_Gutenberg( $theme_json_data ); @@ -141,7 +141,7 @@ public static function get_block_data() { * * @param WP_Theme_JSON_Data_Gutenberg Class to access and update the underlying data. */ - $theme_json = apply_filters( 'global_styles_blocks', new WP_Theme_JSON_Data_Gutenberg( $config, 'core' ) ); + $theme_json = apply_filters( 'theme_json_blocks', new WP_Theme_JSON_Data_Gutenberg( $config, 'core' ) ); $config = $theme_json->get_data(); // Core here means it's the lower level part of the styles chain.