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.
Lo que recibe tu sitio
Aún nada: abre un modelo en el widget.
Mis widgets
Inicia sesión para crear un widgetCómo integrarlo
- Crea un widget y añade el dominio de tu sitio: no se abrirá en otros sitios.
- 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.
- 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
<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.
{
"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:
https://studio.example/order?model={source_url}&title={title}https://studio.example/order?model=https%3A%2F%2Fwww.printables.com%2Fmodel%2F123456-desk-organizer&title=Desk%20organizerSin JavaScript
Si no puedes añadir scripts, usa el marco: altura fija y sin eventos para tu sitio, pero el enlace de pedido funciona.
<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:
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.