La búsqueda de Polyzon en tu sitio web

Para estudios y tiendas de impresión 3D: los visitantes encuentran un modelo en tu propio sitio y tú recibes lo que quieren imprimir.

Pruébalo

Cambia el tema, el color y el botón: tu widget se configura igual. Abre un modelo y pulsa el botón: al lado verás lo que recibe tu sitio.

Tema
Color de acento
Qué hace el botón

Lo que recibe tu sitio

Aún nada: abre un modelo en el widget.

Mis widgets

Inicia sesión para crear un widget

Cómo integrarlo

  1. Crea un widget y añade el dominio de tu sitio: no se abrirá en otros sitios.
  2. Configura el aspecto y la búsqueda en tu panel: tema, colores, fuente y botón. La vista previa se actualiza al instante y, al guardar, tu sitio aplica los cambios por sí solo: no hace falta tocar el código de la página.
  3. Pega el código en tu página. Tu sitio recibe el modelo que alguien quiere imprimir: en un manejador onOrder o como enlace a tu página de pedido.

Código para tu sitio

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>

Opciones

El tema, los colores y el texto del botón no se definen en el código: se guardan en la configuración del widget, en tu panel.

id
El id del widget, que encontrarás en tu panel.
element
El id del elemento (o el propio elemento) donde se insertará el widget.
height
Altura en píxeles. Si no se indica, el widget se ajusta a su contenido.
lang
ru o en. Por defecto, el idioma de la página (el atributo lang).
title
El título del marco para lectores de pantalla.
onReady
El widget se cargó.
onSelect
Un visitante abrió un modelo; sus datos van en el argumento.
onOrder
Un visitante pulsó «Encargar impresión». Con un manejador, el widget no lleva a ninguna parte: muestra tu propio formulario de pedido.

Datos del modelo

sourceUrl es la página del modelo en su plataforma: de ahí descarga el archivo el estudio. polyzonUrl puede estar vacío si el modelo no tiene página en 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": ""
  }
}

Página de pedido en tu sitio

El botón «Encargar impresión» puede llevar a la página de pedido de tu sitio, sin necesidad de un desarrollador. Escribe la dirección de esa página en la configuración del widget (Botón → Página de pedido) y añade etiquetas entre llaves. Cuando un visitante pulse el botón, el widget sustituirá las etiquetas por los datos del modelo elegido, para que veas exactamente qué quiere imprimir. La página debe estar en uno de los dominios del widget.

{polyzon_url}
enlace al modelo en Polyzon
{source_url}
enlace al modelo en la página del autor: de ahí se descarga el archivo para imprimir
{title}
título del modelo
{source}
plataforma, por ejemplo printables
{id}
número del modelo en la plataforma
{image}
enlace a la imagen del modelo

Por ejemplo, en la configuración figura la dirección de abajo. Un visitante elige el organizador y pulsa el botón: llega a tu página con el enlace y el título del modelo en la dirección:

Dirección en la configuración
https://studio.example/order?model={source_url}&title={title}
Adónde llega el visitante
https://studio.example/order?model=https%3A%2F%2Fwww.printables.com%2Fmodel%2F123456-desk-organizer&title=Desk%20organizer

Sin JavaScript

Si no puedes añadir scripts, usa el marco: altura fija y sin eventos para tu sitio, pero el enlace de pedido funciona.

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 tu sitio tiene una CSP estricta

Permite el script y el marco de polyzon.org:

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

Seguridad y límites

  • El widget es un marco independiente: no puede ver tu página, tus cookies ni tus formularios.
  • Sin cookies, anuncios ni contadores de visitas: no hace falta incluirlo en tu banner de cookies.
  • Solo funciona en tus dominios: los navegadores no lo mostrarán en el sitio de nadie más.
  • Hasta 2000 búsquedas al día por widget.
  • El cargador se incluye con integrity: si el archivo cambia alguna vez, el navegador no lo ejecutará.

Normas

  • El widget muestra la búsqueda de Polyzon tal cual: no ocultes la línea «Con la tecnología de» con el logotipo de Polyzon ni hagas pasar los modelos por tuyos.
  • No uses el widget para extraer el catálogo de forma masiva ni lo instales en sitios con contenido ilegal.
  • Los modelos pertenecen a sus autores: comprueba la licencia antes de imprimir por encargo.
  • Polyzon puede limitar o desactivar un widget si se incumplen las normas o en caso de carga elevada.
  • Los datos de contacto de los visitantes los recoge tu sitio: Polyzon ni los recibe ni los transmite.