Netlen Cloud WHMCS Modülü

Kapsamlı sunucu yönetimi ve hesap yönetimi için profesyonel WHMCS entegrasyonu

Genel Bakış

Netlen Cloud WHMCS Modülü, Netlen Cloud API'sini kullanarak WHMCS üzerinden bulut sunucu yönetimi yapmanızı sağlar. Modül iki ana bileşenden oluşur:

Sunucu Modülü

Sunucu oluşturma, yönetim ve müşteri paneli işlevleri için kapsamlı modül.

  • Otomatik sunucu kurulumu
  • Güç yönetimi
  • rDNS yönetimi
  • Modern müşteri arayüzü

Addon Modülü

Hesap yönetimi, sunucu listesi ve daha fazlası için addon modülü.

  • Bakiye görüntüleme
  • Sunucu listesi
  • Paket bilgileri
  • Ticket yönetimi
Not: Bu modül Netlen Cloud API v1.0.7 ile uyumludur.

Özellikler

🖥️ Sunucu Modülü Özellikleri

Sunucu İşlemleri

Sunucu Oluşturma

Plan, lokasyon ve OS seçimi ile otomatik sunucu kurulumu. Configurable Options desteği ile esnek yapılandırma.

Askıya Alma/Çıkarma

Sunucu durumunu kolayca yönetme. Suspend ve Unsuspend işlemleri ile tam kontrol.

Sunucu Silme

