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.
Sitenize gelen veriler
Henüz bir şey yok: widget'ta bir model açın.
Widget'larım
Widget oluşturmak için giriş yapınNasıl kurulur
- Bir widget oluşturun ve sitenizin alan adını ekleyin; widget başka sitelerde açılmaz.
- 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.
- 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
<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.
{
"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:
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%20organizerJavaScript olmadan
Betik ekleyemiyorsanız çerçeveyi kullanın: yükseklik sabittir ve siteniz olay almaz, ancak sipariş bağlantısı çalışır.
<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:
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.