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.
| Parameter | Werte | Wirkung |
|---|---|---|
embed | 1 · stage | 1: der Konfigurator mit seiner Bedienung, ohne eigenen Kopf. stage: nur die Szene, Ihre Seite legt die Bedienung darüber. |
lang | de · en | Sprache der Bedienung und der Texte. |
variant | fir · walnut · red … | Die Ausführung beim Öffnen, so wie sie der Teilen-Link setzt. |
light | sun · soft · studio | Sonne, Nordlicht oder weisses Studio. |
product | kreuzzargenstuhl … | Welches Produkt, wenn eine Adresse mehrere trägt. |
intro | 0 | Ohne 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.
variant | eine Ausführung wählen |
|---|---|
explode | true oder false: in die Teile zerlegen |
drawing | true oder false: die Zeichnung 1 : 1 zeigen |
light | sun, soft oder studio |
lang | de oder en |
detail | zu einem Detail fliegen, null schliesst es |
home | true: zurück in die Ausgangsansicht |
card | false: die Detailkarte ausblenden, Ihre Seite erzählt selbst |
run | false: keine Bilder rechnen, solange er nicht sichtbar ist |
alzato:ready | bereit; mit Produkt, Ausführungen und Details |
|---|---|
alzato:variant | eine Ausführung wurde gewählt |
alzato:detail | ein Detail wurde geöffnet oder geschlossen |
alzato:explode | zerlegt oder zusammengesetzt |
alzato:drawing | Zeichnung ein oder aus |
alzato:light | ein 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
| Programm | rund 245 KB, komprimiert |
|---|---|
| Ulmer Hocker in Fichte, erster Besuch | rund 1,3 MB mit Modell, Holzfotos und Schriften |
| Weitere Hölzer | laden still nach, wenn die Szene steht; die Händlerkarte erst, wenn jemand sie öffnet |
| Bilder pro Sekunde | 120 auf dem Laptop, 60 auf dem iPhone 11 Pro |
| Browser | Chrome, Edge, Firefox und Safari mit WebGL 2, auf Computer, Tablet und Telefon |
| Hosting | Durch 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
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.