DataSSL Panel v2 Yayında! — Yeni DataSSL Panel v2 ile daha modern, hızlı ve kullanıcı dostu bir deneyim sunuyoruz.Yenilikler:Modern ve responsive ta...
Anasayfa İletişim

Modül Kurulum Rehberi

WHMCS ve WISECP için SSL sertifika otomasyon modüllerinin adım adım kurulum ve yapılandırma rehberi

WHMCS 7.x / 8.x / 9.x WISECP Tüm Sürümler Sunucusuz Kurulum ~5 Dakika
Sunucusuz Mimari: Modüller API bilgilerini içinde gömülü olarak taşır. Sunucu eklemenize, API URL veya API Key girmenize gerek yoktur. İndirdiğiniz modül sizin bayi hesabınıza özel olarak oluşturulur.

Sistem Gereksinimleri

WHMCS

  • WHMCS 7.x, 8.x veya 9.x
  • PHP 7.2 veya üzeri (PHP 8.x destekli)
  • cURL PHP eklentisi
  • JSON PHP eklentisi
  • FTP/SFTP veya cPanel erişimi

WISECP

  • WISECP 2.x, 3.x veya üzeri
  • PHP 7.2 veya üzeri
  • cURL PHP eklentisi
  • JSON PHP eklentisi
  • FTP/SFTP veya cPanel erişimi

DATASSL Hesabı

  • Aktif bayi hesabı
  • API anahtarı (otomatik gömülür)
  • Yeterli kredi bakiyesi
  • Tanımlı ürün grubu

Kurulum Adımları

1

Modülü İndirin

Bayi panelinize giriş yapın ve Modül İndir bölümünden WHMCS modülünü indirin. Ya da aşağıdaki butonu kullanarak doğrudan indirebilirsiniz.

WHMCS Modülünü İndir
İndirilen ZIP dosyası sizin API anahtarınızı içinde gömülü olarak taşır. Ayrıca API anahtarı girmenize gerek yoktur.
2

ZIP Dosyasını Açın

İndirdiğiniz datassl_whmcs_v3.0.0.zip dosyasını açın. İçinde şu yapıyı göreceksiniz:

📁 modules/
  📁 servers/
    📁 datassl/ ← Sunucu (Provisioning) Modülü
      📄 datassl.php — Ana modül dosyası
      📁 lib/
        📄 ApiClient.php — API istemci sınıfı
      📄 hooks.php — WHMCS hook'ları
      📁 templates/
        📄 clientarea.tpl — Müşteri paneli şablonu
        📄 admin.tpl — Admin paneli şablonu
        📄 overview.tpl — Genel bakış şablonu
  📁 addons/
    📁 datassl/ ← Addon Yönetim Modülü
      📄 datassl.php — Addon ana dosyası
      📄 hooks.php — Addon hook'ları
      📄 cron.php — Sipariş senkronizasyon cron'u
      📁 lib/
        📄 ApiClient.php — API istemci sınıfı
        📄 Helper.php — Yardımcı fonksiyonlar
📄 README.md
📄 CHANGELOG.md
3

Dosyaları WHMCS'e Yükleyin

ZIP içindeki modules klasörünü WHMCS kurulum dizininize yükleyin. FTP, SFTP veya cPanel Dosya Yöneticisi kullanabilirsiniz.

FTP / SFTP
# İki klasörü de WHMCS dizinine kopyalayın:
modules/servers/datassl/ → /home/user/public_html/whmcs/modules/servers/datassl/
modules/addons/datassl/ → /home/user/public_html/whmcs/modules/addons/datassl/
Önemli: Mevcut WHMCS modules klasörünün içine kopyalayın. Klasörün üzerine yazmayın, sadece servers/datassl ve addons/datassl alt klasörlerini ekleyin.
Dosya İzinleri: PHP dosyaları için 644, klasörler için 755 izni yeterlidir.
4

Addon Modülünü Aktifleştirin

WHMCS admin paneline gidin ve addon modülünü aktifleştirin:

  1. WHMCS Admin paneline giriş yapın
  2. Setup → Addon Modules sayfasına gidin
  3. "DATASSL SSL Certificates" modülünü bulun
  4. "Activate" butonuna tıklayın
  5. Access Control bölümünden yönetici rollerini seçin (örn: Full Administrator)
  6. "Save Changes" ile kaydedin
Otomatik Kurulum: Aktivasyon sırasında modül otomatik olarak:
  • Veritabanı tablolarını oluşturur (mod_datassl_orders, mod_datassl_logs, mod_datassl_settings)
  • 5 adet e-posta şablonu oluşturur (SSL Configuration, Issued, Expiry, Renewed, Reissued)
5

Ürün Oluşturma (Yöntem 1: Addon Paneli - Önerilen)

