# 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?
