WordPress: ‘Düzenleyici beklenmeyen bir hatayla karşılaştı’ Çözümü

WordPress blok editörü (Gutenberg) bazen “Düzenleyici beklenmeyen bir hatayla karşılaştı” şeklinde bir uyarı verir. Bu hata genellikle JavaScript çatışmaları, eklenti uyumsuzlukları veya tema sorunlarından kaynaklanır. Peki bu sorunun çözümü nedir? İşte detaylar…

Gutenberg editöründe bir gönderi, sayfa, WooCommerce öğesi, form, SSS, duyuru, etkinlik veya özel gönderi türlerini düzenlemeye çalışırken: "Düzenleyici beklenmeyen bir hatayla karşılaştı." hatası ile karşılaşabilirsiniz. Bu hata ile birlikte 3 seçenek sunulur: Kurtarma girişimi, Yazı metnini kopyala ve Kopyalama hatası. Ancak bu seçeneklerin hiçbiri sorunu çözmez ve sorunun neden kaynaklandığı hakkında bilgi vermez:

WordPress düzenleyici hatası, genellikle altyapısal bir sorundan değil, eklentiler, temalar veya WordPress’in kendi bileşenleri arasındaki uyumsuzluktan kaynaklanır. Gutenberg (blok düzenleyici) oldukça güçlü bir araçtır, ancak bazen diğer yazılımlarla çakışabilir. Çoğu durumda sorun tek bir nedenden kaynaklanmaz; birkaç faktörün bir araya gelmesiyle ortaya çıkar. Bu yüzden çözümü ararken sistematik bir yaklaşım izlemek gerekir.

“Düzenleyici beklenmeyen bir hatayla karşılaştı” Hatası Çözüm Yolları

Aşağıdaki adımlara geçmeden önce WordPress’in, eklentilerin, temaların, kullandığınız editörün ve web sitenizdeki her şeyin güncel olduğundan emin olun, değilse güncelleyin. Gerekirse WordPress son sürümünü tekrar yükleyin. Ardından, her ihtimale karşı sitenizin bir yedeğini alın ve aşağıdaki adımlara geçin.

1. Tarayıcı Önbelleğini Temizleme

Hatayı görür görmez paniğe kapılmadan önce, en basit çözümlerden başlayalım. Bazen sorun WordPress’te değil, tarayıcınızın önbelleğinde saklanan eski dosyalardadır. Bu eski dosyalar, güncel WordPress kodlarıyla çakışarak hata oluşturabilir.

• Tarayıcı Önbelleğini Temizleyin: Chrome, Firefox veya Safari’de Ctrl+Shift+Delete (Mac’te Cmd+Shift+Delete) tuşlarına basarak önbellek temizleme penceresini açın. “Önbelleğe alınmış resimler ve dosyalar” seçeneğini işaretleyip temizleyin.
• Gizli Pencerede Deneyin: Gizli mod (Incognito) açarak WordPress yönetim panelinize giriş yapın. Eğer hata gizli modda görünmüyorsa, sorun kesinlikle tarayıcı önbelleğindedir.
• Farklı Tarayıcı Kullanın: Chrome’da sorun varsa Firefox veya Edge’de deneyin. Bu sayede sorunun tarayıcıya mı yoksa WordPress’e mi ait olduğunu anlayabilirsiniz.
• Sayfayı Yeniden Yükleyin: Ctrl+F5 (Mac’te Cmd+Shift+R) ile sayfayı zorla yenileyin. Bu işlem, önbelleği atlayarak sayfayı sıfırdan yükler.

2. Cache ve Optimizasyon Eklentileri Yönetimi

WP Rocket, W3 Total Cache, Autoptimize gibi önbellek ve optimizasyon eklentileri performansı artırırken, bazen JavaScript dosyalarını birleştirip sıkıştırarak Gutenberg’in bozulmasına neden olabilir. Bu tür eklentiler kullanıyorsanız, özel ayarlamalar yapmanız gerekebilir.

