あなたのサイトに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は配布元サイトのモデルページで、工房はここからファイルをダウンロードします。モデルのページがPolyzonにない場合、polyzonUrlは空になることがあります。

{
  "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バナーに追加する必要はありません。
• あなたのドメインでのみ動作します。ほかのサイトでは、ブラウザが表示しません。
• 1ウィジェットあたり、1日2000回まで検索できます。
• ローダーはintegrity属性付きで読み込まれます。ファイルが変更された場合、ブラウザは実行しません。

ルール

• ウィジェットはPolyzonの検索をそのまま表示するものです。Polyzonのロゴ付きの「検索提供」表示を隠したり、モデルを自分のものと偽ったりしないでください。
• カタログのスクレイピングにウィジェットを使用したり、違法なコンテンツを含むサイトに設置したりしないでください。
• モデルの権利は作者にあります。受注プリントの前に、ライセンスをご確認ください。
• ルール違反や高負荷の場合、Polyzonはウィジェットを制限または無効化することがあります。
• 訪問者の連絡先はあなたのサイトが収集します。Polyzonがそれらを受け取ったり、第三者に渡したりすることはありません。