La ricerca di Polyzon sul tuo sito

Per service di stampa 3D e negozi: i visitatori trovano un modello direttamente sul tuo sito e tu ricevi ciò che vogliono far stampare.

Provalo

Cambia tema, colore e pulsante: il tuo widget si configura allo stesso modo. Apri un modello e premi il pulsante: accanto comparirà ciò che riceve il tuo sito.

Tema
Colore principale
Cosa fa il pulsante

Cosa riceve il tuo sito

Ancora niente: apri un modello nel widget.

I miei widget

Accedi per creare un widget

Come integrarlo

  1. Crea un widget e aggiungi il dominio del tuo sito: su altri siti non si aprirà.
  2. Configura aspetto e ricerca nella tua area personale: tema, colori, font, pulsante. L’anteprima si aggiorna subito e, una volta salvato, il sito recepisce le modifiche da solo: non serve toccare il codice della pagina.
  3. Incolla il codice nella tua pagina. Il tuo sito riceve il modello che qualcuno vuole far stampare: in un gestore onOrder o come link alla tua pagina d’ordine.

Codice per il tuo sito

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>

Opzioni

Tema, colori ed etichetta del pulsante non si impostano nel codice: si trovano nelle impostazioni del widget, nella tua area personale.

id
L’id del widget, dalla tua area personale.
element
L’id dell’elemento (o l’elemento stesso) in cui inserire il widget.
height
Altezza in pixel. Se manca, il widget si adatta al contenuto.
lang
ru o en. Per impostazione predefinita, la lingua della pagina (attributo lang).
title
Il titolo del frame per gli screen reader.
onReady
Il widget è stato caricato.
onSelect
Un visitatore ha aperto un modello; i suoi dati sono nell’argomento.
onOrder
Un visitatore ha premuto «Ordina la stampa». Con un gestore il widget non porta da nessuna parte: mostra il tuo modulo d’ordine.

Dati del modello

sourceUrl è la pagina del modello sulla sua piattaforma: è da lì che il service scarica il file. polyzonUrl può essere vuoto se il modello non ha una pagina su Polyzon.

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": ""
  }
}

Pagina d’ordine sul tuo sito

Il pulsante «Ordina la stampa» può portare alla pagina d’ordine del tuo sito, senza bisogno di uno sviluppatore. Inserisci l’indirizzo di quella pagina nelle impostazioni del widget (Pulsante → Pagina d’ordine) e aggiungi dei tag tra parentesi graffe. Quando un visitatore preme il pulsante, il widget sostituisce i tag con i dati del modello scelto, così vedi esattamente cosa vuole far stampare. La pagina deve trovarsi su uno dei domini del widget.

{polyzon_url}
link al modello su Polyzon
{source_url}
link al modello sul sito dell’autore: è da lì che si scarica il file per la stampa
{title}
titolo del modello
{source}
piattaforma, ad es. printables
{id}
numero del modello sulla piattaforma
{image}
link all’immagine del modello

Supponiamo che nelle impostazioni ci sia l’indirizzo qui sotto. Un visitatore sceglie l’organizer e preme il pulsante: arriva sulla tua pagina con il link al modello e il titolo nell’indirizzo:

Indirizzo nelle impostazioni 
https://studio.example/order?model={source_url}&title={title}
Dove arriva il visitatore 
https://studio.example/order?model=https%3A%2F%2Fwww.printables.com%2Fmodel%2F123456-desk-organizer&title=Desk%20organizer

Senza JavaScript

Se non puoi aggiungere script, usa il frame: altezza fissa e nessun evento per il tuo sito, ma il link d’ordine funziona.

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>

Se il tuo sito ha una CSP restrittiva

Consenti lo script e il frame da polyzon.org:

Content-Security-Policy 
script-src https://polyzon.org;
frame-src https://polyzon.org;

Sicurezza e limiti

  • Il widget è un frame separato: non può vedere la tua pagina, i cookie o i moduli.
  • Niente cookie, pubblicità o contatori di visite: non va inserito nel banner dei cookie.
  • Funziona solo sui tuoi domini: i browser non lo mostrano sui siti di altri.
  • Fino a 2000 ricerche al giorno per widget.
  • Lo script di caricamento viene incluso con integrity: se il file dovesse cambiare, il browser non lo eseguirà.

Regole

  • Il widget mostra la ricerca di Polyzon così com’è: non nascondere la scritta «Ricerca di» con il logo Polyzon e non spacciare i modelli per tuoi.
  • Non usare il widget per estrarre in massa il catalogo e non inserirlo in siti con contenuti illegali.
  • I modelli appartengono ai loro autori: verifica la licenza prima di stampare su ordinazione.
  • Polyzon può limitare o disattivare un widget in caso di violazione delle regole o di carico elevato.
  • I contatti dei visitatori li raccoglie il tuo sito: Polyzon non li riceve né li trasmette.