Modül Kurulum Rehberi

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

WHMCS 7.x / 8.x / 9.x WordPress / WooCommerce Sunucusuz Kurulum ~5 Dakika

WHMCS Modülünü İndir (v5.8.0) WordPress Eklentisini İndir (v5.8.0)

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

WordPress

WordPress 5.8 veya üzeri
WooCommerce 6.0 veya üzeri
PHP 7.4 veya üzeri
wp_remote_request() (varsayılan)
FTP/SFTP veya wp-admin 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ı

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.

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

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.

Addon Modülünü Aktifleştirin

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

WHMCS Admin paneline giriş yapın
Setup → Addon Modules sayfasına gidin
"DATASSL SSL Certificates" modülünü bulun
"Activate" butonuna tıklayın
Access Control bölümünden yönetici rollerini seçin (örn: Full Administrator)
"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)

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

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

Addons → DATASSL SSL Certificates menüsüne gidin
Sol menüden "Ürün Oluşturucu" sayfasını açın
Ürünlerin ekleneceği WHMCS ürün grubunu seçin (yoksa önce oluşturun)
Kar marjı (markup) oranını belirleyin (örn: %20)
Eklemek istediğiniz ürünleri seçin
"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.

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

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

Setup → Products/Services → Products/Services sayfasına gidin
"Create a New Product" butonuna tıklayın
Product Type: Other seçin
Ürün grubunu ve adını belirleyin, "Continue" tıklayın
Module Settings sekmesine gidin
Module Name: "DATASSL SSL Certificates" seçin
"DATASSL Ürün" dropdown'undan sertifika ürününü seçin
"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.

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.

Kurulumu Test Edin

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

Addons → DATASSL SSL Certificates menüsüne gidin
Genel Bakış sayfasında API durumu, bakiye ve istatistikleri kontrol edin
Sol menüden Ayarlar sayfasına gidin
"Bağlantı Testi" butonuna tıklayın — yeşil onay işareti görmelisiniz
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

Eklentiyi İndirin

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

WordPress Eklentisini İndir

İndirilen ZIP dosyası API anahtarınızı gömülü taşır. WordPress ayarlar sayfasından değiştirebilirsiniz.

ZIP Dosyasını Açın

İndirdiğiniz datassl_wordpress_v5.8.0.zip dosyası şu yapıyı içerir:

📁 datassl/ ← Eklenti Klasörü
  📄 datassl.php — Ana eklenti dosyası
  📄 uninstall.php — Temiz kaldırma
  📁 includes/
    📄 class-api-client.php — API istemci sınıfı
    📄 class-admin.php — Yönetim paneli
    📄 class-orders.php — Sipariş yönetimi
    📄 class-woocommerce.php — WooCommerce entegrasyonu
    📄 class-cron.php — Zamanlanmış görevler
  📁 assets/
    📁 css/ — Stil dosyaları
    📁 js/ — JavaScript dosyaları

Eklentiyi Yükleyin

İki yöntemden birini kullanabilirsiniz:

Yöntem 1: WordPress Admin

Eklentiler → Yeni Ekle → Eklenti Yükle → ZIP Seçin → Yükle

Yöntem 2: FTP / SFTP

datassl/ → /home/user/public_html/wp-content/plugins/datassl/

Yükledikten sonra Eklentiler sayfasından DATASSL SSL Certificates eklentisini etkinleştirin.

WooCommerce Gerekli: Bu eklenti WooCommerce ile çalışır. WooCommerce kurulu ve aktif değilse eklenti sadece admin paneli gösterir.

Ayarları Yapılandırın

WordPress sol menüsünde DATASSL → Ayarlar sayfasını açın:

API URL

Otomatik gömülü gelir

API Anahtarı

Otomatik gömülü gelir

Bağlantı Testi

Tek tıkla API doğrulama

WooCommerce Ürünü Oluşturun

WooCommerce'den yeni bir ürün oluşturun ve ürün tipini DATASSL SSL Sertifika olarak seçin:

Ürünler → Yeni Ekle
Ürün Verisi dropdown'unda "DATASSL SSL Sertifika" seçin
"DATASSL API Ürünü" sekmesinden satmak istediğiniz SSL sertifikasını seçin
Fiyat ve diğer bilgileri doldurun
Kaydet & Yayınla

