Herhangi Bir WordPress Sorununu Kendi Başınıza Nasıl Hata Ayıklayabilirsiniz?

Hata ayıklama?

Kabul edeceğim, bu en heyecan verici konu gibi görünmüyor, ama beni bir dinleyin…

WordPress sitenizle ilgili sorunları çözebileceğinize dair tam bir güveniniz olsaydı ne olurdu?

Ya sizi doğrudan hatanın kaynağına götürebilecek ve nasıl düzelteceğinizi söyleyebilecek adım adım basit bir kontrol listeniz olsaydı?

İşte bu yazıda tam olarak bunu özetledim.

Profesyonel ipucu: Sitenizde herhangi bir hata oluştuğunda geri dönebilmeniz için bu URL'yi daha sonra kullanmak üzere işaretleyin veya kaydedin.

Hata ayıklama o kadar da zor değil

Son birkaç yılda binlerce WordPress sitesinde hata ayıkladım.

Bazı hatalar yaygın ve diğerleri nadir olmakla birlikte, genellikle sorunu tanımlayıp düzeltmeye yarayan birkaç basit adım vardır. Ayrıca temada veya eklentide gerçek bir bug olmadığı sürece herhangi bir kod yazılmasına gerek yoktur.

Bu kılavuzda, müşterilerin web sitelerini düzeltmelerine yardımcı olmak için kullandığım hata ayıklama sürecini paylaşacağım. Bunu kendi sitelerinizden birinde uyguladıktan sonra gerçek bir WordPress uzmanı gibi hissedeceksiniz.

Yaygın hataları düzeltme

Daha yaygın sorunlardan bazılarının tanımlanması kolaydır ve özel çözümlere sahiptir. Önce bunları ele alacağım ve ardından diğer sorunlar için kullanabileceğiniz daha genel sürece geçeceğim.

Tema ayarlarınız uygulanmıyor mu?

Bir eklenti veya tema ayarını değiştirdiyseniz ve sitenizde herhangi bir değişiklik görmüyorsanız, bunun nedeni neredeyse her zaman önbelleğe almadır. Çoğu önbelleğe alma eklentisi, Özelleştiriciyi görüntülerken devre dışı bırakılır, bu nedenle değişikliklerinizi orada görmek, ancak güncellemelerinizi kaydettikten sonra bile sitede yayınlanmaması yaygındır.

WP Rocket, WP Super Cache veya W3 Total Cache gibi bir eklentiniz varsa, bu eklentiler sitenizin dosyalarını önbelleğe alarak daha hızlı yüklenmelerini sağlar. Önbelleğe alma nedeniyle, ziyaretçilere az önce yaptığınız değişiklikleri içeren yeni dosyalar yerine dosyaların önbelleğe alınmış (eski) sürümleri gönderilecektir.

Basit çözüm, önbelleği boşaltmak. Hangi önbellek eklentisini kullanırsanız kullanın, önbelleği boşaltmak için kontrol panelinde bir yerde tıklayabileceğiniz bir düğme olmalıdır.

Bazı önbelleğe alma çözümleri birkaç dakika sürebilir, bu nedenle biraz beklemeniz gerekebilir. Ardından sitenizi ziyaret edin ve tarayıcınızın önbelleğini de temizlemek için cmd+shift+r (ctrl+shift+r) ile tam bir yenileme yapın.

CSS'niz uygulanmıyor mu?

Sitenize yeni CSS eklediyseniz ve değişiklikleriniz geçerli değilse, sitenizin önbelleğini boşaltarak başlayın. Bu işe yaramazsa, muhtemelen CSS'nizi daha "özgül" hale getirmeniz gerekir.

Daha baskın CSS seçicilerini nasıl yazabileceğinizi öğrenmek için CSS özgüllük yönergelerine ilişkin bu genel bakışa göz atın. CSS'nizin yeterince spesifik olup olmadığını kontrol etmek için hızlı bir test olarak şunun gibi bir !important etiketi eklemeyi deneyin:

 .selektör { 
  arka plan: mavi !önemli; 
}

Bu işe yaramazsa, muhtemelen CSS kodunda bir sözdizimi hatası vardır. Eşit sayıda sol ve sağ kaşlı ayraç olup olmadığını kontrol etmek için tarayıcınızdaki veya kod düzenleyicinizdeki bulucuyu kullanın. Ardından eksik noktalı virgülleri kontrol edin ve son olarak sınıf seçicilerinden önce eksik dönemleri kontrol edin.

Bir sözdizimi hatanız varsa, sözdizimi hatasından önceki tüm CSS'ler çalışır ve sonrasında hiçbiri çalışmaz.

404 hatası mı alıyorsunuz?

Bazı temalar ve eklentiler, özel gönderi türleri ekler veya htaccess dosyanızı etkileyebilecek başka değişiklikler yapar. Bu eklentilerden birini devre dışı bırakırken veya temalar arasında geçiş yaparken, kategori sayfalarında veya özel gönderi türlerinde 404 hatayla karşılaşabilirsiniz.

