Gutenberg React 19 Geri Alma: Eklenti Yazarları Şimdi Ne Yapmalı

Yeterince WordPress yükseltmesi gördüm, deseni tanırım. Yeni bir bağımlılık geliyor, demolar tertemiz duruyor, sürüm notlarında “kademeli” ve “geriye dönük uyumlu” gibi kelimeler geçiyor; sonra bir salı sabahı binlerce yayında olan site sessizce alev alıyor. Gutenberg’in React 19 yükseltmesinde yaşanan tam olarak buydu — ve çekirdek ekibi bu konuda doğru kararı verdi.

Eklenti geliştiriyorsanız, müşteri sitesi yönetiyorsanız ya da bu hafta Gutenberg eklentisini güncellediyseniz, bu haberi göz gezdirmek yerine dikkatle okumanız gereken cinsten. İyi tarafı şu: WordPress projesi bu işi, bu ekosistemden beklediğim olgunlukta yönetti. Yükseltme yapıldı, neyin kırıldığı izlendi, geri alındı ve yeni plan kamuya açık biçimde yazıya döküldü.

Ne oldu, önümüzdeki iki ay için ne değişiyor ve gerçek bir WordPress ekibi yönetiyor olsaydım bugün ne yapardım — sırasıyla anlatıyorum.

Aslında ne değişti

27 Mayıs 2026’da çekirdek ekibi, WordPress’i React 19’a yükseltme planını yayımladı. Plan basitti: React 19 önce Gutenberg 23.3 ile gelsin, eklentinin tüm sürüm döngüsü kamuya açık bir test penceresi olarak kullanılsın, ardından ağustosta WordPress 7.1 ile çekirdeğe insin. Yazıda, React 19’da kaldırılan kullanım dışı kalıplar tek tek sayılmıştı — ReactDOM.render() ve hydrate() (yerine createRoot() ve hydrateRoot()), unmountComponentAtNode() (yerine root.unmount()), findDOMNode() ve işlev bileşenlerinde defaultProps.

3 Haziran 2026’da Gutenberg 23.3, React 19 yükseltmesiyle birlikte yayımlandı. Aynı sürümle yeni kalıp tabanlı medya düzenleyici, beş yeni özelleştirilebilir gösterge paneli widget’ı ve gerçek zamanlı işbirliği geliştirmeleri de geldi.

İki gün sonra, 5 Haziran 2026’da ekip, Gutenberg 23.3.2 ile React 19 yükseltmesini geçici olarak geri aldığını duyurdu. Sebep teorik değil, somuttu: React 18 üzerine kurulmuş çok sayıda eklenti yeni çalışma zamanında çöküyordu. Hata kalıbı önemli — kendi react/jsx-runtime yardımcısını paket içine gömen eklentilerin ürettiği elementler, React 19’un çalışma anında etkin biçimde reddettiği bir biçime sahip. Bu, üzerinde durulması gereken yumuşak bir uyarı değil; render sırasında çıkan sert bir reddediş.

Ekip yükseltmeyi rafa kaldırmıyor. Yazıdaki ifade net: “WordPress 7.1’de yükseltmeyi yapmaya kararlıyız.” Değişen şey, oraya gidiş yolu. Sonraki denemede halihazırda yayında olan eklentiler için bir uyumluluk katmanı (compat layer) ve React 18 ile React 19 arasında geçiş yapmayı sağlayacak deneysel bir özellik bayrağı (feature flag) olacak. Yani eklenti yazarları ve site sahipleri, yeni çalışma zamanını bir gecede zorla benimsemek yerine test edebilecek.

WordPress ve WooCommerce tarafı için neden önemli

Site sahibiyseniz pratik etki şu: Gutenberg eklentisini şimdi tekrar güncelleyin — 23.3.2 sürümü düzenleyiciyi React 18’e geri alıyor ve halihazırda kurulu olan eklentilerle uyumluluğu yeniden kuruyor. 3 ile 5 Haziran arasında blok düzenleyicinizde ya da yönetim ekranlarında yarı kırık bir görüntü gördüyseniz, gözünüze gelmiyordu. Çalışma zamanı sözleşmesinin değiştiği o kısa pencerede gerçek yazılım çalıştırıyordunuz.

