Projeler ve ajans desteği için müsait · Hızlı yanıt, işi yapan kişiden

Mesaj gönderin contact@allaux.fr
FR EN TR
allaux.
Acil durum Projemi konuşalım

WooCommerce’de Kısa Kodlardan Sepet ve Ödeme Bloklarına Geçiş

14 Kasım 2023’te yayınlanan WooCommerce 8.3’ten itibaren Sepet ve Ödeme sayfaları, yeni kurulumlarda tarihsel [woocommerce_cart] ve [woocommerce_checkout] kısa kodlarının yerine varsayılan olarak Gutenberg bloklarını kullanır. Kısa kodlar yedek çözüm olarak desteklenmeye devam eder: acil bir geçiş zorunluluğu yoktur.

Sorunumu anlatayım Mesaj gönderin

Bloklar kısa kodlara kıyasla neyi değiştiriyor

[woocommerce_cart] ve [woocommerce_checkout] kısa kodları, satın alma tünelini sunucu tarafında PHP ile klasik bir HTML çıktısı olarak oluşturur. Sepet ve ödeme blokları farklı çalışır: arayüz tarayıcıda React’e dayanır ve her adımda tam sayfa yenilemesi yerine WooCommerce Store API’si üzerinden siteyle iletişim kurar. Alıcı için görsel sonuç klasik bir ödeme tüneli olarak kalır, ancak altta yatan teknik mekanizma tamamen değişir.

Bir eklenti geçişi engelliyorsa hareket alanı bırakmak amacıyla, blok araç çubuğundaki dönüştürme düğmesiyle her an kısa koda geri dönmek mümkündür.

Bir ödeme tüneli özelleştirmesi neden artık uygulanmayabilir

  • Kısa kodlu sepet veya ödeme görünümünü değiştiren klasik bir PHP hook’u veya filtresi (örneğin bir alan eklemek, bir mesaj göstermek veya bölümleri yeniden düzenlemek için) bloklara otomatik olarak uygulanmaz: React mimarisi, render sırasında bu PHP kodunu çalıştırmaz; genellikle blok’lara özgü uzantı noktaları (JavaScript filtreleri, Store API) üzerinden yeniden yazım gerekir.
  • Bloklarla uyumluluğunu açıkça belirtmeyen bir ödeme veya kargo eklentisi, kısa kodlarla normal çalışsa bile blok sepetinde veya ödemesinde kullanılabilir bir ödeme yöntemi olarak görünmeyebilir.
  • Kısa kodlu ödeme tünelinin CSS’ini veya PHP şablonlarını (woocommerce/checkout/ altındaki dosyalar) yoğun şekilde geçersiz kılan bir tema, bu özelleştirmelerin kendi şablonlarını kullanan bloklar üzerinde hiçbir etkisi olmadığını görür.

Bloklara geçişi nasıl yürütüyorum

  1. Sitenin mevcut modunu belirleme

    Kasım 2023’ten önce oluşturulmuş ve otomatik olarak geçiş yapmamış bir sitede özellikle, Sepet ve Ödeme sayfalarının hâlâ tarihsel kısa kodları mı yoksa zaten blokları mı kullandığını kontrol ederim.

  2. Geçişten önce ilgili eklentileri test etme

    Herhangi bir üretim geçişinden önce, aktif her ödeme ve kargo eklentisinin bloklarla çalıştığını ve uyumluluğunu bildirdiğini bir test ortamında kontrol ederim.

  3. Mevcut özelleştirmeleri listeleme

    Kısa kodlu ödeme tünelini değiştiren PHP hook’larını ve şablon geçersiz kılmalarını listeler, bloklar için hangilerinin yeniden yazılması gerektiğini belirlerim.

  4. Geçiş ve hedefe yönelik yeniden yazım

    Blokları etkinleştirir ve eski mekanizmayı yeniden üretmek yerine, blok’lara özgü uzantı noktalarını kullanarak yalnızca artık uygulanmayan özelleştirmeleri yeniden yazarım.

  5. Engel çıkarsa yedek çözüm

    Kritik bir eklenti uyumlu değilse, ilgili bloğu araç çubuğu üzerinden kısa koda geri dönüştürürüm; bu, sitenin geri kalanını engellemeden o sayfanın geçişini ertelememi sağlar.

Daha fazlası için

İhtiyacınızı bir dakikada anlatın

Size bir anket daha değil, doğrudan bir tahmin sunabilmem için birkaç hedefli soru.

origine
catalogue
extensions-premium (facultatif)
conserver (facultatif)
Size dönebilmem için en az bir e-posta veya telefon numarası belirtin.

Size dönebilmem için en az bir e-posta veya telefon numarası belirtin.

Sıkça sorulan sorular

Sitem hâlâ kısa kod kullanıyorsa bloklara geçmem gerekir mi?
Acil değil: kısa kodlar yedek çözüm olarak desteklenmeye devam ediyor. Kullanılan ödeme ve kargo eklentilerinin uyumlu olduğu doğrulandığında geçişi öneririm.
Özel PHP hook’larım basitçe çalışmayı durdurur mu?
Hata vermezler, ancak değiştirdikleri kısa kodlu PHP render’ı bloklarda artık kullanılmadığı için görsel olarak uygulanmayı bırakırlar. Aynı davranışı geri kazanmak için hedefe yönelik bir yeniden yazım gerekir.
Ödeme eklentimin bloklarla uyumlu olup olmadığını nasıl anlarım?
Ödeme yöntemini bir test ortamında blok Ödeme sayfasında test ederim: kullanılabilir yöntemler listesinde görünmüyorsa eklenti muhtemelen henüz uyumlu değildir.
Geçiş bir soruna yol açarsa geri dönebilir miyim?
Evet, her sepet veya ödeme bloğu, araç çubuğunda doğrudan kısa kod sürümüne dönüştürme düğmesi sunar; ağır bir teknik işlem gerekmez.
Bloklar alıcının gördüğü deneyimi değiştiriyor mu?
Akış, alıcı için klasik bir ödeme tüneli olarak kalır. Değişen şey teknik taraftadır: render işlemi klasik PHP render yerine React ve WooCommerce Store API’sine dayanır.

İlgili sayfalar