Ir para o conteúdo principal
Bethemesh

Documentação para programadores

Integrar Bethemesh Widgets

Guia completo para integrar uma ferramenta Bethemesh em HTML, WordPress, Webflow, Wix ou qualquer CMS que aceite iframes.

Início rápido

Adicione um contentor, indique o slug da ferramenta e carregue uma única vez o runtime versionado.

Integração recomendada
<div
  class="bethemesh-widget"
  data-tool="gerador-palavras-passe"
  data-lang="pt"
  data-theme="auto"
  data-min-height="560"
></div>
<script src="https://bethemesh.com/widgets/v1/bethemesh.js" async></script>

Iframe direto

Utilize o iframe direto gerado pelo configurador.

HTML
<iframe
  src="https://bethemesh.com/pt/embed/gerador-palavras-passe?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>

Opções disponíveis

AtributoFunçãoValor predefinido
data-toolSlug localizado do widget (obrigatório).
data-langIdioma da rota incorporada.pt
data-themeTema auto, light ou dark.auto
data-titleTítulo personalizado, máximo de 100 caracteres.Título da ferramenta
data-subtitleSubtítulo personalizado, máximo de 180 caracteres.
data-min-heightAltura inicial antes do redimensionamento automático.560
data-loadingCarregamento do iframe lazy ou eager.lazy

Eventos e redimensionamento automático

O runtime cria o iframe, escuta mensagens assinadas pela Bethemesh e ajusta automaticamente a altura. A API pública também pode inicializar widgets adicionados dinamicamente.

window.BethemeshWidgets.initialize()

Compatibilidade com CMS

WordPress / Elementor

Utilize um bloco HTML personalizado.

Webflow / Wix

Cole o código num componente Embed.

Shopify

Adicione uma secção Custom Liquid ou HTML.

HTML / Astro / React

Insira o contentor e carregue o script apenas uma vez.

Segurança

As permissões e os tokens sandbox são gerados a partir das capacidades declaradas por cada ferramenta. Não aumente manualmente estes direitos sem necessidade real.

Resolução de problemas

Vários widgets

Carregue bethemesh.js uma única vez, mesmo que a página contenha vários contentores.

Conteúdo dinâmico

Os widgets adicionados após o carregamento da página são detetados automaticamente. Também pode chamar BethemeshWidgets.initialize().

Scripts externos bloqueados

Utilize o iframe direto gerado pelo configurador.