Ihr Konfigurator auf jeder Website
Ein paar Zeilen Code oder ein Plugin. Wählen Sie Ihre Plattform und folgen Sie den Schritten; meist dauert es keine zehn Minuten.
Die drei Formen des Codes
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script><iframe src="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en"
style="width:100%;height:1100px;border:0" loading="lazy" title="Configurator"></iframe>[voncon configurator="your-configurator" key="pk_live_YOUR_KEY" locale="en"]WordPress
Nutzen Sie das VONCON-Plugin mit Shortcode oder fügen Sie das Skript in einen Block „Individuelles HTML“ ein.
- 1Öffnen Sie in VONCON „Website-Einbindung“ und laden Sie das WordPress-Plugin (voncon-wordpress.zip) herunter.
- 2In WordPress: Plugins → Installieren → Plugin hochladen, die Zip-Datei wählen und aktivieren.
- 3Seite bearbeiten, einen Shortcode-Block hinzufügen und den Shortcode aus VONCON einfügen.
- 4Ohne Plugin: einen Block „Individuelles HTML“ hinzufügen und den Skript-Code einfügen.
- 5Veröffentlichen und die Seite öffnen: Der Konfigurator erscheint in Ihren Farben.
Page-Builder (Elementor, Divi, WPBakery) haben eigene HTML- oder Shortcode-Widgets; beide Formen funktionieren dort ebenfalls.
[voncon configurator="your-configurator" key="pk_live_YOUR_KEY" locale="en"]Shopify
Fügen Sie der Seiten- oder Produktvorlage einen Abschnitt „Custom Liquid“ hinzu.
- 1Tragen Sie ihrshop.myshopify.com und Ihre eigene Domain bei den erlaubten Domains ein.
- 2Öffnen Sie in Shopify Onlineshop → Themes → Anpassen.
- 3Seiten- oder Produktvorlage öffnen, „Abschnitt hinzufügen“ klicken und „Custom Liquid“ wählen.
- 4Den Skript-Code in das Liquid-Feld einfügen und speichern.
- 5Vorschau öffnen; der Konfigurator lädt unter dem vorherigen Abschnitt.
Ältere Themes ohne Abschnitte: den Code über die Schaltfläche „HTML anzeigen“ (<>) in den Seiteninhalt einfügen.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Wix
Nutzen Sie „Embed a site“ mit der Adresse des Konfigurators, damit er auf Ihrer Domain läuft.
- 1Kopieren Sie in VONCON den iFrame-Code und nehmen Sie die Adresse aus dem Teil src="…".
- 2Im Wix-Editor: Elemente hinzufügen → Einbetten → Website einbetten.
- 3Auf „Website-Adresse eingeben“ klicken, die Adresse einfügen und übernehmen.
- 4Den Rahmen auf volle Breite ziehen und etwa 900 px hoch machen (mobil 1100 px).
- 5Veröffentlichen. Ihre Wix-Domain muss bei den erlaubten Domains stehen.
Wix legt „HTML einbetten“ auf eine eigene Hilfsdomain; „Website einbetten“ vermeidet das und ist zuverlässiger.
<iframe src="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en"
style="width:100%;height:1100px;border:0" loading="lazy" title="Configurator"></iframe>Webflow
Ziehen Sie ein Embed-Element an die gewünschte Stelle.
- 1Tragen Sie ihreseite.webflow.io und Ihre eigene Domain bei den erlaubten Domains ein.
- 2Im Designer: Add (+) → Components → Embed in den Abschnitt ziehen.
- 3Den Skript-Code einfügen und „Save & Close“ klicken.
- 4Den übergeordneten Abschnitt auf volle Breite stellen; der Konfigurator bestimmt seine Höhe selbst.
- 5Die Website veröffentlichen; die Vorschau im Designer führt keine Skripte aus.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Squarespace
Fügen Sie der Seite einen Code-Block hinzu.
- 1Tragen Sie Ihre Squarespace-Domain und Ihre eigene Domain bei den erlaubten Domains ein.
- 2Seite bearbeiten, „Block hinzufügen“ klicken und „Code“ wählen.
- 3Den Skript-Code einfügen, Modus HTML lassen und „Quelle anzeigen“ ausschalten.
- 4Speichern und den Editor verlassen: Code-Blöcke laufen nur auf der veröffentlichten Seite.
Code-Blöcke brauchen den Business-Tarif oder höher. In kleineren Tarifen den iFrame-Code in einem Embed-Block verwenden.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Joomla
Nutzen Sie ein Modul „Eigenes Modul“ oder einen Beitrag mit dem Editor in der Codeansicht.
- 1In Joomla: Inhalt → Site Module → Neu → Eigenes Modul.
- 2Den Editor auf Codeansicht umschalten (Editor an/aus) und den Skript-Code einfügen.
- 3Das Modul einer Position und dem Menüeintrag der Konfiguratorseite zuweisen und speichern.
- 4Entfernt der Editor das Skript, erlauben Sie es unter System → Konfiguration → Textfilter, oder nutzen Sie den iFrame-Code.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Google Sites
Google Sites akzeptiert den iFrame-Code als Einbettung.
- 1Tragen Sie sites.google.com und googleusercontent.com bei den erlaubten Domains ein.
- 2In Google Sites: Einfügen → Einbetten → Code einbetten, den iFrame-Code einfügen.
- 3Den Rahmen auf volle Breite und etwa 1100 px Höhe ziehen.
- 4Die Website veröffentlichen.
<iframe src="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en"
style="width:100%;height:1100px;border:0" loading="lazy" title="Configurator"></iframe>HTML / iFrame
Jede Seite, die Sie bearbeiten können: Code an der gewünschten Stelle einfügen.
- 1Den Skript-Code in das HTML der Seite einfügen, im Inhaltsbereich.
- 2Das Skript lädt einmal und füllt jedes Element mit data-voncon-configurator auf der Seite.
- 3Wo keine Skripte erlaubt sind, den iFrame-Code mit fester Höhe (etwa 1100 px) verwenden.
- 4Seite hochladen und auf einer erlaubten Domain öffnen.
Optionale Attribute: data-voncon-locale="de" für die Sprache, data-voncon-height="900" für die Starthöhe.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>React / Next.js
Skript einmal laden und den Konfigurator in einer Komponente einhängen.
- 1https://app.voncon.app/sdk/v1.js einmal laden (in Next.js mit next/script).
- 2In einer Komponente in einem Effect window.Voncon.mount(element, { key, configurator, locale }) aufrufen.
- 3Das zurückgegebene Objekt behalten: on("price", …), on("lead", …) und openQuoteRequest() verbinden es mit Ihrer Seite.
- 4Beim Entfernen der Komponente destroy() aufrufen.
Mit Content Security Policy app.voncon.app in script-src und frame-src erlauben.
'use client';
import Script from 'next/script';
import { useEffect, useRef } from 'react';
export function Configurator() {
const el = useRef<HTMLDivElement>(null);
useEffect(() => {
let c: { destroy(): void } | undefined;
const mount = () => {
c = window.Voncon.mount(el.current!, {
key: 'pk_live_YOUR_KEY',
configurator: 'your-configurator',
locale: 'en',
});
};
if (window.Voncon) mount();
else window.addEventListener('voncon:ready', mount, { once: true });
return () => c?.destroy();
}, []);
return (
<>
<Script src="https://app.voncon.app/sdk/v1.js" onLoad={() => window.dispatchEvent(new Event('voncon:ready'))} />
<div ref={el} />
</>
);
}Vollbild-Konfigurator
Ein Link statt eines Rahmens: Ihr Produkt in einem echten Raum, 3D, Zeichnung und AR im ganzen Bildschirm.
- 1Die Adresse aus dem iFrame-Code nehmen und &mode=immersive anhängen.
- 2&back= mit der Adresse Ihrer Seite (URL-kodiert) anhängen, damit der Konfigurator einen Weg zurück zeigt.
- 3Die Adresse hinter einen beliebigen Button legen, z. B. „Live konfigurieren“.
- 4Optional: &values= mit Startwerten als JSON und &locale= für die Sprache.
Die Seite in back muss auf einer erlaubten Domain des Schlüssels liegen, sonst bleibt der Zurück-Button verborgen.
<a href="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en&mode=immersive&back=https%3A%2F%2Fyourcompany.com%2Fwindows">
Configure live
</a>Konfigurator-Umschalter
Kunden wechseln zwischen Ihren Konfiguratoren (Fenster, Tür, Garagentor), ohne die Seite zu verlassen.
- 1&switch=1 anhängen, um alle veröffentlichten Konfiguratoren anzubieten, die der Schlüssel öffnen darf.
- 2Oder die gewünschten aufzählen: &switch=fenster-pvc,haustuer.
- 3Der Name des Konfigurators oben öffnet dann ein Menü mit den anderen.
https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&mode=immersive&switch=1Hängen Sie irgendwo fest?Schicken Sie uns die Adresse Ihrer Seite, wir helfen: voncon@vonito.ba