Vai al contenuto principale
Bethemesh

Documentazione per sviluppatori

Integrare Bethemesh Widgets

Guida completa per integrare uno strumento Bethemesh in HTML, WordPress, Webflow, Wix o qualsiasi CMS che accetti iframe.

Torna ai widgetRuntime v1

Avvio rapido

Aggiungi un contenitore, indica lo slug dello strumento e carica una sola volta il runtime versionato.

Integrazione consigliata
<div
  class="bethemesh-widget"
  data-tool="generatore-password"
  data-lang="it"
  data-theme="auto"
  data-min-height="560"
></div>
<script src="https://bethemesh.com/widgets/v1/bethemesh.js" async></script>

Iframe diretto

Usa l’iframe diretto generato dal configuratore.

HTML
<iframe
  src="https://bethemesh.com/it/embed/generatore-password?theme=auto"
  title="Bethemesh widget"
  width="100%"
  height="560"
  loading="lazy"
  sandbox="allow-scripts allow-same-origin"
  style="border:0;display:block;width:100%"
></iframe>

Opzioni disponibili

AttributoFunzioneValore predefinito
data-toolSlug localizzato del widget (obbligatorio).
data-langLingua della route incorporata.it
data-themeTema auto, light o dark.auto
data-titleTitolo personalizzato, massimo 100 caratteri.Titolo dello strumento
data-subtitleSottotitolo personalizzato, massimo 180 caratteri.
data-min-heightAltezza iniziale prima del ridimensionamento automatico.560
data-loadingCaricamento iframe lazy o eager.lazy

Eventi e ridimensionamento automatico

Il runtime crea l’iframe, ascolta i messaggi firmati Bethemesh e ne adatta automaticamente l’altezza. L’API pubblica può anche inizializzare widget aggiunti dinamicamente.

window.BethemeshWidgets.initialize()

Compatibilità CMS

WordPress / Elementor

Usa un blocco HTML personalizzato.

Webflow / Wix

Incolla il codice in un componente Embed.

Shopify

Aggiungi una sezione Custom Liquid o HTML.

HTML / Astro / React

Inserisci il contenitore e carica lo script una sola volta.

Sicurezza

Autorizzazioni e token sandbox vengono generati dalle capacità dichiarate da ogni strumento. Non ampliare manualmente questi diritti senza una necessità reale.

Risoluzione dei problemi

Più widget

Carica bethemesh.js una sola volta, anche se la pagina contiene più contenitori.

Contenuto dinamico

I widget aggiunti dopo il caricamento della pagina vengono rilevati automaticamente. Puoi anche chiamare BethemeshWidgets.initialize().

Script esterni bloccati

Usa l’iframe diretto generato dal configuratore.