WordPress Eklenti Güncellemesi Sonrası Site Bozuldu: Güvenli Geri Dönüş ve Sorun Tespit Rehberi

WordPress eklenti güncellemesi sonrası site bozuldu ve sayfalar açılmıyor, beyaz ekran gösteriyor ya da bazı işlevler çalışmıyorsa ilk adım rastgele dosya silmek değildir. Önce sorunun yalnızca eklentiden mi, tema veya PHP sürümüyle oluşan bir uyumsuzluktan mı kaynaklandığını ayırmak gerekir. Aşağıdaki yöntemler, mevcut dosyaları koruyarak kontrollü biçimde teşhis yapmanıza yardımcı olur.

Önce sorunun kapsamını belirleyin

Siteyi farklı bir tarayıcıda ve mümkünse mobil bağlantı üzerinden açın. Yalnızca yönetim paneli çalışmıyorsa giriş ekranını, ana sayfa açılmıyorsa ziyaretçi tarafını ayrı değerlendirin. Hata sadece belirli bir sayfada görülüyorsa ilgili eklentinin kısa kodu, bileşeni veya kullandığı tema şablonu etkilenmiş olabilir.

Güncellemeden hemen önce alınmış bir hosting yedeğiniz varsa silmeden saklayın. Canlı sitede tekrar tekrar güncelleme, eklenti değiştirme veya veritabanı temizleme işlemi yapmak teşhisi zorlaştırabilir.

WordPress eklenti güncellemesi sonrası site bozuldu: yönetim paneli açılıyorsa

Yönetim paneline girebiliyorsanız Eklentiler bölümünden son güncellenen eklentiyi etkisizleştirin. Site düzelirse sorun büyük olasılıkla güncelleme ile tema, başka bir eklenti veya sunucu ortamı arasındaki uyumsuzluktur.

• Eklentiyi yeniden etkinleştirmeden önce tema ve diğer eklentileri güncel sürümleriyle karşılaştırın.
• Güncelleme notlarında belirtilen minimum WordPress ve PHP sürümünü kontrol edin.
• Sorun yalnızca bir özellikteyse eklentinin ayarlarını sıfırlamak yerine önce dışa aktarma veya yedek alma seçeneğini araştırın.
• Önbellek katmanlarını temizleyin; ancak önbellek temizliğinin PHP kaynaklı kritik hatayı tek başına düzeltmeyeceğini unutmayın.

Eklentiyi devre dışı bırakmak sorunu çözüyor fakat işlev kaybı yaratıyorsa aynı işi yapan yeni bir eklenti kurmadan önce mevcut eklentinin uyumlu sürümünü veya geliştiricinin düzeltme duyurusunu kontrol edin.

Yönetim paneli açılmıyorsa FTP ile eklentiyi kapatın

Panel erişilemiyorsa hosting dosya yöneticisi, FTP veya SFTP üzerinden wp-content/plugins klasörünü açın. Şüpheli eklentinin klasör adını geçici olarak değiştirin. Örneğin klasör adının sonuna -pasif eklemek, WordPress’in eklentiyi yükleyememesini sağlar.

Bu işlemden sonra site açılırsa eklenti kaynaklı bir yükleme hatası olma ihtimali güçlenir. Klasör adını eski haline getirip panelden eklentiyi kalıcı olarak etkisizleştirebilir veya yedeğinizdeki önceki sürümü kontrollü şekilde geri yükleyebilirsiniz. Dosya silmek yerine yeniden adlandırma kullanmak, geri dönüşü kolaylaştırır.

Birden fazla eklenti aynı anda güncellendiyse tüm eklenti klasörünün adını geçici olarak değiştirmek, sorunun genel olarak eklentilerden kaynaklanıp kaynaklanmadığını anlamaya yarar. Site açılırsa klasör adını düzeltin ve eklentileri tek tek etkinleştirerek suçlu bileşeni belirleyin.

Hata kaydını etkinleştirerek nedeni görünür hâle getirin

Beyaz ekran, çoğu zaman ziyaretçiye ayrıntı göstermeyen bir PHP hatasının sonucudur. WordPress’in resmi hata ayıklama dokümantasyonunda açıklanan yönteme göre wp-config.php dosyasında hata kaydı etkinleştirilebilir.

Canlı sitede hatayı ziyaretçiye göstermek yerine kayıt almak daha güvenlidir. Temel ayarlar şu şekilde yapılabilir:

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );

Değerler dosyada zaten varsa ikinci kez eklemeyin; mevcut satırları düzenleyin. Ardından oluşan wp-content/debug.log dosyasını kontrol edin. Eklenti adı, dosya yolu, sınıf adı veya PHP sürümüyle ilgili ifade görürseniz teşhis için önemli bir ipucu elde edersiniz.

İnceleme tamamlandıktan sonra hata ayıklamayı canlı sitede açık bırakmayın. Özellikle hata mesajları sunucu yolları veya yapılandırma bilgileri içerebilir.

Uyumsuzluğu doğrulamak için kontrollü test yapın

Eklentiyi kapatmanıza rağmen sorun devam ediyorsa tema ve diğer eklentilerle çakışma ihtimalini test edin. Mümkünse staging ortamı kullanın. Böyle bir ortam yoksa yoğun olmayan bir zamanda yedek alarak varsayılan bir WordPress temasıyla kısa bir test yapabilirsiniz.

• Varsayılan temada sorun kayboluyorsa tema ile eklenti arasında uyumsuzluk olabilir.
• Yalnızca başka bir eklenti etkinleştiğinde hata oluşuyorsa iki bileşenin çakışmasını inceleyin.
• PHP sürümü değişikliğinden sonra başladıysa hosting sağlayıcısının hata kayıtlarını ve eklentinin gereksinimlerini kontrol edin.

Sunucu yanıt süresiyle ilgili ek bir yavaşlama da varsa bunu doğrudan eklenti hatası kabul etmeyin; WordPress TTFB ölçümü ile uygulama ve sunucu kaynaklı gecikmeyi ayrı inceleyebilirsiniz.

Önceki eklenti sürümüne güvenli dönüş

Güncellemeden önceki sürümle uyumlu bir yedek veya geliştiricinin resmi sürüm arşivi varsa geri dönüş yapılabilir. Ancak yalnızca eklenti dosyalarını değiştirmek bazı sürümlerde veritabanı değişikliklerini geri almaz. Bu nedenle sürüm düşürmeden önce hem dosyaları hem veritabanını yedekleyin.

Geri dönüş sonrasında otomatik güncellemeyi geçici olarak durdurup geliştiricinin düzeltme sürümünü beklemek daha güvenlidir. Eski sürümü uzun süre kullanmak güvenlik güncellemelerini kaçırmanıza neden olabileceğinden sorunu kalıcı çözüm olarak görmeyin.

Sorun çözüldükten sonra yapılacak kontroller

Eklenti yeniden etkinleştirildikten sonra ana sayfa, iletişim formları, giriş işlemi, ödeme adımları ve kritik yönetim ekranlarını test edin. Önbelleği temizleyip farklı bir kullanıcı oturumuyla da kontrol yapın. Hata kaydını kapattığınızdan ve geçici klasör adlarını eski hâline getirdiğinizden emin olun.

Bir sonraki güncellemede aynı riski azaltmak için staging ortamında test yapın, düzenli yedekleri farklı bir konumda saklayın ve eklentileri toplu yerine tek tek güncelleyin. Böylece WordPress eklenti güncellemesi sonrası site bozuldu durumunda hangi değişikliğin soruna yol açtığını daha kolay belirlersiniz.