HOSTKEY faturalandırma sistemiyle çalışmak üzere WHMCS kurulumu ve yapılandırılması¶

Bu makalede

• Gerekli Yazılım
• Modül kurulumu
• Modülü WHMCS'de aktifleştirin
• Konsol Komutlarını Kullanarak HOSTKEY'den Bilgi Yükleme ve Silme
• Fiyat Dışa Aktarma İçin Para Birimi Yapılandırması
• Yeniden satış için belirli ürünleri özelleştirin
• Belirli bir ürünü düzenleyin
• Sipariş edilen ürünlar için ödeme aktivasyonu
• Örnekler ve ipuçları
• Tipik hatalar ve çözümler

Gerekli Yazılım¶

• WHMCS için reseller modülü: download;
• WHMCS sürüm 8.8 veya üzeri.

Modül kurulumu¶

Arşiv içeriğini muhasebe sisteminin kök dizinine (root) çıkarın.

1. Modül arşivini indirip WHMCS kök dizinine unzip yapın

   Arşiv içeriğini muhasebe sisteminin kök dizinine çıkarın.

   WHMCS root, configuration.php dosyalarının, vendor/, modules/, includes/ klasörlerinin bulunduğu yerdir.

   SSH ile:

   cd /path/to/your/whmcs
   

   unzip /path/to/HostkeyResellerMod.zip
   

   FTP ile: Arşiv içeriğini WHMCS kök dizinine yükleyin ve klasörleri birleştirmeyi (merge) onaylayın.

2. Paket açıldıktan sonra yapıyı kontrol edin

   Aşağıdakiler görünmelidir:

   • modules/addons/hostkeyresellermod/
   • modules/servers/hostkeyresellermod/
   • modules/gateways/callback/hostkeyresellermod.php
   • includes/hooks/hostkeyresellermod.php

   Önemli dosyalar:

   • modules/addons/hostkeyresellermod/hostkeyresellermod.php
   • modules/addons/hostkeyresellermod/cron.php
   • modules/addons/hostkeyresellermod/clean.php
   • modules/addons/hostkeyresellermod/import.ini (isteğe bağlı)

3. Admin paneli oturumunuzu yenileyin

   WHMCS admin panelinden çıkış yapıp tekrar giriş yapın. Gerekirse tarayıcı önbelleğinizi temizleyin.

Kopyalama sırasında karşılaşılan yaygın sorunlar¶

• Yanlış klasördeki dosyalar: Modül, WHMCS kök dizini yerine bir alt klasördeyse listede görünmeyecektir.
• Yetki/Sahip (Rights/Owner): Hatalı yetkilendirmeler aktivasyonu/görüntülemeyi engeller.
• Tarayıcı önbelleği/oturum: Yeniden giriş yapmak "modül görünmüyor" sorununu çözer.

Modülü WHMCS'de aktifleştirin¶

1. Eklenti (addon) modülleri listesini açın

   Modülü WHMCS dizinine kopyaladıktan ve dosya sistemi izinlerini yapılandırdıktan sonra, modülü aktifleştirmeniz gerekir. Bunun için:

   • Yol: System Settings > Apps & Integrations > Addon Modules.
   • HOSTKEY VPS/Dedicated öğesini bulun.

   

2. Modülü aktifleştirin ve ayarlara gidin

   • Activate düğmesine tıklayın.
   • Ardından ayarlar formunu açmak için Configure (veya Settings) seçeneğine tıklayın.

   

3. Modül ayarlarını doldurun ve kaydedin

   Alanlar:

   • API Url — HOSTKEY faturalandırma API adresi:
   • Uluslararası: https://invapi.hostkey.com/ (varsayılan).
   • API key — HOSTKEY API'sine erişim anahtarı. talimatları izleyerek edinin; gizli tutun.
   • Preset name prefix — WHMCS listelerinde HOSTKEY ürünlerini görsel olarak ayırt etmek için isim ön eki (varsayılan HKP-).
   • Default product group — Oluşturulan ürünler için WHMCS ürün grubu (varsayılan Hostkey servers).
   • Logging of requests to Hostkey API — Hata ayıklama gerekirse etkinleştirin.

   Save Changes düğmesine tıklayın.

   

4. Erişim ayarlayın (Access Control)

   Modüle erişmesi gereken yönetici gruplarını işaretleyin ("Administrators" grubunu etkinleştirmenizi öneririz).

   Dikkat

   Access Control altında herhangi bir grubu işaretlemezseniz, modül o grup için kullanılabilir olmayacaktır ve yönetici için bile Addons menüsünde görüntülenmeyecektir.

   Her şey doğru yapılmışsa (izinlerin ayarlanması dahil), Addons menüsünde HOSTKEY VPS/Dedicated bölümü görünecektir.

