Polyzon-Suche auf deiner Website

Für 3D-Druck-Studios und Shops: Besucher finden ein Modell direkt auf deiner Website, und du erfährst, was sie gedruckt haben möchten.

Ausprobieren

Wechsle Design, Farbe und Button – genauso richtest du dein Widget ein. Öffne ein Modell und drück den Button: Daneben erscheint, was deine Website empfängt.

Design

Akzentfarbe

Was der Button macht

Was deine Website empfängt

Noch nichts: Öffne ein Modell im Widget.

Meine Widgets

Melde dich an, um ein Widget zu erstellen

So bindest du es ein

Erstelle ein Widget und füge die Domain deiner Website hinzu – auf anderen Websites lässt es sich nicht öffnen.
Richte Aussehen und Suche in deinem Konto ein: Design, Farben, Schrift, Button. Die Vorschau aktualisiert sich sofort, und nach dem Speichern übernimmt deine Website die Änderungen automatisch – den Code auf der Seite musst du nicht anfassen.
Füge den Code in deine Seite ein. Deine Website erhält das Modell, das jemand drucken lassen möchte: in einem onOrder-Handler oder als Link zu deiner Bestellseite.

Code für deine Website

HTML

<div id="polyzon-widget"></div>
<script src="https://polyzon.org/widget/v1.js" integrity="sha384-kCIxhgL0RK6xXdqHfKL2YeR63MyVpmgPD7/BVroRann3f0g9gbpXl5Je0TD/VSwZ" crossorigin="anonymous" async></script>
<script>
  (window.PolyzonWidgets = window.PolyzonWidgets || []).push({
    id: 'YOUR_WIDGET_ID',
    element: 'polyzon-widget',
    onOrder: function (model) {
      // model.title, model.sourceUrl, model.polyzonUrl, model.image …
    }
  });
</script>

Optionen

Design, Farben und Button-Text legst du nicht im Code fest, sondern in den Widget-Einstellungen in deinem Konto.

id: Die Widget-ID aus deinem Konto.
element: Die ID des Elements (oder das Element selbst), in das das Widget eingefügt wird.
height: Höhe in Pixeln. Ohne Angabe passt sich das Widget an seinen Inhalt an.
lang: ru oder en. Standardmäßig die Sprache der Seite (Attribut lang).
title: Der Titel des Frames für Screenreader.
onReady: Das Widget ist geladen.
onSelect: Ein Besucher hat ein Modell geöffnet; dessen Daten sind das Argument.
onOrder: Ein Besucher hat auf „Druck bestellen“ gedrückt. Mit Handler leitet das Widget nirgendwohin weiter – zeig dein eigenes Bestellformular an.

Modelldaten

sourceUrl ist die Seite des Modells auf seiner Plattform: Dort lädt das Studio die Datei herunter. polyzonUrl kann leer sein, wenn das Modell keine Seite auf Polyzon hat.

onOrder(model)

{
  "widgetId": "YOUR_WIDGET_ID",
  "query": "органайзер",
  "source": "printables",
  "sourceName": "Printables",
  "id": "123456",
  "title": "Desk organizer",
  "polyzonUrl": "https://polyzon.org/model/printables/123456",
  "sourceUrl": "https://www.printables.com/model/123456-desk-organizer",
  "image": "https://cache.polyzon.org/api/img?url=…",
  "images": [],
  "creator": "maker",
  "license": "cc-by",
  "formats": [
    "stl",
    "3mf"
  ],
  "price": {
    "type": "free",
    "value": null,
    "display": ""
  }
}

Bestellseite auf deiner Website

Der Button „Druck bestellen“ kann zur Bestellseite auf deiner Website führen – ganz ohne Entwickler. Trag die Adresse dieser Seite in den Widget-Einstellungen ein (Button → Bestellseite) und füge Platzhalter in geschweiften Klammern hinzu. Wenn ein Besucher den Button drückt, setzt das Widget anstelle der Platzhalter die Daten des gewählten Modells ein – so siehst du genau, was gedruckt werden soll. Die Seite muss auf einer der Domains des Widgets liegen.

{polyzon_url}: Link zum Modell auf Polyzon
{source_url}: Link zum Modell beim Autor: Von dort wird die Druckdatei heruntergeladen
{title}: Titel des Modells
{source}: Plattform, z. B. printables
{id}: Nummer des Modells auf der Plattform
{image}: Link zum Bild des Modells

Angenommen, in den Einstellungen steht die Adresse unten. Ein Besucher wählt den Organizer und drückt den Button – er landet auf deiner Seite, und Link und Titel des Modells stehen in der Adresse:

Adresse in den Einstellungen

https://studio.example/order?model={source_url}&title={title}

Hier landet der Besucher

https://studio.example/order?model=https%3A%2F%2Fwww.printables.com%2Fmodel%2F123456-desk-organizer&title=Desk%20organizer

Ohne JavaScript

Wenn du keine Skripte einbinden kannst, nimm den Frame: feste Höhe und keine Events für deine Website, aber der Bestelllink funktioniert.

HTML

<iframe src="https://polyzon.org/widget/YOUR_WIDGET_ID" width="100%" height="640" style="border:0" loading="lazy"
  title="Polyzon" referrerpolicy="strict-origin-when-cross-origin"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox allow-top-navigation-by-user-activation"></iframe>

Wenn deine Website eine strenge CSP hat

Erlaube das Skript und den Frame von polyzon.org:

Content-Security-Policy

script-src https://polyzon.org;
frame-src https://polyzon.org;

Sicherheit und Limits

Das Widget ist ein separater Frame: Es sieht weder deine Seite noch deine Cookies oder Formulare.
Keine Cookies, keine Werbung, keine Besucherzähler: Es gehört nicht in deinen Cookie-Banner.
Funktioniert nur auf deinen Domains: Auf fremden Websites zeigen Browser es nicht an.
Bis zu 2000 Suchanfragen pro Tag und Widget.
Der Loader wird mit integrity eingebunden: Falls sich die Datei je ändert, führt der Browser sie nicht aus.

Regeln

Das Widget zeigt die Polyzon-Suche unverändert: Blende die Zeile „Suche von“ mit dem Polyzon-Logo nicht aus und gib die Modelle nicht als deine eigenen aus.
Nutze das Widget nicht, um den Katalog auszulesen, und binde es nicht auf Websites mit illegalen Inhalten ein.
Die Modelle gehören ihren Urhebern: Prüfe die Lizenz, bevor du im Auftrag druckst.
Polyzon kann ein Widget bei Regelverstößen oder hoher Last einschränken oder deaktivieren.
Kontaktdaten der Besucher erfasst deine Website: Polyzon erhält sie nicht und gibt sie nicht weiter.