# Homelli Snippet - Hızlı Referans Kartı

## 🚀 Hızlı Başlangıç

### Snippet Kullanma
```
//kısayoladı
```
Örnek: `//selamla` → "Merhaba! Size nasıl yardımcı olabilirim?"

### Yeni Snippet Ekleme
1. Eklenti ikonuna tıkla
2. **Yeni** butonuna tıkla
3. Kısayol ve metin gir
4. **Kaydet**

---

## ⚙️ Sunucu Senkronizasyonu

### Sunucu Kurulumu (Tek Seferlik)

```bash
# 1. Veritabanı oluştur (cPanel → MySQL Databases)
Veritabanı: username_snippets
Kullanıcı: username_snippetuser
Şifre: [güçlü şifre]

# 2. Tabloları oluştur (phpMyAdmin → SQL)
database.sql dosyasını çalıştır

# 3. Dosyaları yükle (File Manager/FTP)
public_html/snippet-api/
  ├── api.php
  ├── config.php
  └── .htaccess

# 4. config.php düzenle
DB_NAME: username_snippets
DB_USER: username_snippetuser
DB_PASS: [şifreniz]
API_KEY: [kaydedin!]
```

### Eklenti Ayarları

```
1. Popup → Ayarlar (⚙️)
2. API URL: https://yourdomain.com/snippet-api/api.php
3. API Key: [config.php'deki anahtar]
4. Bağlantıyı Test Et
5. Kaydet
```

### Senkronizasyon

```
Popup → Sync butonu
```

---

## 📝 Kısayol Kuralları

### ✅ Geçerli
- `selamla`
- `tesekkur`
- `bilgi-1`
- `destek_mesaj`
- `müşteri` (Türkçe karakter)

### ❌ Geçersiz
- `selam la` (boşluk)
- `merhaba!` (özel karakter)
- `@destek` (@ işareti)

---

## 🔧 Klavye Kısayolları

| Kısayol | Açıklama |
|---------|----------|
| `Ctrl/Cmd + K` | Arama kutusuna odaklan |
| `Ctrl/Cmd + N` | Yeni snippet ekle |
| `Esc` | Modal'ı kapat |

---

## 📊 API Endpoint'leri

### Stats (Test)
```bash
GET /api.php?action=stats
Header: X-API-Key: [your-key]
```

### Sync (Çek)
```bash
GET /api.php?action=sync&since=1714737600000
Header: X-API-Key: [your-key]
```

### Push (Gönder)
```bash
POST /api.php?action=push
Header: X-API-Key: [your-key]
Content-Type: application/json
Body: {"snippets": [...]}
```

### Delete (Sil)
```bash
DELETE /api.php?action=delete&id=uuid
Header: X-API-Key: [your-key]
```

---

## 🐛 Hızlı Sorun Giderme

### Snippet tetiklenmiyor
```
✓ // yazdıktan sonra boşluk yok mu?
✓ Kısayol doğru mu?
✓ Sayfayı yenile (F5)
```

### Sync çalışmıyor
```
✓ API URL doğru mu?
✓ API Key doğru mu?
✓ Bağlantıyı Test Et
✓ İnternet bağlantısı var mı?
```

### Unauthorized hatası
```
✓ API Key config.php ile aynı mı?
✓ X-API-Key header gönderiliyor mu?
```

### Database connection failed
```
✓ DB bilgileri doğru mu?
✓ Kullanıcı yetkileri var mı?
✓ MySQL servisi çalışıyor mu?
```

---

## 📦 JSON Format

### Dışa Aktarma
```json
{
  "version": 1,
  "exportDate": "2026-05-03T10:00:00.000Z",
  "snippets": [
    {
      "shortcut": "selamla",
      "text": "Merhaba!",
      "createdAt": 1714737600000,
      "updatedAt": 1714737600000
    }
  ]
}
```

### İçe Aktarma
```
Popup → İçe Aktar → JSON seç → Üzerine Yaz/Atla
```

---

## 🔒 Güvenlik Kontrol Listesi

- [ ] HTTPS kullanılıyor
- [ ] API anahtarı güçlü (64+ karakter)
- [ ] config.php izinleri 600/644
- [ ] .htaccess yüklendi
- [ ] API anahtarı paylaşılmadı
- [ ] Düzenli yedek alınıyor

---

## 📱 Desteklenen Platformlar

| Platform | Durum |
|----------|-------|
| WhatsApp Web | ✅ |
| Facebook | ✅ |
| Instagram | ✅ |
| Gmail | ✅ |
| Twitter/X | ✅ |
| LinkedIn | ✅ |
| Diğer siteler | ✅ |

---

## 💡 İpuçları

### Verimlilik
- Sık kullanılanlar için kısa kısayollar
- Kategorilere göre isimlendirme (`destek-`, `satis-`)
- Arama özelliğini kullan

### Organizasyon
- Benzer snippet'leri grupla
- Kullanmayanları sil
- Düzenli yedek al

### Güvenlik
- API anahtarını sakla
- Hassas bilgilere dikkat
- Düzenli şifre değiştir

---

## 📞 Destek

- 📖 [README.md](README.md) - Detaylı dokümantasyon
- 🚀 [SETUP-GUIDE.md](SETUP-GUIDE.md) - Kurulum rehberi
- 🖥️ [server/README.md](server/README.md) - Sunucu kurulumu
- 🐛 GitHub Issues - Sorun bildirimi

---

**Başarılar! 🎉**