Configuración del widget

Los atributos data-* que lee el cargador del widget de Feedjolt: workspace, tablero, tema, token SSO y URL de la API. El resto se configura en el panel.

El loader del widget lee un pequeño conjunto de atributos data-* en la etiqueta del script. Lo demás (texto del botón, posición, color de marca, activo/inactivo) se configura por espacio en Panel -> Ajustes -> Widget y se descarga desde /api/widget/embed/{workspace}/config en tiempo de ejecución.

Esta separación es intencional: el snippet por página queda mínimo, y los rebrands o cambios de copy no requieren redesplegar cada página.

Atributos en la etiqueta del script

<script async src="https://www.feedjolt.com/widget-loader.js"
        data-workspace="acme"
        data-board="feature-requests"
        data-theme="auto"
        data-sso-token="JWT_AQUI"
        data-api-url="https://api.feedjolt.com/api"></script>

Atributo	Obligatorio	Notas
`data-workspace`	sí	Tu slug de espacio. Sin esto el loader registra un error y sale.
`data-board`	no	Slug de un tablero por defecto al que enlazar al abrir el widget. El selector aún muestra otros tableros.
`data-theme`	no	`light`, `dark` o `auto`. Sobrescribe el por defecto del espacio.
`data-sso-token`	no	Un JWT identificando al usuario con sesión - ver SSO abajo.
`data-api-url`	no	Sobrescribe la URL base de API inferida. Útil para instalaciones auto-hospedadas o staged.

Si tus necesidades no se cubren con estos cinco atributos, configura el resto en Ajustes -> Widget.

Ajustes por espacio (panel)

La configuración descargada en runtime contiene:

launcher_text - la etiqueta del botón.
launcher_position - bottom-right o bottom-left.
primary_color - usado como fondo del botón.
is_active - interruptor de desactivación. Si es false, el loader sale temprano; no se renderiza nada.

Esto se propaga a cada instalación del widget para ese espacio, sin cambios de script.

SSO vía `data-sso-token`

Pasa un JWT en data-sso-token para autenticar al usuario dentro del widget. El token se reenvía como parámetro ssoToken al iframe del portal, que entonces inicia sesión al usuario en una sesión de Feedjolt.

El formato del token y el esquema de firma aún no están documentados públicamente - los estamos finalizando. Hasta entonces, la ruta recomendada es dejar data-sso-token vacío; los usuarios iniciarán sesión con magic link dentro del widget si quieren votar o comentar.

Idioma

El widget lee el idioma de <html lang="..."> - en, es o ca. Si no se reconoce, por defecto a en. No hay atributo data-locale hoy - establece el atributo lang de la página en su lugar.

Control programático

window.feedjolt.open() y similares no se exponen hoy. El botón de lanzamiento es el punto de entrada. Si quieres un botón personalizado, mándanos feedback - según la demanda, podríamos lanzar una pequeña API JS.