WP_Theme_JSON::__construct( array $theme_json = array('version' => self::LATEST_SCHEMA), string $origin = 'theme' )

Parameters

$theme_jsonarrayoptional

A structure that follows the theme.json schema.Default: array('version' => self::LATEST_SCHEMA)

$originstringoptional

What source of data this object represents. One of 'blocks', 'default', 'theme', or 'custom'. Default 'theme'.Default: 'theme'

Uses · 11

• _wp_array_get()Accesses an array in depth based on a path of keys.
• _wp_array_set()Sets an array in depth based on a path of keys.
• WP_Theme_JSON_Schema::migrate()Function that migrates a given theme.json structure to the last version.
• static::get_blocks_metadata()
• static::get_valid_block_style_variations()
• static::unwrap_shared_block_style_variations()
• static::sanitize()
• static::maybe_opt_in_into_settings()
• static::get_setting_nodes()
• static::compute_spacing_sizes()
• static::merge_spacing_sizes()

Used by · 14

• WP_REST_Global_Styles_Controller::get_theme_items()Returns the given theme global styles variations.
• WP_REST_Global_Styles_Controller::prepare_item_for_response()Prepare a global styles config output for response.
• WP_REST_Global_Styles_Revisions_Controller::prepare_item_for_response()Prepares the revision for the REST response.
• WP_Theme_JSON_Data::__construct()Constructor.
• WP_Theme_JSON_Data::update_with()Updates the theme.json with the given data.
• WP_Theme_JSON_Resolver::get_block_data()Gets the styles for blocks from the block.json file.
• WP_Theme_JSON_Resolver::get_core_data()Returns core's origin config.
• WP_Theme_JSON_Resolver::get_merged_data()Returns the data merged from multiple origins.
• WP_Theme_JSON_Resolver::get_style_variations()Returns the style variations defined by the theme.
• WP_Theme_JSON_Resolver::get_theme_data()Returns the theme's data.
• WP_Theme_JSON_Resolver::get_user_data()Returns the user's origin config.
• WP_Theme_JSON_Resolver::resolve_theme_file_uris()Resolves relative paths in theme.json styles to theme absolute paths and merges them with incoming theme JSON.

Source

View on Trac ↗View on GitHub ↗

1091	public function __construct( $theme_json = array( 'version' => self::LATEST_SCHEMA ), $origin = 'theme' ) {1092		if ( ! in_array( $origin, static::VALID_ORIGINS, true ) ) {1093			$origin = 'theme';1094		}1095 1096		$this->theme_json    = WP_Theme_JSON_Schema::migrate( $theme_json, $origin );1097		$blocks_metadata     = static::get_blocks_metadata();1098		$valid_block_names   = array_keys( $blocks_metadata );1099		$valid_element_names = array_keys( static::ELEMENTS );1100		$valid_variations    = static::get_valid_block_style_variations( $blocks_metadata );1101		$this->theme_json    = static::unwrap_shared_block_style_variations( $this->theme_json, $valid_variations );1102		$this->theme_json    = static::sanitize( $this->theme_json, $valid_block_names, $valid_element_names, $valid_variations );1103		$this->theme_json    = static::maybe_opt_in_into_settings( $this->theme_json );1104 1105		// Internally, presets are keyed by origin.1106		$nodes = static::get_setting_nodes( $this->theme_json );1107		foreach ( $nodes as $node ) {1108			foreach ( static::PRESETS_METADATA as $preset_metadata ) {1109				$path = $node['path'];1110				foreach ( $preset_metadata['path'] as $subpath ) {1111					$path[] = $subpath;1112				}1113				$preset = _wp_array_get( $this->theme_json, $path, null );1114				if ( null !== $preset ) {1115					// If the preset is not already keyed by origin.1116					if ( isset( $preset[0] ) || empty( $preset ) ) {1117						_wp_array_set( $this->theme_json, $path, array( $origin => $preset ) );1118					}1119				}1120			}1121		}1122 1123		// In addition to presets, spacingScale (which generates presets) is also keyed by origin.1124		$scale_path    = array( 'settings', 'spacing', 'spacingScale' );1125		$spacing_scale = _wp_array_get( $this->theme_json, $scale_path, null );1126		if ( null !== $spacing_scale ) {1127			// If the spacingScale is not already keyed by origin.1128			if ( empty( array_intersect( array_keys( $spacing_scale ), static::VALID_ORIGINS ) ) ) {1129				_wp_array_set( $this->theme_json, $scale_path, array( $origin => $spacing_scale ) );1130			}1131		}1132 1133		// Pre-generate the spacingSizes from spacingScale.1134		$scale_path    = array( 'settings', 'spacing', 'spacingScale', $origin );1135		$spacing_scale = _wp_array_get( $this->theme_json, $scale_path, null );1136		if ( isset( $spacing_scale ) ) {1137			$sizes_path           = array( 'settings', 'spacing', 'spacingSizes', $origin );1138			$spacing_sizes        = _wp_array_get( $this->theme_json, $sizes_path, array() );1139			$spacing_scale_sizes  = static::compute_spacing_sizes( $spacing_scale );1140			$merged_spacing_sizes = static::merge_spacing_sizes( $spacing_scale_sizes, $spacing_sizes );1141			_wp_array_set( $this->theme_json, $sizes_path, $merged_spacing_sizes );1142		}1143	}

History

Introduced in 5.8.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/class-wp-theme-json.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.