crear-controlador

Skill: Crear Controlador FacturaScripts

Cuando el usuario pida crear un controlador, determina el tipo adecuado y genera el código.

Atajo con fsmaker

Antes de crear los archivos a mano, considera usar la herramienta CLI:

fsmaker controller

fsmaker solicita el nombre del controlador, el tipo (ListController, EditController, etc.) y genera el PHP y el XMLView asociado. Los apartados siguientes documentan la estructura completa para cuando necesites crearlos o ajustarlos manualmente.

Tipos de controlador

Tipo	Uso	Nombre convención
Controller	Página personalizada con vista HTML Twig libre	NombreLibre
ListController	Listado de registros con filtros	ListNombreModelo
EditController	Formulario de edición de un registro	EditNombreModelo
PanelController	Combinación de vistas (cabecera + pestañas)	EditNombreModelo

Controller (vista HTML Twig)

Usar cuando se necesita una página completamente personalizada con una plantilla .html.twig en lugar de un XMLView. Ideal para dashboards, páginas de configuración visual, formularios custom, etc.

Archivo PHP: Plugins/MiPlugin/Controller/MiPagina.php

<?php

namespace FacturaScripts\Plugins\MiPlugin\Controller;

use FacturaScripts\Core\Template\Controller;

class MiPagina extends Controller
{
    // Propiedades públicas accesibles desde la vista con {{ fsc.miPropiedad }}
    public string $miVariable = '';

    public function getPageData(): array
    {
        $data = parent::getPageData();
        $data['title'] = 'mi-pagina';    // clave de traducción
        $data['menu'] = 'admin';         // ventas, purchases, accounting, admin...
        $data['icon'] = 'fas fa-home';
        // $data['showonmenu'] = false;  // descomentar para ocultar del menú
        return $data;
    }

    public function run(): void
    {
        parent::run();

        // Leer parámetros de URL o formulario
        $id = $this->request->query('id');
        $valor = $this->request->input('campo');

        // Asignar datos que la vista usará como {{ fsc.miVariable }}
        $this->miVariable = 'Hola mundo';

        // Seleccionar la plantilla (por defecto usa el nombre de la clase)
        $this->setTemplate('MiPagina'); // carga View/MiPagina.html.twig
    }
}