5. Modülü açın ve ürün içe aktarma işlemlerini yapılandırın

   Addons > HOSTKEY VPS/Dedicated yoluna gidin ve yeniden satmak istediğiniz ürünleri seçin:

   • Import VPS products — VPS/VDS için;
   • Import Bare metal products — dedicated sunucular için;
   • Import GPU products — GPU sunucuları için.

   İşaretlenen her kategori için kar marjını (markup) ve formatı ayarlayın:

   • Yüzde olarak: değeri girin ve "%" sembolünü bırakın (örneğin: "10 %").
   • Sabit para birimi olarak: değeri girin ve WHMCS para birimini seçin (örneği: "5 USD").

   Round price to kısmından yuvarlama modunu seçin:

   • Not round — yuvarlama yapmadan.
   • 0.1, 0.2, vb. — onda birler basamağına kadar.
   • 0.25, 0.5, 0.75 — çeyrekler basamağına kadar.
   • 0.5, 1.0 — buçuklar basamağına kadar.
   • 1.0 — tam sayılara kadar.

   

   Ardından ImportProduct/AdjustPrice düğmesine tıklayın.

   Not

   İlk çalıştırma için başka bir yöntem kullanmanızı öneririz; çünkü büyük miktarda bilgi yüklenirken sayfa 504 koduyla sonlanabilir. İlk toplu içe aktarma işleminizde uzun bir yükleme süresi olabilir; eğer 504 hatası alırsanız, konsol üzerinden içe aktarmayı kullanın.

6. Başarılı indirme ve sonraki adımlar

   Modül doğru şekilde bağlandıysa ve aktifleştirildiyse, HOSTKEY ürünlerinin başarıyla indirildiğine dair bir mesaj görünecek ve System Settings > Product/Services menüsündeki ürüne özel ayarlara gitmeniz için bir öneri sunulacaktır.

   

   Product/Services bölümüne gidin:

   • Oluşturulan grupları ve ürünleri kontrol edin.
   • Gerekiyorsa ürünü açın, Pricing sekmesinde fiyatları/periyotları ayarlayın; Details sekmesinde, ürünün vitrinde (showcase) görünmesi için Hidden seçeneğinin işaretini kaldırın.

   

   Not

   Büyük miktarda bilgi durumunda, sayfa 504 Gateway Timeout koduyla sonlanabilir. Ürün listesinin ilk yüklemesi için faturalandırma kök dizininde komutu çalıştırmanızı öneririz.

Konsol Komutlarını Kullanarak HOSTKEY'den Bilgi Yükleme ve Silme¶

cron.php Çalıştırma¶

Hostkey'den bilgi yüklemek için kullanılır. Komutu web sitenizin kök dizininden çalıştırın:

php modules/addons/hostkeyresellermod/cron.php

clean.php Çalıştırma¶

Daha önce HOSTKEY'den alınan bilgileri siler. Komutu web sitenizin kök dizininden çalıştırın:

php modules/addons/hostkeyresellermod/clean.php

Önemli: import.ini dosyası admin ayarlarından üstündür¶

Eğer modules/addons/hostkeyresellermod/ dizininde bir import.ini dosyası varsa, içe aktarma bu dosyadaki ayarlara göre yapılacaktır ve Addons > HOSTKEY VPS/Dedicated sayfasındaki admin paneli üzerinden belirtilen ayarları geçersiz kılacak veya görmezden gelecektir.

Web arayüzü üzerinden yapılan içe aktarma kararsızsa (donma, 504 hatası) veya cron/konsol üzerinden içe aktarma yapıyorsanız import.ini kullanmanızı öneririz.

Admin paneli üzerinden yapılandırma yapmak istiyorsanız, import.ini dosyasını silin veya adını değiştirin:

rm modules/addons/hostkeyresellermod/import.ini

Dosyayı sildikten/adını değiştirdikten sonra içe aktarma tekrar admin panelinde belirtilen değerleri kullanacaktır.

import.ini içerisindeki parametreler¶

Çalışma sırasında komut, modules/addons/hostkeyresellermod/import.ini dosyasını (varsa) kullanır.

import.ini parametreleri:

• template = 5 — 5 yerine WHMCS'deki istediğiniz e-posta şablonunun ID'sini yazın (Email Templates bölümünden görebilirsiniz)
• round = 0 — fiyat yuvarlama (0 = yuvarlama yapma, 10 = 0.1'e kadar, 4 = 0.25'e kadar, 2 = 0.5'e kadar, 1 = 1.0'a kadar)
• vps = 10 % — VPS kar marjı
• bm = 50 USD — Bare metal kar marjı
• gpu = 100 RUB — GPU kar marjı

Örnek import.ini:

[general]
round = 0
template = 5
[markup]
vps = 10 %
bm = 50 USD
gpu = 100 RUB

Dosyanın iki bölümü vardır:

1. general bölümü, yuvarlamayı kontrol eden round parametresini içerir. Parametre için olası değerler:

   • 0 — yuvarlama yok;
   • 10 — en yakın onda birliğe yuvarlama;
   • 4 — en yakın çeyreğe yuvarlama;
   • 2 — en yakın buçukluğa yuvarlama;
   • 1 — en yakın tam sayıya yuvarlama.

