La recherche Polyzon sur votre site

Pour les ateliers et boutiques d’impression 3D : vos visiteurs trouvent un modèle directement sur votre site, et vous recevez ce qu’ils veulent faire imprimer.

Essayez

Changez le thème, la couleur et le bouton : votre widget se configure de la même manière. Ouvrez un modèle et appuyez sur le bouton : ce que reçoit votre site s’affiche à côté.

Thème

Couleur d’accent

Action du bouton

Ce que reçoit votre site

Rien pour l’instant : ouvrez un modèle dans le widget.

Mes widgets

Connectez-vous pour créer un widget

Comment l’intégrer

Créez un widget et ajoutez le domaine de votre site : il ne s’ouvrira pas sur d’autres sites.
Réglez l’apparence et la recherche dans votre espace personnel : thème, couleurs, police, bouton. L’aperçu se met à jour instantanément et, une fois enregistrées, les modifications sont reprises automatiquement par le site — inutile de toucher au code de la page.
Collez le code dans votre page. Votre site reçoit le modèle que l’on veut faire imprimer : dans un gestionnaire onOrder ou via un lien vers votre page de commande.

Code pour votre site

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>

Options

Le thème, les couleurs et le libellé du bouton ne se définissent pas dans le code : ils sont enregistrés dans les paramètres du widget, dans votre espace personnel.

id: L’identifiant du widget, à copier depuis votre espace personnel.
element: L’identifiant de l’élément (ou l’élément lui-même) dans lequel placer le widget.
height: Hauteur en pixels. Sans elle, le widget s’adapte à son contenu.
lang: ru ou en. Par défaut : la langue de la page (attribut lang).
title: Le titre du cadre pour les lecteurs d’écran.
onReady: Le widget est chargé.
onSelect: Un visiteur a ouvert un modèle ; ses données sont passées en argument.
onOrder: Un visiteur a appuyé sur « Commander une impression ». Avec un gestionnaire, le widget ne redirige nulle part : affichez votre propre formulaire de commande.

Données du modèle

sourceUrl est la page du modèle sur sa plateforme : c’est là que l’atelier télécharge le fichier. polyzonUrl peut être vide lorsque le modèle n’a pas de page sur 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": ""
  }
}

Page de commande sur votre site

Le bouton « Commander une impression » peut mener à la page de commande de votre site, sans faire appel à un développeur. Indiquez l’adresse de cette page dans les paramètres du widget (Bouton → Page de commande) et ajoutez-y des balises entre accolades. Quand un visiteur appuie sur le bouton, le widget remplace les balises par les données du modèle choisi : vous voyez exactement ce qu’il veut faire imprimer. La page doit se trouver sur l’un des domaines du widget.

{polyzon_url}: lien vers le modèle sur Polyzon
{source_url}: lien vers le modèle chez l’auteur : c’est là que se télécharge le fichier à imprimer
{title}: titre du modèle
{source}: plateforme, par ex. printables
{id}: numéro du modèle sur la plateforme
{image}: lien vers l’image du modèle

Supposons que les paramètres contiennent l’adresse ci-dessous. Un visiteur choisit un rangement et appuie sur le bouton : il arrive sur votre page, avec le lien et le titre du modèle dans l’adresse :

Adresse dans les paramètres

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

Où arrive le visiteur

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

Sans JavaScript

Si vous ne pouvez pas ajouter de scripts, utilisez le cadre (iframe) : hauteur fixe et aucun événement pour votre site, mais le lien de commande fonctionne.

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>

Si votre site applique une CSP stricte

Autorisez le script et le cadre provenant de polyzon.org :

Content-Security-Policy

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

Sécurité et limites

Le widget est un cadre distinct : il ne voit ni votre page, ni vos cookies, ni vos formulaires.
Pas de cookies, de publicité ni de compteurs de visites : inutile de l’ajouter à votre bannière cookies.
Il ne fonctionne que sur vos domaines : les navigateurs ne l’afficheront sur aucun autre site.
Jusqu’à 2000 recherches par jour et par widget.
Le chargeur est intégré avec l’attribut integrity : si le fichier change un jour, le navigateur ne l’exécutera pas.

Règles

Le widget affiche la recherche Polyzon telle quelle : ne masquez pas la mention « Propulsé par » accompagnée du logo Polyzon et ne faites pas passer les modèles pour les vôtres.
N’utilisez pas le widget pour aspirer le catalogue et ne l’installez pas sur des sites au contenu illégal.
Les modèles appartiennent à leurs auteurs : vérifiez la licence avant d’imprimer sur commande.
Polyzon peut limiter ou désactiver un widget en cas de non-respect des règles ou de forte charge.
Les coordonnées des visiteurs sont collectées par votre site : Polyzon ne les reçoit pas et ne les transmet pas.