Ana içeriğe geç

Giriş

🎯 Bu modül ne yapar?​

ProductStatuses modülü, mevcut nitelik tabanlı filtrelerin yanında katalog öğeleri için ek filtreleme koşulları sağlar. Product Statuses, e-ticaret kataloğunuzdaki ürünleri düzenlemek ve filtrelemek için "Yeni Gelen", "En Çok Satan", "İndirimli", "Stokta Yok" gibi özel ürün etiketleri ve filtreler oluşturmanıza olanak tanır.

Statüler, katalog öğeleri için ek filtreleme mekanizmaları olarak hizmet eder ve ürün yönetimi için daha ayrıntılı organizasyon ve kategorilendirme seçenekleri sunmak amacıyla nitelik tabanlı filtreleme ile birlikte çalışır.

Bunu ürün etiketleme sisteminiz olarak düşünün - OneEntry yönetim panelinde (Katalog > Ürün Statüleri) statü etiketlerini tanımlarsınız, bunları ürünlere atarsınız ve ürünleri dinamik olarak filtrelemek, etiketlemek ve kategorize etmek için kullanırsınız.

📖 Basit Açıklama​

Her e-ticaret mağazası özel ürünleri vurgulamak zorundadır:

  • 🆕 Yeni Gelen - Yakın zamanda eklenen ürünler
  • 🔥 En Çok Satan - Popüler ürünler
  • 💰 İndirimli - İndirimli ürünler
  • ⭐ Öne Çıkan - Vurgulanan ürünler
  • 📦 Stokta Yok - Mevcut olmayan ürünler
  • 🎁 Sınırlı Üretim - Özel ürünler
  • 🚚 Ücretsiz Kargo - Ücretsiz teslimatlı ürünler

Sorunlar:

  • 🔒 Esnek Değil - Yeni statüler eklemek için kod değişiklikleri gerektirir
  • 📊 Yönetimi Zor - Birden fazla boolean alanı
  • 🔄 Yeniden Kullanılabilirlik Yok - Statü mantığını yeniden kullanamazsınız
  • 🎨 Tutarsız - Her yerde farklı etiket stilleri

ProductStatuses çözümü:

Faydalar:

  • 🔒 Esnek - Yönetim panelinde statü ekleyip çıkarabilirsiniz
  • 📊 Kolay Yönetim - Merkezileştirilmiş statü tanımları
  • 🔄 Yeniden Kullanılabilir - Birçok ürün için aynı statü
  • 🎨 Tutarlı - Tek tip etiket görüntüleme

✨ Temel Kavramlar​

Ürün Statüsü Nedir?​

Ürün Statüsü, ürünler için özel bir etiket/etikettir:

  • Statü Adı - Görüntüleme adı (örn. "Yeni Gelen", "İndirimli")
  • Statü İşareti - Filtreleme için benzersiz tanımlayıcı
  • Renk/Stil - Görsel temsil (yönetim panelinde yapılandırılır)
  • Ürün İlişkilendirmesi - Hangi ürünlerin bu statüye sahip olduğu
  • Filtreleme - Statüye göre ürünleri sorgulama

Ürün Statüsü İş Akışı​

1. Yönetim panelinde statü oluştur
   (örn. "Yeni Gelen")
   ↓
2. Statüyü ürünlere ata
   (Yönetimde ürünleri seç)
   ↓
3. SDK aracılığıyla statüleri al
   (ProductStatuses.getProductStatuses())
   ↓
4. Ürünlerde statü etiketlerini göster
   (Ürün listelerinde etiketleri render et)
   ↓
5. Statüye göre ürünleri filtrele
   (Products.getProducts({ statusId }))

Neden ProductStatuses Modülünü Kullanmalısınız?​

FaydasıAçıklama
Esnek FiltrelemeÜrünleri birden fazla özel kritere göre filtreleyin
Dinamik EtiketlerHardcoding olmadan görsel etiketler gösterin
Kolay YönetimYönetim panelinde statü ekleyip çıkarın
Yeniden Kullanılabilir EtiketlerBirçok ürüne aynı statüyü uygulayın
Çok DilliStatü adları her dil için yerelleştirilmiştir
Özel StilHer statü için renk ve stilleri tanımlayın

