Hyvä geçiş kontrol listesi: önce eklentilerinizi inceleyin

Luma'dan Hyvä'ya geçiş yalnızca ön yüzü değiştirir. Ürünleriniz, müşterileriniz ve siparişleriniz olduğu yerde kalır.

Bu, projeyi basit gösterir ve birçok açıdan gerçekten de basittir. Ancak neredeyse her Magento 2 mağazası Luma için yazılmış eklentiler çalıştırır ve geçişin ne kadar sorunsuz olacağını bu eklentiler belirler.

Her Hyvä projesine başlamadan önce kullandığımız kontrol listesi bu.

Neden önce eklentiler?

Hyvä, Luma’nın RequireJS, KnockoutJS ve jQuery altyapısını kaldırır. Kendi ön yüz JavaScript’ini veya Knockout şablonlarını getiren her eklenti, bu altyapının var olmasını bekler.

Hyvä'da böyle bir eklentinin arka uç kısmı çalışmaya devam eder. Ancak alışverişçinin gördüğü kısım (bir widget, bir açılır pencere ya da bir ödeme adımı), ön yüzü yeniden yazılana kadar çalışmaz.

Bunu projenin ortasında fark ederseniz zaman kaybedersiniz ve risk oluşur. İlk gün fark ederseniz, yalnızca planın bir parçası olur.

1. adım: tüm modülleri listeleyin

Eksiksiz bir listeyle başlayın. Hafızanıza ya da yönetim paneli menüsüne güvenmeyin; çünkü birçok modülün yönetim panelinde hiç ekranı yoktur.

bin/magento module:status --enabled | grep -v '^Magento_'
composer show | grep -v '^magento/'

İlk komut, Magento çekirdeğine ait olmayan etkin modülleri listeler. İkincisi Composer paketlerini listeler; böylece her birinin geliştiricisini ve sürümünü kolayca bulursunuz.

Composer olmadan kurulmuş özel ve eski modüller için ayrıca app/code klasörünü de kontrol edin. Çoğu zaman kimsenin hatırlamadığı modüller bunlardır.

2. adım: her modülün mağaza ön yüzünde ne yaptığını belirleyin

Her modül için tek bir soruyu yanıtlayın: Alışverişçinin gördüğü ya da tıkladığı herhangi bir şeyi değiştiriyor mu?

• ERP bağlantıları, sipariş aktarımları, feed'ler ya da yönetim paneli araçları gibi yalnızca arka uçta çalışan modüller genellikle Hyvä'da değişiklik gerektirmeden çalışır.
• Ön yüz şablonu, JavaScript ya da layout değişikliği içeren modüllere daha yakından bakmak gerekir.
• Ödeme sayfasına dokunan modüller ise en dikkatli incelemeyi gerektirir.

Ön yüz kodunu hızlıca fark etmek için her modülde bir view/frontend klasörü arayın; içinde web/js, requirejs-config.js ya da Knockout .html şablonları varsa modülün ön yüz kodu var demektir.

3. adım: her modülü üç gruptan birine ayırın

Her eklentiyi üç gruptan birine ayırıyor ve listenin tamamını mağaza sahibiyle paylaşıyoruz.

Popüler eklenti üreticilerinin çoğu kendi Hyvä uyumluluk modüllerini yayınlıyor. Hyvä da uyumluluk modüllerini takip eden herkese açık bir liste tutuyor; ilk bakılacak yer burası.

Ortadaki sütuna düşen modüller için seçenekleri Hyvä uyumluluk modülü olmayan eklentiler yazımızda ayrıntılı olarak anlatıyoruz.

4. adım: yüksek riskli kategorileri kontrol edin

Deneyimlerimize göre bazı modül türleri diğerlerinden daha sık bozuluyor. İncelemede bunlara ekstra zaman ayırın.

• Ödeme yöntemleri. Birçok ödeme modülü, ödeme adımını Knockout ile oluşturur. Bazı sağlayıcıların ise hiç Hyvä uyumlu sürümü yoktur.
• Takip kodları ve etiket yöneticileri. Birçok modül e-ticaret olaylarını RequireJS üzerinden gönderir. Hyvä'da bu olaylar sessizce durabilir; GA4 raporları da hiçbir hata vermeden boş kalır.
• Slider, galeri ve ürün yapılandırıcılar. Bunlar çoğu zaman ağır jQuery widget'larıdır.
• Temaya özel sayfa oluşturucu (page builder) öğeleri. Eski temanızın kendine özgü öğeleriyle hazırlanmış içerikler, geçişten sonra kaybolabilir.
• Arama ve katmanlı gezinme (layered navigation). Bunların çoğunun kendine ait ön yüz scriptleri vardır.

