Güncellemeler mağazanıza nasıl ulaşır?

Bir kurulum paketini kendiniz güncellemediğiniz için, Sepetya ile çalışan bir mağazada "sürüm yükseltme gecesi" yoktur. Yine de her güncellemenin aynı yoldan geldiğini düşünmek yanıltıcı olur: platformun kendisi otomatik güncellenir, temanız ve eklentileriniz ise sizin onayınızı bekler.

Bu yazıda üç güncelleme türünü, her birinde neyin korunduğunu, API ve webhook kullanıyorsanız nelere dikkat etmeniz gerektiğini ve değişiklikleri nereden takip edeceğinizi anlatıyoruz. Bu sürümde gelen özelliklerin özetini sürüm notları yazısında bulabilirsiniz.

Üç tür güncelleme

Tür	Nasıl gelir?	Siz ne yaparsınız?
Platform (panel, vitrin motoru, API)	Otomatik; mağazanız yayında kalır	Bir şey yapmanız gerekmez
Tema	Yeni tema sürümü çıkar, panelde "Yeni sürüm" olarak görünür	Hazır olduğunuzda "Güncelle"ye basarsınız
Eklenti (modül)	Yeni eklenti sürümü çıkar, eklenti sayfasında "Güncelleme var" görünür	Hazır olduğunuzda güncellersiniz

Ayrım basit bir ilkeden geliyor: görünümünüzü ve entegrasyon ayarlarınızı etkileyen şeyler sizin kararınızla değişir, altyapı ise kendiliğinden güncel kalır.

Platform güncellemeleri

Panel, vitrin ve API platform tarafında güncellenir. Bunun size yansıyan tek pratik yanı şudur: paneli uzun süre açık bıraktıysanız tarayıcıdaki dosyalar eskimiş olabilir. Panel bunu fark ettiğinde "Panelin yeni bir sürümü yayımlandı. Devam etmek için sayfayı yenileyin." der; sayfayı yenilediğinizde yeni sürümle çalışırsınız. Kaydedilmemiş bir düzenleme varsa önce onu kaydedin.

Yeni özellikler çoğunlukla mevcut ekranlara eklenir; bir ayar yeni geldiğinde varsayılan değeriyle gelir ve davranışınızı kendiliğinden değiştirmez. Örneğin yeni bir vitrin bölümü eklendiğinde ana sayfanız olduğu gibi kalır, bölümü siz eklersiniz.

Tema güncellemeleri

Temalar sürümlenir. Kullandığınız temanın yeni bir sürümü çıktığında Online Mağaza › Temalarım sayfasında temanın yanında "Yeni sürüm" etiketi görünür ve "… sürümüne güncelle" düğmesi çıkar. Tema ve editörün tüm yeteneklerini mağaza tasarımı sayfasında bulabilirsiniz. Güncelleme temanın yeni bölümlerini ve düzeltmelerini getirir; ayarlarınız ve bölümleriniz korunur. Yeni eklenen ayarlar varsayılan değerleriyle gelir.

1. Önce tema editöründe "Yeni sekmede önizle" ile taslağı gözden geçirin.
2. Ana sayfa, kategori, ürün, sepet ve blog şablonlarını masaüstü, tablet ve mobil önizlemede sırayla açın.
3. Beğenmediğiniz bir yer varsa ilgili bölümün ayarını değiştirin ya da bölümü gizleyin; sonra "Yayınla" ile yayına alın.

Eklenti güncellemeleri

Eklentiler de sürümlenir. Eklentiler sayfasında kurulu bir eklentinin yeni sürümü varsa "Güncelleme var" etiketi, eklenti ayrıntısında ise "Yeni sürüm: eski → yeni" başlığıyla "Güncelle" düğmesi görünür. Güncelleme ayarlarınızı korur; eklentinin yeni özellikleri ve düzeltmeleri hemen uygulanır. Kurulabilecek eklentilerin tamamı entegrasyonlar sayfasında listelenir. Ödeme, kargo, izleme ve feed eklentileri için güncelleme sonrası şu üç şeyi kontrol etmek yeterlidir:

• Bağlantı: eklenti sayfasındaki durum "bağlı" görünüyor mu? Sağlayıcı anahtarlarınız yerinde kalır, yeniden girmeniz gerekmez.
• Yeni ayarlar: yeni sürümle gelen bir ayar varsa varsayılanıyla gelir; sizin için anlamlı olanı seçin.
• Kayıtlar: eklenti sayfasındaki işlem kayıtlarında hata görünüyorsa oradan okunur. Eklenti bir olayı ya da görevi işlerken hata verdiğinde panele bildirim de düşer.

API ve webhook kullanıyorsanız

