einbetten

Einbetten: der Konfigurator mit einer Zeile Code

Der Konfigurator kommt mit einem iframe auf Ihre Website: eine Zeile HTML, ohne Plug-in und ohne Bibliothek. Sprache und Ausführung wählen Sie über die Adresse; wer mehr will, steuert ihn mit Nachrichten von der eigenen Seite aus. Diese Seite ist für die Person, die Ihre Website betreut.

iframe
1 zeile
stand
November 2026

01 · einbetten

Der iframe: der Konfigurator in einer Zeile

So steht der Ulmer Hocker auf einer Seite. Die Adresse ist die echte aus unserem Lab; Ihre bekommen Sie mit dem Projekt.

<iframe src="https://alzato.ch/apps/hocker-lab/?embed=1&lang=de"
  title="3D-Konfigurator: Ulmer Hocker" allow="fullscreen" loading="lazy"
  style="width:100%; aspect-ratio:16/10; min-height:560px; border:0"></iframe>

Auf schmalen Bildschirmen gilt die Mindesthöhe, damit Bedienung und Karten Platz haben.

02 · parameter

Parameter: was die Adresse einstellt

Alle Parameter sind freiwillig.

ParameterWerteWirkung
embed1 · stage1: der Konfigurator mit seiner Bedienung, ohne eigenen Kopf. stage: nur die Szene, Ihre Seite legt die Bedienung darüber.
langde · enSprache der Bedienung und der Texte.
variantfir · walnut · red …Die Ausführung beim Öffnen, so wie sie der Teilen-Link setzt.
lightsun · soft · studioSonne, Nordlicht oder weisses Studio.
productkreuzzargenstuhl …Welches Produkt, wenn eine Adresse mehrere trägt.
intro0Ohne die Eröffnung, in der sich die Teile zusammensetzen.

03 · nachrichten

Nachrichten: Seite und Konfigurator im Gespräch

Mit window.postMessage steuert Ihre Seite den Konfigurator, und er meldet, was die Besucherin tut. So läuft die Bühne auf unserer Startseite.

An den Konfigurator ({ type: 'alzato:set', … })
varianteine Ausführung wählen
explodetrue oder false: in die Teile zerlegen
drawingtrue oder false: die Zeichnung 1 : 1 zeigen
lightsun, soft oder studio
langde oder en
detailzu einem Detail fliegen, null schliesst es
hometrue: zurück in die Ausgangsansicht
cardfalse: die Detailkarte ausblenden, Ihre Seite erzählt selbst
runfalse: keine Bilder rechnen, solange er nicht sichtbar ist
Vom Konfigurator
alzato:readybereit; mit Produkt, Ausführungen und Details
alzato:varianteine Ausführung wurde gewählt
alzato:detailein Detail wurde geöffnet oder geschlossen
alzato:explodezerlegt oder zusammengesetzt
alzato:drawingZeichnung ein oder aus
alzato:lightein anderes Licht

Beispiel: auf Nussbaum wechseln, sobald der Konfigurator bereit ist

const frame = document.querySelector('iframe');
window.addEventListener('message', (e) => {
  if (e.source !== frame.contentWindow) return;
  if (e.data?.type === 'alzato:ready') {
    frame.contentWindow.postMessage({ type: 'alzato:set', variant: 'walnut' }, '*');
  }
});

04 · grösse und tempo

Grösse und Tempo: was der Konfigurator lädt

Programmrund 245 KB, komprimiert
Ulmer Hocker in Fichte, erster Besuchrund 1,3 MB mit Modell, Holzfotos und Schriften
Weitere Hölzerladen still nach, wenn die Szene steht; die Händlerkarte erst, wenn jemand sie öffnet
Bilder pro Sekunde120 auf dem Laptop, 60 auf dem iPhone 11 Pro
BrowserChrome, Edge, Firefox und Safari mit WebGL 2, auf Computer, Tablet und Telefon
HostingDurch uns, in Frankfurt

Grössen berechnet aus den Dateien des Konfigurators am 19. November 2026; Bildraten gemessen am 14. November 2026 in Chrome. Getestet auf Laptop und iPhone; Messungen auf Android folgen.

05 · datenschutz

Datenschutz: was der Konfigurator sendet

  • Keine Cookies, nichts im Speicher des Browsers, kein Tracking, keine Analyse.
  • Alle Dateien kommen von seiner eigenen Adresse; keine Schriften oder Skripte von Dritten. Einzige Ausnahme: Öffnet jemand die Händlerkarte, lädt sie ihre Kartenbilder von OpenFreeMap.
  • Daten gehen nur weg, wenn jemand eine Anfrage abschickt: Name, E-Mail, Postleitzahl und Ort, Nachricht, der gewählte Händler und die Konfiguration mit Bild, an die Adresse, die im Projekt festgelegt ist.

06 · händler

Händler: der Konfigurator bei Ihren Händlern

Händler betten dieselbe Zeile ein, in ihrer Sprache. Die Anfrage geht an die Adresse, die Sie festlegen: an Sie oder an den Händler. Sie geben uns die Liste der Händler, wir schicken jedem seine Zeile.

07 · geplant

Geplant: Skript-Einbettung und Shopify-App

zur roadmap

  • Skript statt iframe geplant

    Eine Zeile JavaScript, die den Konfigurator ohne iframe in Ihre Seite setzt. Geplant.

  • Shopify-App geplant

    Der Konfigurator auf Shopify-Produktseiten, mit Anbindung an den Warenkorb. Geplant.

Fragen zur Einbettung?

Schicken Sie uns die Adresse Ihrer Website und die Seite, auf der der Konfigurator stehen soll. Innert zwei Arbeitstagen wissen Sie, was es braucht.