mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-15 23:25:50 +01:00
fa4cc8f69d
This changeset ports the work done in Gutenberg (released in 14.1) to add hooks to filter the `theme.json` data. Specifically, it adds the following filters: `theme_json_default`, `theme_json_blocks`, `theme_json_theme`, and `theme_json_user`. For more details, see the following Gutenberg pull requests: - [https://github.com/WordPress/gutenberg/pull/44015 gutenberg#44015]: Make global styles data filterable - [https://github.com/WordPress/gutenberg/pull/44109 gutenberg#44109]: Prepare `WP_Theme_JSON_Data` class for backporting - [https://github.com/WordPress/gutenberg/pull/44159 gutenberg#44159]: Update hook's names from `global_styles_*` to `theme_json_*` Props oandregal, czapla, gziolo, bernhard-reiter. See #56467. Built from https://develop.svn.wordpress.org/trunk@54251 git-svn-id: http://core.svn.wordpress.org/trunk@53810 1a063a9b-81f0-0310-95a4-ce76da25c4cd
73 lines
1.5 KiB
PHP
73 lines
1.5 KiB
PHP
<?php
|
|
/**
|
|
* WP_Theme_JSON_Data class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Theme
|
|
* @since 6.1.0
|
|
*/
|
|
|
|
/**
|
|
* Class to provide access to update a theme.json structure.
|
|
*/
|
|
class WP_Theme_JSON_Data {
|
|
|
|
/**
|
|
* Container of the data to update.
|
|
*
|
|
* @since 6.1.0
|
|
* @var WP_Theme_JSON
|
|
*/
|
|
private $theme_json = null;
|
|
|
|
/**
|
|
* The origin of the data: default, theme, user, etc.
|
|
*
|
|
* @since 6.1.0
|
|
* @var string
|
|
*/
|
|
private $origin = '';
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @link https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/
|
|
*
|
|
* @param array $data Array following the theme.json specification.
|
|
* @param string $origin The origin of the data: default, theme, user.
|
|
*/
|
|
public function __construct( $data = array(), $origin = 'theme' ) {
|
|
$this->origin = $origin;
|
|
$this->theme_json = new WP_Theme_JSON( $data, $this->origin );
|
|
}
|
|
|
|
/**
|
|
* Updates the theme.json with the the given data.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @param array $new_data Array following the theme.json specification.
|
|
*
|
|
* @return WP_Theme_JSON_Data The own instance with access to the modified data.
|
|
*/
|
|
public function update_with( $new_data ) {
|
|
$this->theme_json->merge( new WP_Theme_JSON( $new_data, $this->origin ) );
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns an array containing the underlying data
|
|
* following the theme.json specification.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_data() {
|
|
return $this->theme_json->get_raw_data();
|
|
}
|
|
|
|
}
|