⚙️ HelperOptions — pagina de configuracion global

<?php

// En un AdminController (extends AdminController)
public function __construct()
{
    $this->table        = 'configuration';
    $this->identifier   = 'id_configuration';
    $this->className    = 'Configuration';
    $this->bootstrap    = true;
    $this->fields_options = [
        // ── GRUPO 1 ──
        'general' => [
            'title'  => $this->l('Configuracion General'),
            'icon'   => 'icon-cogs',
            'fields' => [
                'MY_MODULE_API_KEY' => [
                    'title'      => $this->l('API Key'),
                    'hint'       => $this->l('Clave de API del proveedor'),
                    'type'       => 'text',
                    'size'       => 60,
                    'required'   => true,
                    'class'      => 'fixed-width-xxl',
                    'validation' => 'isGenericName',
                ],
                'MY_MODULE_ACTIVE' => [
                    'title'      => $this->l('Activar servicio'),
                    'type'       => 'bool',
                    'required'   => false,
                ],
            ],
            'submit' => ['title' => $this->l('Guardar')],
        ],
        // ── GRUPO 2 ──
        'advanced' => [
            'title'  => $this->l('Opciones Avanzadas'),
            'icon'   => 'icon-wrench',
            'fields' => [
                'MY_MODULE_MODE' => [
                    'title'      => $this->l('Modo de operacion'),
                    'type'       => 'select',
                    'list'       => [
                        ['id' => 'sandbox',    'name' => 'Sandbox (Pruebas)'],
                        ['id' => 'production', 'name' => 'Produccion'],
                    ],
                    'identifier' => 'id',
                    'validation' => 'isCleanHtml',
                ],
                'MY_MODULE_TIMEOUT' => [
                    'title'      => $this->l('Timeout (segundos)'),
                    'type'       => 'text',
                    'size'       => 5,
                    'validation' => 'isUnsignedInt',
                    'cast'       => 'intval',
                ],
            ],
            'submit' => ['title' => $this->l('Guardar opciones avanzadas')],
        ],
    ];

    parent::__construct();
}

<?php

// En el AdminController
public function postProcess(): void
{
    // HelperOptions genera un submit_btn con nombre 'submitOptions{tabla}'
    // Para tabla='configuration', es 'submitOptionsconfiguration'
    if (Tools::isSubmit('submitOptionsconfiguration')) {
        // Iterar los grupos y campos para guardar
        foreach ($this->fields_options as $group) {
            foreach ($group['fields'] as $key => $field) {
                $value = Tools::getValue($key);

                // Aplicar cast si existe
                if (isset($field['cast'])) {
                    $value = $field['cast']($value);
                }

                // Validar si existe
                if (isset($field['validation'])) {
                    $method = $field['validation'];
                    if (!Validate::$method($value)) {
                        $this->errors[] = $this->l('Valor invalido para: ') . $field['title'];
                        continue;
                    }
                }

                Configuration::updateValue($key, $value);
            }
        }

        if (empty($this->errors)) {
            $this->confirmations[] = $this->l('Configuracion guardada correctamente.');
        }
    }

    parent::postProcess();
}