WP_Theme_JSON::get_setting_nodes()protected staticWP 5.8.0

Builds metadata for the setting nodes, which returns in the form of:

[ [ 'path' => ['path', 'to', 'some', 'node' ], 'selector' => 'CSS selector for some node' ], [ 'path' => [ 'path', 'to', 'other', 'node' ], 'selector' => 'CSS selector for other node' ],

]

Method of the class: WP_Theme_JSON{}

No Hooks.

Return

Array. An array of setting nodes metadata.

Usage

$result = WP_Theme_JSON::get_setting_nodes( $theme_json, $selectors );
$theme_json(array) (required)
The tree to extract setting nodes from.
$selectors(array)
List of selectors per block.
Default: array()

Changelog

Since 5.8.0 Introduced.

WP_Theme_JSON::get_setting_nodes() code WP 6.4.3

protected static function get_setting_nodes( $theme_json, $selectors = array() ) {
	$nodes = array();
	if ( ! isset( $theme_json['settings'] ) ) {
		return $nodes;
	}

	// Top-level.
	$nodes[] = array(
		'path'     => array( 'settings' ),
		'selector' => static::ROOT_BLOCK_SELECTOR,
	);

	// Calculate paths for blocks.
	if ( ! isset( $theme_json['settings']['blocks'] ) ) {
		return $nodes;
	}

	foreach ( $theme_json['settings']['blocks'] as $name => $node ) {
		$selector = null;
		if ( isset( $selectors[ $name ]['selector'] ) ) {
			$selector = $selectors[ $name ]['selector'];
		}

		$nodes[] = array(
			'path'     => array( 'settings', 'blocks', $name ),
			'selector' => $selector,
		);
	}

	return $nodes;
}