<h2>File Contents: /home/planet5/www/yogitonics.com/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yogitonics.com/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * REST API: WP_REST_Themes_Controller class
 *
 * @package WordPress
 * @subpackage REST_API
 * @since 5.0.0
 */

/**
 * Core class used to manage themes via the REST API.
 *
 * @since 5.0.0
 *
 * @see WP_REST_Controller
 */
class WP_REST_Themes_Controller extends WP_REST_Controller {

	/**
	 * Matches theme&#039;s directory: `/themes/&lt;subdirectory&gt;/&lt;theme&gt;/` or `/themes/&lt;theme&gt;/`.
	 * Excludes invalid directory name characters: `/:&lt;&gt;*?&quot;|`.
	 */
	const PATTERN = &#039;[^\/:&lt;&gt;\*\?&quot;\|]+(?:\/[^\/:&lt;&gt;\*\?&quot;\|]+)?&#039;;

	/**
	 * Constructor.
	 *
	 * @since 5.0.0
	 */
	public function __construct() {
		$this-&gt;namespace = &#039;wp/v2&#039;;
		$this-&gt;rest_base = &#039;themes&#039;;
	}

	/**
	 * Registers the routes for themes.
	 *
	 * @since 5.0.0
	 *
	 * @see register_rest_route()
	 */
	public function register_routes() {
		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;rest_base,
			array(
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_items&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_items_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;get_collection_params(),
				),
				&#039;schema&#039; =&gt; array( $this, &#039;get_item_schema&#039; ),
			)
		);

		register_rest_route(
			$this-&gt;namespace,
			sprintf( &#039;/%s/(?P&lt;stylesheet&gt;%s)&#039;, $this-&gt;rest_base, self::PATTERN ),
			array(
				&#039;args&#039;   =&gt; array(
					&#039;stylesheet&#039; =&gt; array(
						&#039;description&#039;       =&gt; __( &quot;The theme&#039;s stylesheet. This uniquely identifies the theme.&quot; ),
						&#039;type&#039;              =&gt; &#039;string&#039;,
						&#039;sanitize_callback&#039; =&gt; array( $this, &#039;_sanitize_stylesheet_callback&#039; ),
					),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_item_permissions_check&#039; ),
				),
				&#039;schema&#039; =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);
	}

	/**
	 * Sanitize the stylesheet to decode endpoint.
	 *
	 * @since 5.9.0
	 *
	 * @param string $stylesheet The stylesheet name.
	 * @return string Sanitized stylesheet.
	 */
	public function _sanitize_stylesheet_callback( $stylesheet ) {
		return urldecode( $stylesheet );
	}

	/**
	 * Checks if a given request has access to read the theme.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has read access for the item, otherwise WP_Error object.
	 */
	public function get_items_permissions_check( $request ) {
		if ( current_user_can( &#039;switch_themes&#039; ) || current_user_can( &#039;manage_network_themes&#039; ) ) {
			return true;
		}

		$registered = $this-&gt;get_collection_params();
		if ( isset( $registered[&#039;status&#039;], $request[&#039;status&#039;] ) &amp;&amp; is_array( $request[&#039;status&#039;] ) &amp;&amp; array( &#039;active&#039; ) === $request[&#039;status&#039;] ) {
			return $this-&gt;check_read_active_theme_permission();
		}

		return new WP_Error(
			&#039;rest_cannot_view_themes&#039;,
			__( &#039;Sorry, you are not allowed to view themes.&#039; ),
			array( &#039;status&#039; =&gt; rest_authorization_required_code() )
		);
	}

	/**
	 * Checks if a given request has access to read the theme.
	 *
	 * @since 5.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has read access for the item, otherwise WP_Error object.
	 */
	public function get_item_permissions_check( $request ) {
		if ( current_user_can( &#039;switch_themes&#039; ) || current_user_can( &#039;manage_network_themes&#039; ) ) {
			return true;
		}

		$wp_theme      = wp_get_theme( $request[&#039;stylesheet&#039;] );
		$current_theme = wp_get_theme();

		if ( $this-&gt;is_same_theme( $wp_theme, $current_theme ) ) {
			return $this-&gt;check_read_active_theme_permission();
		}

		return new WP_Error(
			&#039;rest_cannot_view_themes&#039;,
			__( &#039;Sorry, you are not allowed to view themes.&#039; ),
			array( &#039;status&#039; =&gt; rest_authorization_required_code() )
		);
	}

	/**
	 * Checks if a theme can be read.
	 *
	 * @since 5.7.0
	 *
	 * @return true|WP_Error True if the theme can be read, WP_Error object otherwise.
	 */
	protected function check_read_active_theme_permission() {
		if ( current_user_can( &#039;edit_posts&#039; ) ) {
			return true;
		}

		foreach ( get_post_types( array( &#039;show_in_rest&#039; =&gt; true ), &#039;objects&#039; ) as $post_type ) {
			if ( current_user_can( $post_type-&gt;cap-&gt;edit_posts ) ) {
				return true;
			}
		}

		return new WP_Error(
			&#039;rest_cannot_view_active_theme&#039;,
			__( &#039;Sorry, you are not allowed to view the active theme.&#039; ),
			array( &#039;status&#039; =&gt; rest_authorization_required_code() )
		);
	}

	/**
	 * Retrieves a single theme.
	 *
	 * @since 5.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_item( $request ) {
		$wp_theme = wp_get_theme( $request[&#039;stylesheet&#039;] );
		if ( ! $wp_theme-&gt;exists() ) {
			return new WP_Error(
				&#039;rest_theme_not_found&#039;,
				__( &#039;Theme not found.&#039; ),
				array( &#039;status&#039; =&gt; 404 )
			);
		}
		$data = $this-&gt;prepare_item_for_response( $wp_theme, $request );

		return rest_ensure_response( $data );
	}

	/**
	 * Retrieves a collection of themes.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_items( $request ) {
		$themes = array();

		$current_theme = wp_get_theme();
		$status        = $request[&#039;status&#039;];

		if ( array( &#039;active&#039; ) === $status ) {
			$prepared = $this-&gt;prepare_item_for_response( $current_theme, $request );
			$themes[] = $this-&gt;prepare_response_for_collection( $prepared );
		} else {
			foreach ( wp_get_themes() as $theme ) {
				$theme_status = ( $this-&gt;is_same_theme( $theme, $current_theme ) ) ? &#039;active&#039; : &#039;inactive&#039;;
				if ( is_array( $status ) &amp;&amp; ! in_array( $theme_status, $status, true ) ) {
					continue;
				}

				$prepared = $this-&gt;prepare_item_for_response( $theme, $request );
				$themes[] = $this-&gt;prepare_response_for_collection( $prepared );
			}
		}

		$response = rest_ensure_response( $themes );

		$response-&gt;header( &#039;X-WP-Total&#039;, count( $themes ) );
		$response-&gt;header( &#039;X-WP-TotalPages&#039;, 1 );

		return $response;
	}

	/**
	 * Prepares a single theme output for response.
	 *
	 * @since 5.0.0
	 * @since 5.9.0 Renamed `$theme` to `$item` to match parent class for PHP 8 named parameter support.
	 * @since 6.6.0 Added `stylesheet_uri` and `template_uri` fields.
	 *
	 * @param WP_Theme        $item    Theme object.
	 * @param WP_REST_Request $request Request object.
	 * @return WP_REST_Response Response object.
	 */
	public function prepare_item_for_response( $item, $request ) {
		// Restores the more descriptive, specific name for use within this method.
		$theme = $item;

		$fields = $this-&gt;get_fields_for_response( $request );
		$data   = array();

		if ( rest_is_field_included( &#039;stylesheet&#039;, $fields ) ) {
			$data[&#039;stylesheet&#039;] = $theme-&gt;get_stylesheet();
		}

		if ( rest_is_field_included( &#039;template&#039;, $fields ) ) {
			/**
			 * Use the get_template() method, not the &#039;Template&#039; header, for finding the template.
			 * The &#039;Template&#039; header is only good for what was written in the style.css, while
			 * get_template() takes into account where WordPress actually located the theme and
			 * whether it is actually valid.
			 */
			$data[&#039;template&#039;] = $theme-&gt;get_template();
		}

		$plain_field_mappings = array(
			&#039;requires_php&#039; =&gt; &#039;RequiresPHP&#039;,
			&#039;requires_wp&#039;  =&gt; &#039;RequiresWP&#039;,
			&#039;textdomain&#039;   =&gt; &#039;TextDomain&#039;,
			&#039;version&#039;      =&gt; &#039;Version&#039;,
		);

		foreach ( $plain_field_mappings as $field =&gt; $header ) {
			if ( rest_is_field_included( $field, $fields ) ) {
				$data[ $field ] = $theme-&gt;get( $header );
			}
		}

		if ( rest_is_field_included( &#039;screenshot&#039;, $fields ) ) {
			// Using $theme-&gt;get_screenshot() with no args to get absolute URL.
			$data[&#039;screenshot&#039;] = $theme-&gt;get_screenshot() ? $theme-&gt;get_screenshot() : &#039;&#039;;
		}

		$rich_field_mappings = array(
			&#039;author&#039;      =&gt; &#039;Author&#039;,
			&#039;author_uri&#039;  =&gt; &#039;AuthorURI&#039;,
			&#039;description&#039; =&gt; &#039;Description&#039;,
			&#039;name&#039;        =&gt; &#039;Name&#039;,
			&#039;tags&#039;        =&gt; &#039;Tags&#039;,
			&#039;theme_uri&#039;   =&gt; &#039;ThemeURI&#039;,
		);

		foreach ( $rich_field_mappings as $field =&gt; $header ) {
			if ( rest_is_field_included( &quot;{$field}.raw&quot;, $fields ) ) {
				$data[ $field ][&#039;raw&#039;] = $theme-&gt;display( $header, false, true );
			}

			if ( rest_is_field_included( &quot;{$field}.rendered&quot;, $fields ) ) {
				$data[ $field ][&#039;rendered&#039;] = $theme-&gt;display( $header );
			}
		}

		$current_theme = wp_get_theme();
		if ( rest_is_field_included( &#039;status&#039;, $fields ) ) {
			$data[&#039;status&#039;] = ( $this-&gt;is_same_theme( $theme, $current_theme ) ) ? &#039;active&#039; : &#039;inactive&#039;;
		}

		if ( rest_is_field_included( &#039;theme_supports&#039;, $fields ) &amp;&amp; $this-&gt;is_same_theme( $theme, $current_theme ) ) {
			foreach ( get_registered_theme_features() as $feature =&gt; $config ) {
				if ( ! is_array( $config[&#039;show_in_rest&#039;] ) ) {
					continue;
				}

				$name = $config[&#039;show_in_rest&#039;][&#039;name&#039;];

				if ( ! rest_is_field_included( &quot;theme_supports.{$name}&quot;, $fields ) ) {
					continue;
				}

				if ( ! current_theme_supports( $feature ) ) {
					$data[&#039;theme_supports&#039;][ $name ] = $config[&#039;show_in_rest&#039;][&#039;schema&#039;][&#039;default&#039;];
					continue;
				}

				$support = get_theme_support( $feature );

				if ( isset( $config[&#039;show_in_rest&#039;][&#039;prepare_callback&#039;] ) ) {
					$prepare = $config[&#039;show_in_rest&#039;][&#039;prepare_callback&#039;];
				} else {
					$prepare = array( $this, &#039;prepare_theme_support&#039; );
				}

				$prepared = $prepare( $support, $config, $feature, $request );

				if ( is_wp_error( $prepared ) ) {
					continue;
				}

				$data[&#039;theme_supports&#039;][ $name ] = $prepared;
			}
		}

		if ( rest_is_field_included( &#039;is_block_theme&#039;, $fields ) ) {
			$data[&#039;is_block_theme&#039;] = $theme-&gt;is_block_theme();
		}

		if ( rest_is_field_included( &#039;stylesheet_uri&#039;, $fields ) ) {
			if ( $this-&gt;is_same_theme( $theme, $current_theme ) ) {
				$data[&#039;stylesheet_uri&#039;] = get_stylesheet_directory_uri();
			} else {
				$data[&#039;stylesheet_uri&#039;] = $theme-&gt;get_stylesheet_directory_uri();
			}
		}

		if ( rest_is_field_included( &#039;template_uri&#039;, $fields ) ) {
			if ( $this-&gt;is_same_theme( $theme, $current_theme ) ) {
				$data[&#039;template_uri&#039;] = get_template_directory_uri();
			} else {
				$data[&#039;template_uri&#039;] = $theme-&gt;get_template_directory_uri();
			}
		}

		if ( rest_is_field_included( &#039;default_template_types&#039;, $fields ) &amp;&amp; $this-&gt;is_same_theme( $theme, $current_theme ) ) {
			$default_template_types = array();
			foreach ( get_default_block_template_types() as $slug =&gt; $template_type ) {
				$template_type[&#039;slug&#039;]    = (string) $slug;
				$default_template_types[] = $template_type;
			}
			$data[&#039;default_template_types&#039;] = $default_template_types;
		}

		if ( rest_is_field_included( &#039;default_template_part_areas&#039;, $fields ) &amp;&amp; $this-&gt;is_same_theme( $theme, $current_theme ) ) {
			$data[&#039;default_template_part_areas&#039;] = get_allowed_block_template_part_areas();
		}

		$data = $this-&gt;add_additional_fields_to_object( $data, $request );

		// Wrap the data in a response object.
		$response = rest_ensure_response( $data );

		if ( rest_is_field_included( &#039;_links&#039;, $fields ) || rest_is_field_included( &#039;_embedded&#039;, $fields ) ) {
			$response-&gt;add_links( $this-&gt;prepare_links( $theme ) );
		}

		/**
		 * Filters theme data returned from the REST API.
		 *
		 * @since 5.0.0
		 *
		 * @param WP_REST_Response $response The response object.
		 * @param WP_Theme         $theme    Theme object used to create response.
		 * @param WP_REST_Request  $request  Request object.
		 */
		return apply_filters( &#039;rest_prepare_theme&#039;, $response, $theme, $request );
	}

	/**
	 * Prepares links for the request.
	 *
	 * @since 5.7.0
	 *
	 * @param WP_Theme $theme Theme data.
	 * @return array Links for the given block type.
	 */
	protected function prepare_links( $theme ) {
		$links = array(
			&#039;self&#039;       =&gt; array(
				&#039;href&#039; =&gt; rest_url( sprintf( &#039;%s/%s/%s&#039;, $this-&gt;namespace, $this-&gt;rest_base, $theme-&gt;get_stylesheet() ) ),
			),
			&#039;collection&#039; =&gt; array(
				&#039;href&#039; =&gt; rest_url( sprintf( &#039;%s/%s&#039;, $this-&gt;namespace, $this-&gt;rest_base ) ),
			),
		);

		if ( $this-&gt;is_same_theme( $theme, wp_get_theme() ) ) {
			// This creates a record for the active theme if not existent.
			$id = WP_Theme_JSON_Resolver::get_user_global_styles_post_id();
		} else {
			$user_cpt = WP_Theme_JSON_Resolver::get_user_data_from_wp_global_styles( $theme );
			$id       = $user_cpt[&#039;ID&#039;] ?? null;
		}

		if ( $id ) {
			$links[&#039;https://api.w.org/user-global-styles&#039;] = array(
				&#039;href&#039; =&gt; rest_url( &#039;wp/v2/global-styles/&#039; . $id ),
			);
		}

		if ( $theme-&gt;is_block_theme() &amp;&amp; $this-&gt;is_same_theme( $theme, wp_get_theme() ) ) {
			$links[&#039;https://api.w.org/export-theme&#039;] = array(
				&#039;href&#039;        =&gt; rest_url( &#039;wp-block-editor/v1/export&#039; ),
				&#039;targetHints&#039; =&gt; array(
					&#039;allow&#039; =&gt; current_user_can( &#039;export&#039; ) ? array( &#039;GET&#039; ) : array(),
				),
			);
		}

		return $links;
	}

	/**
	 * Helper function to compare two themes.
	 *
	 * @since 5.7.0
	 *
	 * @param WP_Theme $theme_a First theme to compare.
	 * @param WP_Theme $theme_b Second theme to compare.
	 * @return bool
	 */
	protected function is_same_theme( $theme_a, $theme_b ) {
		return $theme_a-&gt;get_stylesheet() === $theme_b-&gt;get_stylesheet();
	}

	/**
	 * Prepares the theme support value for inclusion in the REST API response.
	 *
	 * @since 5.5.0
	 *
	 * @param mixed           $support The raw value from get_theme_support().
	 * @param array           $args    The feature&#039;s registration args.
	 * @param string          $feature The feature name.
	 * @param WP_REST_Request $request The request object.
	 * @return mixed The prepared support value.
	 */
	protected function prepare_theme_support( $support, $args, $feature, $request ) {
		$schema = $args[&#039;show_in_rest&#039;][&#039;schema&#039;];

		if ( &#039;boolean&#039; === $schema[&#039;type&#039;] ) {
			return true;
		}

		if ( is_array( $support ) &amp;&amp; ! $args[&#039;variadic&#039;] ) {
			$support = $support[0];
		}

		return rest_sanitize_value_from_schema( $support, $schema );
	}

	/**
	 * Retrieves the theme&#039;s schema, conforming to JSON Schema.
	 *
	 * @since 5.0.0
	 *
	 * @return array Item schema data.
	 */
	public function get_item_schema() {
		if ( $this-&gt;schema ) {
			return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
		}

		$schema = array(
			&#039;$schema&#039;    =&gt; &#039;http://json-schema.org/draft-04/schema#&#039;,
			&#039;title&#039;      =&gt; &#039;theme&#039;,
			&#039;type&#039;       =&gt; &#039;object&#039;,
			&#039;properties&#039; =&gt; array(
				&#039;stylesheet&#039;                  =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The theme\&#039;s stylesheet. This uniquely identifies the theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;stylesheet_uri&#039;              =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The uri for the theme\&#039;s stylesheet directory.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;format&#039;      =&gt; &#039;uri&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;template&#039;                    =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The theme\&#039;s template. If this is a child theme, this refers to the parent theme, otherwise this is the same as the theme\&#039;s stylesheet.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;template_uri&#039;                =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The uri for the theme\&#039;s template directory. If this is a child theme, this refers to the parent theme, otherwise this is the same as the theme\&#039;s stylesheet directory.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;format&#039;      =&gt; &#039;uri&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;author&#039;                      =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The theme author.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(
						&#039;raw&#039;      =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme author\&#039;s name, as found in the theme header.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
						&#039;rendered&#039; =&gt; array(
							&#039;description&#039; =&gt; __( &#039;HTML for the theme author, transformed for display.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
					),
				),
				&#039;author_uri&#039;                  =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The website of the theme author.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(
						&#039;raw&#039;      =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The website of the theme author, as found in the theme header.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
							&#039;format&#039;      =&gt; &#039;uri&#039;,
						),
						&#039;rendered&#039; =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The website of the theme author, transformed for display.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
							&#039;format&#039;      =&gt; &#039;uri&#039;,
						),
					),
				),
				&#039;description&#039;                 =&gt; array(
					&#039;description&#039; =&gt; __( &#039;A description of the theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(
						&#039;raw&#039;      =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme description, as found in the theme header.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
						&#039;rendered&#039; =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme description, transformed for display.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
					),
				),
				&#039;is_block_theme&#039;              =&gt; array(
					&#039;description&#039; =&gt; __( &#039;Whether the theme is a block-based theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;boolean&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;name&#039;                        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The name of the theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(
						&#039;raw&#039;      =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme name, as found in the theme header.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
						&#039;rendered&#039; =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme name, transformed for display.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
					),
				),
				&#039;requires_php&#039;                =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The minimum PHP version required for the theme to work.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;requires_wp&#039;                 =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The minimum WordPress version required for the theme to work.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;screenshot&#039;                  =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The theme\&#039;s screenshot URL.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;format&#039;      =&gt; &#039;uri&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;tags&#039;                        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;Tags indicating styles and features of the theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(
						&#039;raw&#039;      =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme tags, as found in the theme header.&#039; ),
							&#039;type&#039;        =&gt; &#039;array&#039;,
							&#039;items&#039;       =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
						),
						&#039;rendered&#039; =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The theme tags, transformed for display.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
						),
					),
				),
				&#039;textdomain&#039;                  =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The theme\&#039;s text domain.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;theme_supports&#039;              =&gt; array(
					&#039;description&#039; =&gt; __( &#039;Features supported by this theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(),
				),
				&#039;theme_uri&#039;                   =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The URI of the theme\&#039;s webpage.&#039; ),
					&#039;type&#039;        =&gt; &#039;object&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;properties&#039;  =&gt; array(
						&#039;raw&#039;      =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The URI of the theme\&#039;s webpage, as found in the theme header.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
							&#039;format&#039;      =&gt; &#039;uri&#039;,
						),
						&#039;rendered&#039; =&gt; array(
							&#039;description&#039; =&gt; __( &#039;The URI of the theme\&#039;s webpage, transformed for display.&#039; ),
							&#039;type&#039;        =&gt; &#039;string&#039;,
							&#039;format&#039;      =&gt; &#039;uri&#039;,
						),
					),
				),
				&#039;version&#039;                     =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The theme\&#039;s current version.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;status&#039;                      =&gt; array(
					&#039;description&#039; =&gt; __( &#039;A named status for the theme.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;enum&#039;        =&gt; array( &#039;inactive&#039;, &#039;active&#039; ),
				),
				&#039;default_template_types&#039;      =&gt; array(
					&#039;description&#039; =&gt; __( &#039;A list of default template types.&#039; ),
					&#039;type&#039;        =&gt; &#039;array&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;items&#039;       =&gt; array(
						&#039;type&#039;       =&gt; &#039;object&#039;,
						&#039;properties&#039; =&gt; array(
							&#039;slug&#039;        =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
							&#039;title&#039;       =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
							&#039;description&#039; =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
						),
					),
				),
				&#039;default_template_part_areas&#039; =&gt; array(
					&#039;description&#039; =&gt; __( &#039;A list of allowed area values for template parts.&#039; ),
					&#039;type&#039;        =&gt; &#039;array&#039;,
					&#039;readonly&#039;    =&gt; true,
					&#039;items&#039;       =&gt; array(
						&#039;type&#039;       =&gt; &#039;object&#039;,
						&#039;properties&#039; =&gt; array(
							&#039;area&#039;        =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
							&#039;label&#039;       =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
							&#039;description&#039; =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
							&#039;icon&#039;        =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
							&#039;area_tag&#039;    =&gt; array(
								&#039;type&#039; =&gt; &#039;string&#039;,
							),
						),
					),
				),
			),
		);

		foreach ( get_registered_theme_features() as $feature =&gt; $config ) {
			if ( ! is_array( $config[&#039;show_in_rest&#039;] ) ) {
				continue;
			}

			$name = $config[&#039;show_in_rest&#039;][&#039;name&#039;];

			$schema[&#039;properties&#039;][&#039;theme_supports&#039;][&#039;properties&#039;][ $name ] = $config[&#039;show_in_rest&#039;][&#039;schema&#039;];
		}

		$this-&gt;schema = $schema;

		return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
	}

	/**
	 * Retrieves the search params for the themes collection.
	 *
	 * @since 5.0.0
	 *
	 * @return array Collection parameters.
	 */
	public function get_collection_params() {
		$query_params = array(
			&#039;status&#039; =&gt; array(
				&#039;description&#039; =&gt; __( &#039;Limit result set to themes assigned one or more statuses.&#039; ),
				&#039;type&#039;        =&gt; &#039;array&#039;,
				&#039;items&#039;       =&gt; array(
					&#039;enum&#039; =&gt; array( &#039;active&#039;, &#039;inactive&#039; ),
					&#039;type&#039; =&gt; &#039;string&#039;,
				),
			),
		);

		/**
		 * Filters REST API collection parameters for the themes controller.
		 *
		 * @since 5.0.0
		 *
		 * @param array $query_params JSON Schema-formatted collection parameters.
		 */
		return apply_filters( &#039;rest_themes_collection_params&#039;, $query_params );
	}

	/**
	 * Sanitizes and validates the list of theme status.
	 *
	 * @since 5.0.0
	 * @deprecated 5.7.0
	 *
	 * @param string|array    $statuses  One or more theme statuses.
	 * @param WP_REST_Request $request   Full details about the request.
	 * @param string          $parameter Additional parameter to pass to validation.
	 * @return array|WP_Error A list of valid statuses, otherwise WP_Error object.
	 */
	public function sanitize_theme_status( $statuses, $request, $parameter ) {
		_deprecated_function( __METHOD__, &#039;5.7.0&#039; );

		$statuses = wp_parse_slug_list( $statuses );

		foreach ( $statuses as $status ) {
			$result = rest_validate_request_arg( $status, $request, $parameter );

			if ( is_wp_error( $result ) ) {
				return $result;
			}
		}

		return $statuses;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyogitonics.com%2Fwp-includes%2Frest-api%2Fendpoints'>⬅ Back to Directory</a>