Kart Tasarımcısı

Öğe öğe kart tasarımı, koşullar ve animasyonlar

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

Seçili kanal bir uygulamaysa tasarımcıda tasarladığınız kart uygulamanızda yerel olarak, telefon genişliğinde çizilir; Desktop ve Tablet düğmeleri yoktur. 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 mobilde geçerli olur 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.

Öğe türleri

ÖğeNe 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
HTMLKendi 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 pricePara 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 priceEski 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 savedListe 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. 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.
  • 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.
    • 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.
    • 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:

İşaretNe 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. Renk, köşe ve yazı tipi ayarlanmazsa marka temanızdan gelir.

Mağazada görünmüyorsa

BelirtiSebep
"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 yokBeslemede ek görsel yok ya da eşlenmemiş
Renk örnekleri yokÜrünün aynı grup kodlu kardeşi yok
Öğe hiç çizilmiyorKoş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" bekliyorKart 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ı.

Son güncelleme: 17 Kasım 2026