Inyector de código Header/Footer (CSS/JS): guía completa
Instalar, configurar y usar la inyección de código CSS/JS/HTML: ubicaciones, segmentación por página, modo prueba, duplicación y multitienda para PrestaShop 8 y 9.
Presentación
El Inyector de código Header/Footer añade código CSS, JavaScript o HTML a tu tienda PrestaShop sin modificar los archivos del tema. Cada bloque de código es un snippet gestionado desde el back-office, con su ubicación, sus páginas, su orden de inyección y su estado.
Usos habituales: Google Tag Manager, Google Analytics, Meta Pixel, etiquetas de verificación (Search Console, Pinterest), CSS personalizado, widget de chat.
Instalación
- Descarga el archivo
dfcodeinjector.zipdesde tu cuenta DataFirefly. - En el back-office, abre Módulos > Gestor de módulos, haz clic en Subir un módulo y suelta el archivo.
- Haz clic en Configurar para abrir la lista de snippets.
Compatible con PrestaShop 8.0 a 9.x y multitienda. Interfaz disponible en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.
Actualizar desde la versión 1.0.0
Sube el nuevo archivo desde el gestor de módulos: la actualización se ejecuta automáticamente y tus snippets se conservan. Un snippet que estaba limitado a ciertas páginas pasa a la segmentación Solo las páginas seleccionadas, los demás a Todas las páginas.
Crear un snippet
En la lista, haz clic en Añadir un snippet.
Campos del formulario
- Nombre: nombre interno, por ejemplo «Google Tag Manager».
- Ubicación: dónde se inyecta el código (ver más abajo).
- Código: el código completo, etiquetas incluidas. Se inyecta tal cual. En este campo, la tecla Tab inserta 4 espacios; pulsa Escape y luego Tab para pasar al campo siguiente.
- Segmentación, Páginas y Otras páginas: las páginas en las que se aplica el snippet.
- Orden: orden de inyección dentro de una misma ubicación. Si se deja vacío, el snippet se coloca al final.
- Modo prueba: limita la inyección a las direcciones IP de mantenimiento.
- Activo: activa o desactiva el snippet sin eliminarlo.
- Tienda (solo multitienda): todas las tiendas o una sola.
Las tres ubicaciones
- Header (etiqueta head): estilos, etiquetas meta, etiquetas de verificación, script principal de GTM. Hook
displayHeader. - Inicio del body: justo después de la apertura del body, para la parte noscript de GTM. Hook
displayAfterBodyOpeningTag. - Fin del body: justo antes del cierre del body, para los scripts de seguimiento y de chat. Hook
displayBeforeBodyClosingTag.
Si tu tema no llama a los hooks de inicio o fin del body, el módulo inserta el código directamente en el HTML final de la página, en el mismo lugar (hook actionOutputHTMLBefore). Las tres ubicaciones funcionan por tanto con todos los temas, sin ningún ajuste.
Segmentación por página
El campo Segmentación ofrece tres modos: Todas las páginas, Solo las páginas seleccionadas o Todas las páginas excepto las seleccionadas.
La lista Páginas contiene 30 páginas de PrestaShop: inicio, categoría, ficha de producto, CMS, búsqueda, carrito, proceso de compra, confirmación de pedido, inicio de sesión, mi cuenta, historial de pedidos, contacto, página 404, etc. El campo Otras páginas acepta otros nombres técnicos de página, separados por comas. Para una página de módulo, el formato es module-nombredelmodulo-controlador.
Para conocer el nombre técnico de una página, consulta su código fuente: en el tema Classic y sus derivados es el atributo id de la etiqueta body.
Modo prueba
Un snippet en modo prueba solo se inyecta para las direcciones IP introducidas en el campo IP de mantenimiento de la página Mantenimiento de los parámetros de la tienda. Se aceptan rangos en formato CIDR. Así compruebas una etiqueta en la tienda en línea sin que ningún visitante la reciba y luego desactivas el modo prueba para publicarla.
Duplicar un snippet
El menú de cada fila de la lista ofrece Duplicar. La copia se crea desactivada y se coloca al final: revísala antes de activarla.
Ejemplos
Google Tag Manager
GTM se instala con dos snippets:
- «GTM head», ubicación Header, con el primer script facilitado por Google:
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){ ... })(window,document,'script','dataLayer','GTM-XXXXXX');</script>
<!-- End Google Tag Manager -->
- «GTM body», ubicación Inicio del body, con la parte noscript facilitada por Google.
Píxel de conversión
Ubicación Fin del body, segmentación Solo las páginas seleccionadas, página Confirmación de pedido. El píxel solo se activa después de una compra.
CSS personalizado
Ubicación Header, con el CSS dentro de una etiqueta style:
<style>
.header-banner { background:#0f172a; color:#fff; }
</style>
Etiqueta de verificación
Para Search Console o una red social, ubicación Header:
<meta name="google-site-verification" content="TU_CODIGO" />
Multitienda
Con la multitienda activada, el campo Tienda permite mostrar un snippet en todas las tiendas o en una sola. En una instalación de una sola tienda, el campo está oculto y el snippet se aplica a toda la tienda.
Solución de problemas
- El código no aparece: comprueba que el snippet está activo, que el modo prueba está desactivado (o que tu IP figura en las IP de mantenimiento) y que la página actual forma parte de la segmentación.
- Hay un módulo de caché de páginas instalado: vacía su caché después de cada cambio de snippet.
- El snippet no aparece en una página de módulo: comprueba el nombre técnico introducido en Otras páginas, debe coincidir exactamente con el de la página.
- Dos scripts se ejecutan en el orden equivocado: ajusta el campo Orden.
El código se inyecta sin ningún filtrado. Comprueba su sintaxis (etiquetas bien cerradas) y usa el modo prueba antes de activarlo en una tienda en producción.