# Kart Tasarımcısı

Öğe öğe kart tasarımı, koşullar ve animasyonlar
Kaynak: https://selwise.com/docs/product-cards/designer

Kart tasarımcısı, ürün kartını kod yazmadan, öğe öğe kurmanızı sağlar. Gerçek bir mağaza kartı satır satır alan listesi değildir; görselin üstüne binen rozetler, köşedeki favori kalbi, üzerine gelince beliren sepet düğmesi, renk örnekleri, üstü çizili fiyat ve indirim etiketi gibi iç içe kutulardan oluşur. Tasarımcı bunları ifade eder.

## Panelde nerede

**Tasarım → Ürün Kartları** (Design → Product Cards) → **Create Product Card** ya da var olan bir kart → editör başlığındaki **Drawn by** (Kartı çizen) anahtarında **Designer** (Tasarımcı). Tasarımcı üç sütundur: solda **Layers** (Katmanlar), ortada tuval, sağda seçili öğenin ayarları. Tuval, mağazadaki kartı çizen aynı motorla çizilir; bu yüzden tasarımda gördüğünüz kart mağazadaki karttır.

> **Uygulama kanalında**
>
> Kart hesabınızındır ve uygulamanız da onu kullanır: uygulamada kart **yerel olarak** çizilir ve kartın **Mobile** (telefon) düzenini okur. Hesabınızda bir uygulama kanalı varsa **Mobile** seçiliyken tuvalin üstünde **Preview: Website / App** (Önizleme: Web sitesi / Uygulama) seçimi çıkar: **App**, kartı uygulamanın kendi bileşeniyle, 390 pt genişliğinde bir telefonda ve yan yana iki sütunlu bir ürün ızgarasında çizer (düzenlediğiniz kart ilk ürünün kartıdır). Seçim yalnızca nasıl **baktığınızı** değiştirir: iki önizlemede de yaptığınız stil ayarı kartın telefon düzenine yazılır ve her telefonda geçerli olur. Seçili kanal bir uygulamaysa, telefonda imleç olmadığı için üzerine gelme (hover) efektleri, giriş ve öğe animasyonları, ikinci görsel (**Hover image**) ve özel **HTML** öğesi sunulmaz. Bunlar dışındaki her öğe çizilir: kutular, görsel alanı ve üstüne binen öğeler, metin, fiyat, rozet, puan, renk örnekleri, düğme, ayırıcı ve boşluk. Renk örneğine dokunmak kartta o rengin görselini gösterir; kart ya da düğme o rengin ürün ekranını açar. Sepete ekle düğmesi uygulamanızın kendi sepetine ekler. Favori düğmesi, uygulama favori listesini SDK'ya verdiğinde (`host.toggleWishlist`) çizilir ve uygulamanın kendi favorilerine yazar; liste vermeyen uygulamada düğme çizilmez. Beden ya da seçenek gerektiren üründe seçenekler (**Chips**, **Dropdown** ve **Pencerede sor** hep) yerel bir alt sayfada sorulur. Marka rengi, köşe ve yazı tipi **Brand** ayarından gelir. Kendi HTML'inizle yazılmış bir kart uygulamada çizilemez; şerit varsayılan kartını marka renkleriyle çizer.

## Tuvalde çalışmak