5. adım: ödeme sayfası yolunu erkenden belirleyin

Ödeme sayfası; ödeme, kargo ve takip modüllerinin buluştuğu yerdir. Tasarım çalışması başlamadan önce bu konuda karar verilmesi gerekir.

• Ödeme ve kargo yöntemleriniz destekleniyorsa ya da entegre edilebiliyorsa, Magewire tabanlı Hyvä Checkout.
• Mağazanın geri kalanı Hyvä’ya geçerken ödeme sayfasını şimdilik Hyvä’nın yedek (fallback) yaklaşımıyla Luma’da tutmak.
• Sepet büyüklüğünüze ve pazarlarınıza göre tasarlanmış bir ödeme sayfası şablonu.

Content Security Policy'yi (CSP) de planlayın. Magento 2.4.7'den bu yana ödeme sayfaları katı bir CSP uygular; bu yüzden her inline script'e izin verilmesi gerekir, aksi halde ödeme yöntemleri çalışmayabilir.

Bu kararı verirken Hyvä Checkout'a geçmeye değer mi? başlıklı yazımız size yol gösterecektir.

6. adım: SEO ve takibi koruyun

Ön yüz değişikliği, Google'ın ya da analiz araçlarınızın mağazayı nasıl gördüğünü değiştirmemelidir. Kontrol listesine şunları ekleyin:

1. Kategori ve ürün URL'leri dahil tüm URL'leri aynı tutun.
2. Eski ve yeni sayfalarda render edilen başlıkları, meta açıklamalarını, canonical etiketlerini ve hreflang'i karşılaştırın.
3. Ürün, breadcrumb ve kurum (organization) için yapılandırılmış verileri karşılaştırın.
4. GA4 e-ticaret olaylarını baştan sona test edin: ürün görüntüleme, sepete ekleme, ödemeye başlama ve satın alma.
5. Yayına aldıktan sonra Search Console'u yakından izleyin.

MageBooster’ın Magento 2 SEO kontrol listemiz SEO'nun daha geniş kapsamını ele alıyor.

7. adım: listeyi bir plana dönüştürün

Tüm modüller gruplara ayrıldığında, gerçekçi bir plan için ihtiyacınız olan her şey elinizdedir:

• Uyarlanacak modül sayısı, ana geliştirme eforunu gösterir.
• Ödeme sayfası için seçilen yol, ana riski gösterir.
• Kaldırdığınız modüller mağazayı daha sade ve hafif hale getirir.

Sunucuya bakmanın da tam zamanı. Hyvä ön yüzü hafifletir; ancak yavaş bir sunucu, bozuk bir tam sayfa önbelleği ya da çok büyük görseller hangi temada olursa olsun yavaş kalır.

Aynı dönemde Magento upgrade'i de planlıyorsanız, aynı eklenti incelemesini upgrade için de yapın; böylece her modülü yalnızca bir kez gözden geçirirsiniz.

SSS

Hyvä için kaç eklenti fazla sayılır?

Sabit bir sayı yok. Önemli olan, uyumluluk modülü olmadan ön yüz kodu içeren kaç eklenti olduğu ve bunların ne kadar karmaşık olduğudur.

Bir ödeme yöntemi Hyvä uyumlu değilse yine de Hyvä'ya geçebilir miyiz?

Evet. Entegrasyonu geliştirebilir ya da mağazanın geri kalanı Hyvä'da çalışırken ödeme sayfasını şimdilik Luma'da tutabilirsiniz.

Eklenti incelemesini kim yapmalı?

Hem Luma’yı hem Hyvä’yı bilen bir Magento 2 geliştiricisi. Bu inceleme için modülün tanıtım sayfasını değil, modül kodunu okuyabilen biri gerekir.

Hyvä geçişi için teklif vermeden önce tüm eklentileri kontrol ediyoruz. Sürecin nasıl işlediğini Hyvä tema geliştirme sayfamızda görebilirsiniz. Orada nelerin bozulduğunu ve bunları nasıl çözdüğümüzü de anlatıyoruz.