WordPress Eklenti Cakismasi Nasil Tespit ve Cozulur

WordPress'in en güçlü yanı esnekliğidir: birkaç tıklamayla eklenti kurar, temanızı değiştirir, siteye yeni yetenekler eklersiniz. Ama bu esnekliğin bir bedeli vardır. Farklı geliştiriciler tarafından, farklı kalite standartlarıyla yazılmış onlarca parça aynı anda aynı sayfada çalışmaya başlayınca er ya da geç bir yerde ikisi birbirinin ayağına basar. İşte bu ana biz "eklenti çakışması" diyoruz ve bir gün mutlaka karşınıza çıkar. Bazen tüm siteyi bembeyaz bir ekrana çevirir, bazen sadece yönetim panelindeki bir butonu çalışmaz hale getirir, bazen de sepet toplamını yanlış hesaplatır.

İyi haber şu: eklenti çakışmaları göründükleri kadar korkutucu değildir ve çözümleri neredeyse her zaman aynı mantığa dayanır. Panik yapıp rastgele eklenti silmek yerine sistematik bir eleme yöntemi uygularsanız, sorunlu bileşeni yarım saat içinde tek tek yalıtarak bulabilirsiniz. Bu rehberde bir sistem yöneticisinin masasında oturuyormuş gibi, belirtileri okumaktan başlayıp WP_DEBUG günlüğüyle kök nedeni doğrulamaya kadar tüm süreci adım adım göstereceğim. Yöntem hem paylaşımlı hosting'de cPanel dosya yöneticisiyle hem de SSH erişiminiz varsa komut satırıyla çalışır.

Cakisma Belirtilerini Dogru Okumak#

Bir çakışmayı çözmenin ilk adımı, aslında bir çakışmayla mı yoksa başka bir sorunla mı uğraştığınızı anlamaktır. Çünkü aynı belirti bazen sunucu kaynağının bitmesinden, bazen bozuk bir güncellemeden, bazen de gerçek bir kod çakışmasından kaynaklanır. Belirtiyi doğru okumak, hangi yolu izleyeceğinizi belirler.

En sık karşılaşılan tablo Beyaz Ölüm Ekranı (WSOD - White Screen of Death) denilen durumdur: site açılır ama içerik yerine bomboş beyaz bir sayfa gelir, çoğu zaman hiçbir hata mesajı bile yoktur. Bunun nedeni genellikle bir PHP fatal error'dur; iki eklentinin aynı isimde fonksiyon tanımlaması ya da olmayan bir fonksiyonu çağırması gibi. İkinci sık tablo, sitenin açılması ama düzeninin bozulması: kaymış sütunlar, çalışmayan "Ekle", "Kaydet" veya "Ödeme" butonları, açılmayan menüler. Bu tür görsel/etkileşim hataları neredeyse her zaman bir JavaScript çakışmasıdır; iki eklentinin farklı jQuery sürümü yüklemesi ya da aynı script'i iki kez çağırması gibi.

Belirtiyi sınıflandırmak için şu basit tabloyu kullanabilirsiniz:

Tarayıcı konsolunu okumayı öğrenmek burada altın değerindedir. Chrome veya Firefox'ta F12 tuşuna basıp Console sekmesine geçin. Kırmızı renkli Uncaught TypeError: $ is not a function ya da jQuery is not defined gibi bir satır görüyorsanız, elinizde net bir JavaScript çakışması var demektir ve hangi dosyada patladığını da genelde satırın sağında görürsünüz.

Guvenli Baslangic Yedek Alin#

Sorun gidermeye başlamadan önce yapılacak tek bir şart var: yedek. Eleme yöntemi eklentileri kapatıp açmayı içerir ve nadiren de olsa bir eklentiyi devre dışı bırakmak veritabanında istenmeyen bir yan etki bırakabilir. Elinizde geri dönebileceğiniz bir kopya olması, deneme yaparken rahat olmanızı sağlar.

SSH erişiminiz varsa hem dosyaların hem de veritabanının hızlı bir kopyasını almak birkaç saniye sürer:

