Preferencias de la aplicación

En esta página, ubicada en el menú Administrador->Panel de Control->Preferencias de aplicación, los valores se agrupan en pestañas según el plugin o grupo de datos al que pertenecen.

El controlador que lo gestiona es EditSettings, un controlador extendido que hereda de PanelController, lo que significa que usa las vistas xml para su diseño, donde el nombre del archivo xml debe empezar por el prefijo Settings seguido del nombre del apartado que deseamos agregar a EditSettings. La carga de las distintas pestañas que se visualizan en EditSettings se realiza de manera automática no necesitando controladores adicionales para gestionar el tratamiento de los settings de nuestro plugin.

   default -> SettingsDefault.xml
   email -> SettingsEmail.xml
   logs -> SettingsLog.xml

   myplugin -> SettingsMyPlugin.xml

Al definir el archivo settings de la vista XML usaremos las normas de columnas y grupos y siempre debemos incluir una columna oculta denominada 'name' necesaria como identificador interno.

    <column name='name' display='none' order='0'>
        <widget type='text' fieldname='name' readonly='true' required='true' />
    </column>

También podemos añadir botones de accion para acciones especiales y footers y/o headers. Para el caso de añadir botones de acciones necesitaríamos crear un controlador dentro de nuestro plugin heredando de EditSettings donde implementaremos las acciones especiales deseadas.

    class EditMySettings extends EditSettings
    {
        protected function execAfterAction($action)
        {
            switch ($action) {
                case 'my-action':
                    [ ... ]
                    break;

                default:
                    parent::execAfterAction($action);
                    break;
            }
        }
    }