array( 'type' => 'border', // Factory type, defined in \WPDRMS\AdminUI\OptionFactory /** * Default arguments passed to the factory constructor */ 'default_args' => array( 'width' => 2, 'color' => 'blue', ), ), 'sample_option_name2' => array( 'type' => 'shadow', ), ); /** * @var Array> */ protected array $args; /** * @var Array */ protected array $options; /** * @param array $data * @throws Exception */ public function __construct( array $data = array() ) { $this->setArgs($data); // This will initialize all options and populates the class properties $this->getAll(); } /** @param array $args */ public function setArgs( array $args, $merge = true ): self { $this->args = $merge ? array_merge($this->args ?? array(), $args) : $args; $this->options = array(); return $this; } /** * @param string $option_name * @return Option * @throws Exception */ public function get( string $option_name ): Option { if ( isset($this->options[ $option_name ]) ) { return $this->options[ $option_name ]; } if ( !isset(static::OPTIONS[ $option_name ]) ) { throw new Exception('Option key invalid!'); } if ( isset($this->args[ $option_name ]) ) { if ( is_string($this->args[ $option_name ]) ) { $args = json_decode($this->args[ $option_name ]); } else { $args = $this->args[ $option_name ]; } if ( isset(static::OPTIONS[ $option_name ]['default_args']) ) { // Only fill in default_args keys that are absent from stored args. // Existing stored keys win entirely — this prevents numeric arrays // (e.g. string_array 'value') from merging with default values. $args = array_merge( static::OPTIONS[ $option_name ]['default_args'], $args ); } } elseif ( isset(static::OPTIONS[ $option_name ]['default_args']) ) { $args = static::OPTIONS[ $option_name ]['default_args']; } else { $args = array(); } $this->options[ $option_name ] = OptionFactory::instance()->create( static::OPTIONS[ $option_name ]['type'], $args ); if ( !property_exists($this, $option_name) ) { // phpcs:ignore throw new Exception( "Property '$option_name' should explicitly exist in " . get_class($this) . '! Please define it!' // phpcs:ignore ); } unset($this->{$option_name}); $this->{$option_name} = $this->options[ $option_name ]; return $this->options[ $option_name ]; } /** * @return Option[] * @throws Exception */ public function getAll(): array { foreach ( static::OPTIONS as $key => $option ) { $this->get( $key ); } return $this->options; } public function getDefault( string $option_name ): Option { if ( !isset(static::OPTIONS[ $option_name ]) ) { throw new Exception('Option key invalid!'); } if ( isset(static::OPTIONS[ $option_name ]['default_args']) ) { $args = static::OPTIONS[ $option_name ]['default_args']; } else { $args = array(); } return OptionFactory::instance()->create( static::OPTIONS[ $option_name ]['type'], $args ); } /** * @return Option[] * @throws Exception */ public function getDefaults(): array { $options = array(); foreach ( static::OPTIONS as $key => $option ) { $options[] = $this->getDefault( $key ); } return $options; } public function jsonSerialize(): array { try { return array_map( function ( Option $o ) { return $o->jsonSerialize(); }, $this->getAll() ); } catch ( Exception $e ) { return array(); } } public function toJson(): string { try { $res = wp_json_encode($this->getAll()); } catch ( Exception $e ) { return '{}'; } return $res === false ? '{}' : $res; } }