TrunkLens-Widget für Online-Shops
Ein Button für Produkt- und Warenkorbseiten: Kundinnen und Kunden wählen ihr Auto und sehen sofort, ob die Ware hineinpasst, mit 3D-Ladeplan, Ladereihenfolge, Tipps zur Ladungssicherung und Übergabe an die TrunkLens-App per Link oder QR-Code.
- Rechnet im Browser: keine Serveranfragen, keine Cookies, kein Tracking
- 9 Sprachen (de, en, fr, es, it, nl, pl, sv, da), automatisch nach
<html lang>bzw. Browser - Merkt sich das Auto: Nach der ersten Wahl zeigt jeder Button direkt „Passt · VW Golf“
- Klein: 43 KB (gzip); der 3D-Viewer (144 KB gzip) lädt erst beim Öffnen
- Hell/dunkel, eigene Akzentfarbe, Tastatur- und Screenreader-bedienbar, Bottom-Sheet auf dem Handy
Einbinden
<script src="https://trunklens.com/v1/trunklens-widget.js" async></script>
<div
data-trunklens-product
data-name="Kleiderschrank Nordvik 3-türig"
data-ean="4006381333931"
data-packages="202x60x12:48; 202x40x10:31; 120x50x8:20"></div>
Ein leeres div/span wird zum TrunkLens-Button. Eigene Buttons (<button>, <a> oder Elemente mit Inhalt) behalten ihr Aussehen und öffnen nur den Dialog.
Paketmaße angeben
Maße immer als Transportmaße der Pakete in cm (nicht die Maße des aufgebauten Möbels), Gewicht in kg.
| Form | Beispiel |
|---|---|
| Kurzform | data-packages="202x60x12:48; 120x50x8:20" (Trenner ; oder |, Gewicht nach : oder @, Dezimalkomma erlaubt) |
| JSON am Element | data-trunklens-product='{"name":"OSB-Platte","quantity":6,"packages":[{"length":250,"width":67.5,"height":1.8,"weight":18,"flat":true}]}' |
| Warenkorb | <div data-trunklens-cart='[{"name":"Kommode","packages":[[86,50,16,32]]}, …]'></div> |
Paket-Eigenschaften (JSON): upright (stehend transportieren, z. B. Waschmaschine), flat (liegend), fragile (nichts darauf stapeln). Für alle Pakete eines Artikels auch als Attribute: data-upright, data-fragile. Fehlt das Gewicht, wird es geschätzt.
Weitere Attribute am Artikel: data-quantity="2" oder data-quantity-from="#menge" (liest das Mengenfeld beim Klick), data-sku="KS-150" (eigene Artikelnummer, im JSON sku; Buchstaben, Ziffern, ., _, -, höchstens 40 Zeichen).
Mit Artikelnummer übernimmt die App die Paketdaten bei der Übergabe in die TrunkLens-Produktdatenbank – auch für Artikel ohne EAN. Dazu enthält der App-Link den Shop (shop=, standardmäßig die Domain der Seite); keine Kundendaten.
Optionen am <script>-Tag
| Attribut | Werte | Standard |
|---|---|---|
data-lang | de, en, fr, es, it, nl, pl, sv, da | <html lang>, sonst Browser, sonst en |
data-theme | auto, light, dark | auto |
data-accent | CSS-Farbe, z. B. #0f766e | TrunkLens-Indigo |
data-vehicle | Fahrzeug-ID als Vorauswahl, z. B. vw-golf oder ein Mietfahrzeug | – |
data-handoff | auto (Touch → App-Button, sonst QR), qr (Kiosk im Markt), link | auto |
data-remember | false = Fahrzeugwahl nicht speichern | speichern |
data-viewer | eigene Adresse des 3D-Viewers (Self-Hosting) | neben dem Skript |
data-link-base | Ziel der App-Übergabe | https://trunklens.com/cart-import |
data-shop | Shop-Domain für Artikelnummern, z. B. moebel-xy.de | Domain der Seite |
data-key | Lizenzschlüssel für Ihre Domain (aus der Lizenz-E-Mail) | – (ohne: Testversion mit Hinweis) |
Lizenzschlüssel
Nach Vertragsabschluss erhalten Sie einen Lizenzschlüssel für Ihre Domain(s). Er gehört an das Script-Tag:
<script src="https://trunklens.com/v1/trunklens-widget.js" data-key="IHR-LIZENZSCHLÜSSEL" async></script>
- Der Schlüssel gilt für die Domain und alle Subdomains (
moebel-xy.de→www.moebel-xy.de,m.moebel-xy.de) bis zum angegebenen Datum. - Geprüft wird im Browser über eine digitale Signatur – ohne Serveranfrage und ohne Datenübertragung.
- Ohne gültigen Schlüssel funktioniert das Widget weiter, zeigt aber „Testversion“ am Button und im Dialog. Auf
localhostund Test-Domains (*.local,*.test) ist kein Schlüssel nötig. - In Shopware und WooCommerce tragen Sie den Schlüssel in den Plugin-Einstellungen ein.
- Status abfragen:
TrunkLens.license()bzw. das Ereignistrunklens:license.
JavaScript-API
document.addEventListener('trunklens:ready', () => {
TrunkLens.open([
{
name: 'Ecksofa',
packages: [
[220, 95, 85, 55],
[165, 95, 85, 40],
],
},
]);
// ohne Dialog, z. B. für eigene Hinweise im Shop
const result = TrunkLens.check(items, { vehicle: 'vw-golf', passengers: 1 });
// → { status: 'fits' | 'fitsWithFolding' | 'partial' | 'noFit', headline, subline, trips, vehicle, passengers }
TrunkLens.vehicles(); // [{ id, name, rental }]
TrunkLens.setVehicle('skoda-octavia-combi');
TrunkLens.setLanguage('fr');
TrunkLens.refresh(); // neu eingefügte Buttons sofort erkennen (sonst automatisch)
});
Events (für Analyse und eigene Anzeigen)
| Event | Ziel | detail |
|---|---|---|
trunklens:ready | document | { version } |
trunklens:open | Button | { items } |
trunklens:result | Button | Ergebnis nach Berechnung im Dialog |
trunklens:status | Button | Schnellprüfung mit gemerktem Auto |
Zusätzlich setzt das Widget am Element data-trunklens-status="fits|fitsWithFolding|partial|noFit". Damit lassen sich eigene Buttons per CSS einfärben:
.mein-button[data-trunklens-status='noFit'] {
border-color: #b42318;
}
Datenschutz
Das Widget überträgt keine Produkt-, Warenkorb- oder Nutzungsdaten und setzt keine Cookies. Im localStorage liegt nur das gewählte Auto samt Mitfahrerzahl (trunklens.widget.v1); mit data-remember="false" entfällt auch das. Beim Laden der Dateien von unserem Server wird technisch die IP-Adresse verarbeitet. Beim Self-Hosting beider Dateien (unverändert, siehe Lizenz) erhält TrunkLens keine Daten. Einen Textbaustein für Ihre Datenschutzerklärung enthält die Händler-Lizenz (legal/b2b/widget-lizenz.md).
Self-Hosting
trunklens-widget.js und trunklens-viewer.html unverändert in denselben Ordner legen. Der Viewer wird automatisch neben dem Skript gesucht, sonst data-viewer setzen. Die Content-Security-Policy muss frame-src für den Viewer erlauben.
Browser
Aktuelle Versionen von Safari (iOS/macOS), Chrome, Edge, Firefox und Samsung Internet. Der 3D-Viewer braucht WebGL; ohne WebGL bleiben Ergebnis und Ladereihenfolge als Text nutzbar.
Entwicklung
npm run build:widget # → widget/dist/ (Widget, Viewer, Demo-Shop)
cd widget/dist && python3 -m http.server 8766
# http://localhost:8766/demo.html#vehicle=vw-golf&open=cart&lang=fr&theme=dark&handoff=qr
Das Widget nutzt denselben Kern wie die App (src/core: Pack-Algorithmus, Fahrzeuge, Übersetzungen). Beim Build werden die Wörterbücher auf die benötigten Texte reduziert; fehlt ein verwendeter Text, bricht der Build ab.
© TrunkLens. Alle Rechte vorbehalten. Nutzung nur gemäß Händler-Lizenz.