Поиск Polyzon на вашем сайте

Как подключить

1. Создайте виджет и укажите домен сайта — на других сайтах он не откроется.
2. Настройте в кабинете вид и поиск: тему, цвета, шрифт, кнопку. Превью меняется сразу, а после сохранения сайт сам подхватит изменения — код на странице менять не нужно.
3. Вставьте код на страницу. Сайт получит модель, которую хотят напечатать: в обработчике onOrder или ссылкой на вашу страницу заказа.

Код для сайта

<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>

Параметры

Тему, цвета и надпись на кнопке в коде не задают: они хранятся в настройках виджета в кабинете.

id

id виджета из кабинета.

element

id элемента или сам элемент, куда вставить виджет.

height

Высота в пикселях. Без неё виджет подстраивается под содержимое.

lang

ru или en. По умолчанию — язык страницы (атрибут lang).

title

Подпись фрейма для программ экранного доступа.

onReady

Виджет загрузился.

onSelect

Посетитель открыл модель; в аргументе — её данные.

onOrder

Посетитель нажал «Заказать печать». С обработчиком виджет никуда не уводит — покажите свою форму заказа.

Данные модели

sourceUrl — страница модели на площадке: оттуда студия скачивает файл. polyzonUrl бывает пустым, если у модели нет страницы на 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": ""
  }
}

Страница заказа на вашем сайте

Кнопка «Заказать печать» может вести на страницу заказа на вашем сайте — программист не нужен. Впишите адрес этой страницы в настройках виджета («Кнопка» → «Страница заказа») и добавьте в него метки в фигурных скобках. Когда посетитель нажмёт кнопку, виджет подставит вместо меток данные выбранной модели — и вы увидите, что именно хотят напечатать. Страница должна быть на одном из доменов виджета.

{polyzon_url}

ссылка на модель на Polyzon

{source_url}

ссылка на модель у автора: оттуда скачивается файл для печати

{title}

название модели

{source}

площадка, например printables

{id}

номер модели на площадке

{image}

ссылка на картинку модели

Например, в настройках указан адрес ниже. Посетитель выбрал органайзер и нажал кнопку — он попадёт на вашу страницу, а ссылка на модель и её название будут в адресе:

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%20organizer

Без JavaScript

Если скрипты вставлять нельзя, подойдёт фрейм: высота фиксированная и событий для сайта нет, но ссылка на заказ работает.

<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>

Если на сайте строгий CSP

Разрешите скрипт и фрейм с polyzon.org:

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

Безопасность и лимиты

• Виджет — отдельный фрейм: он не видит страницу, cookie и формы вашего сайта.
• Ни cookie, ни рекламы, ни счётчиков посещений: в cookie-баннер его добавлять не нужно.
• Работает только на ваших доменах: на чужом сайте браузер его не покажет.
• До 2000 поисков в сутки на виджет.
• Загрузчик подключается с integrity: если файл изменится, браузер его не выполнит.

Правила

• Виджет показывает поиск Polyzon как есть: не скрывайте подпись «Поиск от» с логотипом Polyzon и не выдавайте модели за свои.
• Не используйте виджет для выкачивания каталога и не ставьте его на сайты с незаконным содержанием.
• Права на модели принадлежат авторам: проверяйте лицензию, прежде чем печатать на заказ.
• Polyzon может ограничить или отключить виджет при нарушении правил или большой нагрузке.
• Контакты посетителей собирает ваш сайт: Polyzon их не получает и не передаёт.