Zum Hauptinhalt springen
Bethemesh

Entwicklerdokumentation

Bethemesh Widgets einbetten

Vollständige Anleitung zum Einbetten eines Bethemesh-Werkzeugs in HTML, WordPress, Webflow, Wix oder jedes CMS mit Iframe-Unterstützung.

Schnellstart

Füge einen Container hinzu, gib den Werkzeug-Slug an und lade die versionierte Runtime einmal.

Empfohlene Integration
<div
  class="bethemesh-widget"
  data-tool="passwort-generator"
  data-lang="de"
  data-theme="auto"
  data-min-height="560"
></div>
<script src="https://bethemesh.com/widgets/v1/bethemesh.js" async></script>

Direktes Iframe

Verwende das direkte Iframe aus dem Konfigurator.

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

Verfügbare Optionen

AttributZweckStandardwert
data-toolLokalisierter Widget-Slug (erforderlich).
data-langSprache der eingebetteten Route.de
data-themeDesign: auto, light oder dark.auto
data-titleBenutzerdefinierter Titel, maximal 100 Zeichen.Werkzeugtitel
data-subtitleBenutzerdefinierter Untertitel, maximal 180 Zeichen.
data-min-heightAnfangshöhe vor der automatischen Größenanpassung.560
data-loadingiframe-Laden: lazy oder eager.lazy

Ereignisse und automatische Größenanpassung

Die Runtime erstellt das Iframe, verarbeitet signierte Bethemesh-Nachrichten und passt die Höhe automatisch an. Die öffentliche API kann auch dynamisch hinzugefügte Widgets initialisieren.

window.BethemeshWidgets.initialize()

CMS-Kompatibilität

WordPress / Elementor

Verwenden Sie einen Block „Individuelles HTML“.

Webflow / Wix

Fügen Sie den Code in eine Embed-Komponente ein.

Shopify

Fügen Sie einen Custom-Liquid- oder HTML-Abschnitt hinzu.

HTML / Astro / React

Fügen Sie den Container ein und laden Sie das Skript einmal.

Sicherheit

Berechtigungen und Sandbox-Tokens werden aus den deklarierten Fähigkeiten jedes Werkzeugs erzeugt. Erweitere diese Rechte nicht ohne konkreten Bedarf.

Fehlerbehebung

Mehrere Widgets

Lade bethemesh.js nur einmal, auch wenn die Seite mehrere Container enthält.

Dynamische Inhalte

Nach dem Laden hinzugefügte Widgets werden automatisch erkannt. Du kannst auch BethemeshWidgets.initialize() aufrufen.

Externe Skripte blockiert

Verwende das direkte Iframe aus dem Konfigurator.