在你的网站上使用Polyzon搜索

面向3D打印工作室和商店：访客直接在你的网站上找到模型，你就能知道对方想打印什么。

试一试

切换主题、颜色和按钮——你的插件也是这样设置的。打开一个模型并点击按钮，旁边就会显示你的网站将收到的内容。

主题
强调色
按钮功能

你的网站会收到什么

暂无内容：请在插件中打开一个模型。

我的插件

登录后即可创建插件

接入方法

  1. 创建插件并填写你的网站域名——插件在其他网站上无法打开。
  2. 在控制台中设置外观和搜索：主题、颜色、字体、按钮。预览即时更新，保存后网站会自动应用更改，无需修改页面代码。
  3. 将代码粘贴到你的页面中。你的网站会收到访客想打印的模型：通过onOrder处理函数，或以链接形式跳转到你的订单页面。

网站代码

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>

参数

主题、颜色和按钮文字不在代码中设置，而是保存在控制台的插件设置里。

id
控制台中的插件ID。
element
放置插件的元素ID（或元素本身）。
height
高度（像素）。不设置时，插件会根据内容自适应高度。
lang
ru或en。默认使用页面语言（lang属性）。
title
供屏幕阅读器使用的框架标题。
onReady
插件已加载。
onSelect
访客打开了一个模型；参数为该模型的数据。
onOrder
访客点击了“下单打印”。设置处理函数后，插件不会跳转——请显示你自己的订单表单。

模型数据

sourceUrl是模型在其平台上的页面，工作室从那里下载文件。如果模型在Polyzon上没有页面，polyzonUrl可能为空。

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": ""
  }
}

你网站上的订单页面

“下单打印”按钮可以直接跳转到你网站上的订单页面，无需开发人员。在插件设置中（“按钮”→“订单页面”）填写该页面的地址，并添加带花括号的标签。访客点击按钮时，插件会用所选模型的数据替换这些标签，你就能准确知道对方想打印什么。该页面必须位于插件的某个域名下。

{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：高度固定，也不会向你的网站发送事件，但订单链接可以正常使用。

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>

如果你的网站启用了严格的CSP

请允许来自polyzon.org的脚本和框架：

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

安全与限制

  • 插件运行在独立的框架中：无法访问你的页面、Cookie或表单。
  • 不使用Cookie、不含广告、不统计访问：无需将其加入你的Cookie提示横幅。
  • 仅在你的域名上运行：在其他网站上，浏览器不会显示它。
  • 每个插件每天最多2000次搜索。
  • 加载器带有integrity校验：一旦文件发生变化，浏览器将不会执行它。

使用规则

  • 插件按原样展示Polyzon搜索：不要隐藏带有Polyzon标志的“技术支持”字样，也不要把模型冒充为自己的作品。
  • 不要用插件批量抓取目录，也不要将其放在含有违法内容的网站上。
  • 模型归作者所有：接单打印前，请先核实许可协议。
  • 如有违反规则或负载过高，Polyzon可能会限制或停用插件。
  • 访客的联系方式由你的网站收集：Polyzon既不接收，也不转交这些信息。