Addon panelindeki Ürün Oluşturucu ile toplu ürün ekleyin:

  1. Addons → DATASSL SSL Certificates menüsüne gidin
  2. Sol menüden "Ürün Oluşturucu" sayfasını açın
  3. Ürünlerin ekleneceği WHMCS ürün grubunu seçin (yoksa önce oluşturun)
  4. Kar marjı (markup) oranını belirleyin (örn: %20)
  5. Eklemek istediğiniz ürünleri seçin
  6. "Seçili Ürünleri WHMCS'e Ekle" butonuna tıklayın
Otomatik Fiyatlandırma: Ürün oluşturucu, belirlediğiniz markup oranına göre tüm para birimlerinde otomatik fiyatlandırma yapar. SAN destekli ürünler için Configurable Options otomatik oluşturulur.
5b

Ürün Oluşturma (Yöntem 2: Manuel)

Ürünleri tek tek manuel olarak da oluşturabilirsiniz:

  1. Setup → Products/Services → Products/Services sayfasına gidin
  2. "Create a New Product" butonuna tıklayın
  3. Product Type: Other seçin
  4. Ürün grubunu ve adını belirleyin, "Continue" tıklayın
  5. Module Settings sekmesine gidin
  6. Module Name: "DATASSL SSL Certificates" seçin
  7. "DATASSL Ürün" dropdown'undan sertifika ürününü seçin
  8. "Save Changes" ile kaydedin
Ürün dropdown'unda ürün isimlerinin yanında doğrulama tipi (DV/OV/EV), SAN bilgisi ve bayi fiyatı gösterilir. Dropdown boşsa API bağlantısını kontrol edin.
6

Cron Yapılandırması (Önerilen)

Sipariş durumlarını otomatik senkronize etmek için bağımsız bir cron job ekleyin. Bu cron, API üzerinden tüm siparişlerin durumunu kontrol eder ve WHMCS hizmet durumlarını günceller.

Crontab
# Her 6 saatte bir çalıştır (önerilen)
0 */6 * * * php /home/user/public_html/whmcs/modules/addons/datassl/cron.php

# Veya her 4 saatte bir
0 */4 * * * php /home/user/public_html/whmcs/modules/addons/datassl/cron.php
Alternatif: Cron job eklemezseniz bile, WHMCS'in kendi günlük cron'u (DailyCronJob hook) ile siparişler günde bir kez otomatik olarak senkronize edilir. Ancak daha sık güncelleme için bağımsız cron önerilir.
7

Kurulumu Test Edin

Kurulumun başarılı olduğunu doğrulamak için:

  1. Addons → DATASSL SSL Certificates menüsüne gidin
  2. Genel Bakış sayfasında API durumu, bakiye ve istatistikleri kontrol edin
  3. Sol menüden Ayarlar sayfasına gidin
  4. "Bağlantı Testi" butonuna tıklayın — yeşil onay işareti görmelisiniz
  5. Bayi adı, bakiye ve iskonto oranı doğru görünüyorsa kurulum tamamdır
Tebrikler! WHMCS modülü başarıyla kuruldu. Artık SSL sertifikası satışa başlayabilirsiniz.

Addon Panel Sayfaları

Genel Bakış

API durumu, bakiye, sipariş istatistikleri, son siparişler ve hızlı erişim kısayolları

Ürün Oluşturucu

API ürünlerini toplu olarak WHMCS'e ekleyin. Markup ayarlama, SAN ve fiyatlandırma otomasyonu

Siparişler

Tüm SSL siparişlerini tek ekrandan yönetin. Filtreleme, arama, durum senkronizasyonu

İşlem Kayıtları

Detaylı aktivite logları, API çağrıları ve hata izleme

Ayarlar

API bağlantı testi, modül bilgileri, cron yapılandırması, veritabanı durumu

1

Modülü İndirin

Bayi panelinize giriş yapın ve Modül İndir bölümünden WISECP modülünü indirin.

WISECP Modülünü İndir
İndirilen ZIP dosyası sizin API anahtarınızı içinde gömülü olarak taşır. Ayrıca API anahtarı girmenize gerek yoktur.
2

ZIP Dosyasını Açın

İndirdiğiniz datassl_wisecp_v3.0.0.zip dosyasını açın. İçinde şu yapıyı göreceksiniz:

📁 coremio/
  📁 modules/
    📁 Servers/
      📁 DATASSL/ ← Ana Modül Klasörü
        📄 DATASSL.php — Ana modül dosyası
        📄 config.php — Modül yapılandırması
        📁 api/
          📄 Client.php — API istemci sınıfı
        📁 pages/
          📄 settings.php — Ayarlar sayfası
          📄 home.php — Müşteri paneli ana sayfa
          📄 output.php — Admin çıktı sayfası
        📁 lang/
          📄 tr.php — Türkçe dil dosyası
          📄 en.php — İngilizce dil dosyası
