Örnekler

Çarkıfelek

Müşteri ekrandaki çarkı dokunarak ya da QR’ı telefonla okutarak çevirir; kazanan kasada söyleyeceği tek kullanımlık bir kod alır. Viswoo’nun ilk paket eklentisidir ve bu belgelerdeki her kuralı uygular.

Kaynağı indir (ZIP)

Dosya	Ne
viswoo-plugin.json	İzinler settings, events, codes, draw, public; ayar şeması (başlık ve dilimler zorunlu; şans, stok, kazandırır sunucuya özel); draw.pools.default dilimlerden; yerleşim biçimleri
player.html	Ekran görünümü: çark tuvale çizilir, dokunmatikte “Dokun, çevir”, her ekranda QR. Sonuç katmanında büyük kod
public/	Telefon sayfası: aynı çark, günde bir hak, kazanılan kod tarayıcıda saklanır
panel/	Kasa ve istatistik sekmesi: kod doğrulama ve teslim, son 30 gün, kalan stok, telefon bağlantısı
shared/	Ekran ve telefonun ortak çark çizimi ve QR üreticisi; pack ekran görünümüne gömer

Öne çıkanlar:

• Ayar formu yok; kampanya tarihleri ve ekranlar panelin Ekranlar sekmesinde.
• Çark çizimi çerçeve boyut alınca yapılır, resize’da tekrarlanır; etiketler sığmazsa yazı küçülür.
• Çevirme call('draw') ile sunucuda; sonuç gelmeden çark döner, sonuçta durur.
• Hatalar koddan iki dilli metne çevrilir (plugin.limit_reached, plugin.pool_empty, plugin.not_live …).

Simülatörde çalıştırmak için:

unzip carkifelek.zip -d carkifelek && cd carkifelek
npx @viswoo/plugin-sdk dev .

Merhaba Dünya

En küçük paket: panelde bir sekme, ekranda selamlama, ayarlarda selam metni.

Kaynağı indir (ZIP)

Şablonlar

viswoo-plugin init üç şablon açar (basic, interactive, server); her biri çalışan bir eklentidir ve Başlarken sayfasında anlatılır.