## CargoHub – Kargo Takip Sistemi

WooCommerce mağazaları için ücretsiz ve hafif kargo takip eklentisi. Siparişlere kargo firması ve takip numarası ekleyin, müşterilerinize e-posta bildirimi gönderin ve Hesabım sayfasında takip bilgilerini gösterin.

### Özellikler
- Özel kargo firmaları ekleme/düzenleme (sınırsız)
- Siparişe kargo firması ve isteğe bağlı takip numarası ekleme
- Takip numarası olmasa da kargoya verilme e-posta bildirimi
- “Hesabım > Siparişler” ve “Sipariş Detayı” entegrasyonu
- HPOS uyumluluğu bildirimi (WooCommerce Custom Order Tables)
- Mobil uyumlu admin ve ön yüz stilleri
- Güvenli çıktı (escape late), nonce ve sanitize/validate özenli kullanımı

### Gereksinimler
- WordPress ≥ 5.0 (Tested up to: 7.1)
- WooCommerce ≥ 5.0 (WC tested up to: 9.5)
- PHP ≥ 7.3

### Kurulum
1. Eklenti klasörünü `wp-content/plugins/cargohub-kargo-takip` altına yükleyin.
2. WordPress yönetim panelinden eklentiyi etkinleştirin.
3. WooCommerce’in etkin olduğundan emin olun.
4. Yönetim menüsünden “CargoHub” sayfasını açın ve kargo firmalarınızı ekleyin.
5. Sipariş düzenleme ekranından kargo firmasını seçin; varsa takip numarasını girin.

### Kullanım İpuçları
- Sipariş kargoya verildiğinde müşteriye otomatik e-posta gönderilir; takip numarası boşsa e-postada `-` gösterilir.
- Takip numarası için firmaya özel biçim kısıtlaması uygulanmaz.
- “Hesabım > Siparişler” ve “Sipariş Detayı” sayfalarında takip bilgisi ve bağlantısı görüntülenir.
- Hata logları, `uploads` altında siteye özel ve tahmin edilemeyen korumalı bir CargoHub klasöründe tutulur.
- İstenirse `wp-config.php` içinde `CARGOHUB_FREE_LOG_DIR` tanımlanarak web kökü dışındaki özel bir klasör kullanılabilir.

### Gizlilik ve Güvenlik
- Kişisel verileri harici servislere iletmez; tüm veriler WordPress veritabanında saklanır.
- Çıktı kaçışları (esc_*) ve nonce doğrulamaları uygulanır.
- Eklenti silindiğinde siparişler, kargo firmaları ve aktif takip kayıtları korunur.
- "Kargoya Verildi" durumundaki siparişler görünür kalmaları için güvenli biçimde "Tamamlandı" durumuna dönüştürülür.
- Geçici loglar, cache kayıtları ve silinmiş takip kayıtları temizlenir.
- Loglardaki yaygın kişisel/gizli veriler maskelenir; günlük dosya 5 MB, toplam log alanı 50 MB ve saklama süresi 30 gün ile sınırlandırılır.

### Çeviri
- Metin alan adı (text domain): `cargohub-kargo-takip`
- POT dosyası: `languages/cargohub-kargo-takip.pot`

### Lisans
GPL-2.0-or-later

### Destek ve PRO
- WordPress.org destek forumu üzerinden destek alabilirsiniz.
- PRO sürüm (SMS entegrasyonları vb.) WordPress.org dışında sunulur.