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ında Karşılaştır butonuna tıklayarak ürünü listeye ekler. Listeye ulaşıldığında bir modal açılır ve seçili ürünleri yan yana, fiyat-stok-marka-varyant gibi alanları satır satır gösterir. Farklı olan hücreler otomatik vurgulanır.

  • Tema koduna dokunmadan kurulur; Yeniden Ekle butonu ile her zaman yeniden enjekte edilir.
  • Shadow DOM ile temadan izole CSS — mevcut tasarımınızla çakışmaz.
  • Karşılaştırma alanlarını ve varyant/attribute whitelist'lerini panelden siz seçersiniz.
  • 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ı panelde aktif abonelik yoksa ikas Admin'deki Yönet butonu üzerinden planınızı başlatmanız istenir. 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 bir kart üzerinde toplanır ve değişiklikler otomatik kaydedilir.

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
Karşılaştırma butonu ve modal aksanları için kullanılır. Marka renginiz veya kontrast bir vurgu rengi seçebilirsiniz. Renk seçici ile canlı önizleme yaparsınız.

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

Karşılaştır butonu

EruCompare butonu öncelikle ürün detay sayfasında satın al butonunun yakınına satır içi olarak yerleşir. Tema yapısı uygun değilse otomatik olarak sağ alttaki kayan barda görünür — hiçbir senaryoda görünmeden kalmaz. Buton, ürün listeye eklendiğinde Karşılaştırmadan çıkar haline döner.

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

ikas Admin → Uygulamalar → EruCompare panelindeki Script'i yeniden ekle butonuna basın. Bu işlem tüm storefront'larınızı taradığı için yeni temalarda çoğunlukla yeterlidir. Hâlâ görünmüyorsa hello@erusoft.com adresine mağaza adınızı ve temanızı yazın.

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 yaklaşık 1 dakika içinde güncel ayar 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