مُهيّئك على أي موقع
بضعة أسطر من الشيفرة أو إضافة واحدة. اختر منصتك واتبع الخطوات؛ يستغرق الأمر عادة أقل من عشر دقائق.
الأدلة التفصيلية متاحة حاليًا بالإنجليزية.
The three forms of the 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><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
Use the VONCON plugin and a shortcode, or paste the script into a Custom HTML block.
- 1In VONCON open “Website embed” and download the WordPress plugin (voncon-wordpress.zip).
- 2In WordPress go to Plugins → Add New → Upload Plugin, choose the zip and activate it.
- 3Edit the page, add a Shortcode block and paste the shortcode from VONCON.
- 4Without the plugin: add a Custom HTML block and paste the script code instead.
- 5Publish and open the page: the configurator appears in your colours.
Page builders (Elementor, Divi, WPBakery) have their own HTML or shortcode widget; both forms work there too.
[voncon configurator="your-configurator" key="pk_live_YOUR_KEY" locale="en"]Shopify
Add a Custom Liquid section to the page or product template.
- 1Add yourshop.myshopify.com and your own domain to the key’s allowed domains.
- 2In Shopify open Online Store → Themes → Customize.
- 3Open the page or product template, click Add section and choose Custom Liquid.
- 4Paste the script code into the Liquid field and save.
- 5Preview the page; the configurator loads below the section above it.
Older themes without sections: paste the code into the page content using the “Show HTML” (<>) button.
<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
Use “Embed a site” with the configurator’s address, so it runs on your domain.
- 1Copy the iFrame code in VONCON and take the address from its src="…" part.
- 2In the Wix editor click Add Elements → Embed Code → Embed a site.
- 3Click Enter Website Address, paste the address and apply.
- 4Drag the frame to full width and give it a height of about 900 px (1100 px on mobile).
- 5Publish. Your Wix domain must be in the key’s allowed domains.
Wix places “Embed HTML” code on its own helper domain; “Embed a site” avoids that and is the more reliable choice.
<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
Drop an Embed element where the configurator should appear.
- 1Add yoursite.webflow.io and your own domain to the allowed domains.
- 2In the Designer open Add (+) → Components → Embed and drop it into the section.
- 3Paste the script code and save and close.
- 4Set the parent section to full width; the configurator sizes itself.
- 5Publish the site; the preview inside the Designer does not run scripts.
<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
Add a Code block to the page.
- 1Add your Squarespace domain and your own domain to the allowed domains.
- 2Edit the page, click Add Block and choose Code.
- 3Paste the script code, leave the mode on HTML and turn “Display source” off.
- 4Save and leave the editor: code blocks run only on the live page.
Code blocks need a Business plan or higher. On lower plans use the iFrame code in an Embed block.
<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
Use a Custom module or an article with the editor in code view.
- 1In Joomla open Content → Site Modules → New → Custom.
- 2Switch the editor to code view (Toggle Editor) and paste the script code.
- 3Assign the module to a position and to the menu item of your configurator page, then save.
- 4If the editor removes the script, allow it under System → Global Configuration → Text Filters, or use the 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 accepts the iFrame address as an embed.
- 1Add sites.google.com and googleusercontent.com to the key’s allowed domains.
- 2In Google Sites click Insert → Embed → Embed code and paste the iFrame code.
- 3Resize the box to the full width and about 1100 px high.
- 4Publish the site.
<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
Any page you can edit: paste the code where the configurator should appear.
- 1Paste the script code into the page’s HTML, inside the content area.
- 2The script loads once and fills every element with data-voncon-configurator on the page.
- 3Where scripts are not allowed, use the iFrame code with a fixed height (about 1100 px).
- 4Upload the page and open it on a domain from the allowed list.
Optional attributes: data-voncon-locale="de" for the language, data-voncon-height="900" for a starting height.
<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
Load the script once and mount the configurator in a component.
- 1Load https://app.voncon.app/sdk/v1.js once (in Next.js with next/script).
- 2In a component, call window.Voncon.mount(element, { key, configurator, locale }) in an effect.
- 3Keep the returned object: on("price", …), on("lead", …) and openQuoteRequest() connect it to your page.
- 4Call destroy() when the component unmounts.
With a Content Security Policy, allow app.voncon.app in script-src and frame-src.
'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} />
</>
);
}Full-screen configurator
A link instead of a frame: your product in a real room, 3D, drawing and AR on the whole screen.
- 1Take the iFrame address from VONCON and add &mode=immersive.
- 2Add &back= with the address of your page (URL-encoded), so the configurator shows a way back.
- 3Put the address behind any button, e.g. “Configure live”.
- 4Optional: &values= with starting values as JSON, and &locale= for the language.
The page behind back must be on one of the key’s allowed domains, otherwise the back button is hidden.
<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>Configurator switcher
Let customers move between your configurators (window, door, garage door) without leaving the page.
- 1Add &switch=1 to offer all published configurators the key may open.
- 2Or list the ones you want: &switch=window-pvc,entrance-door.
- 3The configurator’s name at the top then opens a menu with the others.
https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&mode=immersive&switch=1هل توقفت عند خطوة ما؟أرسل لنا عنوان صفحتك وسنساعدك: voncon@vonito.ba