- Tuvaldeki herhangi bir öğeye tıklayarak katmanını seçersiniz; seçili öğenin adı tuvalde üstünde yazar, katman ağacında üzerine geldiğiniz öğe tuvalde kesik çizgiyle gösterilir.
- **Layers** (Katmanlar) başlığındaki **Add** (Ekle) öğe menüsünü açar: seçili öğe bir kapsayıcıysa (**Group**, **Image area**) yeni öğe onun içine, değilse hemen altına eklenir. Menü öğeleri Yapı, Ürün bilgisi, Eylem ve Diğer başlıkları altında, her biri ne işe yaradığını söyleyen bir satırla listelenir. Bir kapsayıcının satırındaki **+** da aynı menüyü o kapsayıcı için açar.
- Bir katmanı ağaçta **sürükleyerek** taşırsınız: satırın üst kısmına bırakmak öncesine, alt kısmına bırakmak sonrasına, bir kapsayıcının ortasına bırakmak içine koyar; bırakmadan önce bir çizgi ya da çerçeve nereye gideceğini gösterir. Bir öğe kendi içine taşınamaz.
- Satırda çift tıklayarak katmanı yeniden adlandırırsınız. Satırdaki simgeler koşullu gösterilen, görselin üstünde duran ve animasyonlu öğeleri işaretler; gizli bir öğenin göz simgesi her zaman görünür.
- Kısayollar: **Delete** seçili öğeyi siler, **⌘/Ctrl + D** çoğaltır, **⌘/Ctrl + Z** geri alır, **⇧ + ⌘/Ctrl + Z** yineler, **Alt + ↑/↓** öğeyi kardeşleri arasında taşır, ok tuşları ağaçta gezinir, **Esc** seçimi bırakır. Bir alana yazarken kısayollar çalışmaz.
- Sağdaki ayarlar bölümlere ayrılır (İçerik, Görünürlük, Animasyon, Stil) ve her stil grubu açılıp kapanır; içinde değer olan grup sayısıyla birlikte açık gelir, **↺** o gruptaki değerleri temizler. Üstteki düğmeler üst katmanı seçer, öğeyi taşır, gizler, çoğaltır ve siler.
- Tuvalin üstündeki **Desktop**, **Tablet** ve **Mobile** düğmeleri hem önizlemeyi hem de düzenlediğiniz ekran boyutunu seçer: **Mobile**'dayken yaptığınız stil ayarı yalnızca telefonlarda geçerli olur (web sitenizin telefonlarında ve uygulamanızda) ve tuval kartı bir telefonda görüneceği gibi, mobil kurallarıyla çizer. Geri kalanı devralınır (breakpoint değerleri: tablet 1024 piksele kadar, mobil 640 piksele kadar).
- **Hover state** (Hover hâli) kartı fare üzerindeymiş gibi çizer ve stil ayarlarını hover hâline geçirir; böylece hover değerlerini fareyi karta götürmeden görürsünüz.
- **Entrance** (Giriş) kartın ilk çizildiği animasyondur. **Card hover** (Kart üzerine gelince) tüm kartın tepkisidir. İkisi de kart düzeyindedir, öğe düzeyi değil.
- **Clear design** (Tasarımı temizle) kartı tasarım öncesi alan listesine döndürür; onay ister ve tasarımınız saklanmaz.
- Bir kart en fazla **200 öğe** ve **8 düzey** derinlik taşır; sınırda yeni öğe eklenmez ve panel bunu söyler.

## Hazır tasarımlar

Yeni kart **Standard** ile açılır. Boş bir kartı ya da tasarımı temizledikten sonra galeriden başka bir hazır tasarım seçebilirsiniz. Bkz. [Hazır Tasarımlar](/docs/product-cards/templates).

## Öğe türleri

| Öğe | Ne yapar |
|---|---|
| **Group** (Grup) | Başka öğeleri tutan esnek kutu: yön, hizalama, boşluk |
| **Image area** (Görsel alanı) | Ürün görselinin alanı. İçine koyduğunuz görsel dışındaki öğeler görselin **üstüne** konumlanır (rozet, kalp, hover düğmesi); konumlarını üst, sağ, alt, sol ve katman sırası ayarlarıyla verirsiniz |
| **Image** (Görsel) | Ana görsel (**Main image**) ya da üzerine gelince değişen ikinci görsel (**Hover image**). Ürün sayfasına bağlanabilir |
| **Text** (Metin) | Bir ürün alanına bağlı metin; ön ek, son ek, boş alan için yedek metin, ürün sayfasına bağlantı |
| **Price** (Fiyat) | Dört okumadan biri: **Selling price** (satış fiyatı), **Was price** (eski fiyat), **Discount %** (indirim yüzdesi), **Amount saved** (kazanç tutarı) |
| **Button** (Düğme) | **Add to cart**, **Quick view**, **Go to product** ya da **Add to wishlist**; yükleniyor, eklendi ve hata durumları için ayrı etiket, yalnızca simge seçeneği |
| **Badge** (Rozet) | **Fixed text**, **Discount %** ya da bir **Product field** gösteren etiket |
| **Rating** (Puan) | Yıldızlar; isteğe bağlı yorum sayısı; ölçek 3 ile 10 arası (varsayılan 5) |
| **Colours** (Renkler) | Ürünün renk kardeşleri, tıklanabilir örnekler; 1 ile 12 arası (varsayılan 6), daire ya da kare, küçük, orta ya da büyük. Kartın kendi rengi işaretlenir; üzerine gelinen rengin görseli kartta gösterilir |
| **Divider** (Ayırıcı) / **Space** (Boşluk) | Yatay çizgi, sabit boşluk |
| **HTML** | Kendi markup'ınız; `${title}` gibi yer tutucular doldurulur ve markup güvenlik temizliğinden geçer. En fazla 20.000 karakter |

