SSL Sertifikası

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 / Coremio 3.x 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 / Coremio 3.x veya üzeri
  • PHP 7.4 veya üzeri (PHP 8.x destekli)
  • cURL PHP eklentisi
  • JSON PHP eklentisi
  • FTP/SFTP veya panel 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/ → /home/user/public_html/whmcs/modules/servers/
modules/addons/ → /home/user/public_html/whmcs/modules/addons/
Ö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/cron.php

# Veya her 4 saatte bir
0 */4 * * * php /home/user/public_html/whmcs/modules/addons/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ı API URL ve API Key bilgilerinizi gömülü olarak taşır.
2

Dosyaları Yükleyin

ZIP dosyasını açın ve coremio/modules/Product/DATASSL klasörünü WISECP kurulum dizininize kopyalayın.

coremio/modules/Product/DATASSL/ → <WISECP>/coremio/modules/Product/DATASSL/
3

Modülü Aktifleştirin

  1. WISECP Admin Panel → Ürünler/ServislerModüller
  2. DATASSL modülünü bulun
  3. Bağlantı Testi butonuyla API bağlantısını doğrulayın
  4. Ürünlerinizi DATASSL ürünleriyle eşleştirin
API bilgileri modül içinde gömülü gelir. Ekstra API anahtarı girişi gerektirmez.
4

Ürün Oluşturun

  1. WISECP Admin → Ürünler/Servisler → Yeni ürün ekleyin
  2. Modül olarak DATASSL seçin
  3. İlgili DATASSL ürününü eşleştirin
  4. Fiyatlandırma ve SAN ayarlarını yapılandırın

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

Özellik WHMCS Modülü WISECP Modülü
Versiyon v5.9.0 v1.0.0
Mimari Server + Addon (2 modül) Product Modülü
Sunucu Ayarı Gereksinimi ✓ Gerekmez (Sunucusuz) ✓ Gerekmez (Sunucusuz)
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 ✓ WISECP entegre panel
Sipariş Senkronizasyonu ✓ Cron + Günlük WHMCS cron ✓ WISECP run_action
E-posta Şablonları ✓ 5 otomatik şablon WISECP dahili bildirim
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 Müşteri paneli formu
Sertifika İndirme / Kopyalama ✓ Evet ✓ Evet
Admin Durum Görünümü ✓ Renk kodlu ✓ Renk kodlu
Retry Mantığı ✓ 2 tekrar Tek istek
Dil Desteği İngilizce (WHMCS dili) Türkçe + İngilizce
Süre Dolma Hatırlatma ✓ 30/14/7/3/1 gün WISECP dahili bildirim

Sıkça Sorulan Sorular

Sunucu eklemem gerekiyor mu?
Hayır. Tüm modüller 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 veya WiseCP'de ekstra ayarlara 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. Sipariş sırasında müşteri 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.php dosyasının doğru yolda 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