[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * WP_Theme_JSON_Data class
   4   *
   5   * @package WordPress
   6   * @subpackage Theme
   7   * @since 6.1.0
   8   */
   9  
  10  /**
  11   * Class to provide access to update a theme.json structure.
  12   */
  13  #[AllowDynamicProperties]
  14  class WP_Theme_JSON_Data {
  15  
  16      /**
  17       * Container of the data to update.
  18       *
  19       * @since 6.1.0
  20       * @var WP_Theme_JSON
  21       */
  22      private $theme_json = null;
  23  
  24      /**
  25       * The origin of the data: default, theme, user, etc.
  26       *
  27       * @since 6.1.0
  28       * @var string
  29       */
  30      private $origin = '';
  31  
  32      /**
  33       * Constructor.
  34       *
  35       * @since 6.1.0
  36       *
  37       * @link https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/
  38       *
  39       * @param array  $data   Array following the theme.json specification.
  40       * @param string $origin The origin of the data: default, theme, user.
  41       */
  42  	public function __construct( $data = array( 'version' => WP_Theme_JSON::LATEST_SCHEMA ), $origin = 'theme' ) {
  43          $this->origin     = $origin;
  44          $this->theme_json = new WP_Theme_JSON( $data, $this->origin );
  45      }
  46  
  47      /**
  48       * Updates the theme.json with the the given data.
  49       *
  50       * @since 6.1.0
  51       *
  52       * @param array $new_data Array following the theme.json specification.
  53       *
  54       * @return WP_Theme_JSON_Data The own instance with access to the modified data.
  55       */
  56  	public function update_with( $new_data ) {
  57          $this->theme_json->merge( new WP_Theme_JSON( $new_data, $this->origin ) );
  58          return $this;
  59      }
  60  
  61      /**
  62       * Returns an array containing the underlying data
  63       * following the theme.json specification.
  64       *
  65       * @since 6.1.0
  66       *
  67       * @return array
  68       */
  69  	public function get_data() {
  70          return $this->theme_json->get_raw_data();
  71      }
  72  
  73      /**
  74       * Returns theme JSON object.
  75       *
  76       * @since 6.6.0
  77       *
  78       * @return WP_Theme_JSON The theme JSON structure stored in this data object.
  79       */
  80  	public function get_theme_json() {
  81          return $this->theme_json;
  82      }
  83  }