📄 README.md
📄 CHANGELOG.md
3

Dosyaları WISECP'ye Yükleyin

ZIP içindeki coremio klasörünü WISECP kurulum dizininize yükleyin.

FTP / SFTP
# DATASSL klasörünü WISECP dizinine kopyalayın:
coremio/modules/Servers/DATASSL/ → /home/user/public_html/coremio/modules/Servers/DATASSL/
Dikkat: Klasör adı DATASSL büyük harfle yazılmalıdır (büyük/küçük harf duyarlı sunucularda önemlidir).
Dosya İzinleri: PHP dosyaları için 644, klasörler için 755 izni yeterlidir.
4

Modülü Aktifleştirin

WISECP admin panelinden modülü aktifleştirin:

  1. WISECP Admin Panel'e giriş yapın
  2. Ayarlar → Sunucu Modülleri (Settings → Server Modules) sayfasına gidin
  3. Modül listesinde "DATASSL SSL Certificates" modülünü bulun
  4. Modülü aktifleştirin
Sunucu Gerekmez: WISECP'de sunucu eklemenize gerek yoktur. API bilgileri modül içinde gömülü olarak gelir. Bağlantı testi yapıldığında bayi adı, bakiye ve iskonto oranı otomatik görüntülenir.
5

Ürün/Hizmet Oluşturun

WISECP'de yeni bir ürün oluşturup DATASSL modülünü bağlayın:

  1. Ürünler → Yeni Ürün (Products → New Product) sayfasına gidin
  2. Ürün türünü seçin ve temel bilgileri doldurun
  3. Sunucu/Modül bölümünde "DATASSL" modülünü seçin
  4. Modül ayarlarında "DATASSL Ürün" dropdown'unu açın
  5. Satmak istediğiniz SSL sertifika ürününü seçin
  6. Fiyatlandırma ayarlarını yapın
  7. Kaydet butonuna tıklayın
Ürün dropdown'unda her ürünün yanında marka, doğrulama tipi (DV/OV/EV), SAN bilgisi ve bayi fiyatı gösterilir.
6

Kurulumu Test Edin

Kurulumun başarılı olduğunu doğrulamak için:

  1. Modül ayarlarındaki "Bağlantı Testi" butonuna tıklayın
  2. "Bağlantı başarılı!" mesajını ve bayi bilgilerini doğrulayın
  3. Ürün dropdown'unda sertifika listesinin yüklendiğini kontrol edin
  4. Test siparişi oluşturarak tüm akışı doğrulayın
Tebrikler! WISECP modülü başarıyla kuruldu. Artık SSL sertifikası satışa başlayabilirsiniz.

Müşteri Paneli Özellikleri

SSL Yapılandırma

CSR girişi, doğrulama yöntemi seçimi, onay e-postası ayarlama — kolay 2 adımlı sihirbaz

Sertifika İndirme

Certificate, CA Bundle, Private Key dosyalarını tek tıkla indirme ve kopyalama butonları

Durum Takibi

Renkli durum badge'leri, geçerlilik tarihleri, kalan gün gösterimi, gerçek zamanlı senkronizasyon

Yeniden Yayınla

Sertifika reissue, doğrulama e-postası yeniden gönderimi, DCV yöntemi değiştirme

Modül Karşılaştırması

Özellik WHMCS Modülü WISECP Modülü
Versiyon v3.0.0 v3.0.0
Mimari Server + Addon (2 modül) Tek Sunucu Modülü
Sunucu Ayarı Gereksinimi ✓ Gerekmez ✓ Gerekmez
API Key Otomatik Gömülme ✓ Evet ✓ Evet
Ürün Oluşturucu (Toplu) ✓ Addon panelinden ✗ Manuel oluşturma
Addon Yönetim Paneli ✓ 5 sayfalı tam panel ✗ Yok
Sipariş Senkronizasyonu ✓ Cron + Günlük WHMCS cron ✓ Otomatik
E-posta Şablonları ✓ 5 otomatik şablon WISECP şablonları üzerinden
SAN (Multi-Domain) Desteği ✓ Configurable Options ile ✓ Evet
Wildcard SAN Desteği ✓ Evet ✓ Evet
Çoklu Yıl Desteği ✓ Evet ✓ Evet
Müşteri SSL Yapılandırma 3 adımlı sihirbaz 2 adımlı sihirbaz
Sertifika İndirme / Kopyalama ✓ Evet ✓ Evet
Admin Durum Görünümü ✓ Renk kodlu ✓ Renk kodlu
Retry Mantığı ✓ 2 tekrar ✓ 2 tekrar
Dil Desteği İngilizce (WHMCS dili) Türkçe + İngilizce
Süre Dolma Hatırlatma ✓ 30/14/7/3/1 gün WISECP üzerinden

