38980-vm/app-9w9pd00g5j41/ADMIN_IMAGE_GUIDE.md

Admin Panel Resim Yönetimi - Kullanım Kılavuzu

🎯 Özellikler

✅ Düzeltilen Sorun

• Hero Görseli Yükleme Hatası: "Cannot coerce the result to a single JSON object" hatası düzeltildi
• Artık tüm site ayarları resimleri sorunsuz yüklenebilir

✨ Yeni Özellikler

• Places (Yerler) Resim Yönetimi: Yer eklerken/düzenlerken resim yükleme
• Resim Önizleme: Yüklenen resimleri anında görme
• Resim Silme: İstenmeyen resimleri kolayca silme
• Manuel URL Girişi: Harici resim URL'leri de kullanılabilir

📋 Kullanım Adımları

1. Site Ayarları - Resim Yükleme

Anasayfa Hero Görseli

Admin Panel → Ayarlar → Site Görünümü → Ana Sayfa Hero Görseli

Adımlar:

1. "Dosya Seç" butonuna tıklayın
2. Bilgisayarınızdan bir resim seçin (max 1MB)
3. Resim otomatik olarak yüklenecek
4. Önizleme gösterilecek
5. ✅ Tamamlandı!

Header Arka Plan Resmi

Admin Panel → Ayarlar → Site Görünümü → Header Arka Plan Resmi

Adımlar:

1. "Dosya Seç" butonuna tıklayın
2. Arka plan için uygun bir resim seçin
3. Resim otomatik olarak yüklenecek
4. ✅ Tamamlandı!

Site Logosu

Admin Panel → Ayarlar → Site Görünümü → Site Logosu

Adımlar:

1. "Dosya Seç" butonuna tıklayın
2. Logo dosyanızı seçin (PNG önerilir)
3. Resim otomatik olarak yüklenecek
4. ✅ Tamamlandı!

2. Places (Yerler) - Resim Yönetimi

Yeni Yer Eklerken Resim Yükleme

Admin Panel → Yerler → Yeni Yer Ekle

Adımlar:

1. "Yeni Yer Ekle" butonuna tıklayın
2. Yer bilgilerini doldurun (ad, tür, şehir, vb.)
3. Yer Görseli bölümüne gelin
4. İki seçenek:
   • A) Dosya Yükle:
     • "Dosya Seç" butonuna tıklayın
     • Resim seçin (max 1MB)
     • Önizleme gösterilecek
     • URL otomatik olarak form alanına eklenecek
   • B) Manuel URL:
     • "Görsel URL (Manuel)" alanına harici bir URL girin
     • Örnek: https://example.com/image.jpg
5. Formu kaydedin
6. ✅ Tamamlandı!

Mevcut Yeri Düzenlerken Resim Güncelleme

Admin Panel → Yerler → [Yer Seç] → Düzenle

Adımlar:

1. Yer listesinde düzenlemek istediğiniz yerin yanındaki Düzenle (✏️) butonuna tıklayın
2. Mevcut resim varsa önizleme gösterilir
3. Resmi değiştirmek için:
   • Yeni Resim Yükle: "Dosya Seç" ile yeni resim seçin
   • Resmi Sil: Önizleme üzerindeki X butonuna tıklayın
   • Manuel URL: URL alanını düzenleyin
4. Formu kaydedin
5. ✅ Tamamlandı!

Yer Resmini Silme

Admin Panel → Yerler → [Yer Seç] → Düzenle → Resim Önizlemesi → X

Adımlar:

1. Yeri düzenleme modunda açın
2. Resim önizlemesinin sağ üst köşesindeki X butonuna tıklayın
3. Resim silinecek ve URL alanı temizlenecek
4. Formu kaydedin
5. ✅ Tamamlandı!

🔧 Teknik Bilgiler

Desteklenen Dosya Formatları

• ✅ PNG
• ✅ JPG / JPEG
• ✅ WEBP
• ❌ GIF (desteklenmez)
• ❌ SVG (desteklenmez)

Dosya Boyutu Sınırı

• Maksimum: 1MB (1024 KB)
• Önerilen: 500KB - 800KB (daha hızlı yükleme için)

Önerilen Resim Boyutları

Site Logosu

• Boyut: 200x60 px (yaklaşık)
• Format: PNG (şeffaf arka plan)
• Oran: 3:1 veya 4:1