# Site dosyalarini sikistir
cd /home/kullanici/public_html
tar -czf ~/yedek-site-$(date +%F).tar.gz .

# Veritabanini disari al
mysqldump -u db_kullanici -p db_adi > ~/yedek-db-$(date +%F).sql

SSH'nız yoksa endişelenmeyin; cPanel'in "Yedekle" bölümünden tam yedek indirebilir veya bir yedekleme eklentisi kullanabilirsiniz. Clou.TR paketlerinde otomatik yedekler zaten tutulur, yine de manuel bir kopya işi garantiye alır. Yedekleme stratejinizi düzenli hale getirmek istiyorsanız /yedekleme sayfasındaki seçenekler işinizi kolaylaştırır. Yedeğinizi aldıktan sonra rahat bir nefes alıp elemeye başlayabilirsiniz.

Klasik Yontem Tumunu Kapat Teker Teker Ac#

Eklenti çakışmasını bulmanın en güvenilir ve en eski yöntemi budur: tüm eklentileri devre dışı bırakırsınız, sorun kaybolur mu diye bakarsınız, kaybolduysa eklentileri tek tek yeniden açarak sorunu geri getiren bileşeni yakalarsınız. Mantık çok basit; sorun onlarca eklentiden birinde saklıysa, hepsini kapatıp birer birer açtığınızda hata tam olarak suçlu eklentiyi açtığınız anda geri gelir.

Yönetim paneline (wp-admin) girebiliyorsanız işlem çok kolaydır. Eklentiler ekranında tüm eklentileri seçin, üstteki toplu işlem menüsünden "Devre dışı bırak" deyin. Sitenizi kontrol edin: sorun gitti mi? Gittiyse eklentileri listenin başından itibaren tek tek etkinleştirin ve her etkinleştirmeden sonra sorunlu sayfayı yenileyin. Hata hangi eklentiyi açar açmaz geri geldiyse, suçlunuz odur.

Asıl zor durum, WSOD yüzünden wp-admin'e hiç giremiyorsanız ortaya çıkar. Bu durumda eklentileri panel üzerinden kapatamazsınız ama dosya sistemi üzerinden aynı sonucu elde edebilirsiniz. WordPress, wp-content/plugins klasörünün adını bulamazsa tüm eklentileri otomatik olarak devre dışı sayar. FTP veya cPanel Dosya Yöneticisi'yle klasörü yeniden adlandırmak yeter:

cd wp-content
# Tum eklentileri tek hamlede devre disi birak
mv plugins plugins_kapali

Bu komuttan sonra siteniz açıldıysa, çakışma kesinlikle eklentilerin birinden geliyor demektir. Şimdi klasörü eski adına geri döndürün (mv plugins_kapali plugins) ve bu kez plugins klasörünün içindeki eklenti klasörlerini teker teker geçici bir isimle değiştirerek hangisinin sorunlu olduğunu bulun:

cd wp-content/plugins
# Suphelendiginiz eklentiyi tek basina devre disi birak
mv woocommerce-eklentisi woocommerce-eklentisi.off
# Site duzeldiyse suclu buydu; duzelmediyse geri al ve bir sonrakine gec
mv woocommerce-eklentisi.off woocommerce-eklentisi

Her adımda sadece bir klasörü kapatıp siteyi kontrol edin. Bu yavaş görünen yöntem, en karmaşık çakışmayı bile matematiksel kesinlikle bulur; çünkü değişkeni tek tek yalıtırsınız. WordPress'te oluşan genel hata türleri ve mesajları hakkında daha geniş bir bakış için WordPress hata çözümü rehberimize da göz atabilirsiniz.

Temayi Suphe Listesinden Cikarmak#

Çakışmayı hep eklentilerde ararız ama temalar da en az onlar kadar sık suçludur. Bir tema, sayfa oluşturucularla, çeviri eklentileriyle veya WooCommerce ile uyumsuz olabilir; kendi functions.php dosyasında hatalı bir kod barındırabilir. Bu yüzden tüm eklentileri kapatmak sorunu çözmediyse, bir sonraki adım temayı denklemden çıkarmaktır.