📋 Bilmeniz Gerekenler​

Ürün Statüleri Yönetim Panelinde Oluşturulur​

SDK aracılığıyla statü oluşturamazsınız - bunlar OneEntry yönetim panelinde oluşturulur:

OneEntry Yönetim Paneli → Katalog → Ürün Statüleri → Statü Oluştur → Ad/İşaret Belirle → Kaydet

Oluşturma Süreci:

  • Ad Sağlayın - Statü tanımı (zorunlu)
  • İşaret Sağlayın - Benzersiz tanımlayıcı (zorunlu, yalnızca Latin harfleri/rakamlar/'_'/'-' kullanılabilir)
  • Tamamlamak için "Oluştur" butonuna tıklayın

İşaret Kısıtlamaları:

  • Sadece Latin harfleri (a-z, A-Z)
  • Rakamlar (0-9)
  • Alt çizgi (_) ve tire (-) sembolleri
  • Özel karakterler veya boşluklar yasaktır

Statü Yönetimi:

  • Listeyi Görüntüle - Ad, İşaret ve İşlemler sütunlarıyla tablo
  • Statüyü Düzenle - Ad ve İşaret alanlarını değiştir
  • Statüyü Sil - Kullanılmayan statüleri kaldır
  • Sıralama - Görüntüleme sırasını değiştirmek için sürükleyip bırak (bu sortOrder alanını etkiler)

SDK, statüleri alma ve ürünleri filtreleme için kullanılır, statü oluşturmak için değil.

Statü Ataması​

Statüler, yönetim panelinde ürünlere atanır:

OneEntry Yönetim Paneli → Ürünler → Ürünü Düzenle → Statüleri Ata → Kaydet

SDK'da: Ürünler, atanan statü kimlikleri ile statusIds dizisine sahiptir:

const product = await Products.getProductById(123);
console.log(product.statusIds); // [1, 2] - Statü Kimlikleri

Statüye Göre Filtreleme​

Ürünleri filtrelemek için statü kimliğini kullanın

Çok Dilli Destek​

Statü adları otomatik olarak yerelleştirilir

💡 Önemli Notlar​

Statüler Yönetim Panelinde Oluşturulur​

Unutmayın: SDK, statüleri alma işlemi içindir, oluşturma işlemi için değil.

Statü oluşturmak/düzenlemek için: OneEntry Yönetim Panelini kullanın.

Statü Listesi Arayüzü​

Yönetim paneli, üç sütunlu bir tabloda tüm statüleri görüntüler:

  • Ad - Statü tanımı
  • İşaret - Benzersiz tanımlayıcı
  • İşlemler - Düzenleme ve silme işlemleri, ayrıca sürükleyip bırakma ile sıralama

İşaret Doğrulaması​

Önemli: validateMarker() metodu, bir işaretin oluşturulmadan/ kullanılmadan önce zaten var olup olmadığını kontrol etmeye yardımcı olur.

İşaret kısıtlamaları:

  • Sadece Latin alfanümerik karakterler (a-z, A-Z, 0-9)
  • Alt çizgi (_) ve tire (-) izin verilir
  • Boşluk veya özel karakter yok
  • Tüm statüler arasında benzersiz olmalıdır

Bir Ürün İçin Birden Fazla Statü​

Ürünler aynı anda birden fazla statüye sahip olabilir (örn. "Yeni Gelen" + "İndirimli")

Statü ve Nitelikler​

ProductStatuses, ürün niteliklerinden farklıdır:

ÖzellikProductStatusesNitelikler
AmaçEtiketler/rozetler/filtrelerÜrün özellikleri
Örnekler"Yeni", "İndirimli", "Öne Çıkan"Renk, Boyut, Malzeme
Birden Fazla DeğerEvet (birden fazla statü)Evet (birden fazla nitelik)
FiltrelemeBasit (statü kimliğine göre)Karmaşık (aralıklar, değerler)
Kullanım durumuPazarlama etiketleriÜrün spesifikasyonları

