TrunkLens für Händler

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.

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.

FormBeispiel
Kurzformdata-packages="202x60x12:48; 120x50x8:20" (Trenner ; oder |, Gewicht nach : oder @, Dezimalkomma erlaubt)
JSON am Elementdata-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

AttributWerteStandard
data-langde, en, fr, es, it, nl, pl, sv, da<html lang>, sonst Browser, sonst en
data-themeauto, light, darkauto
data-accentCSS-Farbe, z. B. #0f766eTrunkLens-Indigo
data-vehicleFahrzeug-ID als Vorauswahl, z. B. vw-golf oder ein Mietfahrzeug–
data-handoffauto (Touch → App-Button, sonst QR), qr (Kiosk im Markt), linkauto
data-rememberfalse = Fahrzeugwahl nicht speichernspeichern
data-viewereigene Adresse des 3D-Viewers (Self-Hosting)neben dem Skript
data-link-baseZiel der App-Übergabehttps://trunklens.com/cart-import
data-shopShop-Domain für Artikelnummern, z. B. moebel-xy.deDomain der Seite
data-keyLizenzschlü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>

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)

EventZieldetail
trunklens:readydocument{ version }
trunklens:openButton{ items }
trunklens:resultButtonErgebnis nach Berechnung im Dialog
trunklens:statusButtonSchnellprü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.