Sanal Ürün: SSL ürünü otomatik olarak sanal (virtual) ürün olarak işaretlenir. Kargo gerektirmez.

Kurulumu Test Edin

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

DATASSL → Genel Bakış sayfasında hesap bilgilerinizi doğrulayın
Bağlantı Testi'ni çalıştırın
DATASSL → Ürünler sayfasında API ürünlerinin listelendiğini kontrol edin
Müşteri hesabında Hesabım → SSL Sertifikaları menüsünün göründüğünü doğrulayın
Test siparişi oluşturarak tüm akışı doğrulayın

Tebrikler! WordPress eklentisi başarıyla kuruldu. WooCommerce ile SSL sertifikası satışına başlayabilirsiniz.

Müşteri Paneli Özellikleri

SSL Yapılandırma

Hesabım → SSL Sertifikaları sayfasından CSR girişi, domain ve DCV yöntemi seçimi ile kolay yapılandırma

Durum Takibi

30 saniyelik otomatik durum kontrolü, DCV yöntemi değiştirme ve sipariş iptal etme seçenekleri

Sertifika Görüntüleme

Certificate, CA Bundle, Private Key dosyalarını tek tıkla kopyalama butonları (karanlık tema görünümü)

Yeniden Yayınla

Sertifika reissue (yeni CSR opsiyonel), DCV yöntemi değiştirme, sipariş iptal etme

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.

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/

Modülü Aktifleştirin

WISECP Admin Panel → Ürünler/Servisler → Modüller
DATASSL modülünü bulun
Bağlantı Testi butonuyla API bağlantısını doğrulayın
Ürünlerinizi DATASSL ürünleriyle eşleştirin

API bilgileri modül içinde gömülü gelir. Ekstra API anahtarı girişi gerektirmez.

Ürün Oluşturun

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

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

Özellik	WHMCS Modülü	WordPress Eklentisi	WISECP Modülü
Versiyon	v5.8.0	v5.8.0	v1.0.0
Mimari	Server + Addon (2 modül)	WooCommerce Eklentisi	Product Modülü
Sunucu Ayarı Gereksinimi	✓ Gerekmez (Sunucusuz)	✓ Gerekmez (Sunucusuz)	✓ Gerekmez (Sunucusuz)
API Key Otomatik Gömülme	✓ Evet	✓ Evet	✓ Evet
Ürün Oluşturucu (Toplu)	✓ Addon panelinden	✗ Manuel oluşturma	✗ Manuel oluşturma
Addon Yönetim Paneli	✓ 5 sayfalı tam panel	✓ 4 sayfalı panel (Dashboard, Siparişler, Ürünler, Ayarlar)	✓ WISECP entegre panel
Sipariş Senkronizasyonu	✓ Cron + Günlük WHMCS cron	✓ WP Cron günlük sync	✓ WISECP run_action
E-posta Şablonları	✓ 5 otomatik şablon	✓ wp_mail ile süre uyarıları	WISECP dahili bildirim
SAN (Multi-Domain) Desteği	✓ Configurable Options ile	✓ Evet	✓ Evet
Wildcard SAN Desteği	✓ Evet	✓ Evet	✓ Evet
Çoklu Yıl Desteği	✓ Evet	✓ Evet	✓ Evet
Müşteri SSL Yapılandırma	3 adımlı sihirbaz	WooCommerce hesabım sayfası	Müşteri paneli formu
Sertifika İndirme / Kopyalama	✓ Evet	✓ Evet	✓ Evet
Admin Durum Görünümü	✓ Renk kodlu	✓ Renk kodlu	✓ Renk kodlu
Retry Mantığı	✓ 2 tekrar	✓ 2 tekrar	Tek istek
Dil Desteği	İngilizce (WHMCS dili)	Türkçe (çeviri hazır)	Türkçe + İngilizce
Süre Dolma Hatırlatma	✓ 30/14/7/3/1 gün	✓ 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, WordPress'te 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.

WordPress: SAN desteği eklentide yerleşik olarak gelir. Checkout 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/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