DISPLAY BO Desde 1.5

displayBackOfficeHeader

~3 min de lectura

#Descripcion

Permite inyectar contenido en el `<head>` del back office de PrestaShop. Utilizado para añadir CSS personalizado, scripts de administracion, meta tags y estilos que modifiquen la apariencia del panel de administracion. Se ejecuta en TODAS las paginas del back office.

📍

Disparado por

AdminControllerCore::initHeader() — classes/controller/AdminController.php

#Parametros

Este hook no recibe parametros via $params.

#Ejemplo de codigo

mymodule.php

php

public function install()
{
    return parent::install()
        && $this->registerHook('displayBackOfficeHeader');
}

mymodule.php

php

/**
 * Hook displayBackOfficeHeader — CSS/JS en el admin
 */
public function hookDisplayBackOfficeHeader($params)
{
    // Solo cargar en la pagina de nuestro modulo
    if (Tools::getValue('configure') !== $this->name
        && Tools::getValue('module_name') !== $this->name) {
        return '';
    }

    $this->context->controller->addCSS(
        $this->_path . 'views/css/admin.css'
    );
    $this->context->controller->addJS(
        $this->_path . 'views/js/admin.js'
    );

    // Variables JS para AJAX
    return '<script>var myModuleAjaxUrl = "'
        . $this->context->link->getAdminLink('AdminModules', true, [], [
            'configure' => $this->name,
            'ajax' => 1
        ])
        . '";</script>';
}

#Notas y gotchas

⚠️ Se ejecuta en TODAS las paginas del admin. Filtra siempre con `Tools::getValue('configure')` para no cargar CSS/JS innecesario.
⚠️ Para PS 1.7+, tambien puedes usar `actionAdminControllerSetMedia` como alternativa mas moderna.
⚠️ No cargues librerias pesadas (jQuery UI, Chart.js, etc.) en todas las paginas — condiciona al controlador.
⚠️ El CSS del admin usa Bootstrap 4 (PS 1.7+) — evita conflictos con tus estilos.
⚠️ Si necesitas inyectar contenido en el BODY del admin, usa `displayAdminAfterHeader` o `displayAdminEndContent`.

#Relacionados

#Historial de versiones

Version PS	Cambio
1.5	Introducido para inyeccion en el head del BO
1.7	El admin migra a Symfony/Bootstrap 4 — considerar compatibilidad CSS

← Volver Todos los hooks Ver tambien → Vista tabla periodica

Descargar en Markdown Pensado para pegar en ChatGPT, Claude u otra IA. Incluye solo el contenido de esta pagina.