Configuració del widget

Els atributs data-* que llegeix el carregador del widget de Feedjolt: workspace, tauler, tema, token SSO i URL de l'API. La resta es configura al panell.

El loader del widget llegeix un petit conjunt d'atributs data-* a l'etiqueta del script. La resta (text del botó, posició, color de marca, actiu/inactiu) es configura per espai a Panell -> Configuració -> Widget i es descarrega des de /api/widget/embed/{workspace}/config en temps d'execució.

Aquesta separació és intencional: el snippet per pàgina queda mínim, i els rebrands o canvis de copy no requereixen redesplegar cada pàgina.

Atributs a l'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>

Atribut	Obligatori	Notes
`data-workspace`	sí	El teu slug d'espai. Sense això el loader registra un error i surt.
`data-board`	no	Slug d'un tauler per defecte al qual enllaçar en obrir el widget. El selector encara mostra altres taulers.
`data-theme`	no	`light`, `dark` o `auto`. Sobreescriu el per defecte de l'espai.
`data-sso-token`	no	Un JWT identificant l'usuari amb sessió - veure SSO a baix.
`data-api-url`	no	Sobreescriu la URL base d'API inferida. Útil per a instal·lacions auto-allotjades o staged.

Si les teves necessitats no es cobreixen amb aquests cinc atributs, configura la resta a Configuració -> Widget.

Ajustos per espai (panell)

La configuració descarregada en runtime conté:

launcher_text - l'etiqueta del botó.
launcher_position - bottom-right o bottom-left.
primary_color - fet servir com a fons del botó.
is_active - interruptor de desactivació. Si és false, el loader surt aviat; no es renderitza res.

Això es propaga a cada instal·lació del widget per a aquell espai, sense canvis de script.

SSO via `data-sso-token`

Passa un JWT a data-sso-token per autenticar l'usuari dins el widget. El token es reenvia com a paràmetre ssoToken a l'iframe del portal, que llavors inicia sessió a l'usuari en una sessió de Feedjolt.

El format del token i l'esquema de firma encara no estan documentats públicament - els estem finalitzant. Fins llavors, la ruta recomanada és deixar data-sso-token buit; els usuaris iniciaran sessió amb magic link dins el widget si volen votar o comentar.

Idioma

El widget llegeix l'idioma de <html lang="..."> - en, es o ca. Si no es reconeix, per defecte a en. No hi ha atribut data-locale avui - estableix l'atribut lang de la pàgina en el seu lloc.

Control programàtic

window.feedjolt.open() i similars no s'exposen avui. El botó de llançament és el punt d'entrada. Si vols un botó personalitzat, envia'ns feedback - segons la demanda, podríem llançar una petita API JS.