Özel Kodları Kaybetmeden Shopify Teması Nasıl Güncellenir?

Shopify temasını güncellemek “son sürümü ekle” deyip yayınlamak değildir. Yeni tema vendor iyileştirmeleri ve platform uyumu içerirken canlı temada yılların section, ayar, app block, analitik, erişilebilirlik düzeltmesi ve iş mantığı bulunabilir. Birini diğeriyle değiştirmek özellikleri sessizce kaldırır; tüm eski dosyayı kopyalamak güncellemeyi siler.

Çalışmayı eski vendor tabanı, özelleştirilmiş canlı sürüm ve yeni vendor sürümü arasında üç yönlü merge olarak görün. Hedef bilinçli mağaza değişikliklerini taşırken yeni mimariyi mümkün olduğunca benimsemektir.

Güncellemenin nedenini belirleyin

Yeni Shopify özelliği, bug/erişilebilirlik düzeltmesi, performans, app uyumu, tasarım yenileme veya bakımı kolay vendor yoluna dönüş gibi gerekçe ve ölçülebilir sonuç yazın. Açıkça kapsamlanmadıkça güncellemeyi sınırsız redesign’a çevirmeyin.

Vendor release note ve destek politikasını okuyun. Breaking change, yeniden adlandırılan setting, değişen section, deprecated snippet, bağımlılık ve migration aracını bulun. Lisansın hedef mağazayı kapsadığını ve indirmenin gerçek olduğunu doğrulayın.

Tema çok eski veya baştan yazılmışsa yeni tabanda yeniden uygulama, satır satır merge’den güvenli olabilir. Kararı envanterden sonra verin.

Geri getirilebilir yedek ve sürüm kontrolü kurun

Canlı temayı Shopify’da çoğaltıp dosyalarını çekin. Tema kimliği, setting, template, navigasyon referansı, Markets, redirect ve ilgili app ayarını dışa aktarın. Önemli etkileşimlerin ekran görüntüsü/videosunu saklayın.

Eski base, mevcut custom ve yeni base’i Git’e koyun. Tam eski vendor sürümü yoksa vendor veya geçmişten bulun. Ortak ata olmadan her vendor satırı özelleştirme gibi görünebilir.

Branch ve odaklı commit kullanın. Canlı temada deney yapmayın. Yayın sonrası eski canlı temayı görsel rollback için saklayın; dış app/veri değişikliklerinin ayrı geri dönüş istediğini unutmayın.

Her özelleştirmeyi envantere alın

Git geçmişi, proje notu, tema kodu, app embed ve ekip bilgisini araştırın. Özellik, iş sahibi, template, dosya, setting, bağımlılık, veri alanı, app/API, analitik olay, son değişim, test ve karar sütunları oluşturun.

Şunları sınıflandırın:

• marka ve tasarım token’ları;
• özel section, block, snippet ve template;
• ürün, varyant, bundle, abonelik ve cart mantığı;
• navigasyon, arama, filtre, dil ve Markets;
• app block, embed, script, pixel ve proxy;
• metafield, metaobject, tag ve adlandırma;
• metadata, canonical, schema, robots ve redirect;
• erişilebilirlik ve performans düzeltmesi;
• analitik ve izin;
• kaldırılmış app veya denemeden kalan kod.

Bilinmeyen kodu otomatik taşımayın; araştırın. Bu aşama uygulama şişkinliği rehberimizle eski app kalıntısını kaldırma fırsatıdır.

Davranış başlangıcını kaydedin

Ana sayfa, temel koleksiyon, arama, farklı medya/seçenek/durumlu ürün, sepet, hesap, blog, iletişim, politika, pazar ve dillerden test matrisi kurun. Tükenmiş, indirimli, gift card, abonelik, bundle, uzun başlık, görselsiz ve çok varyantlı ürünü ekleyin.

Mobil, tablet ve masaüstü görüntülerini alın. Klavye, focus, ekran okuyucu etiketi, reduced motion, zoom ve kontrastı test edin. LCP, INP, CLS, network ve console başlangıcını; GA4/reklam olaylarını purchase’a kadar kaydedin.

Temel ödeme, kargo, vergi, indirim, para ve izin durumlarıyla sipariş verin. Tema ticaret yazılımıdır; görsel benzerlik kabul değildir.

Üç sürümü karşılaştırın

Eski base ile canlı tema mağaza değişikliklerini; eski base ile yeni base vendor değişikliklerini gösterir. Kod taşımadan ikisini inceleyin.

