Yayındaikas eklentisi · Kurulum rehberi

EruCompare

Müşteriler ürünleri yan yana karşılaştırsın, farkları renkli vurgularla görsün ve daha emin satın alsın. EruCompare tema koduna dokunmadan ürün detay sayfasına otomatik enjekte olur.

Kurulum süresi
~2 dakika
Tema kodu
Dokunulmaz
Dil
TR / EN
İçindekiler
  1. 01Genel bakış
  2. 02Kurulum (3 adım)
  3. 03Abonelik & fiyatlandırma
  4. 04Yönetim paneli ayarları
  5. 05Müşteri deneyimi
  6. 06Sorun giderme
  7. 07Eklentiyi kaldırma
  8. 08Destek
01

Genel bakış

EruCompare, ikas mağazanızdaki ürünleri karşılaştırma deneyimine açar. Müşteri ürün detay sayfasındaki Karşılaştır butonuna tıklayarak ürünü listeye ekler. Seçili ürünler kayan bardan açılan bir modal içinde yan yana gösterilir; fiyat, stok, marka, varyant ve ürün attribute'ları satır satır karşılaştırılır. Farklı olan hücreler otomatik vurgulanır.

  • Tema koduna dokunmadan kurulur; Script'i yeniden ekle butonu ile her zaman yeniden enjekte edilir.
  • Shadow DOM ile temadan izole CSS — mevcut tasarımınızla çakışmaz.
  • PDP buton konumu, buton stili, kayan bar ve karşılaştırma alanları panelden yönetilir.
  • TR / EN dahili dil desteği; ikas mağaza diline göre otomatik açılır.
02

Kurulum — 3 adım

  1. 1

    ikas App Store'da kurulumu başlatın

    ikas Admin panelinde Uygulamalar bölümüne gidin, EruCompare'i bulun ve 'Yükle' butonuna tıklayın. Uygulama mağazanız için bir yetki isteyecektir.

  2. 2

    OAuth onayını verin

    Açılan ikas yetkilendirme ekranında izinleri inceleyip onaylayın. Onay sonrası otomatik olarak EruCompare paneline yönlendirilirsiniz.

  3. 3

    Script otomatik enjekte olur

    Onay tamamlandığı an EruCompare mağazanızdaki tüm storefront'lara karşılaştırma script'ini ekler. Tema dosyalarını manuel düzenlemenize gerek yoktur.

İpucu: Birden fazla storefront'unuz varsa hepsine eş zamanlı olarak script eklenir. Daha sonra yeni storefront açtığınızda panelden Script'i yeniden ekle butonuyla tek tıkla bağlayabilirsiniz.
03

Abonelik & fiyatlandırma

EruCompare aylık abonelik ile çalışır ve faturalandırma ikas üzerinden yapılır. Kurulum sonrası aktif abonelik yoksa yönetim paneline geçmeden önce abonelik ekranına yönlendirilirsiniz. Plan detayları ve erken erişim koşulları için hello@erusoft.com ile iletişime geçebilirsiniz.

  • Faturalandırma ikas üzerinden; ayrı bir ödeme aracına gerek yok.
  • Aboneliğiniz pasifse yönetim paneli erişimi otomatik kapanır, mağazada modal çalışmaz.
  • Aboneliği yeniden açtığınızda mevcut ayarlarınız korunur.
04

Yönetim paneli ayarları

ikas Admin → Uygulamalar → EruCompare ile panele girersiniz. Tüm ayarlar tek kart üzerinde toplanır, değişiklikler anında kaydedilir ve kısa süre içinde storefront tarafına yansır.

API Anahtarı

Salt okunur — kopyalama tek tıkla
Her mağaza için otomatik üretilen publicApiKey, storefront script'inin sizin mağazanıza ait yapılandırmayı çekmesini sağlar. Manuel olarak değiştirilemez; gerekirse Erusoft destekten döndürülebilir.

Script'i yeniden ekle

