Sorun Giderme (SSS)

Görünmeyen içerikler, lisans hataları ve sık karşılaşılan sorunlar.

Bu rehber SakuraCMS yönetim akışını açıklar. Ekran adları ve kullanılabilir seçenekler, kurulu modül sürümlerine, lisans kapsamına ve hesabınızın yetkilerine göre değişebilir.

1. İlk kontrol: sorun nerede başlıyor?

Önce hangi sayfada, hangi hesapla ve hangi işlemden sonra sorun gördüğünüzü belirleyin. Kaydı yeniden açarak değişikliğin kaydedilip kaydedilmediğini kontrol edin. Sonra yayını, bağlantıyı, yetkiyi ve önbelleği ayrı ayrı değerlendirin.

Çalışan başka alanları değiştirmeden tek bir örnek üzerinde ilerleyin. Aynı düğmeye tekrar tekrar basmak veya aynı içeriği yeniden oluşturmak, sorunun nedenini bulmayı zorlaştırabilir.

2. Sayfa yayınlandı ama menüde görünmüyor

Bir sayfanın yayınlanması onu otomatik olarak ana menüye eklemez. Menü Yönetimi’nde ilgili menüyü açın, sayfayı ekleyin ve sıralamayı kaydedin. Ardından doğru menünün tema konumuna veya header öğesine bağlı olduğunu kontrol edin.

Öğe hâlâ görünmüyorsa sayfa ve menü durumunu, dilini, üst öğenin görünürlüğünü ve varsa erişim ya da cihaz sınırlamalarını inceleyin.

3. Sayfa açılıyor ama bağlı bölüm veya kartlar yok

Sayfa Düzenleyici’de doğru bölümün aktif ve yayında olduğunu doğrulayın. İçerik sayfalarına bağla alanında hedef sayfanın adını, bağlantının açık olmasını ve konumunu kontrol edin. Yalnız taslağı kaydetmek yayınlamak değildir.

Sayfanın metni görünürken kartların görünmemesi bölüm bağlantısı veya yayın durumuyla ilgili olabilir. Sorunu çözmek için sayfa metnini silmeyin; önce bölüm ile sayfa arasındaki ilişkiyi inceleyin.

4. Ana sayfanın orta içerikleri görünmüyor

Bölümde Ana sayfada göster işaretli olsa bile ilgili tema/dil için Ana sayfa bağlantısı kapalı olabilir. Üstteki “Bu temanın ana sayfasında modül içeriklerini kullan” seçeneğini ve Bağlantıyı Kaydet işlemini kontrol edin.

Ardından bölümün yayında, aktif ve ana sayfaya bağlı olduğunu doğrulayın. Doğru tema ve dil üzerinde çalıştığınızdan emin olun. Header/footer görünürken orta içeriğin kapalı olması bu alanların ayrı yönetilmesiyle mümkündür.

5. Başlık iki kez görünüyor veya boşluk kalıyor

Tema sayfa başlığını gösterirken bağlı bölüm de aynı başlığı içeriyor olabilir. Bölümün başlık yapısını ve Sayfa başlığını gizle seçeneğini birlikte değerlendirin. Yalnız çift başlığı çözmek için sayfanın bütün içeriğini silmeyin.

Başlık gizlendiği halde boşluk kalıyorsa temanın başlık kapsayıcısı veya bölüm boşlukları incelenmelidir. Çok sayıda boş paragraf ekleyip silmek yerine, sorunun metinden mi yerleşimden mi geldiğini ayırın.

6. “Bu rehberde” bağlantıları adresi değiştiriyor ama kaymıyor

Bağlantının #hedef değeri ile başlık veya bölümün id değeri aynı olmalıdır. Sayfayı kaydettikten sonra kaynak görünümünde hedefin korunduğunu kontrol edin. Aynı id değerini sayfada birden fazla yerde kullanmayın.

Sayfa Düzenleyici’nin iframe içinde gösterdiği içeriklerde bölüm içi bağlantılar için modülün ilgili kaydırma desteği gerekir. Bu düzeltme 1.2.8 sürümünde hazırlandı. HTML hedefi doğruysa modül sürümünü ve güncel JavaScript dosyasının yüklendiğini kontrol edin. Güvenlik izolasyonunu kaldırmak çözüm değildir.

7. Logo, e-posta veya sosyal medya görünmüyor

