PrestaShop 1.6’dan 1.7’ye: temayı değiştiren basamak
PrestaShop’ta 1.6’dan 1.7’ye geçmek, daha ileri gitmek için atılması zorunlu ilk adımdır: tema motoru değişir, yönetim panelinin bir kısmı Symfony’ye taşınır ve ödeme sayfasındaki ödeme yöntemleri hook’u artık aynı değildir. İşte somut olarak neyin bozulduğu ve bunu nasıl ele aldığım.
1.6 ile 1.7 arasında gerçekte ne değişiyor
PrestaShop 1.6, özel bir “legacy” framework’e ve tamamen Smarty’ye dayalı bir şablon sistemine sahiptir; varsayılan teması Default’tur. 1.7’den itibaren, yönetimin bir kısmı ve bazı ön yüz denetleyicileri, bu ekranlar için Twig kullanılarak Symfony’ye taşınır; Smarty geri kalanı için kullanılmaya devam eder: mimari hibrit hâle gelir. Varsayılan tema da ad değiştirir; 1.6 teması Bootstrap 3 üzerindeyken Bootstrap 4 tabanlı Classic, Default’un yerini alır. Çok özelleştirilmiş olsa bile bir 1.6 teması 1.7’ye olduğu gibi kurulamaz: şablon şablon yeniden inşa edilmesi gerekir.
Mağazaları en sık bozan değişiklik, ödeme adımıyla ilgilidir. 1.6’da ödeme eklentileri displayPayment hook’una bağlanır. 1.7’den itibaren bu hook paymentOptions ile değiştirilir. Güncellenmemiş bir eklenti, herhangi bir hata mesajı vermeden ödeme adımında artık görünmez: müşteri ödeme yapamaz.
Veritabanı yapısı da iki ana sürüm arasında değişir; yeni tablolar ve yeniden adlandırılmış sütunlar eklenir: olduğu gibi geri yüklenen ham bir SQL dökümü güvenilir değildir, gerekli şema güncelleme betiklerini çalıştıran resmi autoupgrade eklentisidir.
1.6’dan 1.7’ye geçişte tipik olarak neler bozulur
- Ödeme eklentisi, displayPayment hook’u artık çağrılmadığı için hiçbir hata mesajı vermeden ödeme adımından kaybolur.
- Tema boş bir sayfa veya bozuk bir görünüm gösterir; 1.6’nın .tpl şablonları artık 1.7’nin dizin yapısıyla uyuşmaz.
- Yönetim panelinin bazı ekranları yer değiştirir; yönetimin bir kısmı artık Symfony denetleyicileri tarafından yönetilir.
- Eski süslü parantez dizi erişim söz dizimini kullanan eklentiler (örn. $array{0}), PHP de yükseltilmişse ölümcül hatalar verir.
1.6’dan 1.7’ye geçişi nasıl yürütüyorum
-
Eklentilerin ve temanın envanteri
Kurulu her eklentiyi ve sürümünü listeliyor, yapılandırma dosyasında 1.7 uyumluluğu bildirip bildirmediğini kontrol ediyorum — aynısını tema için de yapıyorum.
-
Herhangi bir işlem yapmadan önce tam yedekleme
Herhangi bir şey çalıştırmadan önce sitenin tüm dosyalarını, tam bir veritabanı dökümünü ve kritik eklentilerin (ödeme, taşıyıcı) yapılandırmasını yedekliyorum.
-
Mağazanın bir kopyası üzerinde geçiş
autoupgrade eklentisini bir test ortamında çalıştırıyorum, asla üretimde değil. Güncellemeden önce dosyaları ve veritabanını tekrar yedekliyor; hata durumunda geri yükleme sunuyor.
-
Temanın yeniden inşası ve ödeme hook’unun değiştirilmesi
Temayı Classic üzerine uyarlıyor veya yeniden inşa ediyor, her ödeme eklentisinin eski displayPayment yerine paymentOptions kullandığını kontrol ediyorum.
-
Kontrol, ardından geçiş
Test mağazası onaylandıktan sonra, devam eden siparişler üzerindeki etkiyi sınırlamak için üretime geçişi düşük trafikli bir zaman dilimine planlıyorum.
Neyi yedekliyorum, sonrasında neyi kontrol ediyorum
Herhangi bir şey çalıştırmadan önce, sitenin tüm dosya ağacını (.php dosyaları, tema, eklentiler, görseller), tam bir veritabanı dökümünü ve hook değişikliğine en duyarlı ödeme ile taşıyıcı eklentilerinin yapılandırmasını yedekliyorum; bunu autoupgrade/backup klasörünün dışında saklıyorum, çünkü bu klasör sonraki bir denemeyle üzerine yazılabilir.
Geçişten sonra, sipariş, müşteri ve katalog ürünü sayısının öncekiyle eşleştiğini, ana URL’lerin doğru durum koduyla yanıt verdiğini ve yönlendirmelerin çalıştığını kontrol ediyorum. Ayrıca sepetten ödemeye eksiksiz bir sipariş testi yaparak eklentinin paymentOptions hook’uyla doğru göründüğünü doğruluyorum.
// PS 1.6
$this->registerHook('displayPayment');
// PS 1.7+
$this->registerHook('paymentOptions');Bu geçişi hazırlamak veya tamamlamak için
-
Geçiş öncesi kontrol listesi
Sürüm ne olursa olsun, bir PrestaShop geçişi başlatmadan önce kontrol ettiğim her şey.
-
Uyumsuz eklentiler
Geçişi geçemeyecek eklentileri nasıl tespit ettiğim ve bunları neyle değiştirdiğim.
-
SEO’yu korumak
Kazanılmış SEO değerini kaybetmemek için URL’ler ve yönlendirmeler konusunda kontrol ettiklerim.
-
Satışı durdurmadan geçiş yapmak
Devam eden siparişleri engellemeden üretime geçiş yöntemi.
- PHP 5.2 – 7.1 PrestaShop 1.6
- Alt sürüme göre PHP 7.2 – 7.4 PrestaShop 1.7
devdocs.prestashop-project.org
İhtiyacınızı bir dakikada anlatın
Size bir anket daha değil, doğrudan bir tahmin sunabilmem için birkaç hedefli soru.