WP_Theme_JSON::get_setting_nodes( array $theme_json, array $selectors = array() ): array

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

Description

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

Parameters

$theme_jsonarrayrequired: The tree to extract setting nodes from.
$selectorsarrayoptional: List of selectors per block.
Default:array()

Return

array An array of setting nodes metadata.

Source

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_CSS_PROPERTIES_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;
}

View all references View on Trac View on GitHub

Changelog

Version	Description
5.8.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.