Her özelleştirme için:

1. Taşı: hâlâ gerekli ve uyumlu.
2. Yeniden uygula: gerekli fakat yeni mimaride daha doğru extension noktası var.
3. Değiştir: vendor veya Shopify artık karşılıyor.
4. Kaldır: kullanılmıyor veya değersiz.

Yeni theme.liquid, global JS, CSS veya section group üzerine eski dosyayı yazmayın; release mimarisini yok eder. En küçük bilinçli değişikliği yeni koda mevcut convention’la uygulayın.

Theme Check çalıştırın ve deprecated Liquid’i bugün render oluyor diye korumayın. Platform kuralları değişebilir.

Ayarları bilinçli taşıyın

settings_data.json mağaza ayarlarını ve section/block referanslarını tutar. Kör kopya artık olmayan setting’i getirip yeni default’u kaçırabilir. settings_schema.json, ID, tip, default ve preset’i karşılaştırın.

Global renk, font, layout, sosyal link, favicon, cart, search, product card ve özel setting’i eşleyin. ID değiştiyse değeri dönüştürün. Eski app block’u yalnız app’in kaldırıldığı doğrulandıysa silin.

JSON template ve section group’ta type, block ID, sıra, disabled ve setting’i karşılaştırın. Yeni vendor section eski custom’ı karşılıyorsa template’i onunla kurun. Makinece okunur mapping tutup editörde elle doğrulayın.

Özel section ve snippet’leri taşıyın

Her özel section’da schema, benzersiz ID, default, localization, dynamic source, app-block desteği, limit, preset ve erişilebilirlik kontrol edin. Liquid ve image kullanımını güncel en iyi uygulamaya taşıyın.

İki satır değiştiği için eski vendor section’ını komple getirmeyin. Değişikliği yeni section’a uygulayın veya setting’e çevirin. Mağazaya özgü işlevi açık adlandırılmış snippet/asset’e ayırın; sonraki diff küçülsün.

Responsive image, intrinsic dimension ve doğru loading kullanın. Kritik içerik HTML’de olsun. JavaScript tema editöründe ve dinamik section load’da yalnız bir kez başlasın.

Uygulamaları desteklenen extension’larla bağlayın

Yeni temayı editörde açıp her app embed/block’u doğrulayın. Eski JSON block’u otomatik gelmeyebilir. Desteklenen arayüzden yeniden ekleyip ayarı üretin.

App destekliyorsa elle vendor snippet yerine theme app extension tercih edin. Güncel kurulum talimatını isteyin. Abonelik, yorum, bundle, arama, kişiselleştirme, sadakat, sohbet, izin ve analitiği ilgili her template’te deneyin.

Eski app kodunu “belki gerekir” diye kopyalamayın; extension’ı ikiye katlayabilir veya bozuk endpoint yükleyebilir.

SEO sinyallerini koruyun

Render edilen title, description, canonical, robots, hreflang, OG/Twitter, Product/Article/Breadcrumb schema, heading, içerik, link, alt text, pagination ve status davranışını karşılaştırın.

Güncelleme iki canonical çıkarabilir, koleksiyon metnini kaldırabilir, ürün link yolunu değiştirebilir, H1’i çoğaltabilir veya schema’yı eksik vendor default’una döndürebilir. İki preview’u şablon bazında crawl/diff edin.

Ayrı migration planı yoksa public URL’yi koruyun. Değişirse doğrudan redirect ve güncel dahili link kurun. Preview hostname canonical veya sosyal görsel olmasın. Teknik SEO denetimimizi kabul çerçevesi kullanın.

Analitik ve izni koruyun

Google kanalı, GTM, custom/app pixel, tema data layer, Meta/TikTok, affiliate, consent ve listener envanteri çıkarın. Hangisinin theme’e bağlı olduğunu belirleyin.

Product/list view, her arayüzden add-to-cart, cart, checkout, purchase ve izin durumunu test edin. Yeni tema hem eski custom kodu hem extension’ı çalıştırmasın. Kalıcı item/transaction ID kullanıp test siparişini mutabık tutun. GA4 rehberimize bakın.

Production secret’ı public tema asset’ine koymayın. Pixel ve korumalı sunucu işini uygun sistemde tutun.

Performans ve erişilebilirliği regresyon olarak test edin