Önce bilginin Ayarlar’da doğru alanda kayıtlı olduğunu doğrulayın. Yönetici e-postasını halka açık iletişim e-postasıyla karıştırmayın. Header/footer tasarımında ilgili öğenin görünürlüğünü ve veri kaynağını kontrol edin.

Doğru tema ve dil için tasarımı kaydedip yayınlayın. Sosyal medya alanlarına gerçek profil adresleri girin; boş bırakılan platformun simgesinin gösterilmemesi normaldir. Elle yazılmış eski bir içerik, sistem ayarından gelen yeni bilgiyi kullanmayabilir.

8. Görselin adı var ama resim açılmıyor

Medya kaydındaki dosya adresini ve görselin gerçekten mevcut olduğunu kontrol edin. Yerel bilgisayar yolu, geçici adres veya erişime kapalı dosya ziyaretçiye gösterilemez. Sayfada kullanılan adresin yanlış domaine veya eski dizine işaret etmediğini inceleyin.

Görsel dosyasını hemen silip yeniden yüklemek yerine önce kaynak adresini belirleyin. Aynı dosya başka içeriklerde de kullanılabilir. Açılmayan dosya için sunucunun verdiği sonuç ve erişim izinleri ayrıca incelenebilir.

9. Lisans kodu ve domain eşleşmedi

Ekrandaki kurulum domainini, lisans sunucusundaki domain kaydını ve kullanılan kodu karşılaştırın. www ve çıplak domain eşleştirmesinin istemci ile sunucuda tutarlı işlenmesi gerekir. Doğru görünen alan adını rastgele değiştirerek denemeyin.

401 yanıtı bir yetkilendirme veya kimlik doğrulama sorunu gösterebilir; tek başına DNS hatası olduğunu kanıtlamaz. İsteğin hangi hizmetten bu yanıtı aldığını ve sunucunun hata açıklamasını inceleyin. Lisans kodunu destek ekran görüntülerinde açık bırakmayın.

10. Süper Admin modülü görüyor, Admin görmüyor

Süper Admin ile normal Admin’in erişim kapsamı farklıdır. Modülün kurulu, aktif ve lisans kapsamında olduğunu kontrol ettikten sonra ilgili rolün View, Manage ve varsa özel izinlerini inceleyin.

Modülün izinleri listede yoksa izin kaydı araştırılmalıdır. Kullanıcıyı Süper Admin yaparak sorunu geçiştirmeyin. Yetki değişikliği sonrası doğru hesapla oturumu yeniden açıp kontrol edin.

11. Güncelleme görünmüyor veya paket reddediliyor

Önce lisansı yeniden kontrol edin, ardından güncellemeleri sorgulayın. Hedef sürümün yayın durumunu, kanalı ve müşterinin hakkını doğrulayın. Güncelleme dosyasının doğru bileşene ait olduğundan emin olun.

“Tek bir modül kök klasörü” veya “seçilen slug dışında yol” hatası paket yapısıyla ilgilidir. İçerik ZIP’i veya site kök paketini modül paketi olarak yüklemeyin. Reddedilen arşivi rastgele düzenlemek yerine doğru dağıtımı kullanın.

12. Kaydederken ya da çıkışta güvenlik doğrulaması başarısız

Oturum süresi bitmiş veya açık form eski bir oturumun güvenlik bilgilerini taşıyor olabilir. Kaydedilmemiş metninizi güvenli biçimde koruyun; doğru domain üzerinden yeniden giriş yapıp ekranı tazeleyin.

Sorun tekrarlanıyorsa oturum, CSRF ve çıkış isteğinin çalışma şekli incelenmelidir. Güvenlik kontrolünü kapatmak veya çıkış adresine rastgele parametre eklemek kalıcı çözüm değildir.

13. Destek için hangi bilgileri paylaşmalıyım?

Sayfanın adresi, modül adı ve sürümü, yaptığınız işlem, beklediğiniz sonuç ve gördüğünüz hata yeterli bir başlangıçtır. Sorunun tüm hesaplarda mı, yalnız bir rolde mi oluştuğunu da belirtin.

Parola, lisans kodu, oturum çerezi, veritabanı bilgisi veya kişisel verileri paylaşmayın. Görsel gönderecekseniz gizli alanları kapatın. Sorunun hangi adımdan sonra tekrarlandığını açıklamak, ilgisiz alanlara müdahale etmeden inceleme yapılmasını sağlar.