# Ürün Varyantları

Hazır arama deneyimi varyantları
Kaynak: https://selwise.com/docs/search/variants

Varyant, hazır kurgulanmış bir arama deneyimidir: konum, düzen, öneriler ve stil ayarları tek tıkla birlikte gelir. Sıfırdan yapılandırmak yerine bir varyantla başlayıp üzerine özelleştirme yaparsınız.

## Panelde nerede

**Kişiselleştirme → Arama → Configuration** (Personalization → Search), sayfanın üstündeki **Template Variant** (Şablon Varyantı) kartı. Kart, seçili varyantın adını ve bir rozeti gösterir; **Change variant** (Varyantı değiştir) varyant listesini açar, **Hide variants** kapatır.

## Hazır varyantlar

| Varyant (panel adı) | Deneyim | Seçince ayarlanan |
|---|---|---|
| **Modal Classic** | Ortada açılan dengeli arama penceresi | **Modal Popup** |
| **Floating Quick Access** | Köşede duran hızlı arama düğmesi | **Floating Button** (sağ alt), **Keep Open** açık |
| **Inline Embedded** | İçerik ağırlıklı sayfalara gömülü arama | **Inline**, **CSS Selector** `.search-slot`, kategori kenar çubuğu, ızgara düzeni |
| **Sidebar Catalog** | Katalog odaklı, kategori listeli yan panel | **Sidebar Panel**, kategori kenar çubuğu, kompakt düzen, açıklama açık |
| **Fullscreen Discovery** | Tam ekran keşif deneyimi | **Fullscreen**, geniş düzen, en fazla 20 sonuç, açıklama açık |

Türkçe panelde adlar Modal Klasik, Hızlı Erişim Floating, Inline Gömülü, Katalog Sidebar ve Tam Ekran Keşif olarak yazılır. Bu adların ardındaki iç kimlikler (`search-modal-classic` gibi) yapılandırmada `variantId` olarak saklanır.

## Hangi varyantı seçmeli

| Durum | Varyant |
|---|---|
| Sitenizin üst menüsünde arama kutusu var, onu devralacaksınız | **Modal Classic** (ya da **Mega Panel** konumu; varyantlarda yok) |
| Arama kutunuz yok, eklemek istiyorsunuz | **Floating Quick Access** |
| Ayrı bir arama sayfanız ya da arama alanı ayırdığınız bir yer var | **Inline Embedded** |
| Geniş katalog, kategori gezinmesi önemli | **Sidebar Catalog** |
| Arama sitenizin ana gezinme yolu | **Fullscreen Discovery** |

## Varyant seçmek neyi değiştirir

Varyant seçmek, mevcut ayarlarınızın üzerine **yazar**. Seçtiğiniz anda formdaki şu değerler varyantın değerleriyle değişir (henüz kaydedilmez; **Save**'e basana kadar yalnızca formdadır):

- Konum ve (yalnızca **Inline Embedded**'da) **CSS Selector**; **Floating Quick Access**'te köşe.
- **Enable Search**: **açılır**.
- **Min Characters** 2, **Max Results** 12 (Fullscreen'de 20), **Debounce** 220 ms, **Search on Focus** açık, **Mobile Fullscreen** açık.
- **Exclude Out of Stock**: **kapanır** (siz açmış olsanız bile).
- Sonuç yerleşimi, görsel boyutu, gösterilecek öğeler (**Category** dahil) ve animasyon.
- **Suggestions**: dört öneri tipinin hepsi açılır — son aramalar (6), popüler aramalar (**both**, 8), popüler kategoriler (**dynamic**, 8), popüler ürünler (**dynamic**, 6).
- **Add to Cart**: açık, platform **Custom Script**.
- **Styling**, **Text & Translations** ve **View All CTA** değerlerinin **tamamı** varsayılana döner; yaptığınız renk, çeviri ve CTA ayarları silinir. Varyantın kendi renkleri: beyaz zemin, koyu metin, mavi vurgu.
- **Input Placeholder** gibi metinler yeniden İngilizce olur.

Seçmeniz hiçbir şeyi değiştirmeyenler: **Hotkey**, özel tetikleyici seçici, **Product Card Template**, **Audience Targeting** ve yazdığınız özel sepet betiği ile elle girilmiş popüler arama/ürün/kategori listeleri.

> **Varyantı seçtikten sonra tüm özelleştirmeleri yeniden yapın**
>
> Önce varyantı seçin, sonra özelleştirin. Önemli bir özelleştirmeniz varken varyantı (aynı varyantı bile) yeniden seçerseniz **Styling**, çeviriler ve yukarıdaki ayarlar sıfırlanır. Geri almak için **Save**'e basmadan sayfayı yenileyin.

> **Varyanttan sonra Save iki yerde takılabilir**
>
> Her varyant popüler aramaları **both** kaynakla açar; elle yazılmış hiç popüler arama terimi yoksa **Save** "Add at least one manual popular search term" der. Çözüm: **Suggestions** bölümünde bir terim ekleyin, kaynağı **dynamic**'e çevirin ya da bölümü kapatın. Ayrıca varyant **Add to Cart**'ı **Custom Script** ile açtığı için, kanalda daha önce yazılmış bir betik yoksa **Save** özel sepet betiği ister — bkz. [Yapılandırma](/docs/search/configuration#sepete-ekleme-integration).

## Özelleştirilmiş işareti

Kart bir rozet gösterir:

- **Template** (yeşil): formdaki ayarlar, varyantı seçtiğiniz andaki ayarlarla birebir aynı.
- **Customized** (turuncu): varyantın kapsadığı ayarlardan en az biri değişti. Henüz hiç varyant seçmemiş (`legacy-custom`) kanallar her zaman **Customized** görünür.

Rozet yalnızca bir göstergedir; aramanın davranışını değiştirmez. Seçtiğiniz anda varyantın ayarları kanalınıza **kopyalanır** ve ondan sonra kanalınızın kendi ayarları olur; varyant tanımının ileride değişmesi sizinkini etkilemez, geri dönmek için varyantı yeniden seçmeniz gerekir (bu da özelleştirmelerinizi sıfırlar).

Rozet **Hotkey**, özel tetikleyici seçici, **Product Card Template**, **Audience Targeting** ve özel sepet betiğindeki değişiklikleri izlemez; bunları değiştirmek **Template** rozetini **Customized**'a çevirmez.

## Eski şablon sistemi

Selwise'in daha önce ayrı bir arama şablon CMS'i vardı; Ağustos 2026'da kaldırıldı. Varyantlar onun yerini alan mekanizmadır ve fark önemlidir: varyantlar hazır **yapılandırma paketleridir**, kendi HTML'inizi yazdığınız şablonlar değil. Arama arayüzünün görünümünü stil ayarları ve marka temasıyla değiştirirsiniz — bkz. [Görünüm](/docs/search/appearance).