Pretty URLs para modulos — hookModuleRoutes

<?php

public function install(): bool
{
    return parent::install()
        && $this->registerHook('moduleRoutes'); // DEBE estar en install
}

<?php

/**
 * Define las rutas Pretty URL del modulo.
 * Se ejecuta en CADA peticion — mantenerlo ligero.
 */
public function hookModuleRoutes(): array
{
    return [
        // Clave unica: module-{modulo}-{nombre}
        'module-mymodule-list' => [
            'rule'       => 'mi-seccion/lista',    // La URL publica
            'keywords'   => [],                    // Sin parametros dinamicos
            'controller' => 'list',                // controllers/front/list.php
            'params'     => [
                'fc'     => 'module',
                'module' => $this->name,
            ],
        ],
        'module-mymodule-page' => [
            'rule'       => 'mi-seccion/pagina',
            'keywords'   => [],
            'controller' => 'page',
            'params'     => [
                'fc'     => 'module',
                'module' => $this->name,
            ],
        ],
    ];
}

<?php

public function hookModuleRoutes(): array
{
    return [
        'module-mymodule-view' => [
            // {id} y {slug} son parametros capturados de la URL
            'rule'     => 'fichas/{id}-{slug}',
            'keywords' => [
                'id' => [
                    'regexp' => '[0-9]+',               // Solo numeros
                    'param'  => 'id',                   // $_GET['id']
                ],
                'slug' => [
                    'regexp' => '[_a-zA-Z0-9\-\.]+',   // Slug URL-safe
                    'param'  => 'slug',                 // $_GET['slug']
                ],
            ],
            'controller' => 'view',    // controllers/front/view.php
            'params'     => [
                'fc'     => 'module',
                'module' => $this->name,
            ],
        ],
        // URL resultante: /fichas/42-mi-producto-titulo
    ];
}

<?php

// getModuleLink('module', 'controller', $params)
$link = $this->context->link;

// Ruta simple sin parametros
$listUrl = $link->getModuleLink('mymodule', 'list');
// Output: https://tienda.com/mi-seccion/lista

// Ruta con parametros dinamicos
$viewUrl = $link->getModuleLink('mymodule', 'view', [
    'id'   => 42,
    'slug' => 'mi-producto-titulo',
]);
// Output: https://tienda.com/fichas/42-mi-producto-titulo

// Desde dentro del FrontController:
$url = $this->context->link->getModuleLink(
    $this->module->name,
    'list'
);

{* URL del listado sin parametros *}
{url entity='module' name='mymodule' controller='list'}

{* URL con parametros *}
{url entity='module' name='mymodule' controller='view' params=['id' => $item.id, 'slug' => $item.slug]}

# Limpiar cache de Symfony (incluye rutas)
php bin/console cache:clear --env=prod

# Limpiar cache de Smarty (si hay templates cacheados)
rm -rf var/cache/prod/
rm -rf cache/smarty/compile/