WordPress uzun zamandır yalnızca bir blog platformu olmaktan çıkmış olsa da, web sitesinin nişi ne olursa olsun, gönderileri yayınlamak veya güncellemek WordPress web yöneticileri, editörleri veya yazarları için hala önemli bir görevdir. Bu yüzden WordPress gönderilerini güncelleyememe veya yayınlayamama, özellikle görünürde bir sebep olmadan meydana gelirse, iş akışlarını büyük ölçüde engelleyebilir.
Bu yazımızda son zamanlarda böyle bir hatanın ortaya çıkmasının nedenlerini açıklayacağız. Hatanın nedeni hakkında çok az bilgi verdikleri için çok fazla hayal kırıklığına neden olan “Güncelleme başarısız oldu” veya “Yayınlama başarısız oldu” şeklinde hata ekranları eşlik eder. Bununla birlikte bu hatanın, bu makalede özetleyeceğimiz oldukça basit bir sorun giderme süreci vardır. İşte ele alacağımız konular:
-
WordPress Güncellemesi veya Yayınlama Başarısız Hatası Neden Olur?
-
İlk Sorun Giderme
-
REST API durumunu kontrol etme
-
WordPress Eklentilerini Devre Dışı Bırakma
-
Güvenlik Duvarı Ayarlarını Kontrol Etme
-
Hata Ayıklama Günlüğünü İnceleme
-
Klasik Düzenleyiciyi Kullanma
-
Barındırma Sağlayıcınızdan Yardım İsteme
WordPress Güncellemesi veya Yayınlama Başarısız Hatası Neden Olur?
Yukarıda bahsedildiği gibi bu hatanın adı, hata oluştuğunda ekrana gelen mesajlardan gelmektedir. Daha doğrusu Gutenberg editörünü kullanarak bir gönderiyi yayınlamaya çalışırken “Publishing failed” hata mesajını görebilirken, yayınlanmış bir gönderiyi düzenledikten sonra Update butonuna bastıktan sonra ekranda “Update failed” hata mesajı görünebilir.
Ve hatanın bu iki olası varyasyonunun neden meydana geldiğine dair pek çok olası neden olsa da, bunların tümü doğrudan Gutenberg’in nasıl çalıştığına bağlıdır. Spesifik olarak, Gutenberg eklentisinin gönderileri yayınlamak ve güncellemek için REST API’ye güvenmesidir. REST API nedir kısaca değinelim.
Basitçe söylemek gerekirse, WordPress REST API (Temsili Durum Aktarım Uygulaması Programlama Arayüzü), WordPress ile diğer web sistemleri arasında birbirini doğru bir şekilde anlamalarını sağlayan oldukça standart bir iletişim protokolüdür. Bu yüzden WordPress’in etkileşime girebileceği web tabanlı uygulamaların yelpazesini büyük ölçüde genişleterek onu basit bir içerik yönetim sisteminden (CMS) çok daha fazlasına dönüştürür.
Bu işlevsellik daha önce WordPress.com’un bir parçasıydı veya ayrı bir eklenti olarak mevcuttu, fakat Gutenberg’in WordPress 5.0 güncellemesinde varsayılan WordPress editörü olarak sunulmasıyla WordPress Çekirdeğine entegre edildi.
Bu yüzden REST API ile bağlantı kesilirse, engellenirse veya kasıtlı olarak devre dışı bırakılırsa, Gutenberg editörünü kullanarak WordPress gönderilerinizi yayınlayamaz ve güncelleyemezsiniz. WordPress ve REST API arasındaki bağlantıyı kesmenin nedenleri arasında hatalı internet bağlantıları, güvenlik duvarı ayarları, hatalı WordPress eklentileri veya ayarları ve diğerleri yer alır.
Hatanın neden olduğunu açıkladıktan sonra, onu çözmek için gereken sorun giderme yöntemlerine geçelim. Uygulaması en kolay olanlardan başlayarak bunları birkaç alt bölüme ayırdık. Ayrıca diğer önerilerimizi kullanarak hatayı çözememeniz durumunda sorunu çözmenin alternatif bir yolunu da ekledik. Bunu söyledikten sonra devam edelim.
İlk Sorun Giderme
Gerçekten sorun gidermeye başlamadan önce, sorunun devam edip etmediğini veya yalnızca geçici olup olmadığını tekrar kontrol etmenizi öneririz. Sorunun kendi kendine çözülmediğini doğruladıktan sonra, hataya yol açabilecek belirli nedenleri test etmek iyidir. Bu bölümde bunları ele alacağız.
İnternet Bağlantısını Kontrol Etme
Güncelleme veya Yayınlama başarısız hatasını görmenizin en bariz nedeni, yerel olmayan bir ortamda çalışıyorsanız REST API’ye bağlanmak için gerekli olan internet bağlantısının olmamasıdır.
Yeni tarayıcı sekmelerinde diğer web sitelerine erişerek sabit bir internet bağlantınız olduğundan emin olun. İnternet bağlantısındaki herhangi bir sorunun giderildiğinden emin olduktan sonra, hatanın çözülüp çözülmediğini test etmek için gönderiyi bir kez daha yayınlamayı/güncellemeyi deneyin.
Site URL’sini kontrol etme
REST API’nin web sitenize bağlanırken sorun yaşamasının bir başka bariz nedeni de, web sitenizin URL’lerinin mevcut değerlerini yansıtacak şekilde düzgün bir şekilde güncellenmemesidir. Tabii ki, Ayarlar> Genel’de bulunan WordPress Adresi ve Site Adresinden bahsediyoruz. Sorunun daha sonra ortadan kalkıp kalkmadığını görmek için düzgün ayarlanıp ayarlanmadığını doğrulamak veya güncellemek zarar vermez.
Bunu yapmak için Ayarlar > Genel’e gidin ve WordPress Adresi ve Site Adresi seçeneklerini bulun. Bu adresler, sırasıyla WordPress dosyalarınızın konumunu ve ziyaretçilerin web sitenize erişmek için adres alanlarına yazmaları gereken URL’yi temsil eder. Her ikisinin de doğru olduğundan emin olun. Değillerse, doğru adresleri gösterecek şekilde düzenleyin. Herhangi bir değişikliği uygulamak için “Değişiklikleri Kaydet” düğmesine tıklayın.
Adresleri düzenledikten sonra, kimlik bilgilerinizi kullanarak web sitesinde yeniden oturum açmanız gerekecektir. Daha sonra bir gönderi yayınlayarak/güncelleyerek sorunun durumunu test edin.
Kalıcı Bağlantıları Kaydetme
Bazen sorun bozuk bir .htaccess dosyası olabilir. Durumun bu olup olmadığını hızlı bir şekilde test etmek için, varsayılan .htaccess dosyasını yeniden oluşturacak olan kalıcı bağlantı yapısını güncellemeniz yeterlidir.
Bunu yapmak için, Ayarlar> Kalıcı Bağlantılar’a gidin ve alttaki “Değişiklikleri Kaydet” düğmesini tıklayın.
Daha sonra sorunun durumunu gözden geçirin. Devam ederse, aşağıdan ilerleyin. Ek olarak WordPress eklentilerini devre dışı bıraktıktan sonra kalıcı bağlantıların kaydedilmesinin de önerildiğini belirtmemiz gerekir. Bazı eklentiler .htaccess dosyasına yeniden yazma kuralları eklediğinden, dosyanın varsayılan durumunda yeniden oluşturulduğundan emin olmak, sorun giderme işleminin eksiksiz olmasını sağlar.
REST API Durumunu Kontrol Etme
Bu hatanın ana nedeninin REST API ile bağlantıdaki bir sorun olduğundan daha önce bahsettiğimiz için, ilk sorun giderme adımlarından birinin REST API’nin herhangi bir sorun yaşayıp yaşamadığını veya devre dışı bırakılıp bırakılmadığını kontrol etmek olması şaşırtıcı değildir. Bunu kontrol etmek zor gibi görünse de, WordPress 5.2 güncellemesinde sunulan Site Sağlığı aracını kullanarak bunu yapmanın kolay bir yolu var.
Bunu yapmak için Araçlar > Site Sağlığı bölümüne gidin ve Durum sekmesini açın. Orada, web siteniz için önerilen tüm iyileştirmeleri görebilirsiniz. Özellikle, REST API herhangi bir sorun yaşıyorsa veya web sitenizde devre dışı bırakılmışsa, “REST API beklenmeyen bir sonuçla karşılaştı” şeklinde bir mesaj görürsünüz.
Bu hata mesajına tıklamak, sorunla ilgili daha fazla bilgi ortaya çıkaracaktır. Sorunu nasıl çözebileceğinizi anlamak için incelemelisiniz. Çoğu durumda bunun nedeni, tam olarak saptayabileceğiniz ve çözebileceğiniz hatalı kod veya üçüncü taraf hizmet ayarları olabilir. Fakat bir hata mesajı görmüyorsanız aşağıda kalan sorun giderme adımlarına ilerleyin.
WordPress Eklentilerini Devre Dışı Bırakma
Güncelleme veya Yayınlama başarısız hatasının çok yaygın bir nedeni, belirli eklentilerin ayarlarındaki yanlış yapılandırmalardır. Önbelleğe alma, web sitesi optimizasyonu veya web sitesi güvenlik eklentileri, bazıları REST API’yi devre dışı bırakmanın bir yolunu sunarken, diğerleri çeşitli güvenlik kısıtlamaları kullanarak bağlantıyı engelleyebileceğinden, genellikle suçlular arasındadır. Durum ne olursa olsun, hatanın arkasında eklentilerinizden birinin olup olmadığını anlamanın en iyi yolu eklentileri devre dışı bırakmak ve sorunun durumunu incelemektir. Bunu nasıl düzgün bir şekilde yapabileceğinizi aşağıda açıklayacağız.
İlk olarak Eklentiler > Yüklü Eklentiler’e gidin ve tüm eklentileri seçmek için üst kısımdaki onay kutusunu işaretleyin. Daha sonra Toplu İşlemler açılır menüsünden Devre Dışı Bırak seçeneğini seçin ve tüm eklentileri devre dışı bırakmak için “Uygula” düğmesine basın.
Eklentileri devre dışı bıraktıktan sonra, daha önce yapamadığınız bir gönderiyi yayınlamayı veya güncellemeyi deneyin. Bu noktada gönderiyi yayınlayabilir/güncelleyebilirseniz, sorunun eklentilerinizden birinden kaynaklandığı anlamına gelir. Hangisini belirlemek için eklentileri birer birer etkinleştirmeyi deneyin ve ardından sorunun durumunu test edin.
Sorun yeniden ortaya çıkarsa, suçlu en son etkinleştirdiğiniz eklentidir. Bu durumda, sorunu tamamen çözmek için eklenti yazarlarına danışmanızı öneririz. Öte yandan, web sitesinde bulunan tüm WordPress eklentilerini devre dışı bıraktıktan sonra sorun devam ederse, hata herhangi bir eklentinizde olmadığı için kalan sorun giderme adımlarına geçmelisiniz.
Güvenlik Duvarı Ayarlarını Kontrol Etme
Cloudflare veya Sucuri gibi web sitesi güvenlik duvarı hizmetleri ve belirli WordPress güvenlik duvarı eklentileri de bu hatanın suçlusu olabilir. Spesifik olarak, belirli katı güvenlik duvarı kuralları, URL’leri web sitenize olası bir DDOS saldırısı olarak yanlış yorumlayarak meşru REST API isteklerini engelliyor olabilir. Bunu test etmek için güvenlik duvarı hizmetinizi veya eklentinizi geçici olarak devre dışı bırakabilir ve sorunun durumunu kontrol edebilirsiniz. Sorun çözülmüşse bu, güvenlik duvarı hizmetinizin veya eklentinizin bazı kurallarının suçlanacağı anlamına gelir.
Bu durum sırasıyla ilgili pano veya eklenti seçeneklerinde ayarlanan tüm güvenlik duvarı kurallarını incelemeniz gerektiği anlamına gelir. Devre dışı bırakmanız gereken kesin kuralları belirlemek için güvenlik duvarı hizmetine/eklenti desteğine başvurmanızı öneririz. Öte yandan, güvenlik duvarını devre dışı bıraktıktan sonra bile sorun devam ederse, sonraki yöntemlere geçin.
Hata Ayıklama Günlüğünü İnceleme
WordPress, REST API hatalarını takip etmese de, WordPress kodlamasıyla ilgili tüm hataları günlüğe kaydeden bir hata ayıklama sistemine sahiptir. Ayrıca sorun hatalı bir kod parçacığıyla ilgili olabileceğinden, bu hata ayıklama sisteminin sizin açınızdan da böyle olup olmadığını kontrol etmesini sağlamanız faydalı olacaktır.
Bunu yapmak için, önce FTP kimlik bilgilerinizi kullanarak sunucunuza bağlanın. Kök WordPress dizinine gidin ve içindeki wp-config.php dosyasını bulun. Dosyaya sağ tıklayın ve beliren menüden “Görüntüle/Düzenle” seçeneğine tıklayın.
Tercih ettiğiniz dosya düzenleyiciyi kullanarak dosyayı açın ve WordPress hata ayıklama modundan bahseden yorum bölümünü bulun. Daha sonra aşağıdaki iki kod satırını ekleyin:
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true );
aşağıdaki ekran görüntüsünde gösterildiği gibi.
Çoğu durumda, ilk satır zaten mevcut olacaktır, fakat WP_DEBUG sabitinin değeri false olarak ayarlanacaktır. Yalnızca bunu true olarak ayarlamanız ve ardından ikinci kod satırını eklemeniz gerekir.
İlk kod satırı, WordPress hatasının sunucuda günlüğe kaydedilmesini sağlarken, ikincisi, hataların önceden tanımlanmış bir konumda (wp-content/debug.log dosyası) günlüğe kaydedilmesi gerektiğini belirtir. Ek hata ayıklama ayarları için, wp-config.php dosyasını düzenleme ve uygulayabileceğiniz olası yapılandırmalar hakkındaki makalemize bakmanızı öneririz.
Bunu yaptıktan sonra, wp-content klasörüne gitmeli ve debug.log dosyasını bulmalısınız. Üzerine sağ tıklayın ve bilgisayarınıza indirmek için “İndir” seçeneğini seçin.
Daha sonra tercih ettiğiniz metin düzenleyiciyi kullanarak debug.log dosyasını açın ve gösterilen hata mesajlarını, özellikle ilgili dosya yollarını araştırın. Temanıza veya bazı eklentilerinize işaret eden herhangi bir nokta varsa, yardım için ilgili yazarlarına başvurmanız önerilir. Çözüm sürecini hızlandıracağı için yardım isterken debug.log dosyanızı da eklemenizi öneririz.
Sorunu başarıyla çözdükten sonra, ikinci kod satırını kaldırarak ve WP_DEBUG sabitini yanlış olarak sıfırlayarak hata günlüğünü devre dışı bırakabilirsiniz. Tersine, sorunu çözemediyseniz, aşağıdaki diğer sorun giderme yöntemlerimizden bazılarını kullanmayı düşünün.
Klasik Düzenleyiciyi Kullanma
Güncelleme veya Yayınlama başarısız hatasını çözmenin olası bir yolu, Gutenberg yerine TinyMCE düzenleyicisine dönmektir. Bu değişiklik, sorununuzun çözümünü aramaya devam ettiğiniz için hem geçici hem de eski düzenleyiciye alışkınsanız kalıcı olabilir. Klasik Düzenleyici eklentisini yükleyerek Klasik Düzenleyici’yi etkinleştirebilirsiniz.
Bu adımı seçerseniz, Eklentiler > Yeni Ekle’ye gidin ve Öne Çıkanlar bölümünde Klasik Düzenleyici’yi arayın. Yapabilirsiniz…