Feedjoltdocs
DesarrolladoresWidget

Resumen del widget

Cómo funciona el widget de Feedjolt: una etiqueta script async monta un botón y carga un iframe aislado al hacer clic. Instalación, qué se carga y aislamiento.

El widget es una sola etiqueta <script> en tu página que descarga una pequeña configuración de tu espacio, monta un botón de lanzamiento y carga un iframe en lazy cuando el usuario hace clic. Hasta el clic, cero coste de iframe.

Instalación

<script async src="https://www.feedjolt.com/widget-loader.js"
        data-workspace="TU_SLUG_DE_ESPACIO"></script>

Eso es lo mínimo. Recarga la página; verás un botón flotante.

Qué se carga

  • widget-loader.js - ~5 KB. Lee tus atributos data-*, descarga /api/widget/embed/{workspace}/config, monta un botón.
  • El iframe - solo carga cuando el usuario hace clic en el botón. Alojado en https://www.feedjolt.com/{locale}/portal/{workspace}?mode=widget&.... Hasta el clic, sin carga de iframe.
  • postMessage entre marcos - usado por el iframe para pedir al padre que cierre o redimensione. Sin trackers de terceros.

Cómo se aísla de tu página

El widget corre en un <iframe>, así que su CSS, fuentes y JS están aislados de los tuyos. Tus estilos no pueden romper el widget; el widget no puede llegar a tu DOM.

Eso también significa que la personalización profunda de estilo es limitada. El color y la posición del botón vienen de tus ajustes por espacio; el contenido del iframe se tematiza con la misma paleta.

Hacia dónde

  • Configuración - los cinco atributos data-* y los ajustes del panel por espacio.
  • Personalización - lo que puedes ajustar hoy.
  • CSP - las directivas de Content Security Policy que necesita el widget.

On this page