--- title: displayBackOfficeHeader section: hooks slug: displayBackOfficeHeader hook_type: display category: display-admin location: BO since_version: 1.5 source_url: "https://ayudaprestashop.es/hooks/displayBackOfficeHeader" --- # Hook `displayBackOfficeHeader` | Propiedad | Valor | | --- | --- | | Tipo | Display | | Localizacion | BO | | Categoria | display-admin | | Desde version | 1.5 | ## Descripcion Permite inyectar contenido en el 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. ## Valor de retorno - **Tipo**: `string` - **Descripcion**: HTML que se inyecta en el del back office ## Disparado por | Contexto | Clase | Metodo | Fichero | | --- | --- | --- | --- | | AdminController | `AdminControllerCore` | `initHeader()` | `classes/controller/AdminController.php` | **Paginas**: `all-admin-pages` ## Registro del hook ```php public function install() { return parent::install() && $this->registerHook('displayBackOfficeHeader'); } ``` ## Ejemplo de uso ```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 ''; } ``` ## 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. ## Hooks relacionados - [`displayAdminAfterHeader`](https://ayudaprestashop.es/hooks/displayAdminAfterHeader) - [`displayAdminEndContent`](https://ayudaprestashop.es/hooks/displayAdminEndContent) - [`displayBackOfficeFooter`](https://ayudaprestashop.es/hooks/displayBackOfficeFooter) - [`actionAdminControllerSetMedia`](https://ayudaprestashop.es/hooks/actionAdminControllerSetMedia) ## Guias relacionadas - [admin/helperform](https://ayudaprestashop.es/admin/helperform) - [admin/admin-hooks](https://ayudaprestashop.es/admin/admin-hooks) - [modules/main-file](https://ayudaprestashop.es/modules/main-file) ## Historial de versiones | Version | Cambio | | --- | --- | | 1.5 | Introducido para inyeccion en el head del BO | | 1.7 | El admin migra a Symfony/Bootstrap 4 — considerar compatibilidad CSS | --- *Fuente: [https://ayudaprestashop.es/hooks/displayBackOfficeHeader](https://ayudaprestashop.es/hooks/displayBackOfficeHeader). Version Markdown generada automaticamente para consumo por LLMs.*