Sıkça Sorulan Sorular

Sunucu eklemem gerekiyor mu?
Hayır. Her iki modül de sunucusuz (serverless) mimariyle çalışır. API URL ve API Key modül dosyalarına otomatik olarak gömülür. WHMCS'de "Servers" bölümüne, WISECP'de sunucu ayarlarına dokunmanıza gerek yoktur.
API anahtarımı nereye girmeliyim?
Hiçbir yere girmenize gerek yok. Modülü DATASSL bayi panelinizden indirdiğinizde, API anahtarınız otomatik olarak modül dosyalarına gömülür. Modül çalıştığında bu gömülü anahtarı kullanır.
Modülü güncellemek için ne yapmalıyım?
Yeni sürümü DATASSL panelinizden indirin ve mevcut dosyaların üzerine yükleyin. WHMCS addon modülü güncelleme sırasında veritabanı tablolarını ve e-posta şablonlarını otomatik kontrol eder; eksik olanları ekler. Verileriniz korunur.
Ürün dropdown'unda hiçbir ürün görünmüyor, ne yapmalıyım?
Bu genellikle API bağlantı sorununu gösterir. Kontrol edin:
  • cURL eklentisi aktif mi? (php -m | grep curl)
  • Sunucu güvenlik duvarı dış bağlantıları engelliyor mu?
  • Bayi hesabınız aktif mi ve ürün grubu tanımlı mı?
  • WHMCS'de: Addon panelindeki Ayarlar → Bağlantı Testi yapın
  • Admin panelinden "Ürün Listesini Yenile" butonuna tıklayın (cache temizlenir)
Müşteri CSR girmeden sipariş verebilir mi?
Evet. Sipariş sırasında CSR girilmezse hizmet "Yapılandırma Bekliyor" (awaiting_configuration) durumunda aktif edilir. Müşteri daha sonra kendi panelinden (Client Area) CSR girişi yaparak SSL yapılandırmasını tamamlayabilir.
SAN (ek domain) desteğini nasıl etkinleştiririm?
WHMCS: Addon panelindeki Ürün Oluşturucu ile ürün eklerseniz, SAN destekli ürünler için Configurable Options otomatik oluşturulur. Manuel oluşturuyorsanız, bir Configurable Options Group ekleyerek san_count ve san_domains alanlarını tanımlayın.

WISECP: SAN desteği modülde yerleşik olarak gelir. Müşteri sipariş sırasında ek domainlerini girer.
Kredi bakiyem siparişlerden otomatik düşüyor mu?
Evet. API üzerinden oluşturulan tüm siparişlerde kredi bakiyenizden otomatik düşüm yapılır. Yeterli bakiye yoksa sipariş oluşturulmaz (HTTP 402 hatası döner). Modüller bu durumu müşteriye anlamlı bir hata mesajı olarak gösterir.
Kod imzalama (Code Signing) sertifikaları destekleniyor mu?
Evet. Kod imzalama ve EV Kod İmzalama sertifikaları tam desteklenir. Bu ürün tipleri için domain doğrulama (DCV) gerektirmez ve domain alanı gizlenir. Sadece CSR ve iletişim bilgileri yeterlidir.

Sorun Giderme

Sorun Çözüm
WHMCS: Addon menüde görünmüyor Setup → Addon Modules'dan aktifleştirildiğinden ve admin rollerinin seçildiğinden emin olun
WHMCS: Ürün oluşturulamıyor Önce bir WHMCS ürün grubu (Product Group) oluşturulmuş olmalıdır
WHMCS: Module Setting'de modül görünmüyor modules/servers/datassl/datassl.php dosyasının doğru yolda olduğunu kontrol edin
WISECP: Modül listesinde DATASSL yok coremio/modules/Servers/DATASSL/ klasörünün doğru yolda ve büyük harfle olduğunu kontrol edin
API bağlantı hatası Sunucunuzun dış bağlantıları engellemediğinden emin olun. curl ve json PHP eklentilerini kontrol edin
Sipariş oluşturulamıyor WHMCS: Utilities → Logs → Module Log'dan detaylı hatayı görün. Kredi bakiyenizi kontrol edin
Sertifika indirilemiyor Sertifika henüz hazır olmayabilir. Sipariş durumunu senkronize edin, "active/issued" durumuna geçmesini bekleyin
Cron çalışmıyor PHP yolunun doğru olduğundan emin olun: which php. Cron log'larını kontrol edin: /var/log/cron
Yardıma mı İhtiyacınız Var?
Kurulumla ilgili sorun yaşıyorsanız destek ekibimizle iletişime geçin.
Destek Talebi Oluştur