wppaste
WordPress

WP_Theme_JSON_Resolver::get_style_variations( string $scope = 'theme' ): array

Since
6.0.0, 6.2.0, 6.6.0
Source
wp-includes/class-wp-theme-json-resolver.php:802
Returns the style variations defined by the theme.

Parameters

$scopestringoptional
The scope or type of style variation to retrieve e.g. theme, block etc.Default: 'theme'

Return

array
The style variations defined by the theme.

Uses · 10

Used by · 5

Source

	public static function get_style_variations( $scope = 'theme' ) {		$variation_files    = array();		$variations         = array();		$base_directory     = get_stylesheet_directory() . '/styles';		$template_directory = get_template_directory() . '/styles';		if ( is_dir( $base_directory ) ) {			$variation_files = static::recursively_iterate_json( $base_directory );		}		if ( is_dir( $template_directory ) && $template_directory !== $base_directory ) {			$variation_files_parent = static::recursively_iterate_json( $template_directory );			// If the child and parent variation file basename are the same, only include the child theme's.			foreach ( $variation_files_parent as $parent_path => $parent ) {				foreach ( $variation_files as $child_path => $child ) {					if ( basename( $parent_path ) === basename( $child_path ) ) {						unset( $variation_files_parent[ $parent_path ] );					}				}			}			$variation_files = array_merge( $variation_files, $variation_files_parent );		}		ksort( $variation_files );		foreach ( $variation_files as $path => $file ) {			$decoded_file = self::read_json_file( $path );			if ( is_array( $decoded_file ) && static::style_variation_has_scope( $decoded_file, $scope ) ) {				$translated = static::translate( $decoded_file, wp_get_theme()->get( 'TextDomain' ) );				$variation  = ( new WP_Theme_JSON( $translated ) )->get_raw_data();				if ( empty( $variation['title'] ) ) {					$variation['title'] = basename( $path, '.json' );				}				$variations[] = $variation;			}		}		return $variations;	}

History

Introduced in 6.0.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.

6.6.0
Added configurable scope parameter to allow filtering theme.json partial files by the scope to which they can be applied e.g. theme vs block etc. Added basic caching for read theme.json partial files.from the docblock
6.2.0
Returns parent theme variations if theme is a child.from the docblock
6.0.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/class-wp-theme-json-resolver.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.