- Konu sahibi
- #1
WordPress blok doğrulama hatası, özellikle statik bloklarda, kayıtlı markup ile bloğun mevcut özniteliklerinden save işlevinin yeniden ürettiği beklenen markup uyuşmadığında oluşur. İçeriği editörde açıp ayrıştırırken de görülebilir; yalnız sunucuya kaydetme hatası değildir. Genellikle blok içeriğinin kod görünümünde elle değiştirilmesi, tema veya eklentinin blok çıktısını değiştirmesi, hatalı HTML kullanılması ya da eski bir blok sürümüyle oluşturulan içeriğin yeni sürüm tarafından farklı yorumlanması bu uyarıya yol açar. Hata, çoğu zaman içeriğin tamamen kaybolduğu anlamına gelmez; ancak düzeltme seçeneğini kullanmadan önce değişikliğin ne olduğunu kontrol etmek gerekir.
WordPress, her bloğun editördeki ayarlarına göre belirli bir HTML yapısı üretmesini bekler. Kayıtlı içerikteki yapı bu beklentiyle karşılaştırılır. Örneğin bir paragraf bloğu editörde yalnızca metin içerirken, kod görünümünde bu bloğun etiketine farklı bir sınıf eklenirse veya paragraf etiketi kapatılmazsa doğrulama başarısız olabilir.
Basit bir varsayımsal örnekte, standart bir paragraf bloğu şu şekilde kaydedilmiş olsun:
Bir eklenti ya da elle yapılan düzenleme sonucunda içerik şu hale gelirse:
Blok, bu sınıfı kendi yapılandırmasının parçası olarak tanımıyorsa editör kayıtlı içeriği beklenen çıktıyla eşleştiremez ve doğrulama uyarısı gösterebilir. Buradaki önemli nokta, görünen metnin aynı kalmasına rağmen HTML yapısının değişmiş olmasıdır.
Bloğun Gelişmiş alanından eklenen destekli özel sınıf, öznitelik ve çıktı birlikte kaydedildiği için normalde geçerlidir. Örnekte sorun sınıf kullanmak değil, kayıtlı HTML’ye sınıf eklenirken blok özniteliğinin tutarsız kalmasıdır. Sunucuda render edilen dinamik blokların save:null ile kaydettiği yapı ve doğrulama yolu farklıdır; ön yüzde render_block filtresiyle çıktı değişmesi tek başına post_content’in bozulduğunu göstermez. Özel blok geliştiricisi save yapısını değiştiriyorsa eski sürümler için deprecation/migrate desteğini değerlendirmelidir.
Önce hatalı bloğun içeriğini ve yakın zamanda yapılan değişiklikleri karşılaştırın. Özellikle kod görünümünde eklenen etiketleri, sınıfları, bağlantıları ve kısa kodları kontrol edin.
Aşağıdaki ayrım, hangi çözümün daha uygun olduğunu belirlemeye yardımcı olur.
Bu belirtiler tek başına kesin teşhis değildir; aynı hata birden fazla nedenden kaynaklanabilir. Özellikle tüm bloklarda sorun varsa tek tek metin düzeltmek yerine tema, eklenti ve özel blok kodunu incelemek daha doğru olur.
Kod görünümünde blok yorumlarını, açılış-kapanış etiketlerini veya blok özniteliklerini rastgele silmek sorunu büyütebilir. Bir başka hata, yalnızca uyarıyı gizlemek için her bloğu HTML'ye çevirmektir; bu işlem bloğun görsel ayarlarını ve gelecekteki düzenlenebilirliğini sınırlayabilir. Ayrıca sorunun eklenti güncellemesinden sonra başlayıp başlamadığını kontrol etmeden tüm içeriği yeniden yazmak gereksiz veri kaybına neden olabilir.
Özel HTML kullanmak zorunluysa, bunu ilgili HTML bloğunda tutmak ve normal blokların ürettiği yapıyı elle değiştirmemek daha güvenlidir. Sorun birden çok yazıda tekrarlanıyorsa tekil içerik düzeltmek yerine blok kaydını değiştiren tema veya eklenti kodu bulunmalıdır.
Uyarının kendisi doğrudan bir SEO sonucu oluşturmaz. Ancak hatalı HTML, eksik içerik veya kaydedilemeyen düzenlemeler sayfanın görünen çıktısını bozabilir. Bu nedenle yayımlamadan önce sayfanın ziyaretçiye nasıl göründüğünü kontrol edin.
İçerik kısa ve kolayca yeniden oluşturulabiliyorsa evet. Uzun metin, bağlantı veya özel biçimlendirme varsa önce içeriği kopyalayın; aksi halde gerekli ayrıntılar kaybolabilir.
Blok doğrulaması nasıl çalışır?
WordPress, her bloğun editördeki ayarlarına göre belirli bir HTML yapısı üretmesini bekler. Kayıtlı içerikteki yapı bu beklentiyle karşılaştırılır. Örneğin bir paragraf bloğu editörde yalnızca metin içerirken, kod görünümünde bu bloğun etiketine farklı bir sınıf eklenirse veya paragraf etiketi kapatılmazsa doğrulama başarısız olabilir.
Basit bir varsayımsal örnekte, standart bir paragraf bloğu şu şekilde kaydedilmiş olsun:
Kod:
<!-- wp:paragraph -->
<p>Örnek açıklama.</p>
<!-- /wp:paragraph -->Bir eklenti ya da elle yapılan düzenleme sonucunda içerik şu hale gelirse:
Kod:
<!-- wp:paragraph -->
<p class="ozel-sinif">Örnek açıklama.</p>
<!-- /wp:paragraph -->Blok, bu sınıfı kendi yapılandırmasının parçası olarak tanımıyorsa editör kayıtlı içeriği beklenen çıktıyla eşleştiremez ve doğrulama uyarısı gösterebilir. Buradaki önemli nokta, görünen metnin aynı kalmasına rağmen HTML yapısının değişmiş olmasıdır.
Bloğun Gelişmiş alanından eklenen destekli özel sınıf, öznitelik ve çıktı birlikte kaydedildiği için normalde geçerlidir. Örnekte sorun sınıf kullanmak değil, kayıtlı HTML’ye sınıf eklenirken blok özniteliğinin tutarsız kalmasıdır. Sunucuda render edilen dinamik blokların save:null ile kaydettiği yapı ve doğrulama yolu farklıdır; ön yüzde render_block filtresiyle çıktı değişmesi tek başına post_content’in bozulduğunu göstermez. Özel blok geliştiricisi save yapısını değiştiriyorsa eski sürümler için deprecation/migrate desteğini değerlendirmelidir.
Hata görüldüğünde uygulanacak adımlar
Önce hatalı bloğun içeriğini ve yakın zamanda yapılan değişiklikleri karşılaştırın. Özellikle kod görünümünde eklenen etiketleri, sınıfları, bağlantıları ve kısa kodları kontrol edin.
- İçeriğin güncel bir taslağını veya geri alınabilir bir kopyasını oluşturun. Büyük bir içerikte düzeltme yapmadan önce bu adım, yanlış seçimin geri döndürülebilmesini sağlar.
- Hatalı bloğu seçin ve WordPress'in sunduğu doğrulama seçeneklerini inceleyin. Arayüzdeki Kurtarmayı dene benzeri seçenek, tanınan özniteliklerden yeniden blok oluşturmaya çalışır; elle eklenen HTML/biçimin tamamen korunacağı garanti değildir; HTML'ye dönüştür seçeneği ise içeriği düzenlenebilir özel HTML olarak bırakabilir.
- Metin ve biçimlendirme önemliyse önce orijinal içeriği karşılaştırın. Yalnızca küçük bir HTML farkı varsa bloğu yeniden oluşturmak veya metni yeni bir paragraf bloğuna taşımak genellikle daha temiz bir çözümdür.
- Hata yeni bir eklenti, tema veya özel kod eklenmesinden sonra başladıysa ilgili değişikliği geçici olarak geri alıp bloğu tekrar açın. Sorun kayboluyorsa blok çıktısını değiştiren bileşen üzerinde inceleme yapın.
- Bloğu düzelttikten sonra yazıyı güncelleyin, sayfayı yeniden açın ve aynı uyarının tekrar oluşup oluşmadığını kontrol edin. Hata sürüyorsa aynı içerikteki diğer blokları da tek tek inceleyin.
Hatanın kaynağına göre karar
Aşağıdaki ayrım, hangi çözümün daha uygun olduğunu belirlemeye yardımcı olur.
| Belirti | Muhtemel neden | Uygun yaklaşım |
|---|---|---|
| Yalnızca tek blokta görülüyor | Elle değiştirilmiş veya bozulmuş HTML | İçeriği karşılaştırıp bloğu düzeltin ya da yeniden oluşturun |
| Birçok eski yazıda görülüyor | Tema veya eklenti çıktısının değişmesi | Değişikliği yapan bileşeni belirleyip uyumluluğunu inceleyin |
| Yeni oluşturulan her blokta görülüyor | Editör, tema veya eklenti çakışması | Bileşenleri kontrollü biçimde devre dışı bırakarak çakışmayı ayırın |
| Metin kaybolmuş gibi görünüyor | Yanlış kurtarma seçeneği veya hatalı HTML | Önce taslak/revizyon kopyasına dönün, ardından bloğu yeniden ekleyin |
Bu belirtiler tek başına kesin teşhis değildir; aynı hata birden fazla nedenden kaynaklanabilir. Özellikle tüm bloklarda sorun varsa tek tek metin düzeltmek yerine tema, eklenti ve özel blok kodunu incelemek daha doğru olur.
Sık yapılan hatalar
Kod görünümünde blok yorumlarını, açılış-kapanış etiketlerini veya blok özniteliklerini rastgele silmek sorunu büyütebilir. Bir başka hata, yalnızca uyarıyı gizlemek için her bloğu HTML'ye çevirmektir; bu işlem bloğun görsel ayarlarını ve gelecekteki düzenlenebilirliğini sınırlayabilir. Ayrıca sorunun eklenti güncellemesinden sonra başlayıp başlamadığını kontrol etmeden tüm içeriği yeniden yazmak gereksiz veri kaybına neden olabilir.
Özel HTML kullanmak zorunluysa, bunu ilgili HTML bloğunda tutmak ve normal blokların ürettiği yapıyı elle değiştirmemek daha güvenlidir. Sorun birden çok yazıda tekrarlanıyorsa tekil içerik düzeltmek yerine blok kaydını değiştiren tema veya eklenti kodu bulunmalıdır.
Kaynaklar
Sık sorulan sorular
Blok doğrulama hatası SEO'yu doğrudan bozar mı?
Uyarının kendisi doğrudan bir SEO sonucu oluşturmaz. Ancak hatalı HTML, eksik içerik veya kaydedilemeyen düzenlemeler sayfanın görünen çıktısını bozabilir. Bu nedenle yayımlamadan önce sayfanın ziyaretçiye nasıl göründüğünü kontrol edin.
Hatalı bloğu silip yeniden eklemek doğru mudur?
İçerik kısa ve kolayca yeniden oluşturulabiliyorsa evet. Uzun metin, bağlantı veya özel biçimlendirme varsa önce içeriği kopyalayın; aksi halde gerekli ayrıntılar kaybolabilir.