En temiz test, geçici olarak WordPress'in varsayılan temasına (örneğin Twenty Twenty-Four veya Twenty Twenty-Five) geçmektir. Bu temalar WordPress ekibi tarafından bakılan, bilinen temiz kod tabanlarıdır; onlara geçince sorun kaybolursa suçlu sizin temanızdır. wp-admin'e girebiliyorsanız Görünüm > Temalar ekranından varsayılan temayı etkinleştirmeniz yeterli.

Panele giremiyorsanız temayı da dosya sistemi üzerinden değiştirebilirsiniz. WordPress, aktif temanın klasörünü bulamazsa otomatik olarak elindeki varsayılan temaya döner. Aktif tema klasörünü geçici olarak yeniden adlandırmanız yeter:

cd wp-content/themes
# Aktif temayi gecici olarak devre disi birak
mv benim-temam benim-temam_kapali
# Bir varsayilan tema kurulu degilse WP-CLI ile hizlica kurun
wp theme install twentytwentyfive --activate

Şu ayrımı unutmayın: temanızı doğrudan düzenlediyseniz (özellikle functions.php içine kod eklediyseniz), bu değişiklikler tema güncellenince kaybolur ve bazen bu kayıp bir çakışmayı tetikler. Bu yüzden özelleştirmeleri her zaman bir alt tema (child theme) içinde yapmak, hem güncelleme güvenliği hem de sorun gidermede işinizi kolaylaştırır. Tema ve eklenti seçiminde temiz, bakımlı seçenekleri tercih etmek çakışma ihtimalini baştan düşürür; hangi eklentilerin güvenilir olduğu konusunda WordPress eklenti önerileri yazımız yol gösterici olabilir.

Health Check Eklentisiyle Izole Test#

Yukarıdaki elle kapat-aç yönteminin bir sıkıntısı var: siz eklentileri kapattığınızda canlı sitenizin ziyaretçileri de o özellikleri kaybeder. Yoğun bir e-ticaret sitesinde WooCommerce'i on dakika kapatmak istemezsiniz. İşte tam bu noktada WordPress'in resmi Health Check & Troubleshooting eklentisi devreye girer ve işi zarif hale getirir.

Bu eklentinin "Troubleshooting Mode" (Sorun Giderme Modu) özelliği harika bir numara yapar: eklentileri ve temayı yalnızca sizin oturumunuz için devre dışı bırakır. Yani siz temiz bir kurulumda test yaparken, siteye giren diğer ziyaretçiler her şeyi normal görmeye devam eder. Kurulumu ve kullanımı şöyle işler: eklentiyi kurun, Araçlar > Site Sağlığı > Sorun Giderme menüsüne gidin ve modu başlatın. Artık üstteki yönetim çubuğundan tek tek eklentileri kendi oturumunuz için açıp kapatabilir, farklı temalara geçip test edebilirsiniz.

WP-CLI kullanıyorsanız eklentiyi tek satırla kurup etkinleştirebilirsiniz:

# Health Check eklentisini kur ve etkinlestir
wp plugin install health-check --activate

Bu yöntemin klasik yönteme göre avantajlarını görmek için şu karşılaştırma faydalı:

Kısacası panele girebiliyorsanız ve site canlı yayında ise, ilk tercihiniz her zaman Health Check modu olmalı. wp-admin'e hiç giremiyorsanız da dosya sistemi üzerinden yürüyen klasik yöntem tek seçeneğiniz olur.

WP_DEBUG ile Hatanin Kokune Inmek#

Eleme yöntemi size sorunlu eklentinin hangisi olduğunu söyler ama neden çakıştığını söylemez. İşte kök nedeni gözünüzle görmek istediğinizde WordPress'in hata ayıklama günlüğü devreye girer. WP_DEBUG açıkken WordPress, tüm PHP hatalarını, uyarılarını ve tam olarak hangi dosyanın hangi satırında patladığını bir günlük dosyasına yazar. Bu, beyaz ekranın arkasındaki gerçek mesajı görmenin en dürüst yoludur.