2. markup bölümü, her grup için yüzde olarak kar marjını içerir.

   Eğer import.ini dosyası mevcut değilse veya default seçeneği kullanılıyorsa, herhangi bir kar marjı veya yuvarlama uygulanmaz.

Otomatik ön ayar güncelleme (cron)¶

Günün yoğun olmayan saatlerinde günde bir kez olacak şekilde bir zamanlayıcı ayarlamanızı öneririz.

Örnek crontab (her gün 03:30'ta; whmcs yollarını kendi yollarınızla değiştirin):

30 3 * * * /usr/bin/php /path/to/whmcs/modules/addons/hostkeyresellermod/cron.php >/dev/null 2>&1

Zamanlama ipuçları: cron hakkında kısa bilgi, yardımcı araç — crontab.guru.

Fiyat Dışa Aktarma İçin Para Birimi Yapılandırması¶

Ürün fiyatlarını doğru bir şekilde dışa aktarmak için EUR veya USD'ye ve bunlar arasındaki kur oranlarını yapılandırmanız gerekir. Bu işlem Payments >> Currencies bölümünden yapılabilir.

Yeniden satış için belirli ürünleri özelleştirin¶

System Settings >> Product/Services yoluna giderek, yeniden satmak üzere size sunulan tüm ürünların bir tablosunu göreceksiniz.

En sağdaki sütunlardaki simgelere tıklayarak ürün ayarlarını değiştirebilir veya ürünü listeden kaldırabilirsiniz. Ayarların çoğu WHMCS ayarları tarafından belirlenir ve biz sadece yeniden satış için kritik olanlara odaklanacağız.

Belirli bir ürünü düzenleyin¶

Edit simgesine tıklamak sizi Edit Product parametre değiştirme bölümüne götürecektir.

Details sekmesi¶

Bu sekme, mağazanızda görüntülenecek ürün adını değiştirmenize olanak tanır.

Ayrıca, ürünü sipariş formundan kaldırmadan gizlemek için Hidden seçeneğini işaretleyebilirsiniz.

Price sekmesi¶

Bu sekmeyi, ürününüzün size sunulan para birimleri cinsinden fiyatını ayarlamak için kullanın.

Üç tip ödeme (Payment Type) ayarlayabilirsiniz:

• Free - ürün ücretsiz olarak dağıtılır;
• One Time - bir aylık kullanım için tek seferlik ödeme;
• Recurring - belirli bir süre için yinelenen ödeme.

Her dönem ve para birimi için fiyatı ayrı ayrı ayarlarsınız, bu da size fiyatlandırma politikanızı ayarlama esnekliği sağlar:

• One Time/Monthly - Tek seferlik ödeme veya aylık yinelenen ödeme.
• Quarterly - her üç ayda bir (3 ay) ödeme
• Semi-annual - her altı ayda bir (6 ay) ödeme
• Annual - Bir yıllık (12 ay) ödeme

Size iki ayrı fiyat sunulur:

• Setup Fee - ürünün kurulum ücreti;
• Price - ürünün satış fiyatı.

Parametreleri ve fiyatı değiştirdikten sonra Save Changes düğmesine tıklayın ve bu ürün için ayarları kaydedin.

Ayarların başarıyla kaydedildiğini onayladıktan sonra, ürün tablosuna dönmek için sağ üst köşedeki Back to product list düğmesine tıklayın.

Yapılandırıldıktan sonra ürünler müşteri panelinde görünür.

Sipariş edilen ürünlar için ödeme aktivasyonu¶

Herhangi bir sipariş edilen ürünün ödemesi için HOSTKEY hesap bakiyeniz kullanılacaktır. Lütfen otomatik bakiye ödemesi modunun etkinleştirildiğinden emin olun.

Örnekler ve ipuçları¶

• Kar marjı ve yuvarlama örneği: 10% kar marjı ve 0.5'e yuvarlama ile fiyat 123.56 > 136.0 olur.
• Para Birimleri: Payments > Currencies kısmını kontrol edin - EUR/USD kurları ve kullanılan para birimleri arasındaki kurlar ayarlanmış olmalıdır.

Tipik hatalar ve çözümler¶

• Geçersiz API key / 403: API anahtarının geçerliliğini, URL'yi (.com), fazladan boşluk olup olmadığını kontrol edin.
• Modül Addons kısmında görünmüyor: Access Control altındaki grupları kontrol edin, oturumu yenileyin, dosya/sahip yetkilerini kontrol edin.
• İçe aktarmada 504 Gateway Timeout: Konsol üzerinden içe aktarmayı kullanın, max_execution_time süresini artırın.
• Fiyatlar "zarar" gibi görünüyor: Pricing kısmındaki fiyatınızı alış fiyatından daha yüksek ayarlayın; kar marjını ve yuvarlamayı kontrol edin.
• 503 Hatası: Sorunu anlamak için sunucu hata günlüklerini (error.log veya php_error.log) kontrol etmeyi deneyin.