Aller au contenu principal
Bethemesh

Documentation développeur

Intégrer Bethemesh Widgets

Guide complet pour intégrer un outil Bethemesh dans un site HTML, WordPress, Webflow, Wix ou tout CMS acceptant une iframe.

Démarrage rapide

Ajoutez un conteneur, indiquez le slug de l’outil, puis chargez une seule fois le runtime versionné.

Intégration recommandée
<div
  class="bethemesh-widget"
  data-tool="generateur-de-mot-de-passe"
  data-lang="fr"
  data-theme="auto"
  data-min-height="560"
></div>
<script src="https://bethemesh.com/widgets/v1/bethemesh.js" async></script>

Iframe directe

Utilisez l’iframe directe proposée dans le configurateur.

HTML
<iframe
  src="https://bethemesh.com/fr/embed/generateur-de-mot-de-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>

Options disponibles

AttributRôleValeur par défaut
data-toolSlug localisé du widget (obligatoire).
data-langLangue de la route embarquée.en
data-themeThème auto, light ou dark.auto
data-titleTitre personnalisé, limité à 100 caractères.Titre de l’outil
data-subtitleSous-titre personnalisé, limité à 180 caractères.
data-min-heightHauteur initiale avant le redimensionnement automatique.560
data-loadingChargement lazy ou eager de l’iframe.lazy

Événements et redimensionnement

Le runtime crée l’iframe, écoute les messages signés Bethemesh et ajuste automatiquement sa hauteur. L’API publique permet aussi d’initialiser des widgets ajoutés dynamiquement.

window.BethemeshWidgets.initialize()

Compatibilité CMS

WordPress / Elementor

Utilisez un bloc HTML personnalisé.

Webflow / Wix

Collez le code dans un composant Embed.

Shopify

Ajoutez une section Liquid ou HTML personnalisé.

HTML / Astro / React

Insérez le conteneur dans le markup et chargez le script une fois.

Sécurité

Les permissions et le sandbox sont générés à partir des capacités déclarées par chaque outil. N’élargissez pas manuellement ces droits sans besoin réel.

Dépannage

Plusieurs widgets

Chargez bethemesh.js une seule fois, même si la page contient plusieurs conteneurs.

Contenu dynamique

Les widgets ajoutés après le chargement sont détectés automatiquement. Vous pouvez aussi appeler BethemeshWidgets.initialize().

Scripts externes bloqués

Utilisez l’iframe directe proposée dans le configurateur.