=== Bolcal Satış Yönetimi ===
Geliştirici: Bolcal Yazılım
Sürüm: 1.3.0
Gereksinim: WordPress, WooCommerce, PHP 7.4+

KURULUM VE GÜNCELLEME
1. WordPress > Eklentiler > Yeni Ekle > Eklenti Yükle bölümünden ZIP'i seçin.
2. Sitede 1.0.0 veya 1.1.0 varsa aynı klasör adına kurulacaktır. WordPress güncelleme onayı isterse değiştirin.
3. Satış Yönetimi > Ayarlar > Rapor Para Birimi'ni doğrulayın. Alfa için TRY seçilebilir.
4. Satış Yönetimi > Genel Bakış menüsünden gerçek siparişlerle tutarları karşılaştırın.
5. Verileri Yenile düğmesi tüm rapor önbelleği için yeni nesil oluşturur.

1.2.0 - PAYLAŞIM, RAPOR DİLİ VE SİPARİŞ TAKİBİ
- WhatsApp metninden bozuk karakter üretebilen emojiler kaldırıldı; sade Türkçe,
  satır satır anlaşılır, URL kodlamalı satış özeti oluşturulur.
- WhatsApp'ta Paylaş ve Özeti Kopyala ayrı seçeneklerdir.
- PDF ve Excel/CSV dosyalarının adı otomatik olarak bu WordPress sitesinin başlığı
  (Ayarlar > Genel > Site Başlığı) ve seçilen tarih aralığından türetilir.
- PDF üst başlığına "SATIŞ PERFORMANSI RAPORU" ve mağaza adı yazılır.
- "Satış Siparişi" ifadesi açıklayıcı "Satışa Dahil Siparişler" olarak değiştirildi.
  "Toplam Siparişler" diğer sipariş durumlarını da kapsar.
- İşleme alınan, tamamlanan, ödeme bekleyen, başarısız vb. sipariş durumları
  için yeni özet paneli, PDF bölümü ve CSV satırları eklendi.
- Excel ile açılabilir UTF-8 BOM'lu noktalı virgül ayrımlı CSV indirilebilir.
  CSV hücrelerinde formül enjeksiyonuna karşı baştaki formül işaretleri korunur.
- Her site kendi raporunu oluşturur; merkezi sisteme sipariş aktarılmaz.

1.1.0 - ÖNEMLİ DÜZELTMELER
- Günlük ciro ve sipariş sayısı artık gecikebilen wc_order_stats Analytics özeti yerine
  WooCommerce wc_get_orders() API'si üzerinden hesaplanıyor. HPOS ve klasik sipariş
  depolaması destekleniyor.
- Başlangıç ekranında günün tüm sipariş sayısı ve satışa dahil edilen sipariş sayısı ayrı.
- Sipariş toplamı, kaydedilmiş iadeler düştükten sonra alınır.
- Para birimi bağımsız rapor ayarı eklendi: Otomatik / TRY / USD / EUR / GBP / CHF / AED.
- Aelia kur dönüşüm filtresi wc_aelia_cs_convert; sipariş baz döviz tutarı alanı
  _order_total_base_currency kullanılabiliyor. Aelia hiç kurulu değilken de çalışır.
- Kur çevrilemezse dövizler toplanmaz; eksik tutar varsa yöneticiye uyarı gösterilir.
- Satış Raporunu Paylaş: gerçek, çok sayfalı PDF indir, PDF'yi cihaz paylaşım ekranında
  aç (uygun tarayıcılarda), WhatsApp satış özetini gönder. PDF kütüphanesiz üretilir.
- PDF Türkçe karakterleri korur; resim tabanlı olduğu için metin seçilemez.
- Yönetici başlığına karışan dış eklenti bildirimleri üstte ayrı beyaz alana taşınır.
- Yeni sipariş, durum güncellemesi veya iadede önbellek geçersiz kılınır.
- Otomatik vitrinlerin ön yüz verisi hızlı indeksli sorgu kullanır; ziyaretçilerde
  ağır sipariş taraması yapılmaz.

RAPOR KURALLARI
- Satış tutarına varsayılan olarak yalnızca processing ve completed siparişleri girer.
- İsteğe bağlı on-hold durumu Ayarlar'dan dahil edilebilir.
- Tüm siparişler metriğinde bekleyen/iptal/başarısız vb. durumlar da sayılır.
- Seçilen dönem en fazla 2.500 son satış siparişi taranır. Daha büyük raporlarda
  eksik hesap uyarısı çıkar; kısa bir tarih seçilmesi gerekir.
