# Kart Alanları

Kartta gösterilebilecek veri alanları
Kaynak: https://selwise.com/docs/product-cards/fields

Kartta gösterilebilecek veri alanları. Hepsi ürün beslemenizden gelir; kartı tasarlarken bir metni, rozeti ya da koşulu bu alanlara bağlarsınız.

## Panelde nerede

- **Designer** (Tasarımcı): bir **Text** öğesi seçin → **Product field** (Ürün alanı) listesi. Rozetin **Product field** kaynağı ve **Visibility** koşulları aynı listeyi kullanır.
- **My own code** (Kendi kodum): **Slot bindings** bölümünde bir token'ı bir ürün alanına bağlarken kullanılan **Select field** listesi; HTML editörünün yanındaki **Token reference** (Token başvurusu) paneli.

## Kullanılabilir alanlar

Toplam 20 alan vardır. Tür, değerin koşullarda nasıl karşılaştırıldığını belirler.

| Alan | Tür | Kaynak |
|---|---|---|
| `id` | metin | Ürün kimliği |
| `title` | metin | Ürün adı |
| `description` | metin | Tam açıklama |
| `shortDescription` | metin | Kısa açıklama |
| `price` | sayı | Satış fiyatı |
| `originalPrice` | sayı | Liste fiyatı |
| `discountRate` | sayı | Beslemedeki indirim oranı; besleme vermiyorsa iki fiyattan hesaplanır |
| `imageUrl` | metin | Ürün görseli |
| `url` | metin | Ürün sayfası adresi |
| `categories` | metin | Kategoriler |
| `categoryHierarchy` | metin | Kategori yolu |
| `productType` | metin | Ürün tipi |
| `stock` | sayı | Stok adedi |
| `inStock` | mantıksal | Stokta var mı |
| `sku` | metin | Stok kodu |
| `brand` | metin | Marka |
| `rating` | sayı | Puan |
| `reviewCount` | sayı | Değerlendirme sayısı |
| `isNew` | mantıksal | Yeni ürün mü |
| `isBestseller` | mantıksal | Çok satan mı |

Bunların yanında beslemenizin **özel alanları** `attr.alan_adı` olarak listelenir (örneğin `attr.garanti_suresi`). Özel alanlar her zaman metindir. Alan adlarının nasıl oluştuğu için: [Ürün Özellikleri](/docs/product-enrichment/product-attributes). Liste yüklenemezse yalnızca standart alanlar sunulur.

Kart tasarımcısına özgü iki veri daha vardır ve alan listesinde yer almaz: **Hover image** öğesi için ürünün ek görselleri, **Colours** öğesi için aynı grup kodlu kardeş ürünler. Bkz. [Kart Tasarımcısı](/docs/product-cards/designer).

## Alan boşsa

Beslemenizde karşılığı olmayan bir alanı kartta kullanırsanız o öğe **çizilmez**: metin öğesi boş kalır ve ayrı bir satır bırakmaz; yedek metin (**Fallback text**) yazdıysanız o görünür. Özel HTML kartında ise token boş metne döner, öğe yerinde kalır; boş öğeyi CSS ile gizleyin (`.marka:empty { display: none; }`). Panelde **Product Feeds** ekranından birkaç ürüne bakıp hangi alanların dolu olduğunu görün.

En sık boş kalanlar: `brand`, `rating`, `reviewCount`, `shortDescription`. Bunlar çoğu beslemede bulunmaz.

## Biçimlendirilmiş değerler

Fiyat alanlarının biçimlendirilmiş sürümleri de vardır: ham `price` değeri `299.9` iken biçimli sürüm para birimini ve ondalık ayırıcıyı içerir. Tasarımcıdaki **Price** öğesi bunu kendiliğinden yapar; özel HTML kartında `${formattedPrice}` ve `${formattedOldPrice}` kullanırsınız (bkz. [Özel Kart Oluşturma](/docs/product-cards/creating)).

Biçim, ziyaretçinin tarayıcısının dil ayarıyla kanalın para biriminden üretilir. Aynı fiyat bir ziyaretçide `299,90 ₺`, başkasında `TRY 299.90` görünebilir. Kartta fiyat gösterirken her zaman biçimli sürümü kullanın; ham sayı para birimi taşımaz.

> **Para birimi otomatiktir**
>
> Biçimlendirme ürünün para birimine, yoksa kanalın para birimi ayarına göre yapılır. Kart tanımında para birimi sabitlemeyin; çok kanallı kurulumda yanlış birim gösterirsiniz.

## Türetilmiş işaretler

`isNew`, `isBestseller` ve indirim işareti ham veriden türetilir ve rozet göstermek için kullanılır. Tasarımcıda `isOnSale`, `hasDiscount`, `isOutOfStock` gibi yedi hazır işaret ayrıca koşullarda kullanılabilir. Bkz. [Rozetler](/docs/product-cards/badges).

## Alan sıralaması

Tasarımcıda sıra, katman ağacındaki sıradır: öğeleri yukarı aşağı taşırsınız ya da başka bir kapsayıcıya sürüklersiniz. Tipik sıra: görsel alanı (üstünde rozetler) → marka → ad → fiyat → sepete ekle. Tasarımcıdan önce yapılmış eski kartlarda alanlar satır sırasıyla çizilir.