Custom Integrations
Custom Integrations es un módulo opcional que permite añadir tus propios fragmentos de código en línea a la cabecera o al pie de página de tu tienda. A cada fragmento se le asigna una categoría de consentimiento y se emite a través de la barrera del Gestor de consentimiento, de modo que se ejecuta solo después de que el visitante haya otorgado esa categoría. Esto te permite cargar códigos de herramientas como Meta Pixel, TikTok, Matomo o Google Consent Mode de una forma que respeta la elección del visitante.
El código lo proporcionas tú mismo. El plugin no realiza ninguna petición HTTP saliente desde PHP y no incluye codificados de forma fija ningún endpoint de terceros. Son herramientas que te ayudan a cargar tus propios fragmentos de forma responsable, no constituyen asesoramiento legal ni garantizan por sí solas ningún resultado legal concreto.
Activar el módulo
Section titled “Activar el módulo”El módulo está desactivado de forma predeterminada. Actívalo en WooCommerce > Polski > Módulos (la sección “Custom Integrations”). Una vez activado, los fragmentos se emiten en la parte pública de la tienda, nunca en el área de administración. La gestión de los ajustes requiere la capacidad manage_woocommerce.
Cómo funciona
Section titled “Cómo funciona”Cada fragmento pasa por la barrera del Gestor de consentimiento. En lugar de un script ejecutable de inmediato, en la página se imprime un marcador de posición, y el controlador de front-end del Gestor de consentimiento lo sustituye por un script funcional solo después de que se haya otorgado la categoría correspondiente. Los fragmentos de la categoría “Necesarias” se activan siempre.
| Aspecto | Comportamiento |
|---|---|
| Ubicación | Los fragmentos de cabecera se imprimen en wp_head, los de pie de página en wp_footer (prioridad 30). |
| Solo parte pública | Los fragmentos nunca se imprimen en el área de administración. |
| Barrera de consentimiento | Cada fragmento pasa por la barrera del Gestor de consentimiento y espera a que se otorgue su categoría. |
| Necesarias | Los fragmentos de la categoría “Necesarias” se ejecutan siempre, sin esperar el consentimiento. |
| Sin tráfico PHP | El plugin no envía ninguna petición HTTP desde el servidor, solo se carga tu propio código. |
Campos del fragmento
Section titled “Campos del fragmento”La lista de fragmentos es repetible, por lo que puedes añadir tantos fragmentos como necesites. Cada fila tiene los siguientes campos:
| Campo | Descripción |
|---|---|
| Etiqueta | Un nombre legible para el fragmento, que te ayuda a reconocerlo en la lista. Opcional. |
| Ubicación | head o footer. El valor predeterminado es el pie de página. |
| Categoría de consentimiento | La categoría del Gestor de consentimiento que debe otorgarse antes de que el fragmento se ejecute. Un valor no reconocido se trata como “Necesarias”. |
| Código | El fragmento en sí. Las filas con código vacío se omiten. |
Cómo se trata el código
Section titled “Cómo se trata el código”Si tu fragmento está envuelto en una sola etiqueta <script>...</script>, se extrae su contenido interno y se pasa a la barrera como contenido del script. Si pegas JavaScript sin etiqueta, se trata como cuerpo de un script en línea. Cualquier marcado fuera de la etiqueta <script> se descarta, de modo que solo el contenido del script llega a la barrera (el marcador de posición permanece como text/plain hasta que se otorga el consentimiento).
Ajustes
Section titled “Ajustes”Los ajustes se encuentran en la tarjeta del módulo en WooCommerce > Polski > Módulos. La lista de fragmentos se almacena como un único ajuste repetible.
| Ajuste | Predeterminado | Descripción |
|---|---|---|
| Lista de fragmentos | (vacía) | Una lista repetible de fragmentos (etiqueta, ubicación, categoría, código). |
Resolución de problemas
Section titled “Resolución de problemas”Un fragmento no se ejecuta - comprueba si el visitante ha otorgado la categoría de consentimiento asignada a ese fragmento. Los fragmentos distintos de “Necesarias” esperan el consentimiento. Asegúrate también de que el Gestor de consentimiento esté activo.
Un fragmento no aparece en el código fuente de la página - asegúrate de que el campo de código no esté vacío y de que el módulo esté activado. Los fragmentos no se imprimen en el área de administración, así que compruébalos en la parte pública de la tienda.
Parte del código desaparece - solo el contenido del script llega a la barrera. El marcado y el código fuera de una sola etiqueta <script>...</script> se descartan. Pega JavaScript o envuélvelo en una sola etiqueta <script>.
Informar de problemas: github.com/wppoland/polski/issues