# Homelli Snippet - Hızlı Kurulum Rehberi

Bu rehber, eklentiyi kurup çalıştırmanız için gereken tüm adımları içerir.

## 📋 İçindekiler

1. [Eklenti Kurulumu](#eklenti-kurulumu)
2. [İlk Snippet Ekleme](#ilk-snippet-ekleme)
3. [Sunucu Senkronizasyonu (Opsiyonel)](#sunucu-senkronizasyonu)
4. [JSON İçe Aktarma](#json-içe-aktarma)

---

## 1. Eklenti Kurulumu

### Chrome'a Yükleme

1. Bu projeyi bilgisayarınıza indirin veya klonlayın
2. Chrome tarayıcısını açın
3. Adres çubuğuna `chrome://extensions/` yazın ve Enter'a basın
4. Sağ üst köşeden **"Geliştirici modu"** anahtarını açın
5. **"Paketlenmemiş öğe yükle"** butonuna tıklayın
6. İndirdiğiniz klasörü seçin
7. Eklenti yüklendi! Chrome toolbar'da eklenti ikonunu göreceksiniz

### İlk Açılış

1. Chrome toolbar'da eklenti ikonuna tıklayın
2. Boş bir popup açılacak (henüz snippet yok)
3. **"İlk Snippet'i Oluştur"** butonuna tıklayın

---

## 2. İlk Snippet Ekleme

### Yeni Snippet Oluşturma

1. Popup'ta **"Yeni"** butonuna tıklayın
2. **Kısayol Adı** alanına bir kısayol girin (örn: `selamla`)
   - Boşluk içermemeli
   - Türkçe karakterler kullanabilirsiniz (ğ, ü, ş, ı, ö, ç)
   - Sadece harf, rakam, tire ve alt çizgi kullanın
3. **Snippet Metni** alanına mesajınızı yazın (örn: "Merhaba! Size nasıl yardımcı olabilirim?")
4. **Kaydet** butonuna tıklayın

### Snippet Kullanma

1. WhatsApp Web, Facebook, Instagram veya herhangi bir web sitesini açın
2. Bir metin alanına tıklayın
3. `//selamla` yazın (kısayol adınızı kullanın)
4. Snippet otomatik olarak eklenecek!

### Örnek Snippet'ler

İşte başlangıç için bazı öneriler:

| Kısayol | Metin |
|---------|-------|
| `selamla` | Merhaba! Size nasıl yardımcı olabilirim? |
| `tesekkur` | Teşekkür ederim, iyi günler dilerim! |
| `bilgi` | Ürünümüz hakkında detaylı bilgi için lütfen web sitemizi ziyaret edin. |
| `adres` | Adresimiz: [Adresiniz buraya] |
| `telefon` | Telefon: [Telefon numaranız] |
| `mail` | E-posta: [E-posta adresiniz] |

---

## 3. Sunucu Senkronizasyonu

Birden fazla bilgisayarda aynı snippet'leri kullanmak istiyorsanız, sunucu senkronizasyonunu kurabilirsiniz.

### Gereksinimler

- cPanel hosting hesabı
- PHP 7.4+
- MySQL veritabanı

### Hızlı Kurulum

1. **Sunucu Kurulumu**
   - [Server Kurulum Rehberi](server/README.md) dosyasını takip edin
   - Veritabanı oluşturun
   - Dosyaları yükleyin
   - `config.php` dosyasını düzenleyin

2. **Eklenti Ayarları**
   - Popup'ta sağ alttaki **Ayarlar** (⚙️) butonuna tıklayın
   - **API URL** alanına sunucu adresinizi girin:
     ```
     https://yourdomain.com/snippet-api/api.php
     ```
   - **API Key** alanına `config.php` dosyasındaki API anahtarını girin
   - **Bağlantıyı Test Et** butonuna tıklayın
   - Başarılı mesajı görürseniz **Kaydet** butonuna tıklayın

3. **İlk Senkronizasyon**
   - Popup'ta **Sync** butonuna tıklayın
   - Mevcut snippet'leriniz sunucuya yüklenecek
   - Diğer bilgisayarlarda aynı API bilgilerini kullanarak senkronize edin

### Senkronizasyon Nasıl Çalışır?

- **Push**: Yerel snippet'leriniz sunucuya gönderilir
- **Pull**: Sunucudaki yeni/güncel snippet'ler indirilir
- **Merge**: Çakışmalar otomatik olarak çözülür (en yeni kazanır)
- **Manuel**: Sync butonu ile istediğiniz zaman senkronize edin

---

## 4. JSON İçe Aktarma

Daha önce başka bir snippet eklentisi kullandıysanız veya yedek dosyanız varsa, JSON formatında içe aktarabilirsiniz.

### Desteklenen Format

```json
{
  "version": 1,
  "exportDate": "2026-05-03T10:00:00.000Z",
  "snippets": [
    {
      "shortcut": "selamla",
      "text": "Merhaba! Size nasıl yardımcı olabilirim?",
      "createdAt": 1714737600000,
      "updatedAt": 1714737600000
    }
  ]
}
```

veya eski format:

```json
{
  "version": 1,
  "snippets": {
    "selamla": {
      "text": "Merhaba! Size nasıl yardımcı olabilirim?",
      "category": "Genel",
      "createdAt": 1714737600000,
      "usageCount": 0
    }
  }
}
```

### İçe Aktarma Adımları

1. Popup'ta **İçe Aktar** butonuna tıklayın
2. JSON dosyanızı seçin
3. Çakışma durumunda ne yapılacağını seçin:
   - **Üzerine Yaz**: Mevcut snippet'leri güncelle
   - **Atla**: Mevcut snippet'leri koru, sadece yenileri ekle
4. İşlem tamamlandığında sonuç mesajını göreceksiniz

### Özel Durumlar

- **Türkçe Karakterler**: Otomatik olarak normalize edilir
- **Unicode Karakterler**: Combining diacriticals otomatik temizlenir
- **Geçersiz Kısayollar**: Hata mesajı ile bildirilir
- **Uzun Metinler**: 10,000 karakter limiti vardır

---

## 🎯 Kullanım İpuçları

### Verimlilik

- Sık kullandığınız mesajlar için kısa kısayollar kullanın
- Kategorilere göre kısayol isimleri verin (örn: `destek-`, `satis-`)
- Arama özelliğini kullanarak hızlıca bulun

### Organizasyon

- Benzer snippet'leri gruplandırın
- Düzenli olarak kullanmadıklarınızı silin
- Yedek almayı unutmayın (Dışa Aktar)

### Güvenlik

- API anahtarınızı kimseyle paylaşmayın
- Hassas bilgiler içeren snippet'ler için dikkatli olun
- Düzenli olarak şifrenizi değiştirin

---

## ❓ Sık Sorulan Sorular

### Snippet tetiklenmiyor?

- `//` yazdıktan sonra boşluk bırakmayın
- Kısayol adının doğru olduğundan emin olun
- Sayfayı yenileyin (F5)

### Kaç snippet ekleyebilirim?

- Chrome Local Storage sınırsızdır
- Pratik olarak binlerce snippet ekleyebilirsiniz

### Hangi platformlarda çalışır?

- WhatsApp Web ✅
- Facebook ✅
- Instagram ✅
- Gmail ✅
- Twitter/X ✅
- LinkedIn ✅
- Tüm web siteleri ✅

### Mobilde çalışır mı?

- Hayır, sadece Chrome masaüstü sürümünde çalışır
- Mobil tarayıcılar Chrome eklentilerini desteklemez

### Verilerim güvende mi?

- Evet! Verileriniz sadece tarayıcınızda saklanır
- Sunucu senkronizasyonu opsiyoneldir
- Kendi sunucunuzu kullanırsınız (üçüncü parti yok)

---

## 🆘 Destek

Sorun yaşıyorsanız:

1. [Sorun Giderme](README.md#-sorun-giderme) bölümüne bakın
2. Tarayıcı konsolunu kontrol edin (F12 → Console)
3. GitHub'da issue açın

---

**Homelli Snippet** - Hızlı mesaj şablonları için snippet yöneticisi 🚀