• WP Önbelleğini temizleyin– WordPress kontrol paneline giriş yapın ve kullandığınız önbellek eklentisine bağlı olarak, sitenizin tüm önbelleğini temizleyin. Genellikle WP panelin üst kısmında eklentinize ait “Tüm Önbelleği Sil” gibi bir kısa yol olur. Web sitenizin önbelleğini temizlemek için buna tıklamanız yeterlidir.
• JavaScript Optimizasyonunu Devre Dışı Bırakın- Cache eklentinizin ayarlarına gidin ve “JavaScript birleştirme” veya “JavaScript minify” seçeneklerini kapatın. Gutenberg, optimize edilmemiş JavaScript dosyalarıyla daha iyi çalışır.
• WordPress Admin’i Önbellekten Hariç Tutun– Yönetim panelinin (wp-admin) hiçbir zaman önbelleğe alınmaması gerekir. Cache eklentinizde “wp-admin” dizinini hariç tuttuğunuzdan emin olun.
• Lazy Load’u Düzenleyicide Kapatın– Bazı optimizasyon eklentileri düzenleyici içinde de lazy loading uygular. Bu, blokların düzgün yüklenmesini engelleyebilir.
• 📌 Her cache eklentisinin ayarları farklıdır. Değişiklik yaptıktan sonra mutlaka önbelleği tamamen temizleyin ve düzenleyiciyi test edin. Eğer sorun devam ederse, cache eklentisini geçici olarak devre dışı bırakıp test edin.

3. CDN Önbelleğini Temizleyin

Cloudflare veya başka bir CDN kullanıyorsanız buralardan da önbelleği temizlemelisiniz. Aşağıda, Cloudflare’den önbelleğin nasıl silineceğini kısaca anlatacağız, ancak başka bir CDN hizmeti kullanıyorsanız, Google’da kendi CDN’niniz için bu işlemin nasıl yapılacağını aratıp gerekli adımları izleyin. Herhangi bir CDN kullanmıyorsanız bu adımı atlayın.

• Öncelikle Cloudflare hesabınıza giriş yapın ve web sitenizi seçin.
• Şimdi Önbelleğe Alma seçeneğine (Caching) gidin ve Her Şeyi Temizle’ye tıklayın.

4. Eklenti Çakışmasını Tespit Etme ve Çözme

WordPress’te yüklü onlarca eklenti varsa ve bunlardan biri Gutenberg’le uyumsuzsa, düzenleyici hata verir. Ancak hangi eklentinin çakışma yarattığını bulmak için tüm eklentileri tek tek test etmeniz gerekir.

• Eklentileri devre dışı bırakın:
  • WordPress yönetim paneline giriş yapın. Eklentiler → Yüklü Eklentiler sayfasına gidin. Tüm eklentileri seçip toplu olarak “Devre Dışı Bırak” seçeneğini kullanın. Düzenleyiciyi test edin. Hata gittiyse sorun eklentilerdedir. Eklentileri tek tek aktif hale getirerek hangisinin soruna yol açtığını bulun.
  • Panele Erişemiyorsanız FTP/cPanel: FTP programı veya cPanel Dosya Yöneticisi ile sitenize bağlanın. /wp-content/plugins/ klasörüne gidin. “plugins” klasörünün adını “plugins_devre_dışı” olarak değiştirin. WordPress tüm eklentileri otomatik olarak devre dışı bırakır. Yönetim paneline tekrar giriş yapabilir ve eklentileri yeniden aktif edebilirsiniz.
• Sorunlu eklentiyi bulduktan sonra yapmanız gerekenler:
  • Eklentiyi Güncelleyin: Genellikle eski sürümler sorun yaratır. Güncel sürüme geçerek sorunu çözebilirsiniz.
  • Alternatif Arayın: Eğer eklenti artık geliştirilmiyorsa veya güncelleme sorunu çözmüyorsa, benzer işlevi gören başka bir eklenti bulun.
  • Geliştiriciye Bildirin– Eklentinin destek forumunda sorunu bildirin. Çoğu geliştirici hızlıca çözüm üretir.

5. Tema Kaynaklı Sorunları Çözme

