Nuvaka › Geliştirici belgeleri › Mağaza sunumu
Mağaza sunumu
Uzantının Mağaza'daki kartı, kısa tanıtımı ve görselleri paketten ayrıdır: yeni sürüm çıkarmadan, istediğin zaman değiştirebilirsin. Ad, açıklama, ikon, kategori ve izinler ise manifestten gelir.
Kart türü ve kısa tanıtım
| Alan | Değer | Kural |
|---|---|---|
cardStyle | compact | wide | compact: küçük kart (ikon, ad, açıklama). wide: geniş kart; banner ya da video öne çıkar. |
tagline | { tr?, en? } | kısa tanıtım cümlesi; her dil en çok 90 karakter |
Geniş kart, banner ya da video yüklediğinde anlam kazanır; görseli olmayan uzantı için compact yeterlidir.
Görsel kuralları
| Tür | Biçim ve boyut | Kural |
|---|---|---|
banner | png, jpeg, webp · ≤ 2 MB | genişlik ≥ 640 px, en-boy oranı 1.6–2.2 (yaklaşık 16:9; ör. 1280×720). Tek banner; yenisi eskisinin yerine geçer. |
video | mp4, webm · ≤ 20 MB | geniş kartta sessiz ve otomatik, döngüyle oynar (ses beklenmemeli). Tek video; yenisi eskisinin yerine geçer. |
screenshot | png, jpeg, webp · ≤ 2 MB | en çok 8 ekran görüntüsü; ayrıntı sayfasında görünür |
- Tür dosya adından değil içerikten (dosyanın ilk baytlarından) belirlenir; uzantısı
.pngolan bir jpeg jpeg sayılır, tanınmayan dosya reddedilir. - Hatalar:
415 bad_type(yanlış tür),413 too_large(boyut),400 bad_aspect(banner genişliği ya da oranı),400 limit(8'den fazla ekran görüntüsü). - Görsellerin adresi içerikle değişir; aynı adres her zaman aynı dosyayı verir.
Nereden değiştirilir
Uygulamadan
Profil › Geliştirici › Mağaza sunumu: uzantını seç, kart türünü ve kısa tanıtımı (Türkçe/İngilizce) kaydet, banner, video ve ekran görüntülerini yükle ya da sil. Gizlenmiş bir görsel varsa gizlenme nedeni burada görünür.
CLI'dan
# kart türü ve kısa tanıtım (seçeneksiz: mevcut sunumu gösterir)
nuvaka-ext listing tarikgkhsn.github-watcher --style wide --tagline-tr "Depolarının yeni sürümlerini kaçırma" --tagline-en "Never miss a new release"
# görseller
nuvaka-ext media upload tarikgkhsn.github-watcher --kind banner banner.png
nuvaka-ext media upload tarikgkhsn.github-watcher --kind video tanitim.mp4
nuvaka-ext media upload tarikgkhsn.github-watcher --kind screenshot ekran1.png
nuvaka-ext media list tarikgkhsn.github-watcher
nuvaka-ext media delete tarikgkhsn.github-watcher <mediaId>Bu komutlar giriş yapılmış geliştirici token'ıyla (nuvaka-ext login ya da NUVAKA_TOKEN) çalışır. --tagline-tr "" o dildeki tanıtımı kaldırır; yalnız bir dil verilirse diğerinin değeri korunur. Ayrıntılar: CLI › listing ve media.
Uçlar (kullanıcı oturumu ya da geliştirici token'ı): PUT /api/ext/v1/dev/extensions/{id}/listing, GET|POST /api/ext/v1/dev/extensions/{id}/media (?kind=banner|video|screenshot, ham gövde), DELETE /api/ext/v1/dev/extensions/{id}/media/{mediaId}.
Medya şikâyeti ve gizleme
- Giriş yapmış her kullanıcı bir mağaza görselini ya da yorum görselini şikâyet edebilir; aynı kişi aynı görseli bir kez şikâyet eder.
- 5 farklı kullanıcıdan şikâyet alan görsel kendiliğinden gizlenir. Yöneticiler de nedeniyle gizleyebilir ya da yeniden açabilir.
- Gizlenen görsel
404döner ve kartlardan, ayrıntı sayfasından kaybolur. Nedenini Mağaza sunumu ekranında (hiddenReason) görürsün; yerine uygun bir görsel yükle.
Karanlık tema
Nuvaka arayüzü karanlıktır. Manifestte "themes": ["dark"] (ya da ["dark", "light"]) yazan uzantılar karanlık açılır ve Mağaza'da "Karanlık tema var" süzgecinde çıkar. dark içermeyen uzantılar için kullanıcı kurmadan önce "Bu uygulamanın karanlık teması yok" uyarısını görür. Bkz. Manifest › themes.
Mağaza kullanıcıya nasıl görünür
Raflar
Mağaza'nın ana sayfası sırasıyla şu raflardan oluşur (her rafta en çok 18 uzantı; boş raf gösterilmez):
| Raf | İçerik |
|---|---|
official | Nuvaka onaylı ya da Nuvaka ekibinin yayınladığı uzantılar |
new | yeni yayınlananlar |
top_rated | en az 3 puan almış olanlar, Bayes ortalamasına göre (az puanlı bir uzantı tek bir 5 yıldızla zirveye çıkmaz) |
most_installed | en çok kurulanlar |
recently_updated | yakında güncellenenler |
Süzgeçler ve sıralama
- Bu sürümle uyumlu — varsayılan olarak açık: yalnız
minAppVersion'ı kullanıcının uygulama sürümüne uyanlar listelenir.minAppVersion'ı gereğinden yüksek yazma; uzantın eski sürümlerdeki kullanıcılara görünmez. - Nuvaka onaylı, Karanlık tema var, en yüksek risk (düşük / orta / yüksek), en az puan, kategori ve arama (ad, açıklama, yayıncı kullanıcı adı, kimlik).
- Sıralama: Önerilen, En çok kurulan, En yüksek puan (Bayes ortalaması), En yeni, Son güncellenen.
Yayıncı profili
Kartta ya da ayrıntı sayfasında yayıncı adına tıklanınca yayıncı profili açılır: üyelik tarihi, yayındaki uzantılar, onaylı uzantı sayısı, toplam kurulum ve ortalama puan.
Ayrıntı sayfası ve yorumlar
- Ayrıntı sayfasında banner/video, ekran görüntüleri, sürüm geçmişi ve değişiklik notları (
--changelog), izinler ve gerekçeleri, tehlikeli ikili uyarıları, puan dağılımı ve en faydalı 3 yorum görünür. - Uzantıyı kurmuş kullanıcı 1–5 puan ve yorum (≤ 2000 karakter) yazabilir; kişi başı tek yorum, sonradan güncellenir. Yayıncı yorumlara yanıt yazabilir.
- Yoruma en çok 2 görsel (png/jpeg/webp, her biri ≤ 2 MB) ve 1 video (mp4/webm, ≤ 5 MB) eklenebilir. Yorum görselleri de şikâyet edilebilir ve aynı kurallarla gizlenir.
- Yorumlar en yeni, en faydalı, en yüksek ya da en düşük puana göre sıralanır; yalnız medyalı yorumlar süzülebilir.
Nuvaka Apps API v1 · son güncelleme 2026-09-27