En iyi uygulama: Pazarlama etiketleri için statüleri, ürün özellikleri için nitelikleri kullanın.

📊 Hızlı Referans Tablosu​

MetotAçıklamaKullanım Durumu
getProductStatuses()Tüm ürün statülerini alTüm mevcut statüleri listele
getProductsByStatusMarker()Statüyü işaretine göre alTanımlayıcıya göre statü al
validateMarker()İşaretin var olup olmadığını kontrol etKullanımdan önce işareti doğrula

❓ Sıkça Sorulan Sorular (SSS)​

Ürün statüleri ile ürün nitelikleri arasındaki fark nedir?​

Ürün statüleri, filtreleme ve etiketleme için pazarlama etiketleridir (Yeni, İndirimli, Öne Çıkan), nitelikler ise ürün spesifikasyonlarıdır (Renk, Boyut, Malzeme). Pazarlama etiketleri için statüleri, ürün özellikleri için nitelikleri kullanın.

Bir ürün aynı anda birden fazla statüye sahip olabilir mi?​

Evet! Ürünler aynı anda birden fazla statüye sahip olabilir. Örneğin, bir ürün hem "Yeni Gelen" hem de "İndirimli" olabilir. Ürün nesnesindeki statusIds dizisi, tüm atanan statü kimliklerini içerir.

Ürünleri statüye göre nasıl filtrelerim?​

Statü filtreleri ile Products modül yöntemlerini kullanın. Belirli statülere sahip ürünleri almak için sorgunuzda statü kimliğini veya işaretini geçirin. Birden fazla statü filtresini de birleştirebilirsiniz.

Statü oluşturulmadan önce bir işareti nasıl doğrularım?​

validateMarker() metodunu kullanarak bir işaretin zaten var olup olmadığını kontrol edin. Bu, tekrar eden işaretleri önlemeye yardımcı olur ve işaretinizin adlandırma kurallarına (sadece Latin harfleri, rakamlar, alt çizgi, tire) uymasını sağlar.

Gösterilen statülerin sırasını değiştirebilir miyim?​

Evet! Yönetim panelinde, statüleri sürükleyip bırakarak sıralayabilirsiniz. Bu, sortOrder alanını etkiler ve uygulamanızda görüntüleme önceliğini belirler.

Statü etiketlerine özel stil eklemek için ne yapmalıyım?​

Tüm statüleri alın, statü işaretlerini CSS sınıflarına veya ön uç kodunuzda satır içi stillere eşleştirin. Ürünlerin statusIds dizisine göre etiketleri render ederken bu stilleri uygulayın.

🎓 En İyi Uygulamalar​

  • Açıklayıcı işaretler kullanın - new_arrival, status1 değil
  • Renkleri tutarlı tanımlayın - Marka renk paletini kullanın
  • Aktif statüleri sınırlayın - Kullanıcıları çok fazla etiketle bunaltmayın
  • Statü adlarını kısa tutun - "İndirimli" "İndirimdeki Ürünler"dan daha iyidir
  • Filtreleme için statü kullanın - Statüleri UI'da filtrelenebilir hale getirin
  • Statüleri önbelleğe alın - Nadiren değişir, performans için önbelleğe alın
  • Birden fazla statüyü gösterin - Ürünlerde tüm ilgili etiketleri gösterin
  • Sıralama için statü kullanın - Öncelikle "Öne Çıkan" statüsüne göre sıralayın

OneEntry yönetim panelinde ürün statüleri hakkında daha fazla bilgi: https://doc.oneentry.cloudhttps://doc.oneentry.cloud/docs/catalog/product-statuses/

ProductStatuses modülünün tanımı​

ProductStatuses modülü, nitelikler tarafından tanımlanan koşullara ek olarak filtreler olarak hizmet eden statüleri yönetir. Product Statuses, Platform OneEntry'deki katalog öğeleri için ek filtreleme koşulları sağlar ve nitelik tabanlı filtreleme ile birlikte çalışır.


const { ProductStatuses } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 İlgili Belgeler​