Aynı URL, cihaz, ağ ve test sayısıyla karşılaştırın. Gerçek LCP öğesi, uzun etkileşim görevi, shift, JS transfer, üçüncü taraf ve görseli bulun. Yeni tema default’ta hızlıyken eski kod kopyalanınca yavaşlayabilir.

Kritik JS, görsel ağırlığı, üçüncü taraf ve layout için bütçe koyun. Menü, modal, drawer, slider, filtre, varyant, cart, form ve editor reload’u deneyin. Focus trap/restore, Escape, label ve hareket tercihini kontrol edin.

Canlı temadaki performans/erişilebilirlik düzeltmesini yeni base’e göre değerlendirin; bazıları taşınır, bazıları vendor tarafından farklı çözülmüştür.

Aşamalı kabul yapın

Theme Check, custom asset lint/build, link/crawl, schema ve visual regression çalıştırın; sonra insan testi yapın.

Merchandising template/editörü; marketing kampanya, içerik, pixel ve SEO’yu; operasyon sipariş, stok, fulfillment, bildirim ve iadeyi; destek hesap ve müşteri sorununu; finans vergi, indirim, ödeme ve raporu; geliştirme kod, performans, erişilebilirlik, hata ve rollback’i doğrulasın.

Her hataya severity, template, adım, beklenen/gerçek, sahip ve retest kanıtı ekleyin. Ana sayfa ekran görüntüsüyle onay vermeyin.

Yayın akışını hazırlayın

Tema değişikliklerini dondurun veya final delta süreci kurun. Geliştirme sırasında canlıya gelen değişikliği yayın öncesi merge edin. Sakin saatte sorumlular hazır olsun.

Runbook; final yedek, theme ID, commit, app ayarı, freeze, test siparişi, publish, smoke check, analitik not, dashboard, rollback tetikleyicisi ve sahip içersin. Aynı anda app, domain, checkout ve kampanya değiştirmeyin.

Yayın sonrası home, collection, product, search, cart, account, dil/pazar, iletişim ve policy kontrol edin. Gerçek sipariş verin; analitik/bildirimi doğrulayın; console/hata ve conversion izleyin.

Güncelleme kaydı tutun

Yeni sürüm, release note, taşınan/yeniden yapılan/değiştirilen/kaldırılan işler, dosya/extension noktası, setting mapping, test, bilinen sınır ve sonraki incelemeyi belgeleyin. Git’te release tag oluşturun.

Özelleştirme politikası belirleyin: setting, izole section/snippet, desteklenen extension, minimum global patch, açık ad ve test. Vendor sürümlerini düzenli inceleyin; bir sonraki güncelleme yıllık kurtarma olmasın.

Tema güncelleme listesi

• Eski base, canlı custom ve yeni base Git’te.
• Özelleştirme envanterinin sahibi/kararı var.
• Davranış, görsel, performans, SEO, analitik ve erişilebilirlik baseline’ı var.
• Eski dosya üzerine yazmak yerine yeni base’e yeniden uygulandı.
• Global setting, JSON template ve section group eşlendi.
• App’ler güncel block/embed/extension kullanıyor.
• Ürün, cart, checkout, Markets ve uç durumlar geçti.
• Canonical, schema, link, hreflang ve URL doğru.
• Analitik, izin ve purchase mutabık.
• Freeze, smoke test, monitoring ve rollback hazır.
• Kayıt sonraki merge’i küçültüyor.

Canlı temanız güvenle güncellenemeyecek kadar özelleştirildiyse Shopimaster’a ulaşın. Değişiklik geçmişini yeniden çıkarabilir, özel işlevi güncel vendor tabanına taşıyabilir, eski kodu temizleyebilir, ticaret ve SEO regresyonlarını çalıştırıp belgeli rollback ile yayınlayabiliriz.

Projeyi kapatmadan ilk tam haftayı saklanan baseline ile karşılaştırın. Ürün şablonu hataları, başarılı sepete ekleme, checkout tamamlanma, organik açılış davranışı, arama kullanımı, uygulama alarmı ve destek taleplerini inceleyin. Temayı düzenleyen çalışanlarla görüşün; günlük merchandising yavaşladı veya karıştıysa teknik kabul tamamlanmış değildir. Ertelenen her iyileştirmeye sahip ve hedef sürüm verin, sohbet geçmişinde bırakmayın. Son olarak test edilen tema paketini, bağımlılık sürümlerini ve release notlarını birlikte arşivleyin. Böylece acil incelemede müşterinin gördüğü sürüm tam olarak yeniden üretilebilir.