### Çıktılar

| Ayar | Çıktı örneği |
|---|---|
| Fiyat: Selling price | Para birimiyle biçimli satış fiyatı. Biçim tarayıcının dil ayarına göre değişir (ör. 899,90 ₺ ya da TRY 899.90) |
| Fiyat: Was price | Eski fiyat; yalnızca liste fiyatı satış fiyatından büyükse, aksi hâlde boş |
| Fiyat ve rozet: Discount % | `-25%`; liste fiyatı varsa iki fiyattan hesaplanır, yoksa beslemedeki indirim oranı. Sıfırsa hiçbir şey çizilmez |
| Fiyat: Amount saved | Liste fiyatı ile satış fiyatı arasındaki fark |
| Rating | `★★★★☆`; puan 0 ya da yoksa hiçbir şey çizilmez |
| Metin: alan boş | **Fallback text** (yedek metin) yazıldıysa o, yoksa öğe hiç çizilmez |

### Düğme davranışı

Add to cart, kanalın sepet entegrasyonuna bağlıdır. Sepet entegrasyonu kurulu değilse düğme ürün sayfasına giden bir bağlantıya düşer, yani kart yine bir yere gider. Entegrasyon için: [Sepete Ekleme](/docs/recommendations/add-to-cart). **Go to product** ürün adresi yoksa hiç çizilmez.

### Görsel ve renk örnekleri beslemenizden gelir

- **Hover image** beslemenizin ek görsel alanlarından (`additional_image_link`, `images` ve benzerleri) okunur; ürün başına en fazla 6 ek görsel taşınır. Besleme ek görsel vermiyorsa ya da alan eşlenmemişse o ürünlerde öğe çizilmez. **Product Feeds → Alan Eşleştirme**'de ek görselleri eşleyin: [Alan Eşleştirme](/docs/product-feeds/field-mapping).
- **Colours** öğesi, bu ürünle aynı **grup koduna** sahip diğer ürünleri gösterir (bir besleme satırı bir üründür; bir renk kendi ürün sayfasına sahip ayrı bir üründür, bu yüzden örnek o ürünün sayfasına bağlanır). Kardeşi olmayan üründe öğe çizilmez. Bkz. [Varyant Gruplama](/docs/product-feeds/variant-grouping).
  - **Display** (Gösterim): **Automatic** örneği rengin adından boyar (`Beyaz`, `Lacivert`, `Gül Kurusu`, `Navy` gibi Türkçe ve İngilizce renk adları ya da beslemedeki `#1f3a5f` gibi bir renk kodu); adı tanınmayan renkte o rengin ürün görseli gösterilir. **Colour** yalnızca boyar, **Product photo** her zaman görseli gösterir. `Siyah/Beyaz` gibi iki renkli adlarda ilk renk kullanılır.
  - Kartın gösterdiği ürünün rengi halkayla işaretlenir (renk adı yoksa aynı görselden) ve en fazla gösterilen sayının dışında kalmaz; kalan renkler `+N` olarak yazılır.
  - Renkler, bedeni sepete eklerken sormaz; bu, **Sepete ekle** katmanındaki **Option chooser** (Seçenek seçici) ayarıdır: [Sepete Ekleme](/docs/recommendations/add-to-cart).
  - **Show that colour's photo on hover** açıkken, alışverişçi bir rengin üzerine geldiğinde kartın görseli o rengin görseline döner, renk satırından ayrılınca geri gelir. Dokunmatik ekranda örnek doğrudan o rengin ürün sayfasını açar.
  - Tasarımcının tuvali mağazanızın kendi ürünlerini, mağazadaki kartın aldığı renk kardeşleri ve hover görselleriyle çizer; önizlemedeki ürünlerin hiçbirinin kardeşi yoksa ayarlarda bunu söyleyen bir not çıkar.

