Medya kütüphanesini açtığınızda sizi boş bir ekran karşılıyor. Yüzlerce görsel yüklediğinizi biliyorsunuz ama ızgara (grid) görünümünde hiçbiri gözükmüyor. İlginç olan şu: liste görünümüne geçtiğinizde dosyalar bir anda ortaya çıkıyor. Bu ayrım aslında sorunun nerede olduğuna dair iyi bir ipucu. Çünkü iki görünüm farklı teknolojilerle çalışır.
Neden boş görünür
Izgara görünümü JavaScript ve WordPress REST API üzerinden çalışır. Görselleri getirmek için arka planda sunucuya bir istek atar ve dönen veriyi ekrana dizer. Liste görünümü ise klasik sayfa yüklemesiyle, doğrudan PHP ile gelir. Izgara boş ama liste doluysa sorun neredeyse kesin olarak JavaScript tarafında ya da REST API’nin engellenmesindedir.
JavaScript çakışması en sık sebeptir. Bir eklenti ya da tema hatalı bir betik yüklüyorsa ızgarayı dolduran kod çalışmadan durur. İkinci ihtimal REST API’nin kapatılmış ya da engellenmiş olmasıdır. Bazı güvenlik eklentileri REST API’yi tamamen kapatır, bu da ızgarayı boşaltır. Üçüncü olarak bellek yetersizliği var. Çok sayıda görsel varken PHP’ye ayrılan bellek azsa istek yarıda kesilir ve ekran boş kalır.
Adım adım çözüm
- İlk iş olarak liste görünümüne geçin. Medya kütüphanesinin üst köşesindeki görünüm değiştirme düğmesiyle dosyalarınıza erişebilir, acil işinizi görebilirsiniz. Böylece çalışmaya devam ederken sorunu rahat rahat araştırırsınız.
- Tarayıcıda F12 ile geliştirici araçlarını açıp Console sekmesine bakın. Kırmızı bir hata, hangi betiğin soruna yol açtığını söyler. Network sekmesinde ise REST API isteğinin başarılı mı yoksa hata mı döndürdüğünü görebilirsiniz. 403 ya da 401 gibi bir kod görürseniz REST API engelleniyor demektir.
- Eklentileri tek tek devre dışı bırakın. Özellikle güvenlik eklentilerinden başlayın, çünkü REST API’yi en çok onlar kısıtlar. Izgara bir eklentiyi kapatınca dolduysa suçluyu buldunuz.
- PHP bellek limitini artırın. wp-config.php dosyasına şu satırı ekleyin:
- define(‘WP_MEMORY_LIMIT’, ‘256M’);
Çok sayıda görseli olan sitelerde bellek sıkışması ızgarayı boşaltabilir, bu ayar genelde rahatlatır.
- REST API’nin çalıştığını doğrulayın. Tarayıcıya sitenizin adresinin sonuna /wp-json/ yazıp girin. Bir JSON çıktısı görmelisiniz. Hata ya da boş sayfa geliyorsa REST API engellidir ve bunu açmanız gerekir.
Bellek sorununun belirtisi genelde şudur: az sayıda görselle ızgara açılır ama kütüphane büyüdükçe boş gelmeye başlar. Çünkü istek ne kadar çok görsel getirmeye çalışırsa o kadar bellek harcar. Bellek limitini artırdıktan sonra ızgara yine ağır açılıyorsa sunucunun PHP sürümünü de kontrol etmekte fayda var. Eski PHP sürümleri hem yavaştır hem de bellek yönetimi zayıftır. Güncel bir PHP sürümüne geçmek çoğu zaman hem bu sorunu hem de genel yavaşlığı birlikte çözer.
Network sekmesini okurken şuna dikkat edin: ızgara görsel listesini media adlı bir uç noktadan ister. O isteğin karşısında 200 yazıyorsa istek başarılı demektir, yani sorun gelen verinin işlenmesinde ya da JavaScript tarafındadır. 403 ya da 401 görüyorsanız yetki engeli, 500 görüyorsanız sunucu tarafında bir hata vardır. Bu kodlar, sorunu tarayıcı ile sunucu arasında net bir şekilde ayırır ve doğru tarafa yönelmenizi sağlar.
Tema da sebep olabilir
Eklentileri eledikten sonra sorun sürüyorsa temayı geçici olarak varsayılan bir temaya alın. Bazı temalar yönetim paneline de betik yükler ve bunlar ızgarayla çakışabilir. Varsayılan temayla ızgara doluyorsa mesele kendi temanızdadır ve tema geliştiricisine bildirmek yerinde olur.
Bir daha karşılaşmamak için
Güvenlik eklentisi kurarken REST API ayarlarına dikkat etmek bu sorunun önünü büyük ölçüde keser, çünkü API’yi tümden kapatmak ızgaradan fazlasını bozar. Bellek limitini makul bir seviyede tutmak, görsel sayısı arttıkça yaşanan takılmaları engeller. Eklenti ve tema güncellemelerini takip etmek de JavaScript çakışmalarının çoğunu daha çıkmadan kapatır. Bu düzenle medya kütüphaneniz hızlı ve dolu açılır.
Bu işleri kendiniz yapmak yerine profesyonel destek isterseniz, WordPress bakım ve teknik destek hizmetime göz atabilirsiniz.
Bu konunun tüm rehberi: WordPress Hataları ve Çözümleri