Kurulum
Aramayı açma ve bağlama
Arama modülünü açmak ve sitenizin arama kutusuna bağlamak.
Panelde nerede
Search → yapılandırma ekranı.
1. Aramayı açın
Enabled anahtarını açın. Varsayılan olarak kapalıdır — kapalıyken widget arama kodunu hiç indirmez.
Kapalıyken maliyet yok
Arama kapalıysa arama kodu sitenize hiç yüklenmez. Bu bilinçli bir tasarımdır: kullanmadığınız modül sayfa ağırlığınıza eklenmez.
2. Konum seçin
Arama arayüzünün nasıl açılacağını belirler:
| Konum | Davranış |
|---|---|
panel | Site başlığının altına açılan tam genişlikte mega panel |
modal | Ekranın ortasında açılan pencere |
inline | Sayfanın içine gömülü |
floating | Köşede duran arama düğmesi |
fullscreen | Tam ekran arama |
sidebar | Yandan açılan panel |
Ürün kataloğu için mega panel
panel, sonuçları kart ızgarası olarak, kategori filtrelerini yanında gösterir —
mağazaların kendi mega menülerinin çalıştığı gibi. modal ise dar bir sütundur:
600 piksel genişlikte bir pencereye tek bir ürün kartı sığar. Kataloğunuzda
görsel ağırlıklı ürünler varsa panel seçin.
Mega panel, Mega Panel stil sekmesinden ayarlanır: hangi elementin altına yerleşeceği (Dock Under Element), en fazla genişliği, iç boşlukları ve gölgesi. Yükseklik ölçülerek bulunur — sabit bir değer girmezsiniz, çünkü duyuru şeridi olan bir başlığın yüksekliği sayfadan sayfaya değişir.
3. Tetikleyiciyi bağlayın
Panel, modal, fullscreen ve floating konumlarında aramanın nasıl açılacağını belirtirsiniz:
| Alan | Açıklama |
|---|---|
| Trigger selector | Sitenizdeki mevcut arama kutusunun veya butonunun CSS seçicisi |
| Hotkey | Klavye kısayolu, örn. / veya cmd+k |
Tetikleyici seçici verirseniz Selwise sitenizin kendi arama kutusunu devralır: ziyaretçi ona tıkladığında Selwise araması açılır.
İki arama birden açılıyorsa
Tetikleyici olarak seçtiğiniz element temanızın kendi aramasına da bağlıysa tek tıklamada iki panel birden açılır. Selwise'ın dinleyicisi temanınkinin yanına eklenir; sonradan eklenen bir dinleyici öncekini iptal edemez.
Bu durumda Position Style Compatibility sekmesindeki Trigger Replaces Existing Handler seçeneğini açın: Selwise tıklamayı yakalama aşamasında alır ve temanın dinleyicisine hiç ulaşmaz. Tetikleyiciniz aynı zamanda bir menü açıyorsa bu seçeneği kapalı bırakın — o dinleyicinin de çalışması gerekir.
Inline konumunda ise Selector alanına aramanın yerleşeceği elementi yazarsınız.
4. Test edin
Arama yapılandırmasını yayına almadan önce test moduna alabilirsiniz:
localStorage.setItem('selwise_test_mode', 'true');
location.reload();
5. Sitenizin kendi aramasını kapatın
Selwise araması çalışır hale geldiğinde sitenizin kendi arama sonuç sayfası hâlâ erişilebilir kalır. İki arama deneyiminin bir arada olması kafa karıştırıcıdır; tetikleyici seçiciyi doğru bağladığınızdan emin olun.
Sırada ne var
- Yapılandırma — davranış ve görünüm.
- Varyantlar — hazır deneyimler.
Son güncelleme: 10 Eylül 2026