## Koşullar: bu öğe ne zaman görünür

**Visibility** (Görünürlük) bölümünde **Add condition** ile öğeye koşul eklersiniz; tüm koşullar sağlanmazsa öğe hiç çizilmez. Bir öğede en fazla 8 koşul olabilir.

Koşul bir ürün alanı, bir türetilmiş işaret ya da `attr.alan_adı` biçimindeki besleme alanı üzerinde kurulur. Karşılaştırmalar: **is set** (dolu), **is empty** (boş), **is true**, **is false**, **equals**, **is not**, **greater than**, **less than**. Büyüktür ve küçüktür sayı ister; sayı girmezseniz karşılaştırma 0'a göre yapılır ve panel bunu uyarıyla söyler.

Türetilmiş işaretler ham üründen hesaplanır:

| İşaret | Ne zaman doğru |
|---|---|
| **On sale** (`isOnSale`) | Liste fiyatı satış fiyatından büyük (beslemenin kendi "indirimde" işaretine bakılmaz; her ürünü indirimli işaretleyen besleme `-0%` çıkarmasın diye) |
| **Has a discount** (`hasDiscount`) | İndirimde ya da beslemedeki indirim oranı sıfırdan büyük |
| **Has a was price** (`hasOriginalPrice`) | Liste fiyatı var |
| **Out of stock** (`isOutOfStock`) | Stokta yok |
| **Has a rating** (`hasRating`) | Puan sıfırdan büyük |
| **Has a second image** (`hasSecondImage`) | Ek görsel var |
| **Has colour options** (`hasSwatches`) | Renk kardeşi var (iki ya da daha çok) |

Koşul listesinde işaretler **Product state** (Ürün durumu), kartın alanları **Product fields** (Ürün alanları), beslemenizin kendi alanları **Feed attributes** (Besleme özellikleri) başlığı altında, adlarıyla listelenir.

Yaygın örnekler: indirim rozeti için `hasDiscount` **is true**; "Tükendi" etiketi için `isOutOfStock` **is true**; marka satırı için `brand` **is set**.

## Animasyonlar

- **Öğe animasyonu** (Animation bölümü): **Appear on hover** (üzerine gelince belirir), **Slide up on hover**, **Fade in on hover**, **Pulse**. Hover düğmesini bu yolla saklarsınız.
- **Entrance**: **Fade in**, **Slide up**, **Slide down**, **Zoom in**, **Blur in**. Şeritteki kartlar 60 milisaniye arayla girer (en çok 8. karta kadar artar; böylece uzun bir şeritte son kart beklemez).
- **Card hover**: **Lift**, **Lift (strong)**, **Scale**, **Border**, **Glow**, **Zoom image**, **Swap image**.
- Geçiş süresi tüm geçişler için milisaniyedir (0 ile 2000 arası, varsayılan 200).

Tüm animasyonlar, ziyaretçinin cihazında "hareketi azalt" ayarı açıksa kapanır.

## Stil ve marka

Her öğenin biçim ayarları kırk bir özelliklik tek bir tablodan gelir: panelde bir kontrol varsa mağazada onu çizen bir kural da vardır. Tam liste: [Kart Stili](/docs/product-cards/styling). Renk, köşe ve yazı tipi ayarlanmazsa marka temanızdan gelir.

## Mağazada görünmüyorsa

| Belirti | Sebep |
|---|---|
| "Custom HTML is overriding this design" uyarısı | Kart **My own code** modunda ve HTML dolu; markup tasarımı bastırır. **Use the design** ile tasarımı geri alın |
| Hover görseli yok | Beslemede ek görsel yok ya da eşlenmemiş |
| Renk örnekleri yok | Ürünün aynı grup kodlu kardeşi yok |
| Öğe hiç çizilmiyor | Koşul sağlanmıyor ya da bağlı alan o üründe boş |
| Eklediğiniz öğe uygulanmadı | Öğe ya da düzey sınırı aşıldı ("That change was not applied") |
| Tasarım "Convert" bekliyor | Kart tasarımcıdan önce yapılmış; **Convert current card** ya da bir hazır tasarım seçin |

Yapay zekâ ile tasarım: [Yapay Zekâ ile Kart Tasarımı](/docs/product-cards/ai-design).
