DLE Commerce Pro — Kullanım Kılavuzu
Eklenti: DLE Commerce Pro v1.0.0 (İlk Yayın)
DLE: 19.0+ / 20.0 uyumlu
Ödeme: Havale / EFT — manuel onay (ödeme ağ geçidi yok)
Mimari: VFS eklenti — DLE çekirdek dosyalarına fiziksel müdahale yokBu kılavuz, eklentiyi sıfırdan kurup canlıya almak için hazırlanmıştır. Kurulum, yapılandırma, günlük kullanım ve sık sorunlar tek dokümanda toplanmıştır.
1. Paket içeriği
| Dosya / klasör | Açıklama |
|---|---|
dle-commerce-pro.xml |
DLE eklenti paketi — Admin’den yüklenir |
commerce/ |
Frontend şablonları (shop, cart, checkout, …) |
dle_commerce_kullanim_kilavuzu_editor.html |
Bu kılavuz (DLE statik sayfaya yapıştırılabilir) |
Kurulum sonrası şablonlar otomatik olarak templates/Default/commerce/ altına kopyalanır. Aktif temanız farklıysa commerce klasörünü kendi temanıza taşıyın.
2. Gereksinimler
| Gereksinim | Açıklama |
|---|---|
| DataLife Engine | 19.0 veya üzeri (20.0 önerilir) |
| PHP | DLE ile uyumlu sürüm; session ve mbstring açık |
| MySQL | Tablolar kurulumda otomatik oluşturulur |
| AJAX (v19+) | index.php?controller=ajax&mod=dle_commerce |
3. Kurulum (ilk kez)
3.1 Eklentiyi yükle
- Admin → Eklentiler → Yükle →
dle-commerce-pro.xmlseçin. - Kurulum tamamlandığında eklenti etkin olmalı.
- Sol menüde DLE Commerce Pro (Mağaza) modülü görünür.
- Önbelleği temizleyin.
3.2 Şablonları kontrol et
/templates/{aktif_tema}/commerce/
shop.tpl, product.tpl, cart.tpl, checkout.tpl, orders.tpl
wishlist.tpl, compare.tpl, addresses.tpl, block_products.tpl
shop.css, commerce.js
3.3 Mağazayı siteye bağla
Menü veya header’a mağaza linki ekleyin:
<a href="/shop/">Mağaza</a>
3.4 Lansman kontrol listesi
- ✓ Eklenti v1.0.0 kuruldu ve aktif
- ✓ Admin → Mağaza → Ayarlar yapılandırıldı
- ✓ Banka hesapları gerçek IBAN ile eklendi
- ✓ Kargo yöntemleri ve isteğe bağlı bölgeler tanımlandı
- ✓ En az 1 kategori + test ürünü yayında
- ✓
/shop/açılıyor, test siparişi + havale bildirimi denendi - ✓ Mobil sepet ve ödeme sayfası test edildi
Önemli: Sipariş havale ile tamamlanır. Ödeme admin onayına kadar stok rezerve edilir; ödeme onayında kesinleşir. Otomatik kart ödemesi yoktur.
4. Özellik özeti (v1.0.1)
| Özellik | Açıklama |
|---|---|
| Ürün & varyasyon | Global nitelikler, kartezyen varyasyon matrisi, galeri, SEO |
| Kategori ağacı | DLE native nestable sürükle-bırak, AJAX sıralama |
| Marka | Marka sayfaları ve mağaza filtreleri |
| Stok rezervasyonu | Havale beklerken rezerve; onayda kesin stok düşümü |
| Havale bildirimi | Dekont yükleme, güvenli private depolama |
| Kargo bölgeleri | İl/ilçe bazlı ücret matrisi, checkout AJAX hesaplama |
| Kuponlar | Ürün, kategori ve marka kısıtlaması |
| Mağaza filtreleri | Marka, fiyat, stokta, indirimli |
| Karşılaştırma | Ürün karşılaştırma listesi (limit ayarlanabilir) |
| Favoriler & adresler | Üye favori listesi ve adres defteri |
| Raporlama & log | Satış raporu, stok log, audit log |
5. Admin panel
| Menü | İşlev |
|---|---|
| Panel | Gelir, bekleyen sipariş, havale bildirimi, stok uyarıları |
| Ürünler | Ekleme, düzenleme, varyasyon matrisi, özellik tablosu |
| Siparişler | Durum, kargo takip, fatura/etiket, ödeme onayı |
| Havale | Bildirim listesi, dekont inceleme |
| İadeler | İade talep yönetimi |
| Diğer | Kategori, marka, nitelikler, yorum, kupon, kargo, ödeme, banka, rapor, log, e-posta, ayarlar |
6. Ürün yönetimi
6.1 Kategoriler
- Sürükle-bırak ile sıralama; alt kategori desteği
- Görsel ve SEO alanları
- URL:
/shop/category/{slug}/
6.2 Varyasyon matrisi
- Varyasyon Özellikleri — Renk, Beden vb. tanımlayın.
- Ürün düzenle → özellikleri atayın.
- Matris oluştur — tüm kombinasyonlar otomatik üretilir.
- Her varyasyona fiyat, stok, SKU verin.
6.3 Markalar
URL: /shop/brand/{slug}/ — mağaza sidebar filtrelerinde kullanılır.
7. Havale sipariş akışı
| Adım | Kim / ne |
|---|---|
| 1 | Müşteri sepete ekler, checkout’ta siparişi tamamlar |
| 2 | Sipariş bekliyor, stok rezerve |
| 3 | Checkout’ta banka bilgileri görünür |
| 4 | Müşteri havale yapar, Havale Bildirimi gönderir (isteğe bağlı dekont) |
| 5 | Admin sipariş detayında Ödemeyi Onayla |
| 6 | Stok kesinleşir, sipariş işleme alınır |
Otomatik iptal: Ayarlar → belirtilen saat içinde ödenmeyen siparişler iptal edilir (0 = kapalı).
8. Kargo ve kuponlar
8.1 Kargo
- Yöntemler: sabit ücret, ücretsiz, ücretsiz kargo alt sınırı
- Bölgeler: il/ilçe listesi + yöntem bazlı ücret matrisi
- Checkout’ta il değişince ücret AJAX ile güncellenir
8.2 Kuponlar
- Sabit veya yüzde indirim; min. tutar, kullanım limiti, tarih aralığı
- Ürün / kategori / marka kısıtlaması — sadece uygun kalemlere uygulanır
9. Frontend URL’ler
| Sayfa | URL |
|---|---|
| Mağaza | /shop/ |
| Kategori | /shop/category/{slug}/ |
| Marka | /shop/brand/{slug}/ |
| Ürün | /shop/product/{slug}/ |
| Sepet | /shop/cart/ |
| Ödeme | /shop/checkout/ |
| Siparişler | /shop/orders/ |
| Favoriler | /shop/wishlist/ (giriş gerekli) |
| Karşılaştır | /shop/compare/ |
| Adresler | /shop/addresses/ (giriş gerekli) |
10. Şablonlar ve {customcommerce}
Şablonlar templates/{skin}/commerce/ altında. Inline döngü kullanır ([product_item] vb.).
Anasayfada ürün bloğu:
{customcommerce available="global" limit="8" order="newest" title="Öne Çıkan Ürünler" featured="yes" link="/shop/"}
Parametreler: limit, category, brand, order (newest, price_asc, price_desc, popular, sales, featured), featured="yes", sale="yes", title, link, template.
11. Ayarlar
| Ayar | Öneri |
|---|---|
| Para birimi | TRY / TL |
| KDV | 20% (sınıf bazlı JSON) |
| Misafir alışverişi | İhtiyaca göre |
| Otomatik iptal | 48 saat (havale için uygun) |
| Karşılaştırma | Açık, limit 4 |
| Dekont yükleme | Açık |
| Sayfa başına ürün | 12 |
| Mağaza e-postası | Gerçek bildirim adresi |
12. Güvenlik notları
- Tüm AJAX istekleri
user_hash/ CSRF ile korunur - Dekontlar
engine/data/commerce_receipts/— web’den doğrudan erişilemez - Sipariş, kupon ve bildirimlerde rate limit uygulanır
- Admin işlemleri audit log’a yazılır
13. Güncelleme (ileri sürümler)
v1.0.0 sonrası yeni sürüm çıktığında:
- Yeni
dle-commerce-pro.xmlile Admin → Eklentiler → Güncelle commerce/şablon vecommerce.jsdosyalarını aktif temada güncelleyin- Önbelleği temizleyin
Mevcut sipariş ve ürün verileri korunur; mysqlupgrade yeni tabloları ekler.
14. Sık sorulan sorunlar
| Sorun | Çözüm |
|---|---|
/shop/ 404 |
Eklenti aktif mi? Cache temizleyin; URL kuralları kurulumda eklenir |
| AJAX CSRF hatası | Sayfayı yenileyin; giriş hash kontrolü |
| Sepet çalışmıyor | commerce.js yüklü mü? AJAX URL v19 formatında olmalı |
| Ödeme onayı sonrası stok | Sipariş detay → Ödemeyi Onayla |
| Kupon geçersiz | Kısıtlama (ürün/kategori/marka) — uygun ürün ekleyin |
| Şablon değişmiyor | DLE cache + Ctrl+F5 |
| Türkçe bozuk (e-posta) | Admin → E-posta şablonlarını düzenleyin; XML UTF-8 BOM’suz olmalı |
15. Canlıya alma — son kontrol
- Gerçek banka IBAN ve hesap sahibi bilgileri
- Kargo ücretleri test edildi (en az 2 farklı il)
- Tam döngü: sepet → sipariş → havale bildirimi → admin onay
- E-posta şablonları Türkçe ve doğru
- Menüde
/shop/linki - Mobil test: ürün, sepet, ödeme
- Eklenti sürümü: 1.0.0
DLE Commerce Pro v1.0.0 · İlk Yayın · DLE 19/20
Destek ve güncellemeler için satın aldığınız kanalı kullanın.
Sürüm geçmişi
DLE Commerce Pro — Kritik Düzeltmeler & Seviye Atlama (26.08.2026) (v1.0.1)
Yapılan Kritik Düzeltmelerin ve Seviye Atlamanın Özeti:
-
Kısmi İade & Stok İadesi (_commerce_return_items):
-
Artık tüm sipariş körü körüne depoya iade edilmiyor. Admin panelinde iade edilen ürünler ve adetleri tek tek seçiliyor, sadece iade edilen kalemlerin stoğu depoya dönüyor (stock_released).
-
-
Atomik Çift Aşamalı Stok Rezervasyonu:
-
products ve variations tablolarına reserved_stock eklendi.
-
Havale/EFT siparişlerinde stok düşmüyor; (stock - reserved_stock) >= qty formülüyle atomik olarak rezerve ediliyor. Ödeme onaylandığında commit_order_stock() ile fiziksel stoktan kalıcı düşüyor.
-
-
Varyasyon Bazlı Stok Alarmı (_commerce_stock_alerts):
-
variation_id entegre edildi. Artık kullanıcı tükenen "XL Beden" veya "Siyah Renk" için alarm kurabiliyor; o varyasyon stoğa girdiğinde sadece o varyasyonu bekleyenlere mail gidiyor.
-
commerce.js varyasyon seçildiğinde formun görünürlüğünü dinamik senkronize ediyor.
-
-
Gerçek Kargo Ağırlık (weight) Motoru:
-
calculate_cart_weight() ve calculate_order_items_weight() fonksiyonlarıyla sepetteki ürünlerin gramaj/kg toplamı hesaplanıp ağırlık bazlı kargo yöntemlerine çarpılarak yansıtılıyor.
-
-
Tokenlı Güvenli Dekont Yaşam Döngüsü & Stream:
-
32 karakterlik rastgele dosya adı (random_bytes(16)), private dizin (ENGINE_DIR/data/commerce_receipts/), access_token_hash doğrulaması ve shop/receipt/?id=X&token=Y stream endpoint'i tamam.
-
-
Bireysel/Kurumsal Fatura Snapshot Sistemi (_commerce_order_addresses):
-
Sipariş anındaki adres, TCKN, VKN, Vergi Dairesi ve Şirket Unvanı kilitli snapshot olarak kaydediliyor. TCKN/VKN zorunlulukları mağaza ayarlarından yönetilebiliyor.
-
-
Kurumsal Audit Log:
-
Eylem whitelist'i, product.price_changed, payment_notification.approved, hassas veri maskeleme ve sayfalanmış salt-okunur admin paneli hazır.
-
-
Saf Inline Şablon Mimarisi:
-
shop_item.tpl gereksinimi çekirdekten kaldırıldı, dahili fallback motoruna bağlandı.
-
