# 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.

- Source canonique : [https://allaux.fr/tr/wordpress-woocommerce/migration/blocs-panier-commande](https://allaux.fr/tr/wordpress-woocommerce/migration/blocs-panier-commande)
- Langue : TR
- Dernière mise à jour : 2026-09-30

## Doğrudan yanıt

> Yayındaki sayfalara dokunmayın: Sepet ve Ödeme sayfalarını çoğaltın, kopyalara Sepet bloğunu ve Ödeme bloğunu yerleştirin, sonra gerçek ödeme yöntemleriniz ve kargo ücretlerinizle baştan sona bir test siparişi verin. Kopyalar doğrulanınca WooCommerce, Ayarlar, Gelişmiş bölümünde bu sayfaları tanımlayın. [woocommerce_cart] ve [woocommerce_checkout] kısa kodları yedek olarak desteklenmeye devam eder.

## 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.

## Bu geçişte kesin bir dönüşü olmayan nokta yok

> Bir URL veya platform değişikliğinin aksine, blok araç çubuğundan istediğiniz zaman kısa koda geri dönmek mümkündür: bu da bu geçişi üretimde aşamalı olarak test etmeyi daha güvenli kılar.

## Daha fazlası için

- **WooCommerce’de yüksek performanslı sipariş depolamaya geçiş** — WooCommerce’in aynı dönemine ait, eklentiler tarafında kendi uyumluluk mantığına sahip bir değişiklik. ([/wordpress-woocommerce/migration/stockage-haute-performance-commandes](/wordpress-woocommerce/migration/stockage-haute-performance-commandes))
- **WooCommerce ödeme sorununu çözme** — Bloklara geçtikten sonra bir ödeme eklentisi görünmemeye başlarsa, teşhise genellikle buradan başlarım. ([/wordpress-woocommerce/probleme-paiement](/wordpress-woocommerce/probleme-paiement))
- **WooCommerce’i büyük bir sürüme güncelleme** — Sepet ve ödeme blokları, WooCommerce’in büyük bir sürüm yükseltmesinden önce kontrol edilmesi gereken değişikliklerden biridir. ([/wordpress-woocommerce/mise-a-jour/version-majeure-woocommerce](/wordpress-woocommerce/mise-a-jour/version-majeure-woocommerce))
- **WordPress ve WooCommerce geçiş merkezi** — WordPress ve WooCommerce üzerinde ele aldığım tüm geçişler ve sürüm yükseltmeleri. ([/wordpress-woocommerce/migration](/wordpress-woocommerce/migration))

## FAQ

### 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.