Busca do Polyzon no seu site

Para estúdios de impressão 3D e lojas: os visitantes encontram um modelo direto no seu site, e você recebe o que eles querem imprimir.

Experimente

Troque o tema, a cor e o botão — seu widget é configurado do mesmo jeito. Abra um modelo e clique no botão: o que o seu site recebe aparece ao lado.

Tema

Cor de destaque

O que o botão faz

O que o seu site recebe

Nada ainda: abra um modelo no widget.

Meus widgets

Entre para criar um widget

Como instalar

Crie um widget e adicione o domínio do seu site — ele não abre em outros sites.
Configure a aparência e a busca no seu painel: tema, cores, fonte, botão. A prévia é atualizada na hora e, depois que você salva, o site aplica as mudanças sozinho — não é preciso mexer no código da página.
Cole o código na sua página. Seu site recebe o modelo que a pessoa quer imprimir: em um handler onOrder ou como link para a sua página de pedidos.

Código para o seu 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>

Opções

Tema, cores e texto do botão não são definidos no código: eles ficam nas configurações do widget, no seu painel.

id: O id do widget, que está no seu painel.
element: O id do elemento (ou o próprio elemento) onde o widget será inserido.
height: Altura em pixels. Sem ela, o widget se ajusta ao conteúdo.
lang: ru ou en. Por padrão, o idioma da página (atributo lang).
title: Título do frame para leitores de tela.
onReady: O widget carregou.
onSelect: Um visitante abriu um modelo; os dados dele vêm no argumento.
onOrder: Um visitante clicou em “Pedir impressão”. Com um handler, o widget não redireciona para lugar nenhum — mostre seu próprio formulário de pedido.

Dados do modelo

sourceUrl é a página do modelo na plataforma: é de lá que o estúdio baixa o arquivo. polyzonUrl pode vir vazio quando o modelo não tem página no 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 pedidos no seu site

O botão “Pedir impressão” pode levar à página de pedidos do seu site — sem precisar de programador. Coloque o endereço dessa página nas configurações do widget (Botão → Página de pedidos) e adicione tags entre chaves. Quando um visitante clicar no botão, o widget coloca os dados do modelo escolhido no lugar das tags, e você vê exatamente o que ele quer imprimir. A página precisa estar em um dos domínios do widget.

{polyzon_url}: link para o modelo no Polyzon
{source_url}: link para o modelo no site do autor: é de lá que se baixa o arquivo para impressão
{title}: título do modelo
{source}: plataforma, por exemplo printables
{id}: número do modelo na plataforma
{image}: link para a imagem do modelo

Digamos que as configurações tenham o endereço abaixo. Um visitante escolhe o organizador e clica no botão — ele chega à sua página com o link e o título do modelo no endereço:

Endereço nas configurações

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

Onde o visitante chega

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

Sem JavaScript

Se você não pode adicionar scripts, use o frame: a altura é fixa e não há eventos para o seu site, mas o link 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>

Se o seu site tem uma CSP restritiva

Permita o script e o frame de polyzon.org:

Content-Security-Policy

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

Segurança e limites

O widget é um frame separado: ele não vê sua página, seus cookies nem seus formulários.
Sem cookies, anúncios ou contadores de visitas: ele não precisa entrar no seu banner de cookies.
Funciona só nos seus domínios: os navegadores não o exibem no site de mais ninguém.
Até 2000 buscas por dia por widget.
O script de carregamento é incluído com integrity: se o arquivo mudar, o navegador não o executa.

Regras

O widget mostra a busca do Polyzon como ela é: não oculte a linha “Com tecnologia” com o logo do Polyzon nem apresente os modelos como seus.
Não use o widget para extrair o catálogo nem o coloque em sites com conteúdo ilegal.
Os modelos pertencem aos seus autores: confira a licença antes de imprimir sob encomenda.
O Polyzon pode limitar ou desativar um widget se as regras forem violadas ou em caso de carga alta.
Quem coleta os dados de contato dos visitantes é o seu site: o Polyzon não os recebe nem os repassa.