235 lines
6.6 KiB
Markdown
235 lines
6.6 KiB
Markdown
# 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?
|