Storefront'lara tek tıkla yeniden enjeksiyon
Tema değişikliği, yeni storefront eklenmesi veya script'in elle silinmesi durumlarında bu butonu kullanın. Mevcut tüm storefront'larınız taranır ve eksik olanlara script eklenir. İşlem idempotent — var olan script üzerine yazılmaz.

Maks. ürün sayısı

2 - 8 arası, varsayılan 4
Karşılaştırma modal'inde yan yana gösterilebilecek ürün sayısı. Müşteri bu sayıya ulaştığında modal otomatik açılır. Geniş ekranlarda 6-8 görsel olarak rahat, mobilde 3-4 tavsiye edilir.

Tema rengi

Hex renk kodu, varsayılan #111111
Modal aksanları, fark vurguları ve varsayılan buton renkleri için kullanılır. Marka renginiz veya kontrast bir vurgu rengi seçebilirsiniz. PDP butonu için ayrıca arka plan ve border rengi belirleyebilirsiniz.

PDP buton yerleşimi

CSS selector + before / after / prepend / append
Karşılaştır butonunun ürün detay sayfasında hangi elemana göre yerleşeceğini belirlersiniz. Varsayılan selector .product-detail-page-buy-box değeridir. Tema yapınız farklıysa satın alma kutusuna yakın bir CSS selector yazıp butonu seçili alanın before, after, prepend veya append pozisyonuna yerleştirebilirsiniz. Önizleme butonu mağazada ?eru_compare_preview=1 parametresiyle yerleşim alanını işaretler.

PDP buton stili

Radius, boyut, arka plan ve border
Buton köşe yuvarlaklığı 0-999 px arasında ayarlanır; hazır seçenekler kare, yumuşak, yuvarlak ve pill formudur. Boyut seçenekleri small, medium ve large. Buton pasifken beyaz zemin üzerinde seçtiğiniz renklerle görünür; ürün listeye eklendiğinde arka plan rengine döner ve metin beyazlaşır.

Kayan bar

Aç/kapat, köşe, offset ve radius
Kayan bar karşılaştırma listesini açan sabit kısayoldur. İsterseniz kapatabilir veya bottom-right, bottom-left, top-right, top-left köşelerinden birine taşıyabilirsiniz. X/Y offset değerleri 0-200 px aralığındadır; radius değeri de 0-999 px arasında ayarlanır. Varsayılan konum sağ alt, 24 px boşluk ve pill formudur.

Karşılaştırma alanları

Çoklu seçim — açın/kapatın
Modal'de hangi sistem alanlarının satır olarak çıkacağını belirlersiniz. Seçenekler:
  • price — Fiyat (indirimli/orijinal)
  • stock — Toplam stok
  • brand — Marka
  • shortDescription — Kısa açıklama
  • description — Tam açıklama
  • weight — Ağırlık
  • categories — Kategoriler
  • tags — Etiketler
Varsayılan açık: price, stock, brand.

Varyant tipleri whitelist

Mağazanızdan otomatik keşfedilir
Ürünlerinizde tanımlı tüm varyant tipleri (Beden, Renk, Hacim vb.) listelenir. Seçtikleriniz modal'de satır olur. Hiçbir şey seçmezseniz karşılaştırılan ürünler üzerinde keşfedilen tüm varyant tipleri gösterilir. Bu kısıtlama varyant tipi seviyesinde ürün gizlemek için kullanılır (örn. warehouse_id gibi iç varyantlar).

Ürün attribute'ları whitelist

Mağazanızdan otomatik keşfedilir
Özel ürün attribute'larınız (Malzeme, Garanti, Menşei vb.) seçenek sayısıyla birlikte listelenir. Whitelist mantığı varyant tipleriyle aynı — seçim yapmazsanız hepsi gösterilir, seçtiğinizde sadece onlar.
05

Müşteri deneyimi

PDP Karşılaştır butonu