Kendi yazılımınız API'ye bağlıysa uyumluluk sözü nettir: /api/v1 içinde yalnız geriye uyumlu eklemeler yapılır. Yeni bir uç nokta, isteğe bağlı bir alan ya da yeni bir enum değeri gelebilir; var olan bir alan kaldırılmaz ya da anlamı değiştirilmez. Kırıcı bir değişiklik gerekirse yeni bir ana sürüm (/api/v2) açılır ve v1 çalışmaya devam eder.

• Webhook olayları: her olay zarfında apiVersion alanı bulunur. Yeni olay türleri eklendiğinde bunlara abone olmadığınız sürece hiçbir şey değişmez; abone olduğunuz olayların gövdesine yeni alanlar eklenebilir, bu yüzden tanımadığınız alanları yok sayın.
• OpenAPI belgesi: GET /api/v1/openapi.json her zaman güncel şemayı verir. Entegrasyonunuzu güncellemeden önce elinizdeki kopyayla karşılaştırmak en hızlı yoldur.
• Yeni alanları kullanmak: yeni bir alanı kullanmaya başlamadan önce boş gelme ihtimalini de düşünün; eski kayıtlarda değer bulunmayabilir.

API tarafına yeni başlıyorsanız REST API ile başlangıç ve webhook rehberi yazılarıyla devam edebilirsiniz.

Değişiklikleri nereden takip edersiniz?

• Sürüm notları sayfası: değişiklik günlüğünde alanlara göre düzenlenmiş liste bulunur.
• Blogdaki "Ürün güncellemeleri" kategorisi: öne çıkan özellikleri anlatan yazılar buraya düşer. Blog akışını RSS ile de izleyebilirsiniz: /blog/rss.xml.
• Panel içindeki ipuçları: tema ve eklenti sayfalarındaki "Yeni sürüm" etiketleri, mağazanıza özel olanı gösterir.
• Kendi mağazanızdaki değişiklikler: bir fiyatı, stoğu ya da ayarı kimin değiştirdiğini Ayarlar › Denetim kaydı ve kayıtların zaman çizelgeleri söyler. Bu, platform güncellemelerinden bağımsızdır ama "dün farklıydı" sorusunun cevabı çoğu zaman buradadır.

Beklenmeyen bir şey görürseniz

Güncellemelerin ardından "dün böyle değildi" dediğiniz bir durum olursa sırayla şu dört yere bakmak çoğu soruyu çözer:

1. Sayfayı yenileyin. Panelde eski dosyalarla çalışıyor olabilirsiniz. Tarayıcı sekmesini kapatıp açmak ya da sert yenileme yapmak yeterlidir.
2. Taslak mı, yayın mı? Tema editöründe yaptığınız değişiklik yayınlanmadıysa vitrinde görünmez; editörün üst kısmı "Kaydedilmemiş değişiklik", "Taslak kaydedildi" ya da "Yayındaki sürümle aynı" der. Vitrini gizli bir pencerede açarak ziyaretçinin gördüğünü kontrol edin.
3. Eklenti kayıtlarına bakın. Bir ödeme, kargo ya da izleme eklentisi beklediğiniz gibi çalışmıyorsa eklenti sayfasındaki işlem kayıtları ve bildirimler nedenini söyler. Webhook kullanıyorsanız teslimat günlüğü aynı işi görür.
4. Kim değiştirdi? Bir ayar ya da fiyat beklenmedik şekilde farklıysa Ayarlar › Denetim kaydı kimin, ne zaman, neyi değiştirdiğini gösterir. Personeliniz varsa cevap genellikle burada çıkar.

Bunlara rağmen bir hata sürüyorsa destek talebi açarken ne yaptığınızı, hangi sayfada olduğunuzu ve varsa ekranda görünen istek kimliğini (requestId) yazın; kaydı doğrudan bulmayı sağlar.

Güncelleme sonrası kontrol listesi

• Panelde "yeni sürüm" uyarısı geldiğinde kaydedilmemiş işi kaydedip sayfayı yeniledim.
• Tema güncellemesini yayınlamadan önce taslağı masaüstü, tablet ve mobilde önizledim.
• Ana sayfa bölümlerini ve menüleri güncellemeden sonra bir kez gözden geçirdim.
• Ödeme ve kargo eklentilerinin bağlantı durumunu kontrol ettim; bir test siparişi geçirdim.
• İzleme ve feed eklentilerinde yeni ayar gelip gelmediğine baktım.
• API entegrasyonumda tanımadığım alanların yok sayıldığından emin oldum.
• Webhook alıcımın yeni olay türlerinde hata vermediğini teslimat günlüğünden doğruladım.
• Sürüm notlarını okudum; işime yarayan yeni özellikleri not ettim.

Yeni özellikleri kendi mağazanızda denemek için ücretsiz başlayın; panelde bir şeyin yeri değiştiyse bize yazabilirsiniz.