Bunun gibi rastgele 404 hatanız varsa, Kalıcı Bağlantılar ayarları sayfasını ziyaret edin (Ayarlar > Kalıcı Bağlantılar).

Özel bir kalıcı bağlantı yapısı girdiyseniz, Gönderi adı seçeneği gibi önceden tanımlanmış bir yapıya geçmeyi deneyin ve ayarlarınızı kaydedin.

Kalıcı bağlantı ayarlarınızı değiştirmeseniz bile kaydedin!

Kalıcı bağlantı ayarlarını kaydettiğinizde, WordPress aslında htaccess dosyasının yeni bir kopyasını yeniden oluşturur. Bu genellikle karşılaşabileceğiniz hileli 404 hatalarını düzeltir.

Temanızı güncelledikten sonra hata ortaya çıktı mı?

Niyetim her zaman temalarımızı geliştirmek olsa da, bazen tema güncellemeleriyle yeni hatalar ortaya çıkıyor.

Bir temayı güncelledikten sonra sitenizde yeni bir hata fark ederseniz, önceki bir sürüme geri dönmenin kolay bir yolu vardır (bu, eklentiler için de geçerlidir).

WP Rollback eklentisini kurun ve etkinleştirin; kullandığınız temanın son sürümüne geri dönebileceksiniz.

Bu eklenti hakkında sevmediğim tek şey, geri alma seçeneğinin bulunmasının zor olmasıdır. Görünüm menüsünü ziyaret edin ve sağ alttaki Geri Al düğmesini bulmak için etkin temaya tıklayın.

“Geri Al”ı tıkladıktan sonra, temanın şimdiye kadar yayınlanmış her sürümünü içeren bir sayfaya yönlendirileceksiniz.

Ardından istediğiniz sürümü seçebilir ve işlemi tamamlamak için alttaki Geri Al düğmesine tıklayabilirsiniz. Geri alma güncellemesi, normal bir tema güncellemesi gibi çalışır.

En son hangi sürümü kullandığınızı hatırlamıyorsanız, birkaç sürümü geri almayı deneyebilirsiniz. Destek Merkezini ziyaret ederseniz, her güncellemenin yayınlandığı tarih de dahil olmak üzere tüm temalarımız için değişiklik günlüklerini bulabilirsiniz.

Daha eski bir sürüme dönmek hatayı düzeltirse, temadaki hata hakkında destek ekibiyle iletişime geçebilirsiniz. Eğer yardımcı olmazsa, hatanın tema tarafından ortaya çıkmadığını biliyorsunuzdur ve bu, neredeyse kesinlikle sitedeki bir eklentiden geldiği anlamına gelir.

Lütfen WP Geri Alma işleminin yalnızca wordpress.org'da bulunan ücretsiz temalar (ve eklentiler) için çalıştığını unutmayın.

"Ölümün beyaz perdesini" görüyor musunuz?

İşte ortak bir senaryo:

Birdenbire tüm site beyaza döndüğünde ve yönetici menüsüne bile erişemediğinizde temanızda bir PHP dosyası düzenliyorsunuz. Bu PHP'de "önemli bir hata" olarak bilinir.

Büyük olasılıkla, bir yerde eksik veya fazladan bir karakter var. Tüm siteyi çökertmek için bir PHP dosyasına ait olmayan rastgele bir nokta veya harf yeterlidir. PHP dosyalarını düzenlerken dikkatli olun!

Bunu nasıl düzelteceğiniz aşağıda açıklanmıştır:

İlk olarak, düzenlediğiniz temanın yeni bir kopyasını indirin. Temalarımızı ziyaret edin ve herhangi birini yeniden indirebilirsiniz. İndirdiğiniz yeni kopyanın içinde orijinal, düzenlenmemiş dosyalar bulunur.

Ardından, sitenize FTP üzerinden bağlanın. FTP'yi hiç kullanmadıysanız, nasıl yapılacağını öğrenmek için bu FTP eğitimini takip edebilirsiniz. Tema, sunucunuzda aşağıdaki konumda bulunur:

wordpress/wp-içeriği/temaları

Örneğin, bu, Ignite temasına giden yol olacaktır:

wordpress/wp-içerik/temalar/ateşleme

Diyelim ki site çöktüğünde header.php dosyasını düzenlediğinizi varsayalım. Sitemizden yeni indirdiğiniz Ignite kopyasında header.php'yi bulun ve FTP aracılığıyla sunucunuzdaki “ignite” klasörüne yükleyin.

Dosya yüklendikten sonra siteniz tekrar çevrimiçi olacaktır. Ayrıca, bu tekrar olursa sitenizi nasıl düzelteceğinizi artık biliyorsunuz.

Bunun tema dosyalarınızı düzenlemeyi kolaylaştırdığını bilmekle birlikte, temanızdaki dosyaları hiçbir zaman doğrudan düzenlememenizi tavsiye ederim. Bunun yerine bir çocuk teması kullanmak çok daha akıllıca.

Diğer her şeyde hata ayıklama

İlk birkaç adım, bazı oldukça spesifik hataları kapsar, ancak hemen hemen her şey sonraki üç adımda düzeltilebilir.

