Gestión de menús del Back Office

manuelhub

Hola a todos,

Estoy intentando añadir un nuevo elemento de menú personalizado en el Back Office de PrestaShop 8.0.2 para una herramienta interna, pero me estoy volviendo loco. He probado con un override en AdminTabsController y también intentando registrar un hook en la instalación de un módulo, pero siempre hay problemas. O no aparece el menú, o se rompe la instalación al actualizar PrestaShop.

Mi último intento fue en el método install() de mi módulo. Quiero que aparezca como un nuevo elemento principal o al menos dentro de una categoría existente pero de forma organizada.

Aquí tenéis el código que estoy usando para intentar registrar la pestaña. La idea era que apareciera como un menú principal, pero no funciona y no sé si el id_parent es el problema o si es la forma incorrecta de hacerlo en PS 8 con Symfony:

public function install()
{
    if (!parent::install()) {
        return false;
    }

    $tab = new Tab();
    $tab->active = 1;
    $tab->class_name = 'AdminMyCustomMenu';
    $tab->name = array_fill_keys(Language::getLanguages(false, false), 'Mi Menú Personalizado');
    $tab->id_parent = (int)Tab::getIdFromClassName('TOP'); // ¿Este es el problema?
    $tab->module = $this->name;
    
    if (!$tab->add()) {
        return false;
    }
    return true;
}

¿Alguna idea de por qué Tab::getIdFromClassName('TOP') podría no ser lo que busco o si hay una forma más robusta de gestionar esto?

nuria_tienda

@manuelhub entiendo perfectamente la frustración. El manejo de las pestañas en PrestaShop siempre ha sido un poco delicado, y con las últimas versiones y Symfony, se ha complicado aún más.

Respecto a tu código, Tab::getIdFromClassName('TOP') no es el ID correcto para crear un menú de nivel superior. 'TOP' es más una referencia simbólica para ciertas operaciones, pero no el id_parent real para un menú principal. Para eso, generalmente se usa 0 o el ID de una de las categorías principales de PrestaShop si quieres anidarlo.

¿Qué versión exacta de PrestaShop estás usando? Saberlo podría ayudar a afinar la solución, aunque en general, esa es la lógica.

Milo

Hola @manuelhub y @nuria_tienda,

Confirmado, el problema principal con el código que presentas es precisamente el id_parent. Como bien apunta @nuria_tienda, Tab::getIdFromClassName('TOP') no te dará el resultado esperado para un menú de nivel superior en el Back Office. Para que una pestaña aparezca como un menú principal, su id_parent debe ser 0 (para un menú raíz totalmente nuevo) o el ID de una de las grandes categorías principales existentes si quieres agruparla bajo algo como 'Configurar' o 'Ventas'.

Si quieres que tu menú aparezca, por ejemplo, bajo la sección 'Configurar' (donde suelen ir los módulos), el id_parent correcto sería el de 'AdminParentModules'. Aquí te dejo una corrección a tu método install() que debería funcionar:

public function install()
{
    if (!parent::install()) {
        return false;
    }

    $tab = new Tab();
    $tab->active = 1;
    $tab->class_name = 'AdminMyCustomMenu';
    $tab->name = array_fill_keys(Language::getLanguages(false, false), 'Mi Menú Personalizado');
    $tab->id_parent = (int)Tab::getIdFromClassName('AdminParentModules'); // Esto la coloca bajo 'Configurar'
    $tab->module = $this->name;
    
    if (!$tab->add()) {
        return false;
    }
    return true;
}

Con esta modificación, tu pestaña AdminMyCustomMenu debería aparecer bajo el menú 'Configurar'. Recuerda que después de instalar el módulo, a veces hay que limpiar la caché o incluso revisar los permisos de los empleados para que el nuevo menú sea visible.

Para una gestión más avanzada y sin tener que tocar código directamente en cada instalación o actualización, te recomiendo usar un módulo para administrador de menú. Estos módulos están diseñados para añadir, editar, mover y eliminar elementos del menú de forma visual desde el Back Office, evitando así overrides frágiles que se rompen con las actualizaciones de PrestaShop.

manuelhub

¡Muchísimas gracias, @Milo! Esa fue la clave. Cambiar el id_parent a (int)Tab::getIdFromClassName('AdminParentModules') hizo que el menú apareciera exactamente donde quería, bajo 'Configurar'. Revisé los permisos y todo estaba bien, así que era puramente el id_parent.

Voy a probar también el módulo que mencionas, suena a una solución mucho más limpia y mantenible a largo plazo para no tener que estar parcheando código cada vez. ¡Un saludo y gracias de nuevo a ambos!