Ir al contenido principal
Bethemesh

Documentación para desarrolladores

Integrar Bethemesh Widgets

Guía completa para integrar una herramienta Bethemesh en HTML, WordPress, Webflow, Wix o cualquier CMS que acepte iframe.

Inicio rápido

Añade un contenedor, indica el slug de la herramienta y carga una sola vez el runtime versionado.

Integración recomendada
<div
  class="bethemesh-widget"
  data-tool="generador-de-contrasenas"
  data-lang="es"
  data-theme="auto"
  data-min-height="560"
></div>
<script src="https://bethemesh.com/widgets/v1/bethemesh.js" async></script>

Iframe directo

Usa el iframe directo generado por el configurador.

HTML
<iframe
  src="https://bethemesh.com/es/embed/generador-de-contrasenas?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>

Opciones disponibles

AtributoFunciónValor predeterminado
data-toolSlug localizado del widget (obligatorio).
data-langIdioma de la ruta integrada.en
data-themeTema auto, light o dark.auto
data-titleTítulo personalizado, limitado a 100 caracteres.Título de la herramienta
data-subtitleSubtítulo personalizado, limitado a 180 caracteres.
data-min-heightAltura inicial antes del ajuste automático.560
data-loadingCarga lazy o eager del iframe.lazy

Eventos y redimensionamiento

El runtime crea el iframe, escucha los mensajes firmados por Bethemesh y ajusta automáticamente su altura. La API pública también inicializa widgets añadidos dinámicamente.

window.BethemeshWidgets.initialize()

Compatibilidad CMS

WordPress / Elementor

Usa un bloque HTML personalizado.

Webflow / Wix

Pega el código en un componente Embed.

Shopify

Añade una sección Liquid o HTML personalizado.

HTML / Astro / React

Inserta el contenedor y carga el script una vez.

Seguridad

Los permisos y el sandbox se generan a partir de las capacidades declaradas por cada herramienta. No amplíes estos derechos sin una necesidad real.

Solución de problemas

Varios widgets

Carga bethemesh.js una sola vez aunque la página contenga varios contenedores.

Contenido dinámico

Los widgets añadidos después de cargar la página se detectan automáticamente. También puedes llamar a BethemeshWidgets.initialize().

Scripts externos bloqueados

Usa el iframe directo generado por el configurador.