ControlsRegistry

Класс обертка на методом Controls_Stack::add_control, позволяет вместо добавления всех полей управления по одному с помощью метода add_control описать их все в массиве данных.

Для создания группы полей управления нужно наследоваться от класса ControlsRegistry и в конструкторе класса переопределить свойство ControlsRegistry::$controls, добавив в него массив данных, где ключом выступает id поля управления, а значением массив-конфигурация для создания поля.

Далее нужно воспользоваться методом Controls_Stack::add_controls( Controls_Stack $controls_stack ): Controls_Stack и передать в него виджет, к которому требуется добавить поля.

Например добавим класс для добавления поля логирования в виджет:

class ConsoleLog extends ControlsRegistry {  
   public function __construct( string $slug ) {  
      parent::__construct( $slug );  
  
      $this->controls = [  
         'log_text' => [  
            'label'     => 'Console.log',  
            'type'      => Controls_Manager::TEXT,  
            'condition' => [  
               $this->slug . '_action' => Type::LOG->value,  
            ],  
         ],  
      ];  
   }  
}

// Где-то в другом месте кода
(new ConsoleLog)->add_controls($widget);

Таким образом мы переходим от императивного программирования, в котором нужно указывать каждое действие, к декларативному, где нужно лишь указать конфигурацию, а как она будет обрабатываться нас уже не интересует

Для более удобного добавления полей управления на основе класса ControlsRegistry можно добавить фабрику классов, как например в Triggers/Actions/Fabric::get_control