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 yok

Bu 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

  1. Admin → Eklentiler → Yükle → dle-commerce-pro.xml seçin.
  2. Kurulum tamamlandığında eklenti etkin olmalı.
  3. Sol menüde DLE Commerce Pro (Mağaza) modülü görünür.
  4. Ö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

Ö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

6.2 Varyasyon matrisi

  1. Varyasyon Özellikleri — Renk, Beden vb. tanımlayın.
  2. Ürün düzenle → özellikleri atayın.
  3. Matris oluştur — tüm kombinasyonlar otomatik üretilir.
  4. 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

8.2 Kuponlar

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ı

13. Güncelleme (ileri sürümler)

v1.0.0 sonrası yeni sürüm çıktığında:

  1. Yeni dle-commerce-pro.xml ile Admin → Eklentiler → Güncelle
  2. commerce/ şablon ve commerce.js dosyalarını aktif temada güncelleyin
  3. Ö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

  1. Gerçek banka IBAN ve hesap sahibi bilgileri
  2. Kargo ücretleri test edildi (en az 2 farklı il)
  3. Tam döngü: sepet → sipariş → havale bildirimi → admin onay
  4. E-posta şablonları Türkçe ve doğru
  5. Menüde /shop/ linki
  6. Mobil test: ürün, sepet, ödeme
  7. 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.



Dosya İndirme Kilitli