EruCompare önce panelde tanımladığınız selector'ı arar. Bulursa butonu ürün detay sayfasındaki doğal satın alma alanına yerleştirir. Selector geçersizse veya tema geç render oluyorsa yaygın ikas buy-box selector'larıyla kısa bir fallback denemesi yapar. Ürün listeye eklendiğinde buton Karşılaştırmadan çıkar haline döner.

Kayan bar

Kayan bar açıksa sayfanın seçtiğiniz köşesinde sabit durur. Liste boşken kompakt ikon olarak görünür; ürün eklendiğinde Karşılaştır etiketi ve ürün sayacı gösterir. Modal açıkken bar gizlenir, böylece mobilde modalın üstüne binmez. PDP içinde inline buton başarıyla yerleştiyse ekstra sabit PDP butonu gösterilmez.

Karşılaştırma modal'i

Kayan bara tıklandığında veya maksimum ürün sayısına ulaşıldığında modal açılır. Modal şu öğeleri gösterir:

  • Üst başlık — “Ürün karşılaştırma (N)”, temizle ve kapat butonları
  • Her sütun bir ürün — görsel, ad (PDP'ye link), fiyat, satın al CTA'sı, kaldır butonu
  • Satırlar — panel ayarlarındaki alanlar, varyant tipleri ve ürün attribute'ları
  • Farklı olan hücreler farklı arka plan ile vurgulanır (diff highlighting)

Dil ve para birimi

Modal başlığı ve etiketler ikas mağaza diline göre TR / EN olarak gösterilir. Fiyat formatı locale kurallarına uyar (örn. TR için 1.299,90 TL).

06

Sorun giderme

Karşılaştır butonu mağazada görünmüyor

Önce panelde Script'i yeniden ekle butonuna basın. Sonra PDP buton yerleşimi bölümündeki selector değerini kontrol edin ve önizleme butonuyla mağazada hedef alanın işaretlenip işaretlenmediğine bakın. Hâlâ görünmüyorsa hello@erusoft.com adresine mağaza adınızı, tema adınızı ve ürün linkini yazın.

Buton yanlış yerde görünüyor

PDP buton yerleşimi bölümünde selector'ı satın alma kutusuna daha yakın bir elemana çevirin. Konum seçeneğini after yerine append veya before deneyin. Önizleme modu hedef elementi kırmızı kesikli çizgiyle gösterir.

Modal'da bazı alanlar boş geliyor

Karşılaştırılan ürünlerden birinde o alan tanımlı olmayabilir (örn. attribute boş, varyant yok). Panel ayarlarından ilgili alanı whitelist'ten çıkararak da temizleyebilirsiniz.

Yeni storefront açtım, EruCompare orada çalışmıyor

Storefront eklendikten sonra panelden Script'i yeniden ekle butonuna basın. Yeni storefront otomatik olarak tespit edilir ve script kurulur.

Ayarlarımı değiştirdim ama mağazada eski hâli görünüyor

Tarayıcı cache'ini temizleyin veya sayfayı sert yenileyin (Cmd/Ctrl + Shift + R). Storefront config'i kısa süreli cache'lendiği için güncel ayar kısa süre içinde yayına geçer.

07

Eklentiyi kaldırma

ikas Admin → Uygulamalar → EruCompare → Kaldır. Kaldırma onaylandığı an:

  • EruCompare tüm storefront'larınızdaki script'leri otomatik olarak ayırır.
  • Mağazanıza ait yapılandırma ve oturum verileri Erusoft tarafında silinir.
  • İleride tekrar kurarsanız temiz bir kurulumla başlarsınız; eski ayarlar geri yüklenmez.
08

Destek

Kurulum, ayarlama veya canlı kullanım sırasında takıldığınız her şey için 24 saat içinde yanıt veriyoruz.

  • E-posta: hello@erusoft.com
  • Konu satırına mağaza adınızı eklemeniz teşhisi hızlandırır.
  • Genel sorulara S.S.S bölümünden de bakabilirsiniz.
← Tüm rehberlere dön