Kendi Sitenize ZPL Etiket Önizleyici Gömme

Yayın tarihi: 2026-08-25

Dokümantasyonunuz, destek portalınız ya da iç aracınız ZPL kodu gösteriyorsa, yanında render edilmiş etiketi tek iframe ile gösterebilirsiniz. JavaScript kütüphanesi yok, API anahtarı yok, sunucu tarafı kod yok:

<iframe
  src="https://labelixa.com/embed/viewer#KODLANMIS"
  style="width:100%;height:420px;border:0"></iframe>

# işaretinden sonra ne var

Parça (fragment), etiketi taşıyan base64 kodlu bir JSON nesnesidir:

const veri = {z: "^XA^FO50,50^A0N,40^FDMerhaba^FS^XZ",
              d: "8",   // dpmm: 6, 8, 12 ya da 24
              w: "4",   // genişlik (inç)
              h: "6"};  // yükseklik (inç)
const hash = btoa(unescape(encodeURIComponent(JSON.stringify(veri))));
iframe.src = "https://labelixa.com/embed/viewer#" + hash;

Doğru değeri almanın en kolay yolu: ZPL görüntüleyiciyi açın, etiketi yapıştırın ve "bağlantıyı kopyala" deyin — # sonrası tam olarak bu biçimdir.

ZPL neden fragment'te taşınıyor

# sonrası hiçbir isteğin URL'inde gönderilmez; etiket içeriğiniz vekil loglarına, CDN loglarına ya da Referer başlığına düşmez. Gömülü sayfa onu tarayıcıda okur ve ana görüntüleyiciyle aynı API üzerinden render eder.

Dürüst sınırlar

Gömme anonim render kotasını kullanır; dokümantasyon sayfaları ve destek konuları için yeterlidir ama yüksek trafikli ürün sayfaları için boyutlandırılmamıştır — orada API üzerinden anahtarla sunucu tarafında render edip görseli önbelleğe alın. iframe verdiğiniz yüksekliğe uyar; etiketin altında küçük bir "Labelixa" bağlantısı görünür kalır: ücretsiz gömmenin bedeli o bağlantıdır.

Görüntüleyiciyi kendi sayfanızda anın

iframe belgesi labelixa.com'da yaşar; içindeki bağlantı sizin sitenizde hiçbir şey saymaz. Ücretsiz görüntüleyiciyi gerçekten işe yaradığı yerde anmak ve başkalarının onu bulmasına yardım etmek isterseniz, çerçevenin altına kendi HTML'inizde tek satırlık bir altyazı koyun:

<p class="caption">Etiket
<a href="https://labelixa.com/tr/tools/zpl-preview">Labelixa ZPL önizleyici</a> ile render edildi</p>

İsteğe bağlıdır; gömme onsuz da çalışır.

README'niz için rozet

Deponuz CI'da doğrulanan ZPL dosyaları taşıyorsa (tanılama API'si ya da npx labelixa validate hatada sıfır dışı çıkar), bunu bir rozetle söyleyebilirsiniz:

[![ZPL validated with Labelixa](https://labelixa.com/static/badge-zpl-validated.svg)](https://labelixa.com/tools/zpl-preview)

Rozet statik bir SVG'dir — sayaç yok, izleme yok, bir gün önbelleklenir. Yalnız iddia deponuz için doğruysa kullanın: kimsenin doğrulamadığı dosyaların yanında "doğrulandı" diyen rozet kimseye yardım etmez.

Okurlar kendi ZPL'lerini denesin

Yukarıdaki görüntüleyici tek bir sabit etiket gösterir. Okurların sayfanızdan ayrılmadan kendi ZPL'lerini yapıştırıp çizmesini istiyorsanız — bir eğitim yazısı, bilgi bankası maddesi, destek formu — onun yerine deneme bileşenini gömün:

<iframe src="https://labelixa.com/embed/try"
        width="100%" height="520" loading="lazy"
        title="ZPL dene"></iframe>

Aynı minimal yüzeydir; bir metin kutusu ve Çiz düğmesi vardır. Görüntüleyiciyle aynı parça biçimiyle önceden doldurabilirsiniz (/embed/try#…): etiket kutuda belirir ve yüklenince bir kez çizilir. Çizimler sizin değil okurun anonim kotasından düşer; metin, çizim isteği dışında tarayıcıdan çıkmaz.

Sık sorulan sorular

Görüntüleyiciyi gömmek için API anahtarı gerekir mi?

Hayır. Gömme anonim render kotasıyla çalışır — dokümantasyon ve destek sayfalarına yeter. Yüksek trafikli sayfalar API üzerinden anahtarla sunucu tarafında render edip görseli önbelleğe almalı.

iframe URL'indeki ZPL sunucularınıza gönderiliyor mu?

Etiket # işaretinden sonra (URL fragment'inde) taşınır; tarayıcılar bu kısmı istek URL'inin parçası olarak asla göndermez — vekil loglarına, CDN loglarına ve Referer başlığına düşmez. Render, ana görüntüleyiciyle aynı API üzerinden olur.

README'm için ZPL rozetini nasıl alırım?

Rozet bölümündeki Markdown satırını kopyalayın: labelixa.com'dan statik bir SVG gömer ve görüntüleyiciye bağlanır. Kayıt yok, sayaç yok. Yalnız deponuz ZPL dosyalarını CI'da gerçekten doğruluyorsa kullanın.

Etiketin altındaki Labelixa bağlantısını kaldırabilir miyim?

Hayır — görünür bağlantı ücretsiz gömmenin bedelidir. Markasız görsel gerekiyorsa API üzerinden render edip PNG'yi kendiniz sunun.

İlgili yazılar

Kendi ZPL kodunuzu deneyin →