Eklentiler masum çıktıysa, suçlu temanız olabilir. Özellikle özel yapım veya uzun süredir güncellenmemiş temalar, Gutenberg ile uyumsuzluk gösterebilir. Tema kaynaklı sorunları test etmek, eklentilere göre biraz daha hassas bir işlemdir çünkü temayı değiştirdiğinizde sitenizin görünümü değişir.

• Varsayılan Temaya Geçin– Görünüm → Temalar bölümünden WordPress’in varsayılan temalarından birini (Twenty Twenty-Four gibi) etkinleştirin. Bu temalar Gutenberg ile tam uyumludur.
• Düzenleyiciyi Test Edin– Varsayılan temadayken düzenleyiciyi açın ve hata alıp almadığınızı kontrol edin. Hata gittiyse, sorun kesinlikle temanızdaydı.
• Tema Güncellemesi veya Destek– Eski temanıza geri dönmeden önce, tema geliştiricisinden güncelleme olup olmadığını kontrol edin veya destek ekibiyle iletişime geçin.

📌 Eğer temanız premium bir temaysa ve sürekli güncelleme alıyorsa, muhtemelen zaten bir yaması vardır. Tema geliştiricileri, kullanıcılardan gelen hata raporlarına genellikle hızlıca yanıt verirler. Ancak tema artık desteklenmiyorsa, maalesef yeni bir temaya geçmeyi düşünmeniz gerekebilir.

6. WordPress ve PHP Sürüm Uyumluluğu

Bazen sorun ne eklentilerde ne de temadadır, sorun altyapıdadır. WordPress sürekli güncellenir ve her yeni sürüm daha yüksek PHP versiyonları gerektirir. Eğer hosting sağlayıcınız eski bir PHP sürümü kullanıyorsa, Gutenberg düzgün çalışmayabilir ve Düzenleyici beklenmeyen bir hatayla karşılaştı’ sorunu oluşabilir.

• WordPress Sürümünüzü Kontrol Edin– Gösterge Tablosu → Güncellemeler bölümünden WordPress sürümünüzü kontrol edin. En güncel sürümü kullandığınızdan emin olun.
• PHP Sürümünü Öğrenin– Araçlar → Site Sağlığı → Bilgi sekmesine giderek “Sunucu” başlığı altında PHP sürümünüzü görebilirsiniz. WordPress en az PHP 7.4 önerir, ancak ideal olan PHP 8.0 veya üzeridir.
• PHP Sürümünü Yükseltin– Hosting kontrol panelinize (cPanel, Plesk vb.) giriş yapın ve PHP sürümünü en güncel kararlı sürüme yükseltin. Çoğu hosting firması bu işlemi tek tıkla yapmanıza olanak tanır.
• Uyumluluk Testi Yapın– PHP Compatibility Checker gibi bir eklenti yükleyerek, mevcut eklenti ve temalarınızın yeni PHP sürümüyle uyumlu olup olmadığını test edin.

PHP Sürümü	WordPress Uyumluluğu	Güvenlik Durumu
PHP 7.4	✅ Uyumlu	⚠️ Destek Sona Erdi
PHP 8.0	✅ Uyumlu	✅ Güvenli
PHP 8.1	✅ Uyumlu	✅ Güvenli
PHP 8.2	✅ Uyumlu (Önerilen)	✅ Güvenli

📌 PHP güncellemesi yaparken dikkatli olun. Bazı eski eklentiler yeni PHP sürümleriyle çalışmayabilir. Bu yüzden işlemi yapmadan önce tam yedek almayı unutmayın.

7. Bellek Limiti Artırma ve Sunucu Ayarları

WordPress düzenleyicisi, özellikle medya yüklü sayfalar için epey bellek tüketir. Eğer sunucunuzun PHP bellek limiti düşükse, düzenleyici yeterli kaynağı bulamaz ve hata verir. Neyse ki bu sorunu çözmek için birkaç farklı yöntem var.

• wp-config.php Dosyası ile Bellek Artırma– FTP veya cPanel üzerinden sitenizin kök dizinindeki wp-config.php dosyasını bulun. Dosyayı açın ve “/* Bu satırdan sonra düzenlemeyi bırakın. Mutlu blog yazarlığı. */” satırının hemen üzerine şu kodu ekleyin:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

