SmarterMail Cloud Modülü
SmarterMail alan adı ve posta kutularını WHMCS ürünleriyle otomatik oluşturur, kota ve kullanım bilgilerini eşitler.
Ön koşullar
- WHMCS 8.x/9.x desteklenen sürüm
- PHP 8.1+, cURL, JSON, XML ve mbstring
- SmarterMail REST API için HTTPS erişimi
- Ayrı API yöneticisi ve DNS kayıt planı
Kurulum adımları
-
1
Yedek ve ön kontrol
WHMCS dosyaları ile veritabanını yedekleyin; işlemi önce staging ortamında uygulayın.
-
2
Dosyaları yükleyin
Paket dizin yapısını bozmadan şu hedeflere yükleyin: modules/servers/smartermailcloud/, modules/addons/smartermailcloud_admin/
-
3
İzinleri doğrulayın
Klasörleri normalde 750/755, dosyaları 640/644 tutun; web sunucusu sahibini doğru ayarlayın ve 777 kullanmayın.
-
4
Bağımlılıkları kurun
Paket vendor klasörü içermiyorsa, composer.json bulunan modül klasöründe üretim bağımlılıklarını kurun.
Komutcomposer install --no-dev --optimize-autoloader -
5
Modülü etkinleştirin
WHMCS yönetiminde sunucu modülünü ve varsa yönetici eklentisini etkinleştirin.
-
6
İlk yapılandırmayı kaydedin
Aşağıdaki modüle özel alanları doldurun; test tamamlanmadan canlı ortam/kimlik bilgilerine geçmeyin.
Yapılandırma
API profili
SmarterMail URL'sini, REST API türünü, servis hesabını, zaman aşımı ve tekrar sayısını yapılandırın.
Ürün limitleri
Alan adı, kullanıcı, disk, alias, liste ve spam filtre limitlerini WHMCS ürününe bağlayın.
Müşteri görünümü
Webmail, SMTP/IMAP/POP3 adreslerini ve SSL portlarını gerçek DNS yapınıza göre tanımlayın.
Kuyruk cron'u
Paketin kuyruk dosyasını gerçek yoluyla her dakika; WHMCS ana cron'unu normal planında çalıştırın.
* * * * * php -q /WHMCS_PATH/modules/servers/smartermailcloud/lib/cron.php
Testler
- Test alan adı ve posta kutusu oluşturun; kota/şifre değerlerini SmarterMail'de doğrulayın.
- SMTP gönderim ve IMAP oturum açma testini TLS ile gerçekleştirin.
- Kuyruğun aynı işi iki kez uygulamadığını ve kullanım verisini güncellediğini kontrol edin.
Güvenlik
- Modern sürümlerde HTTPS REST API kullanın; eski HTTP Legacy API'yi yalnız zorunlu ve izole ortamlarda değerlendirin.
- API parolasını, JWT/token değerini ve posta kutusu şifrelerini loglamayın.
Sorun giderme
Bağlantı başarısız
API sürümü, HTTPS portu, sertifika zinciri, servis hesabı ve SmarterMail API erişimini kontrol edin.
Kota güncellenmiyor
Dakikalık kuyruk görevinin PHP yolunu ve cron günlüğünü inceleyin.