WP_Theme_JSON_Resolver::get_theme_data() │ public static │ WP 5.8.0

Returns the theme's data.

Data from theme.json will be backfilled from existing theme supports, if any. Note that if the same data is present in theme.json and in theme supports, the theme.json takes precedence.

Method of the class: WP_Theme_JSON_Resolver{}

Return

WP_Theme_JSON. Entity that holds theme data.

Usage

$result = WP_Theme_JSON_Resolver::get_theme_data( $deprecated, $options );

$deprecated(array)

Deprecated. Not used.
Default: array()

$options(array)

Options arguments.

Default: array()

• with_supports(true|false)
  Whether to include theme supports in the data.
  Default: true

Changelog

WP_Theme_JSON_Resolver::get_theme_data() WP Theme JSON Resolver::get theme data code ^{WP 6.5.2}

public static function get_theme_data( $deprecated = array(), $options = array() ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __METHOD__, '5.9.0' );
	}

	$options = wp_parse_args( $options, array( 'with_supports' => true ) );

	if ( null === static::$theme || ! static::has_same_registered_blocks( 'theme' ) ) {
		$wp_theme        = wp_get_theme();
		$theme_json_file = $wp_theme->get_file_path( 'theme.json' );
		if ( is_readable( $theme_json_file ) ) {
			$theme_json_data = static::read_json_file( $theme_json_file );
			$theme_json_data = static::translate( $theme_json_data, $wp_theme->get( 'TextDomain' ) );
		} else {
			$theme_json_data = array();
		}

		/**
		 * Filters the data provided by the theme for global styles and settings.
		 *
		 * @since 6.1.0
		 *
		 * @param WP_Theme_JSON_Data $theme_json Class to access and update the underlying data.
		 */
		$theme_json      = apply_filters( 'wp_theme_json_data_theme', new WP_Theme_JSON_Data( $theme_json_data, 'theme' ) );
		$theme_json_data = $theme_json->get_data();
		static::$theme   = new WP_Theme_JSON( $theme_json_data );

		if ( $wp_theme->parent() ) {
			// Get parent theme.json.
			$parent_theme_json_file = $wp_theme->parent()->get_file_path( 'theme.json' );
			if ( $theme_json_file !== $parent_theme_json_file && is_readable( $parent_theme_json_file ) ) {
				$parent_theme_json_data = static::read_json_file( $parent_theme_json_file );
				$parent_theme_json_data = static::translate( $parent_theme_json_data, $wp_theme->parent()->get( 'TextDomain' ) );
				$parent_theme           = new WP_Theme_JSON( $parent_theme_json_data );

				/*
				 * Merge the child theme.json into the parent theme.json.
				 * The child theme takes precedence over the parent.
				 */
				$parent_theme->merge( static::$theme );
				static::$theme = $parent_theme;
			}
		}
	}

	if ( ! $options['with_supports'] ) {
		return static::$theme;
	}

	/*
	 * We want the presets and settings declared in theme.json
	 * to override the ones declared via theme supports.
	 * So we take theme supports, transform it to theme.json shape
	 * and merge the static::$theme upon that.
	 */
	$theme_support_data = WP_Theme_JSON::get_from_editor_settings( get_classic_theme_supports_block_editor_settings() );
	if ( ! wp_theme_has_theme_json() ) {
		if ( ! isset( $theme_support_data['settings']['color'] ) ) {
			$theme_support_data['settings']['color'] = array();
		}

		$default_palette = false;
		if ( current_theme_supports( 'default-color-palette' ) ) {
			$default_palette = true;
		}
		if ( ! isset( $theme_support_data['settings']['color']['palette'] ) ) {
			// If the theme does not have any palette, we still want to show the core one.
			$default_palette = true;
		}
		$theme_support_data['settings']['color']['defaultPalette'] = $default_palette;

		$default_gradients = false;
		if ( current_theme_supports( 'default-gradient-presets' ) ) {
			$default_gradients = true;
		}
		if ( ! isset( $theme_support_data['settings']['color']['gradients'] ) ) {
			// If the theme does not have any gradients, we still want to show the core ones.
			$default_gradients = true;
		}
		$theme_support_data['settings']['color']['defaultGradients'] = $default_gradients;

		if ( ! isset( $theme_support_data['settings']['shadow'] ) ) {
			$theme_support_data['settings']['shadow'] = array();
		}
		/*
		 * Shadow presets are explicitly disabled for classic themes until a
		 * decision is made for whether the default presets should match the
		 * other presets or if they should be disabled by default in classic
		 * themes. See https://github.com/WordPress/gutenberg/issues/59989.
		 */
		$theme_support_data['settings']['shadow']['defaultPresets'] = false;

		// Allow themes to enable link color setting via theme_support.
		if ( current_theme_supports( 'link-color' ) ) {
			$theme_support_data['settings']['color']['link'] = true;
		}

		// Allow themes to enable all border settings via theme_support.
		if ( current_theme_supports( 'border' ) ) {
			$theme_support_data['settings']['border']['color']  = true;
			$theme_support_data['settings']['border']['radius'] = true;
			$theme_support_data['settings']['border']['style']  = true;
			$theme_support_data['settings']['border']['width']  = true;
		}

		// Allow themes to enable appearance tools via theme_support.
		if ( current_theme_supports( 'appearance-tools' ) ) {
			$theme_support_data['settings']['appearanceTools'] = true;
		}
	}
	$with_theme_supports = new WP_Theme_JSON( $theme_support_data );
	$with_theme_supports->merge( static::$theme );
	return $with_theme_supports;
}