• .htaccess Dosyası ile PHP Bellek Limiti Artırma– Eğer yukarıdaki yöntem işe yaramazsa, .htaccess dosyanıza şu satırı ekleyin:

php_value memory_limit 256M

• php.ini Dosyası Üzerinden Ayarlama– Eğer hosting’inizde php.ini dosyasına erişiminiz varsa (veya bu dosyayı oluşturabiliyorsanız), şu satırı ekleyin:

memory_limit = 256M
max_execution_time = 300

📌 Bazı paylaşımlı hosting hizmetleri bellek limitini kısıtlar. Eğer yukarıdaki yöntemlerle limit artmıyorsa, hosting desteğinizle iletişime geçerek limiti artırmalarını talep edin.

8. JavaScript Hatalarını Tespit ve Düzeltme

Gutenberg temelde bir JavaScript uygulamasıdır. Eğer tarayıcınızda bir JavaScript hatası oluşuyorsa, düzenleyici çalışmayı durdurur ve “beklenmeyen hata” mesajı görürsünüz. Bu hataları tespit etmek ve çözmek için tarayıcı geliştirici araçlarını kullanmanız gerekir.

• Chrome’da F12 veya Ctrl+Shift+I (Mac’te Cmd+Option+I) tuşlarına basarak geliştirici araçlarını açın. “Console” sekmesine tıklayın.
• Kırmızı renkli hatalar JavaScript sorunlarını gösterir. Hatanın hangi dosyadan kaynaklandığına dikkat edin — bu genellikle bir eklenti veya tema dosyasıdır.
• Hatanın kaynağını bulduğunuzda (ör. bir eklenti), o eklentiyi devre dışı bırakın veya geliştiriciye bildirin.
• Sık Karşılaşılan JavaScript Hataları:
  • jQuery is not defined: Tema veya eklenti jQuery’yi yanlış yüklüyor
  • Uncaught TypeError: Bir fonksiyon veya değişken tanımsız
  • Failed to load resource: Bir dosya yüklenemedi (genellikle CDN sorunu)
  • CORS policy: Harici kaynaklardan veri çekilemedi

📌 Çoğu JavaScript hatası, tema veya eklentilerin kendi JavaScript dosyalarını WordPress’in standart yükleme sırasına uymadan eklemesinden kaynaklanır. Bu yüzden kaliteli, düzenli güncellenen eklentiler kullanmaya dikkat edin.

9. Son Çare: Klasik Düzenleyiciye Geçiş ve Destek

Yukarıdaki tüm çözümleri denediyseniz ve hâlâ sorun devam ediyorsa, iki seçeneğiniz var: Klasik Düzenleyici’ye geçmek veya profesyonel destek almak.

• Klasik Düzenleyici Eklentisi– WordPress’in eski düzenleyicisine geri dönmek istiyorsanız, “Classic Editor” eklentisini yükleyebilirsiniz. Bu eklenti, Gutenberg’i tamamen devre dışı bırakır ve klasik editörü açar. Ancak bu geçici çözümdür.
  • Eklentiler → Yeni Ekle bölümünden “Classic Editor” araması yapın.
  • Eklentiyi yükleyip etkinleştirin. Artık tüm içeriklerinizi klasik düzenleyicide açabilirsiniz.
• Profesyonel Destek– Eğer teknik bilginiz yoksa veya sorunu çözemiyorsanız, profesyonel yardım almanın tam zamanı:
  • Hosting Desteği: İlk başvuracağınız yer. Çoğu hosting firması WordPress sorunlarında yardımcı olur.
  • WordPress.org Forumları: Ücretsiz topluluk desteği. Sorununuzu detaylı anlatın.
  • Tema/Eklenti Geliştiricileri: Sorun belirli bir ürünle ilgiliyse doğrudan geliştiriciye ulaşın.
  • Freelance WordPress Uzmanları: Acil durumlar için ücretli destek alabilirsiniz.