Web sitenizde Polyzon araması

3D baskı stüdyoları ve mağazalar için: ziyaretçiler modeli doğrudan sitenizde bulur, siz de neyi bastırmak istediklerini öğrenirsiniz.

Deneyin

Temayı, rengi ve düğmeyi değiştirin; widget'ınız da aynı şekilde ayarlanır. Bir model açıp düğmeye basın: sitenizin alacağı veriler yanda görünür.

Tema
Vurgu rengi
Düğmenin işlevi

Sitenize gelen veriler

Henüz bir şey yok: widget'ta bir model açın.

Widget'larım

Widget oluşturmak için giriş yapın

Nasıl kurulur

  1. Bir widget oluşturun ve sitenizin alan adını ekleyin; widget başka sitelerde açılmaz.
  2. Görünümü ve aramayı panelinizden ayarlayın: tema, renkler, yazı tipi, düğme. Önizleme anında güncellenir; kaydettiğinizde site değişiklikleri kendiliğinden alır, sayfadaki koda dokunmanız gerekmez.
  3. Kodu sayfanıza yapıştırın. Siteniz, bastırılmak istenen modeli onOrder işleyicisinde ya da sipariş sayfanıza giden bir bağlantıyla alır.

Siteniz için kod

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>

Seçenekler

Tema, renkler ve düğme metni kodda ayarlanmaz: bunlar widget'ın panelinizdeki ayarlarında saklanır.

id
Panelinizdeki widget kimliği (id).
element
Widget'ın yerleştirileceği öğenin id'si (veya öğenin kendisi).
height
Piksel cinsinden yükseklik. Belirtilmezse widget içeriğine göre boyutlanır.
lang
ru veya en. Varsayılan olarak sayfanın dili (lang özniteliği).
title
Ekran okuyucular için çerçeve başlığı.
onReady
Widget yüklendi.
onSelect
Ziyaretçi bir model açtı; modelin verileri argüman olarak gelir.
onOrder
Ziyaretçi “Baskı siparişi ver” düğmesine bastı. İşleyici varsa widget hiçbir yere yönlendirmez; kendi sipariş formunuzu gösterin.

Model verileri

sourceUrl, modelin kendi platformundaki sayfasıdır: stüdyo dosyayı oradan indirir. Modelin Polyzon'da sayfası yoksa polyzonUrl boş olabilir.

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

Sitenizdeki sipariş sayfası

“Baskı siparişi ver” düğmesi sitenizdeki sipariş sayfasına yönlendirebilir; geliştiriciye gerek yok. Bu sayfanın adresini widget ayarlarına girin (Düğme → Sipariş sayfası) ve süslü parantez içinde etiketler ekleyin. Ziyaretçi düğmeye bastığında widget etiketlerin yerine seçilen modelin verilerini koyar; böylece tam olarak neyin bastırılmak istendiğini görürsünüz. Sayfa, widget'ın alan adlarından birinde olmalıdır.

{polyzon_url}
Polyzon'daki model bağlantısı
{source_url}
yazarın sitesindeki model bağlantısı: baskı dosyası oradan indirilir
{title}
model adı
{source}
platform, örneğin printables
{id}
modelin platformdaki numarası
{image}
model görselinin bağlantısı

Diyelim ki ayarlarda aşağıdaki adres var. Ziyaretçi düzenleyiciyi seçip düğmeye basıyor ve adresinde model bağlantısı ile model adı bulunan sayfanıza geliyor:

Ayarlardaki adres
https://studio.example/order?model={source_url}&title={title}
Ziyaretçinin yönlendirileceği adres
https://studio.example/order?model=https%3A%2F%2Fwww.printables.com%2Fmodel%2F123456-desk-organizer&title=Desk%20organizer

JavaScript olmadan

Betik ekleyemiyorsanız çerçeveyi kullanın: yükseklik sabittir ve siteniz olay almaz, ancak sipariş bağlantısı çalışır.

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>

Sitenizde katı bir CSP varsa

polyzon.org kaynaklı betiğe ve çerçeveye izin verin:

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

Güvenlik ve limitler

  • Widget ayrı bir çerçevedir: sayfanızı, çerezlerinizi veya formlarınızı göremez.
  • Çerez, reklam veya ziyaret sayacı yok: çerez bildiriminize eklemeniz gerekmez.
  • Yalnızca sizin alan adlarınızda çalışır: tarayıcılar onu başka bir sitede göstermez.
  • Widget başına günde en fazla 2000 arama.
  • Yükleyici integrity özniteliğiyle eklenir: dosya bir gün değişirse tarayıcı onu çalıştırmaz.

Kurallar

  • Widget, Polyzon aramasını olduğu gibi gösterir: Polyzon logolu “Arama altyapısı” satırını gizlemeyin ve modelleri kendinizinmiş gibi sunmayın.
  • Widget'ı kataloğu toplu olarak çekmek için kullanmayın ve yasa dışı içerik barındıran sitelere yerleştirmeyin.
  • Modeller yazarlarına aittir: sipariş üzerine baskı yapmadan önce lisansı kontrol edin.
  • Kurallar ihlal edilirse veya yük çok artarsa Polyzon bir widget'ı sınırlayabilir veya devre dışı bırakabilir.
  • Ziyaretçilerin iletişim bilgilerini sizin siteniz toplar: Polyzon bunları almaz ve kimseye aktarmaz.