Ayarı açmak için sitenizin kök dizinindeki wp-config.php dosyasını açın ve /* That's all, stop editing! */ satırının üstüne şu satırları ekleyin:

// Hatalari ekranda gostermeden dosyaya yaz
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Buradaki ince nokta şu: WP_DEBUG_DISPLAY değerini false yapıyoruz ki hatalar ziyaretçilerin ekranına dökülmesin (bu hem çirkin hem de güvenlik açığıdır); bunun yerine WP_DEBUG_LOG sayesinde hepsi sessizce wp-content/debug.log dosyasına yazılır. Sorunu tekrar tetikleyin, sonra bu günlüğü okuyun. SSH'nız varsa canlı olarak da izleyebilirsiniz:

# Hata gunlugunu canli takip et
tail -f wp-content/debug.log

Günlükte tipik olarak şuna benzer bir satır göreceksiniz ve bu, altın değerinde bir ipucudur:

PHP Fatal error:  Cannot redeclare cloutr_helper() (previously declared in
/wp-content/plugins/eklenti-a/init.php:42) in
/wp-content/plugins/eklenti-b/functions.php:15

Bu tek satır her şeyi anlatır: iki eklenti (eklenti-a ve eklenti-b) aynı isimde bir fonksiyon tanımlamış ve PHP ikincisini görünce çökmüş. Artık suçluyu tahmin etmiyor, doğrudan görüyorsunuz. Sorun çözüldükten sonra bu satırları wp-config.php'den kaldırmayı veya WP_DEBUG değerini false yapmayı unutmayın; hata günlüğünü canlı bir sitede sürekli açık bırakmak hem performansı düşürür hem de dosya boyutunu şişirir.

Cakisma Yasandiginda Kalici Cozum Yollari#

Suçluyu buldunuz; peki şimdi ne yapacaksınız? Sorunlu eklentiyi sonsuza dek kapalı tutmak çoğu zaman doğru cevap değildir, çünkü o eklentiye bir ihtiyacınız olduğu için kurmuştunuz. Kalıcı çözüm, çakışmanın tipine göre değişir ve elinizde birkaç sağlam seçenek vardır.

İlk ve en sık çözüm güncellemedir. Çakışmaların büyük kısmı, iki eklentinin farklı sürümlerinin belli bir anda uyumsuz olmasından doğar ve geliştiriciler bu tür sorunları hızla yamalarlar. Her iki eklentiyi ve WordPress çekirdeğini en güncel sürüme çekmek, sorunu çoğu zaman kendiliğinden çözer. İkinci seçenek alternatif bulmaktır: aynı işi yapan, daha temiz kodlanmış bir eklentiyle değiştirmek. Üçüncüsü, geliştiriciyle iletişime geçip destek talebi açmaktır; ciddi eklentilerin geliştiricileri çakışma raporlarını genellikle ciddiye alır.

Şu karar tablosu hangi durumda ne yapacağınızı özetliyor:

Özellikle önbellek ve optimizasyon eklentileri (dosya birleştirme, JS erteleme özellikleri) sık sık görsel çakışmaların gizli kaynağıdır. Böyle bir eklenti sitenizdeki tüm JavaScript'i birleştirip küçültürken bir başka eklentinin script'ini bozabilir. Çözüm genelde o eklentinin ayarlarından ilgili dosyayı "birleştirme/optimize etme dışında tut" listesine eklemektir; eklentiyi tamamen kapatmak yerine sadece o tek dosyayı istisna yapmak performansı korurken çakışmayı giderir.

Eğer bu süreç size fazla teknik geliyorsa ya da kritik bir siteyi riske atmak istemiyorsanız, işi uzmanına bırakmak da tamamen makul bir seçenektir. Clou.TR'nin WordPress bakım hizmeti tam da bu tür çakışma tespiti, güvenli güncelleme ve düzenli sağlık kontrolü işlerini sizin yerinize üstlenir. Sunucu tarafında yaşanan kaynak veya yapılandırma kaynaklı sorunlar için ise sunucu yönetimi tarafındaki ekip devreye girebilir.

