# Hedef Sanal POS

WooCommerce için çoklu banka / tek POS destekli Hedef Sanal POS eklentisi.

## Özellikler

### Ödeme altyapısı
- WooCommerce ödeme geçidi olarak çalışır ve başlık, açıklama, test modu, loglama gibi temel alanlarla yönetilir. Gateway test modu açıkken ödeme ekranında uyarı gösterir ve kayıtlı kartlar ile taksit planlarını birlikte sunar.【F:src/Gateways/Hedefsp_WC_Gateway_HedefSanalPos.php†L16-L119】
- Gate motoru ile en düşük komisyonlu veya öncelikli POS'a otomatik yönlendirme yapılır; bankalar arası seçim için komisyon tablosu, öncelik ve varsayılan POS tanımları kullanılır.【F:src/Gateways/Router.php†L18-L83】
- Akbank JSON, Garanti BBVA, İş Bankası, QNB, Ziraat, PayTR ve test amaçlı Fake POS connector'ları desteklenir; charge, refund, void işlemleri doğru bankaya aktarılır.【F:src/Gateways/Router.php†L5-L69】【F:src/Gateways/Router.php†L92-L139】
- 3D Secure dönüşleri için Akbank, Garanti, QNB, PayTR ve Ziraat callback handler'ları otomatik bağlanır.【F:src/Bootstrap.php†L5-L51】
- Test modu, global ayarlar ve gate yapılandırması tek `hedefsp_settings` option'ında tutulur; döviz kuru, taksit sınırı, başarısız işlem e-postaları gibi anahtarlar buradan yönetilir.【F:src/Service/Options.php†L9-L52】
- TCMB today.xml veya manuel kur bilgileriyle farklı para birimindeki siparişlerin TRY karşılığı otomatik hesaplanır; kur filtresi ile geliştirici müdahalesi desteklenir.【F:src/Service/CurrencyService.php†L1-L91】

### Taksit ve ücretlendirme
- Ürün, kategori ve global seviyede maksimum taksit kuralı belirlenir; en sıkı kural sepet için geçerli olacak şekilde hesaplanır.【F:src/Service/InstallmentService.php†L11-L67】
- Gate ayarlarına göre banka bazlı komisyon oranlarıyla taksit planı, aylık ödeme ve toplam tutar sunulur; komisyon bulunamadığında varsayılan tablolara düşer.【F:src/Service/InstallmentService.php†L69-L128】
- Sepette seçilen taksit için ek komisyon otomatik olarak siparişe ücret kalemi olarak eklenir ve toplamlar yeniden hesaplanır.【F:src/Gateways/Router.php†L102-L138】

### Kart saklama ve müşteri deneyimi
- Kayıtlı kartlar checkout ekranında listelenir; yeni kart kaydetme seçeneği ve kart teması (açık/koyu) desteklenir.【F:src/Gateways/Hedefsp_WC_Gateway_HedefSanalPos.php†L58-L117】
- "Hesabım > Kayıtlı Kartlarım" sekmesi eklenir; kullanıcılar kartları görüntüleyip silebilir veya varsayılan kart atayabilir, endpoint kalıcı olsun diye rewrite kuralları kontrol edilir.【F:src/Account/SavedCardsEndpoint.php†L9-L82】【F:src/Account/SavedCardsEndpoint.php†L103-L159】

### Yönetim ve raporlama
- Admin tarafında özel menü, genel ayarlar, banka ayarları, gate (yönlendirme) ayarları, taksit meta alanları, işlemler listesi, sipariş detay kutusu (void/refund aksiyonları) ve dashboard ekranı (bugünkü ciro, haftalık işlem, başarısız işlemler) etkinleştirilir.【F:src/Bootstrap.php†L53-L98】
- Başarılı ve başarısız tüm denemeler `wp_hedefsp_transactions` tablosunda saklanır; dashboard özetleri ve tarih/banka/durum filtreli işlem sorguları bu tablodan üretilir.【F:src/Model/Transaction.php†L1-L110】【F:src/Model/Transaction.php†L112-L206】
- Admin e-posta bildirimleri için başarısız işlem uyarısı ayarı bulunur (genel ayarlar üzerinden).【F:src/Service/Options.php†L20-L44】

### Arayüz ve entegrasyon
- Frontend için checkout, taksit tablosu ve taksitli fiyat gösterimleri otomatik enque edilir; ürün/sepet/sipariş tamamlama ekranlarına uyumlu çalışır.【F:src/Bootstrap.php†L35-L75】
- Elementor yüklüyse eklenti otomatik entegre olur ve gerekli widget/öğeleri hazırlar.【F:src/Bootstrap.php†L29-L38】
- Eklenti etkinleştiğinde işlem tablosu oluşturulur ve "Kayıtlı Kartlarım" endpoint'i için rewrite kuralları flush edilir.【F:src/Install.php†L1-L19】

## Kurulum

1. Eklentiyi `wp-content/plugins/Hedef-Sanal-POS` klasörüne kopyalayın.
2. WordPress admin panelinden **Eklentiler > Yüklü Eklentiler** bölümünden etkinleştirin.
3. **WooCommerce > Ayarlar > Ödemeler** sekmesinden "Hedef Sanal POS" geçidini aktif edin.
4. Admin menüsündeki **Hedef Sanal POS** menüsünden:
   - Genel Ayarlar
   - Banka Ayarları
   - Gate (Yönlendirme) Ayarları
   - Taksit & Komisyon tablolarını yapılandırın.

## Lisans
GPLv2 veya sonraki sürüm.