Eklenti yazarıysanız bu geri alma bir hediye, erteleme değil. WordPress yol haritasına göre WordPress 7.1, 19 Ağustos 2026 için planlanıyor. Yani önünüzde yaklaşık on hafta var. Bu süre içinde kendi react/jsx-runtime kopyanızı paketlemeyi bırakıp, yönetim ve düzenleyici bağlamlarında @wordpress/element paketini kanonik React yüzeyi olarak benimsemeniz gerekiyor. Bir sonraki deneme uyumluluk katmanıyla gelecek; ama uyumluluk katmanları geçişi yumuşatmak içindir, geçişin yerine geçmek için değil.

WooCommerce yığını işletiyorsanız bu konu dolaylı ama somut biçimde sizi de etkiliyor. WooCommerce 10.8 zaten WordPress 6.9 ve üzerini şart koşuyor; sonraki iki Woo sürümü de yönetim ekranlarında, Sepet ve Ödeme bloklarında ve yeni gösterge paneli widget’larında giderek daha fazla React 19 çalışma zamanını varsayacak. Ekibinizin sürdürdüğü her özel Woo eklentisi, bu mesele bakımından aynı zamanda bir Gutenberg eklentisidir.

WordPress’in olgunluk üzerinden kazandığını neden tekrar tekrar söylediğimi soranlara, bunu örnek gösteriyorum. Geriye dönük uyumluluğu önemsemeyen bir platform kırılmayı yayınlar, suçu eklenti yazarlarına atar ve yoluna devam ederdi. WordPress kırılmayı yayınladı, kırk sekiz saat içinde yayın etkisini ölçtü, geri aldı ve daha iyi bir planı kamuya açık biçimde yazdı. Yönetişim dediğimiz şey budur. Sayfa sıralaması geçmişinin, yönlendirmelerin, sürüm kayıtlarının ve eklenti ekosisteminin altında duran asıl temel de budur.

Bu hafta ne yapardım, neyi yapmazdım

Ekibimle bu hafta üzerinde çalıştığımız kısa liste şu.

• Önce hazırlık ortamında Gutenberg 23.3.2’ye güncelleyin. Geri alma yayında. Çökme gördüğünüz için eklentiyi eski bir sürümde dondurduysanız artık ileri gidebilirsiniz; ama yayına dokunmadan önce klon bir ortamda doğrulayın.
• Tüm özel blokları ve yönetim ekranlarını kullanım dışı React API’leri için tarayın. Kod tabanınızda ReactDOM.render, hydrate, unmountComponentAtNode, findDOMNode, string ref kullanımı ve işlev bileşenlerinde defaultProps arayın. React 19 yükseltmesi geri döndüğünde bunların hiçbiri çalışmayacak.
• Eklenti paketlerinde react ve react/jsx-runtime ile çıktı vermeyi bırakın. Derleme aracınız bunları eklenti çıktısına dahil ediyorsa, çekirdek ekibinin tanımladığı kırılma kalıbı sizsiniz. WordPress’in sağladığı React’i @wordpress/element üzerinden kullanın ve çalışma zamanı sürümünün sahibi düzenleyici olsun.
• Hazırlık ortamında SCRIPT_DEBUG açın. React’in ayrıntılı uyarıları, hangi ekranın kırılacağını kullanıcılarınız fark etmeden önce öğrenmenin en kolay yoludur.
• Yayında daha eski bir Gutenberg sürümüne geri dönmeyin. Güvenli hat 23.3.2 hattı. Daha geriye gitmek başka bir uyumsuzluk sınıfını davet eder.
• Bir eklenti satıyorsanız 7.1 öncesinde uyumluluk sürümü yayımlayın. Uyumluluk katmanı gelse bile 7.1 penceresini içselleştirilmesi gereken doğru son tarih olarak alın. Bu hafta başlarsanız iki ay yeter.

Yapmayacağım şey ise şu: Kaldırılan API’leri kullanmayan kod için panikle yeniden yazıma girişmek. React 19 kalıpların büyük çoğunluğunu olduğu gibi koruyor — işlev bileşenleri, hook’lar, suspense, modern ref kullanımı, hepsi çalışıyor. Kırılma noktası dar, geçiş mekanik.

Bu büyüklükte bir çalışma zamanı yükseltmesi için çoğu ekosistemin sunmadığı kadar nefes alma alanı önümüzde duruyor. Süreyi iyi kullanın, düzeltmeyi yayımlayın ve WordPress 7.1 ağustosta geldiğinde her şey temiz insin.