Cakismalari Bastan Onlemenin Yollari#

Çakışmayı çözmek güzeldir ama en iyi çakışma, hiç yaşanmayanıdır. Birkaç basit alışkanlık, ileride saatlerinizi kurtaracak sorunların büyük kısmını daha ortaya çıkmadan engeller. Bunlar hem yeni başlayanların hem de yılların yöneticisinin uyguladığı temel disiplinlerdir.

En önemli kural az ve öz eklenti kullanmaktır. Her eklenti, çakışma yüzeyini büyüten yeni bir kod parçasıdır; gerçekten ihtiyaç duymadığınız eklentileri kurmayın, kurup denedikten sonra kullanmadıklarınızı silin (devre dışı bırakmak yetmez, veritabanı izleri kalabilir). İkinci kural, güncelleme öncesi test yapmaktır. Canlı sitede körlemesine güncelleme yapmak yerine, bir "staging" (deneme) kopyası üzerinde güncellemeleri deneyip her şeyin sorunsuz çalıştığını gördükten sonra canlıya taşımak profesyonel yaklaşımdır. Üçüncüsü, düzenli yedek: bu rehberde en başta söyledik, sonda tekrar edelim; otomatik yedeğiniz varsa en kötü senaryoda bile birkaç dakikada geri dönersiniz.

Bir de altyapı tarafı var. Yavaş ya da kaynağı kısıtlı bir hosting, çakışma gibi görünen ama aslında bellek limitinden kaynaklanan hatalar üretebilir. memory_limit değerinin yeterli olması, çoğu WSOD'yi baştan engeller. Bu değeri wp-config.php üzerinden yükseltebilirsiniz:

// PHP bellek limitini artir
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

Sağlam bir başlangıç için sitenizi WordPress'e göre yapılandırılmış, güncel PHP sürümü sunan ve yeterli kaynak veren bir pakette barındırmak, çakışma çözümünü baştan kolaylaştırır. Clou.TR'nin WordPress hosting paketleri bu tür kaynak ve yapılandırma dertlerini büyük ölçüde ortadan kaldırır; daha genel ihtiyaçlar için web hosting seçeneklerine de göz atabilirsiniz.

Sıkça Sorulan Sorular#

Eklenti çakışması sitemin tamamen çökmesine neden olur mu?#

Evet, olabilir ama bu durumun bile net bir çözümü vardır. Bir PHP fatal error üreten çakışma, sitenin beyaz ekran vererek tamamen erişilmez hale gelmesine yol açabilir. Ancak bu durumda bile FTP veya cPanel Dosya Yöneticisi ile wp-content/plugins klasörünü yeniden adlandırarak tüm eklentileri devre dışı bırakabilir ve siteyi anında geri getirebilirsiniz. Site çöktü diye veriniz silinmez; sadece geçici olarak erişilemez, yedek ve dosya erişimiyle her zaman geri dönülür.

wp-admin paneline hiç giremiyorsam çakışmayı nasıl bulurum?#

Panel erişimini kaybettiyseniz tüm işi dosya sistemi üzerinden yürütürsünüz. FTP ya da cPanel Dosya Yöneticisi ile wp-content/plugins klasörünü plugins_kapali olarak yeniden adlandırın; site açılırsa sorun eklentilerdedir. Sonra klasörü eski adına döndürüp içindeki eklenti klasörlerini teker teker kapatarak suçluyu bulursunuz. Aynı mantık tema için wp-content/themes altında geçerlidir. Panele girmek şart değildir, dosya erişimi tek başına yeterlidir.

Sorun eklentide mi temada mı, nasıl kesin ayırt ederim?#