Header Arka Plan

• Boyut: 1920x400 px
• Format: JPG veya WEBP
• Oran: 16:9 veya panoramik

Hero Görseli

• Boyut: 1920x1080 px
• Format: JPG veya WEBP
• Oran: 16:9

Yer Görselleri

• Boyut: 800x600 px veya 1200x800 px
• Format: JPG veya WEBP
• Oran: 4:3 veya 3:2

⚠️ Önemli Notlar

Resim Yükleme Kuralları

1. Dosya boyutu 1MB'ı geçmemeli

   • Daha büyük dosyalar hata verecektir
   • Gerekirse resmi sıkıştırın

2. Sadece resim dosyaları kabul edilir

   • PDF, Word, vb. dosyalar yüklenemez

3. Resimler public olarak erişilebilir

   • Yüklenen resimler herkese açık URL'ler alır
   • Gizli/özel resimler yüklemeyin

Resim Silme

• Resim silindiğinde storage'dan da otomatik olarak kaldırılır
• Silme işlemi geri alınamaz
• Yeri silerken resim otomatik olarak silinmez (manuel silmeniz gerekir)

Manuel URL Kullanımı

• Harici resim URL'leri kullanabilirsiniz
• URL'nin geçerli ve erişilebilir olduğundan emin olun
• HTTPS URL'leri önerilir

🐛 Sorun Giderme

"Dosya boyutu 1MB'dan küçük olmalıdır" Hatası

Çözüm:

1. Resmi bir resim düzenleme programında açın
2. Boyutunu küçültün veya kaliteyi düşürün
3. Online araçlar: TinyPNG, Squoosh, Compressor.io
4. Tekrar yüklemeyi deneyin

"Sadece resim dosyaları yüklenebilir" Hatası

Çözüm:

1. Dosya uzantısını kontrol edin (.jpg, .png, .webp)
2. Dosyanın gerçekten bir resim olduğundan emin olun
3. Gerekirse resmi yeniden kaydedin

Resim Yüklenmiyor / Önizleme Gösterilmiyor

Çözüm:

1. İnternet bağlantınızı kontrol edin
2. Sayfayı yenileyin (F5)
3. Tarayıcı önbelleğini temizleyin
4. Farklı bir tarayıcıda deneyin
5. Sorun devam ederse admin ile iletişime geçin

"Cannot coerce the result to a single JSON object" Hatası

Durum: ✅ Bu hata düzeltildi!

• Artık bu hatayı almamalısınız
• Eğer hala alıyorsanız, sayfayı yenileyin

📞 Destek

Sorun yaşarsanız:

1. Tarayıcı konsolunu açın (F12)
2. Hata mesajını kopyalayın
3. Ekran görüntüsü alın
4. Teknik destek ekibine iletin

🎉 İpuçları

Daha İyi Resimler İçin

1. Yüksek kaliteli resimler kullanın

   • Bulanık veya düşük çözünürlüklü resimlerden kaçının

2. Uygun boyutlarda resimler seçin

   • Çok büyük resimler yavaş yüklenir
   • Çok küçük resimler kalitesiz görünür

3. Resim optimizasyonu yapın

   • TinyPNG gibi araçlarla sıkıştırın
   • WEBP formatını tercih edin (daha küçük dosya boyutu)

4. Tutarlı stil kullanın

   • Tüm yer resimleri benzer stil ve kalitede olsun
   • Marka kimliğinize uygun resimler seçin

Hızlı İşlemler

• Toplu Resim Yükleme: Şu an desteklenmiyor, her yer için ayrı ayrı yükleme yapın
• Resim Düzenleme: Yüklemeden önce resmi düzenleyin, sistem içinde düzenleme yok
• Yedekleme: Önemli resimlerin yedeğini bilgisayarınızda saklayın

✅ Kontrol Listesi

Resim yüklemeden önce:

• Dosya boyutu 1MB'dan küçük mü?
• Dosya formatı PNG, JPG veya WEBP mi?
• Resim kalitesi yeterli mi?
• Resim boyutları uygun mu?
• Resim içeriği uygun mu? (telif hakkı, vb.)

Resim yüklendikten sonra:

• Önizleme doğru görünüyor mu?
• URL otomatik olarak eklendi mi?
• Form kaydedildi mi?
• Resim canlı sitede görünüyor mu?