- Sipariş ve ürün verileri 5 dakika (değiştirilebilir) önbelleğe alınır.
- İlk uzun dönem raporu açılışı daha yavaş olabilir. Ziyaretçiler bu raporları sorgulamaz.
- Aelia harici bir döviz eklentisi kullanılıyorsa otomatik kur çevrimi garanti değildir.
- Aelia ile geçmiş dönemin baz para birimi tutarı siparişte varsa kullanılır; rapor
  para birimi farklıysa Aelia'nın mevcut dönüşüm oranı uygulanabilir. Bu nedenle
  tarihsel karşılaştırma muhasebe kaydı olarak kullanılmamalıdır.
- Ürün ve kategori gelirleri kaydedilmiş kalem iadelerini dikkate alır.
  Ciro, ürün geliri ve adet toplamları kargo/vergi/kupon/yuvarlama nedeniyle farklı olabilir.
- PDF yönetici tarayıcısında oluşturulur. İsim/e-posta gibi müşteri bilgileri
  PDF'ye konmaz. WhatsApp'a metin iletimi yalnızca yöneticinin tıklamasıyla olur.
  Masaüstü WhatsApp bağlantısı PDF dosyasını otomatik ekleyemez.

KISA KODLAR
[bolcal_vitrin tip="cok_satan" gun="7" limit="10" sutun="5"]
[bolcal_vitrin tip="yukselen" gun="14" limit="10" sutun="5"]
[bolcal_vitrin tip="manuel" alan="ana" limit="10" sutun="5"]
[bolcal_vitrin tip="indirimli" limit="10" sutun="5"]
[bolcal_vitrin tip="yeni" limit="10" sutun="5"]
[bolcal_tamamlayici limit="4"]

Ürün kartları WooCommerce [products] kısa kodu üzerinden mevcut temayla uyumludur.
Canlı kurulumdan önce test sitesinde Motta, Elementor, Discount Rules Pro,
Aelia ve ödeme yöntemi birlikte sınanmalıdır. Satış verileri başka yere aktarılmaz.

1.2.0 NOTLAR
- WooCommerce'de "İşleme alınıyor" ve "Tamamlandı" durumları varsayılan olarak ciroya
  dahil edilir; "Beklemede" yalnızca Ayarlar'da seçiliyse dahil edilir.
- WhatsApp'tan PDF doğrudan dosya olarak gönderimi masaüstünde desteklenmeyebilir.
  Böyle durumlarda "PDF İndir" ve WhatsApp'ta dosya ekleme kullanılmalıdır.
- CSV dosyasında satılan ürün/kategori ve gün bazlı analiz özetleri bulunur;
  müşteri isimleri, e-postalar veya telefonlar dışa aktarılmaz.


1.3.0 - SEPET TAKİBİ VE HATIRLATMA
- Yeni Satış Yönetimi > Sepet Takibi sekmesi. 30 günün en çok sepete eklenen ürünleri
  ve miktarları. Bu ölçüm 1.3.0 kurulduktan sonra başlar, geçmiş veriyi tahmin etmez.
- Misafir ve kayıtlı müşterinin ödeme sayfasında geçerli e-posta girildiğinde sepete
  ait ürünler / varyasyonlar, sepet tutarı, varsa telefon/ad, tarih ve ileti izni saklanır.
- Hem klasik ödeme ekranı hem WooCommerce Blok Ödeme alanı için isteğe bağlı
  'sepet hatırlatma e-postası' kutusu; varsayılan işaretsizdir.
- Yetkili yöneticiler terk sepetleri görür, izin varsa elle e-posta gönderir veya
  otomatik zamanlayıcıyı açabilir. Otomatik e-posta varsayılan KAPALI.
- İlk hatırlatma süresi, tekrar süresi, maksimum tekrar, veri saklama ayarlanabilir.
- İmzalı, 14 gün geçerli sepet geri yükleme bağlantısı. Stoklar/fiyatlar yenilenir;
  stok dışı ürünler atlanabilir.
- Ödeme gerçekleşirse hatırlatmalar durur; eskiden terk edilen sepet için
  ödeme tamamlandıysa kurtarılan sepet olarak işaretlenir.
- Her sepet için hatırlatma iptal bağlantısı, kişisel verilerin otomatik temizlenmesi.
- E-posta altyapısı WordPress wp_mail üzerinden çalışır (SMTP gerekebilir).
- WP-Cron site trafiğine bağlıdır; tam dakika garantisi yoktur.
- Hiçbir müşteri verisi dış servise / Bolcal sunucularına aktarılmaz.
- Önemli: Siteye giriş veya e-postanın girilmiş olması ileti izni sayılmaz.
  Yönetici, geçerli aydınlatma ve ileti izinlerini sağlamaktan sorumludur.
- PHP, JavaScript ve ZIP paket kontrolleri yapılmıştır. Gerçek ödeme yöntemi,
  tema ve Checkout Blocks sürümlerinde canlı/test siparişleriyle doğrulayın.