Bunu ayırmanın en temiz yolu iki aşamalı bir testtir. Önce tüm eklentileri kapatın; sorun devam ediyorsa büyük ihtimalle temadadır, kayboluyorsa eklentilerdendir. Ardından temayı varsayılan bir WordPress temasına (örneğin Twenty Twenty-Five) geçirin; sorun temiz temada kaybolursa kaynağınız kesinlikle kendi temanızdır. Bu iki testi birlikte uyguladığınızda, sorunun eklenti mi tema mı kaynaklı olduğunu tahmine yer bırakmadan belirlersiniz.

WP_DEBUG'ı açık bırakmanın bir zararı var mı?#

Evet, canlı bir sitede kalıcı olarak açık bırakmak sakıncalıdır. Hata ayıklama günlüğü sürekli yazdığı için debug.log dosyası zamanla devasa boyutlara ulaşabilir ve disk alanınızı tüketebilir. Daha önemlisi, WP_DEBUG_DISPLAY değerini yanlışlıkla açık bırakırsanız hata mesajları ziyaretçilere görünür ve bu, sunucu yolları gibi bilgileri sızdıran bir güvenlik riskidir. Sorunu çözer çözmez WP_DEBUG değerini false yapın veya eklediğiniz satırları kaldırın.

Health Check eklentisi çakışmayı otomatik olarak düzeltir mi?#

Hayır, Health Check eklentisi çakışmayı sizin yerinize çözmez; onu bulmanızı kolaylaştıran bir teşhis aracıdır. En değerli özelliği "Sorun Giderme Modu"dur: eklenti ve temaları yalnızca sizin oturumunuz için devre dışı bırakarak, siteyi ziyaretçiler için ayakta tutarken güvenli bir şekilde test yapmanızı sağlar. Yani suçluyu izole etmenizi hızlandırır ama düzeltmeyi (güncelleme, kaldırma, alternatif bulma) yine sizin yapmanız gerekir.

Aynı işi yapan iki eklenti neden çakışır?#

Aynı işlevi gören iki eklenti (örneğin iki farklı önbellek eklentisi ya da iki SEO eklentisi) genellikle aynı WordPress kancalarına, aynı veritabanı alanlarına ve bazen aynı fonksiyon isimlerine dokunmaya çalışır. İkisi de aynı anda aynı kaynağı yönetmeye kalkınca birbirlerinin işini bozar; sonuç ya çökme ya da tutarsız davranış olur. Genel kural nettir: aynı işi yapan iki eklentiyi asla birlikte etkin tutmayın, ihtiyacınıza en uygun olanı seçip diğerini tamamen kaldırın.

Kapanış#

Eklenti çakışması, ilk karşılaştığınızda paniğe kapılmanıza yol açan ama aslında son derece sistematik bir mantıkla çözülen bir sorundur. Belirtiyi doğru okuyun, yedeğinizi alın, eklentileri ve temayı teker teker eleyerek suçluyu yalıtın ve WP_DEBUG günlüğüyle kök nedeni gözünüzle doğrulayın. Bu dört adımı disiplinle uyguladığınızda, en karmaşık çakışmayı bile tahmine dayanmadan, matematiksel kesinlikle çözebilirsiniz. Health Check eklentisi süreci canlı sitede bile güvenli hale getirir, düzenli yedek ise en kötü senaryoda dahi sizi korur.

Bu tür sorunlarla hiç uğraşmadan, hızlı ve stabil bir WordPress deneyimi istiyorsanız işin altyapısını sağlam kurmak en büyük farkı yaratır. Clou.TR'nin WordPress'e özel optimize edilmiş WordPress hosting paketleri, güncel PHP sürümleri ve bol kaynağıyla çakışmaların önemli bir kısmını baştan engeller; sitenizin bakımını tamamen bize devretmek isterseniz WordPress bakım hizmetimiz çakışma tespitinden güvenli güncellemeye kadar her şeyi üstlenir. Verilerinizi güvenceye almak için yedekleme çözümlerimize, kaynak ve yapılandırma konusunda destek için sunucu yönetimi ekibimize göz atabilirsiniz. Sitenizin bir daha beyaz ekran vermemesi için doğru altyapıyla başlayın.