Sunucu ve ilişkili kaynakları (IP'ler, rDNS kayıtları) temizleme.

Paket Yükseltme

Sunucu paketini yükseltme ve kaynakları artırma.

Güç Yönetimi

Başlat/Durdur/Yeniden Başlat

Sunucu güç kontrolü için modern butonlar ve onay modalleri.

Durum Takibi

Gerçek zamanlı sunucu durumu görüntüleme ve durum rozetleri.

Sunucu Yönetimi

Yeniden Kurulum

İşletim sistemi yeniden kurulumu. Configurable options'tan OS seçimi ile modal arayüz.

Şifre Sıfırlama

Otomatik güvenli şifre oluşturma ve modal içinde gösterimi.

Ek IP Satın Alma

IPv4 ve IPv6 ek IP adresi satın alma. Ayrı butonlar ile kolay yönetim.

rDNS Yönetimi

IPv4 ve IPv6 adresleri için reverse DNS ayarlama. Mevcut rDNS görüntüleme ve güncelleme.

Müşteri Paneli Özellikleri

Resource Usage Cards

CPU, RAM, Storage, Upload, Download ve Bandwidth kullanım bilgilerini gösteren modern kartlar.

Modern UI

Kart tabanlı modern arayüz tasarımı. Beyaz arka plan ve gölge efektleri ile profesyonel görünüm.

Username/Password

WHMCS'den çekilen bilgilerin gösterilmesi. Password göster/gizle özelliği ile güvenli erişim.

SVG OS İkonları

OS isimlerine göre dinamik SVG ikon gösterimi. Ubuntu, CentOS, Windows ve daha fazlası.

📦 Addon Modülü Özellikleri

Dashboard

Bakiye Kartı

Mevcut bakiyeyi gösteren gradient kart. Mavi tonlarda modern tasarım.

Aktif Sunucu Sayısı

Aktif sunucu sayısını gösteren kart. Hizmet durumuna göre sayım.

Support Tickets

Açık ticket sayısını gösteren kart. Hızlı erişim için.

Reseller Status

Reseller durumu ve indirim bilgileri. Kademe ve indirim oranı gösterimi.

Sekmeler

Overview

Genel bakış ve sunucu listesi. İlk yüklemede gösterilir.

Servers

Tüm sunucuların listesi. Durum, IP, plan ve fiyat bilgileri.

Packages

Mevcut paketler ve fiyatlar. Reseller indirimli fiyatlar dahil.

Locations

Lokasyon listesi. Aktif/pasif durum bilgileri.

Operating Systems

İşletim sistemi listesi. Versiyon bilgileri ile.

Support Tickets

Ticket listesi ve yanıtlama. Modal içinde mesaj görüntüleme.

Setup

Configurable Options oluşturma. OS ve Location seçenekleri.

Özel Özellikler

Lazy Loading

Performans için sekme bazlı veri yükleme. Sadece tıklanan sekme yüklenir.

Version Check

Otomatik versiyon kontrolü ve güncelleme bildirimi. SweetAlert2 ile modern uyarılar.

Mevcut Options Kontrolü

Setup sekmesinde mevcut configurable options kontrolü ve bilgilendirme.

Çoklu Dil

Türkçe ve İngilizce dil desteği. WHMCS admin dil tercihine göre otomatik seçim.

Sunucu Modülü

Kurulum

  1. modules/servers/netlencloud/ klasörünü WHMCS'inizin modules/servers/ dizinine kopyalayın
  2. WHMCS admin panelinde Setup → Products/Services → Servers menüsüne gidin
  3. Add New Server butonuna tıklayın
  4. Module olarak Netlen Cloud seçin
  5. API bilgilerinizi girin:
    • API Key: Netlen Cloud panelinizden aldığınız API anahtarı
    • API URL: API URL'niz (varsayılan: https://api.netlen.com/v1)
  6. Test Connection butonuna tıklayarak bağlantıyı test edin

Ürün Yapılandırması

  1. Setup → Products/Services → Products/Services menüsüne gidin
  2. Yeni bir ürün oluşturun veya mevcut bir ürünü düzenleyin
  3. Module olarak Netlen Cloud seçin
  4. Module Settings bölümünde:
    • Server olarak yukarıda oluşturduğunuz sunucuyu seçin
    • Plan ID, Location ID, OS Version ID değerlerini girebilirsiniz (opsiyonel)
  5. Configurable Options bölümünde OS ve Location seçenekleri oluşturun (Setup sekmesinden otomatik oluşturulabilir)

Custom Fields

Modül otomatik olarak server_id adında bir custom field oluşturur ve sunucu oluşturulduğunda bu alana server ID'yi kaydeder. Bu sayede API isteklerinde doğru server ID kullanılır.

Önemli: Sunucu oluşturulduktan sonra username field'ına OS'ye göre "root" veya "Administrator" kaydedilir. Password field'ına ise güvenli şifre kaydedilir.

Addon Modülü

Kurulum

  1. modules/addons/netlencloud/ klasörünü WHMCS'inizin modules/addons/ dizinine kopyalayın
  2. WHMCS admin panelinde Setup → Addon Modules menüsüne gidin
  3. Netlen Cloud modülünü bulun ve Activate butonuna tıklayın
  4. Configure butonuna tıklayın ve API bilgilerinizi girin:
    • API Key: Netlen Cloud panelinizden aldığınız API anahtarı
    • API URL: API URL'niz (varsayılan: https://api.netlen.com/v1)
  5. Save Changes butonuna tıklayın

Kullanım

Addon modülü aktifleştirildikten sonra:

  • Admin Panel: Setup → Addon Modules → Netlen Cloud menüsünden erişebilirsiniz
  • Müşteri Paneli: Müşteriler de aynı menüden erişebilir (eğer izin verilmişse)

Setup Sekmesi

Setup sekmesinde Configurable Options oluşturabilirsiniz:

  1. OS değerlerini ekleyin (format: ID|İsim, örn: 1|Ubuntu 18.04 LTS)
  2. Location değerlerini ekleyin (format: ID|İsim, örn: 1|Türkiye)
  3. Tümünü Oluştur/Ekle butonu ile hazır OS listesini ekleyebilirsiniz
  4. Configurable Options Oluştur butonuna tıklayın
Uyarı: Eğer configurable options zaten mevcut ise, yeniden oluşturulduğunda mevcut değerler silinip yenileri eklenecektir.

Kurulum

Gereksinimler

  • WHMCS 8.x
  • PHP 8.1 veya üzeri
  • ionCube Loader 13 veya üzeri
  • cURL desteği
  • Netlen Cloud API anahtarı

Adım Adım Kurulum

1. Dosyaları Kopyalama

Modül zip dosyası WHMCS'in ana dizinine çıkarılabilir şekilde hazırlanmıştır. Zip dosyasını WHMCS'inizin ana dizinine çıkarın:

# WHMCS ana dizinine gidin
cd /path/to/whmcs/

# Zip dosyasını çıkarın
unzip netlencloud-whmcs-module.zip

Alternatif: FTP ile zip dosyasını yükledikten sonra, kullandığınız hosting kontrol panelinden (cPanel, Plesk, vb.) arşivden çıkarabilirsiniz.

Zip dosyası içinde zaten doğru klasör yapısı mevcuttur:

  • modules/addons/netlencloud/ - Addon modülü
  • modules/servers/netlencloud/ - Sunucu modülü
  • assets/img/servers/ - OS ikonları için gerekli görseller

Zip dosyasını çıkardığınızda tüm dosyalar otomatik olarak doğru konumlara yerleşecektir.

2. API Anahtarı Alma

  1. Netlen Cloud paneline giriş yapın
  2. Reseller → API menüsüne gidin
  3. Yeni bir API anahtarı oluşturun
  4. En az bir IP adresi ekleyin (WHMCS sunucunuzun IP adresi)
  5. API anahtarını kopyalayın

3. Modül Aktifleştirme

Her iki modülü de WHMCS admin panelinden aktifleştirin ve API bilgilerinizi girin.

Başarılı: Kurulum tamamlandıktan sonra Test Connection butonunu kullanarak bağlantıyı test edin.

Kullanım

Müşteri Paneli

Müşteriler, hizmet detay sayfasında aşağıdaki işlemleri yapabilir:

  • Sunucu Bilgileri: CPU, RAM, Storage, Bandwidth kullanım bilgilerini görüntüleme
  • IP Yönetimi: IP adreslerini görüntüleme ve rDNS ayarlama
  • Güç Yönetimi: Sunucuyu başlatma/durdurma/yeniden başlatma
  • Yeniden Kurulum: İşletim sistemi yeniden kurulumu (modal ile OS seçimi)
  • Şifre Sıfırlama: Otomatik güvenli şifre oluşturma ve görüntüleme
  • Ek IP Satın Alma: IPv4 ve IPv6 ek IP adresi satın alma

Admin Paneli

Admin panelinde:

  • Sunucu Durumu: Gerçek zamanlı sunucu durumu görüntüleme
  • Özel Butonlar: Start, Stop, Restart, Reinstall, Password Reset butonları
  • Hizmet Sekmesi: Detaylı sunucu bilgileri ve yönetim seçenekleri
  • Configurable Options: Setup sekmesinden OS ve Location seçenekleri oluşturma

Addon Modülü

Addon modülü ile:

  • Dashboard: Bakiye, aktif sunucu sayısı ve ticket sayısı görüntüleme
  • Sunucu Listesi: Tüm sunucuları görüntüleme ve yönetme
  • Paket Bilgileri: Mevcut paketleri ve fiyatları görüntüleme
  • Lokasyonlar: Mevcut lokasyonları görüntüleme
  • İşletim Sistemleri: Mevcut OS'leri ve versiyonlarını görüntüleme
  • Support Tickets: Ticket listesi ve yanıtlama
  • Setup: Configurable Options oluşturma ve yönetimi

API Endpoint'leri

Modül aşağıdaki API endpoint'lerini kullanır:

Hesap ve Bakiye

GET /balance
Bakiye bilgisi
GET /reseller
Reseller durumu ve indirim bilgileri

Sunucu Yönetimi

GET /servers
Sunucu listesi
GET /servers/{server_id}
Sunucu detayı
POST /servers
Sunucu oluşturma
DELETE /servers/{server_id}
Sunucu silme

Güç Yönetimi

POST /servers/{server_id}/start
Sunucu başlatma
POST /servers/{server_id}/stop
Sunucu durdurma
POST /servers/{server_id}/restart
Sunucu yeniden başlatma

Sunucu İşlemleri

POST /servers/{server_id}/reinstall
Yeniden kurulum
POST /servers/{server_id}/password-reset
Şifre sıfırlama
POST /servers/{server_id}/upgrade
Paket yükseltme

IP Yönetimi

POST /servers/{server_id}/ips/purchase
Ek IP satın alma
POST /servers/{server_id}/ips/{ip_address}
rDNS ayarlama
GET /servers/{server_id}/ips/{ip_address}/rdns
rDNS bilgisi alma
DELETE /servers/{server_id}/ips/{ip_address}
Ek IP iptal etme

Bilgi Endpoint'leri

GET /packages
Paket listesi
GET /locations
Lokasyon listesi
GET /operating-systems
İşletim sistemi listesi
GET /tickets
Ticket listesi
GET /tickets/{ticket_number}
Ticket detayı
POST /tickets/{ticket_number}/reply
Ticket yanıtlama
GET /version-check
Versiyon kontrolü

Güvenlik ve Validasyon

Şifre Politikası

Modül aşağıdaki şifre gereksinimlerini kontrol eder:

  • Minimum 8 karakter
  • En az bir büyük harf (A-Z)
  • En az bir küçük harf (a-z)
  • En az bir rakam (0-9)
  • En az bir sembol (!@#$%^&*-)
  • Sadece izin verilen karakterler: harfler, rakamlar ve !@#$%^&*- sembolleri

Otomatik Güvenli Şifre Oluşturma

Eğer kullanıcı tarafından girilen şifre gereksinimleri karşılamıyorsa veya boşsa, modül otomatik olarak 9 karakterlik güvenli bir şifre oluşturur. Bu şifre tüm gereksinimleri karşılar ve karakterler karıştırılarak rastgele sıralanır.

API Key Güvenliği

  • API anahtarları WHMCS'in güvenli veritabanında saklanır
  • API anahtarları asla frontend'de görüntülenmez
  • IP whitelist kontrolü ile sadece yetkili IP'lerden erişim sağlanır

OS'ye Göre Username

Sunucu oluşturulduğunda, işletim sistemine göre otomatik username atanır:

  • Windows OS'ler: Administrator
  • Diğer OS'ler: root

Bu bilgi WHMCS'in username field'ına kaydedilir ve müşteri panelinde gösterilir.

Sorun Giderme

Yaygın Sorunlar ve Çözümleri

"API Key boş olamaz" Hatası

Çözüm: Sunucu modülü ayarlarında API Key'in doğru girildiğinden emin olun. API Key alanının boş olmadığından kontrol edin.

"IP address not whitelisted" Hatası

Çözüm: Netlen Cloud panelinde API anahtarınız için WHMCS sunucunuzun IP adresini ekleyin. Reseller → API menüsünden IP ekleyebilirsiniz.

"Insufficient balance" Hatası

Çözüm: Müşterinin Netlen Cloud hesabında yeterli bakiye olmalıdır. Bakiye kontrolü sunucu oluşturulmadan önce yapılır.

"Package not found" Hatası

Çözüm: Plan ID'nin doğru olduğundan emin olun. Plan'ın aktif olduğundan kontrol edin.

"Location not found" Hatası

Çözüm: Location ID'nin doğru olduğundan emin olun. Location'ın aktif olduğundan kontrol edin.

"OS Version not found" Hatası

Çözüm: OS Version ID'nin doğru olduğundan emin olun. OS Version'ın aktif olduğundan kontrol edin.

Configurable Options Oluşturma Hatası

Çözüm: Veritabanı yapısının doğru olduğundan emin olun. WHMCS Database Capsule sınıfının mevcut olduğundan kontrol edin.

CORS Hatası

Çözüm: Addon modülünde AJAX istekleri modülün kendi proxy'si üzerinden yapılır. Bu sayede CORS sorunları çözülür.

Destek

Sorularınız ve destek talepleriniz için bizimle iletişime geçebilirsiniz:

E-posta

support@netlen.com

Web Sitesi

https://www.netlen.com

API Dokümantasyon

API Dokümantasyon

API Panel

API Yönetim Paneli

Versiyon Bilgisi: Bu dokümantasyon Netlen Cloud WHMCS Modülü v1.0.1 için hazırlanmıştır. Modül Netlen Cloud API v1.0.7 ile uyumludur.
Netlen Cloud

Profesyonel bulut sunucu yönetimi için kapsamlı WHMCS entegrasyonu

Versiyon 1.0.1 | Netlen Cloud API v1.0.7

© 2012-2026 Netlen. Tüm hakları saklıdır.