Tüm eklentileri geçici olarak devre dışı bırakın

Sitenizde neler olup bittiğinden emin değilseniz, denenecek ilk şey budur.

Temalarımızın her zaman %100 hatasız olduğunu söyleyemesem de, sitenizdeki bir hatanın bir eklentiden kaynaklanması genellikle çok daha olasıdır. Bunun nedeni, WordPress sitelerinin bir tema kullanması, ancak ortalama olarak 6-10 eklenti kullanmasıdır.

Kontrol panelinizdeki Eklentiler sayfasını ziyaret ederek başlayın. Etkin ve devre dışı eklentilerden oluşan bir karışımınız varsa, hangilerini kullandığınızı yazın veya Eklentiler sayfasının ekran görüntüsünü alın.

Ardından, tüm eklentileri seçmek için tablonun üstündeki onay kutusunu tıklayın ve tüm eklentileri bir kerede devre dışı bırakmak için toplu işlemler açılır menüsünü kullanın.

Bunu yapmakta biraz tereddüt edersen anlarım.

Sitenize ne olacak?

Eklentilerin devre dışı bırakılmasından siteniz geçici olarak etkilenecek olsa da, onları yeniden etkinleştirdiğinizde her şey normale dönecektir. Eklentiler, devre dışı bırakıldığında ayarlarını silmez. Bu, bir eklentiyi yeniden etkinleştirdiğinizde, daha önce sahip olduğunuz ayarlarla tamamen aynı şekilde geri yükleneceği anlamına gelir.

Eklentiler devre dışı bırakıldığında, hatanın devam edip etmediğini kontrol edebilirsiniz. Hata ortadan kalktıysa, sorunun eklentilerden birinden geldiğini biliyorsunuzdur.

Hata dönene kadar her eklentiyi birer birer yeniden etkinleştirin. Bu bir eklenti ise, ihtiyacınız yoksa, onu silebilirsiniz. Aksi takdirde, hata hakkında eklenti geliştiricisiyle iletişime geçebilirsiniz. Eklentideki genel bir hatadan ziyade temalarımızdan biriyle çakışıyor gibi görünüyorsa, lütfen bize de ulaşın.

Bu yardımcı olmazsa, bir sonraki adıma geçin.

Temanızı yeniden yükleyin

Eklentilerinizi devre dışı bırakmak işe yaramazsa temada bir hata olabilir. Hata, bir tema dosyasında yapılan bir düzenlemeden, hatalı bir güncellemeden kaynaklanan bozuk bir dosyadan veya temadaki bir hatadan kaynaklanıyor olabilir.

Tema dosyalarını düzenlediyseniz, temayı yeniden yüklemek düzenlemelerinizi geçersiz kılacağından bu değişiklikleri kaydettiğinizden emin olun.

Bir temayı yeniden yüklemek için Görünüm menüsünü ziyaret ederek başlayın ve farklı bir temaya geçin. Ardından, kullandığınız temayı seçtiğinizde, altta Sil seçeneğini göreceksiniz.

Aktif temanızı silemezsiniz, bu yüzden önce temaları değiştirmelisiniz.

Tema silindikten sonra yeni bir kopyayı yeniden yükleyebilir ve hatanın giderilip giderilmediğini kontrol edebilirsiniz. Bu işe yaramazsa, temada bir hata olabilir.

Denenecek son şey, WordPress'in kendisini yeniden yüklemektir.

WordPress'i yeniden yükleyin

Son çare olarak, WordPress'i yeniden yüklemeyi deneyebilirsiniz. İster inanın ister inanmayın, WordPress'i yeniden yüklemek göründüğü kadar zor değil.

Gösterge tablonuzu ziyaret edin ve Gösterge Tablosu altındaki Güncellemeler alt menü öğesini tıklayın.

Bu sayfada, WordPress çekirdeği, temalarınız ve eklentileriniz için mevcut tüm güncellemeleri göreceksiniz. WordPress'in en son sürümünde değilseniz, bir güncelleme düğmesi de görürsünüz. Aksi takdirde, Şimdi Yeniden Yükle düğmesini görürsünüz. Bu düğmeye tıklayın ve WordPress sizin için kendini otomatik olarak yeniden kuracaktır.

Umarım, bu sizin için hatayı çözecektir. Değilse, yardım için bir geliştiriciyle iletişim kurmanın zamanı geldi.

Çözüm

Bu hata ayıklama işlemi, aldığım tüm destek isteklerinin yakınında işe yarıyor. Bazen daha fazla teknik uzmanlık gerekir, ancak buradaki adımlar herhangi bir kodlama veya programlama bilgisi gerektirmez. Sadece biraz hata ayıklama bilgisine ve WordPress bilgisine ihtiyacınız var.

Sitenizle ilgili sorun yaşıyorsanız ve bu kılavuz yardımcı olmadıysa, yardım için bizimle iletişime geçmenin en iyi yollarını bulmak için Destek Merkezini ziyaret edebilir ve temanızı buradan seçebilirsiniz.