Zinn Digital® modülü, WHMCS'nin kendi düğmelerini platformumuzda gerçek eylemlere dönüştürür. Bir sipariş, müşterinizin barındırma hizmetini hazırlar. WHMCS'nin vadesi geçmiş fatura otomasyonu hizmeti askıya alır. Faturanın ödendi olarak işaretlenmesi askıyı kaldırır. İptal işlemi, silinmeyi zamanlar. Ve müşteriniz, müşteri alanında kendisini doğrudan içeri alan bir Hosting paneline giriş yap düğmesine sahip olur.
Ücretsizdir, GPL-2.0-veya-sonrası ile lisanslanmıştır ve platformumuza hiçbir ayrıcalıklı yolu yoktur: yaptığı her çağrı, kendi API anahtarınızla bizzat yapabileceğiniz belgelenmiş bir uç noktadır.
Başlamadan önce
İki şeye ihtiyacınız vardır ve ikincisi insanları yanıltır.
- Aktif bir programa sahip bir Zinn® bayi hesabı. zinndigital.com adresinden
kaydolun ve bayiliği açın.
- Site kontenjanı olan bir bayi planı. Müşterilerinizin sipariş ettiği siteler sizin planınızdan
düşülür; bu nedenle içinde yer olan bir plana ihtiyacınız vardır.
⚠️ Bağlantıyı Test Et, bir siparişin başarılı olup olmayacağını size söyleyemez. Programınızı okur ve hiçbir şey hazırlamaz; bu nedenle henüz hiçbir şey satamayan sağlıklı, active bir hesap bildirir. İlk siparişiniz "This organization has no hosting plan, so it cannot host a site yet" uyarısıyla başarısız olursa gerçekleşen durum budur — bayi planınızı satın alın veya uzatın ve siparişi tekrar verin. Modülde herhangi bir sorun yoktur.
1. API anahtarını oluşturun
Zinn® kontrol panelinizde API keys bölümünü açın ve tam olarak şu on bir izinle bir anahtar oluşturun:
| İzin | Neden gereklidir |
|---|
org.create | İlk siparişlerinde müşterinizin Zinn® hesabını açmak için. |
org.read | Müşteri hesaplarınızı okumak için. |
sites.create | Siteyi hazırlamak için. |
sites.view | Bir hizmeti ve kullanımını okumak için. |
sites.delete | Sonlandırmak için. |
reseller.view | Sattıklarınızı listelemek, disk ve bant genişliğini okumak için. |
reseller.provision | Askıya almak, askıyı kaldırmak, müşteriyi içeri almak, planını belirlemek ve paketini değiştirmek için. |
billing.view | Gerçekleştirmeden önce bir yükseltmenin ne kadara mal olacağını okumak için. |
sites.manage | Düğmelerden önbelleği temizlemek ve yedek almak için. |
sites.panel_access | WordPress yöneticisinin şifresini değiştirmek için. |
hosting.php.manage | Yükseltme veya düşürmede PHP sürümünü değiştirmek için. |
⛔ reseller.manage iznini vermeyin. Bir faturalandırma paneline yapıştırılan bir anahtar, ödeme yapılmaması durumunda bir müşteriyi beklemeye alabilmeli ve içeri girişini sağlayabilmelidir. Kendi ödeme ağ geçidi kimlik bilgilerinizi okuyabilmemeli ve yeniden yazabilmemelidir. Daha geniş olanı vermek zorunda kalmamanız için reseller.provision mevcuttur. ⛔ org.create isteğe bağlı değildir. Bu olmadan modül hesaplarınızı okuyabilir ancak bir hesap açamaz; bu yüzden Bağlantıyı Test Et başarılı olur ve ilk sipariş 403 yanıtı verir. ⛔⛔ Tablonun tamamına izin verin ve Bağlantıyı Test Et seçeneğinin bunu yapıp yapmadığınızı size söyleyemeyeceğini unutmayın. Bayi programınızı okur ve hiçbir şey hazırlamaz; bu nedenle bunlardan herhangi biri eksik olan bir anahtar için de yeşil yanar. Bunun yerine elde edeceğiniz şey, aylar sonra, bir müşteriden gelen ve eksik iznin kapsadığı tek bir işlemde alınan 403 hatasıdır.
2. Modülü kurun
- Modülü indirin ve zipten çıkarın.
zinn dizinini, modül dosyası modules/servers/zinn/zinn.php yoluna gelecek şekilde WHMCS kurulumunuza
yükleyin.
⛔ Dizinin adı zinn olmalıdır. WHMCS, bir hazırlama modülünün fonksiyon adlarını dizin adından türetir; bu nedenle dizini zinn-whmcs veya zinndigital olarak yeniden adlandırmak, WHMCS'nin listelediği, seçmenize izin verdiği ve ardından hiçbir yerde hata vermeksizin asla çağırmadığı bir modülle sonuçlanır. Zip zaten doğru ada açılır; sadece adını değiştirmeyin.
3. Sunucuyu ekleyin
WHMCS'de: Yapılandırma → Sistem Ayarları → Sunucular → Yeni Sunucu Ekle.
- Ad: herhangi bir şey, örneğin
Zinn Digital®
- Ana Bilgisayar Adı:
api.zinndigital.com
- Tür:
Zinn Digital®
- Şifre: 1. adımdaki API anahtarınız
⛔ Anahtar, WHMCS'nin şifrelenmiş olarak sakladığı Şifre alanına girer. Bunu bir ürün yapılandırma seçeneğine koymayın — bunlar veritabanında düz metindir ve her yönetici tarafından görülebilir; ayrıca bu kimlik bilgisi müşterilerinizin barındırma hizmetini oluşturabilir ve silebilir.
Bağlantıyı Test Et düğmesine basın. Alanların doldurulduğunu kontrol etmek yerine gerçek bir çağrı yapar ve platformumuzun ne söylediğini bildirir.
4. Ürünü oluşturun
Yapılandırma → Sistem Ayarları → Ürünler/Hizmetler, ardından Modül Ayarları'nı az önce eklediğiniz sunucuya ayarlayın. Alanlar şunlardır:
| Alan | Zorunlu | Açıklaması |
|---|
| Product line | evet | Sattığınız Zinn® serisi — mainstream (yönetilen WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail veya reseller. |
| Stack | evet | Neyin derleneceği: wordpress (varsayılan), woocommerce, php, static, node, one_click, headless_cms, nextcloud veya owncloud. |
| Application | hayır | Yalnızca one_click ve headless_cms yığınları için — hangi uygulamanın kurulacağı. Başka bir yığında bir ad belirtmek reddedilir, çünkü o yığın neyin kurulacağına zaten karar vermiştir. |
| PHP version | hayır | örneğin 8.3. Serinin varsayılanı için boş bırakın. Serinin sunmadığı bir sürüm, sunduğu sürümlerin listesiyle birlikte reddedilir. |
| Plan code | evet | Bu ürünün sattığı Zinn® planı. GET /v1/reseller/prices sizinkileri listeler. Bu alan olmadan verilen bir sipariş reddedilir — aşağıdaki uyarıya bakın. |
| Billing interval | hayır | monthly (varsayılan) veya annual — bu müşteri için sizin toptan satış kaleminizin düzenleneceği aralık. Kendi müşterinizden ne tahsil edeceğiniz WHMCS ürününde belirlenir ve bundan etkilenmez. |
⛔⛔ Plan kodu zorunludur ve bu kod olmadan verilen bir sipariş bilerek reddedilir. 2026-09-01 tarihine kadar bu alan yalnızca dekoratifti ve hiçbir şey onu okumuyordu; bu nedenle modül hiçbir plan içermeyen bir barındırma siparişi veriyordu — ve bunun tüm sonuçları sessizce gerçekleşiyordu. Toptan satış ekstreniz müşterilerinizin canlı aboneliklerinden oluşturulduğundan, hizmet için bir kalem bulunmuyordu ve çalıştığı sürece size hiçbir fatura kesilmiyordu; müşteriniz hiçbir kontenjan devralmıyordu, bu nedenle sitelerine hiçbir disk veya dosya kotası uygulanmıyordu; ve Paket Değiştir'in değiştirebileceği hiçbir şey yoktu, bu nedenle sattığınız bir yükseltme gerçekleştirilemiyordu. Site bu süreç boyunca kusursuz bir şekilde hazırlandı ve hizmet verdi.
Modül artık bunun yerine siparişi reddeder, çünkü tahmin edebileceği güvenli bir plan yoktur: bir tahmin, seçmediğiniz ve fiyatlandırmamış olabileceğiniz bir planda barındırma hazırlayabilir ve — hemen okuduğunuz bir reddin aksine — ancak ve ancak bir ekstre geldiğinde gün yüzüne çıkabilirdi.
Otomatik Kurulum'u dilediğiniz gibi ayarlayın — modül WHMCS hizmet kimliği üzerinde birim işlemlidir (idempotent), bu nedenle yeniden denenen bir hazırlama, size ikincisini faturalandırmak yerine aynı siteyi döndürür.
Her WHMCS eylemi ne yapar
| WHMCS eylemi | Bizim tarafımızda ne olur |
|---|
| Oluştur | Müşterinin Zinn® hesabını oluşturur (veya zaten sahip olduklarını yeniden kullanır) ve sitelerini hazırlar. |
| Askıya Al | Siteyi ödeme yapılmama nedeniyle beklemeye alır. İçerik korunur; hiçbir şey silinmez. |
| Askıyı Kaldır | Sizin beklemenizi kaldırır. |
| Sonlandır | Bir ek süre ile sitenin silinmesini zamanlar. Tarih müşteri alanında görünür. |
| Kullanım güncelleme | Her hizmette diski ve bant genişliğini günde bir kez yeniler. |
| Hosting paneline giriş yap | Müşterinizin paneline doğrudan giden tek seferlik, tek kullanımlık bir oturum açma bağlantısı açar. |
| Paket Değiştir | Hizmeti yükseltir veya düşürür. Paketi ve yeni ürün bir sürüm belirtiyorsa PHP sürümünü taşır. |
| Şifre Değiştir | WordPress yöneticisinin şifresini belirler. Bu tür bir hesabı olmayan yığınlarda bu kutu görünmez. |
| Yenile | Hizmetin hâlâ var olduğunu doğrular. Zinn® barındırma süreklidir, bu nedenle uzatılacak uzak bir dönem yoktur. |
| Kullanımı Eşitle / Önbelleği Temizle / Yedek Al | Yönetici hizmet sayfasındaki düğmeler. Müşteriniz, müşteri alanında Önbelleği Temizle ve Yedek Al özelliklerine sahip olur. |
| Hizmet sekmesi | Durum, plan, disk, bant genişliği, zamanlanmış tüm silme işlemleri ve askıya almayı kimin uyguladığı. |
| İçe Aktar | ListAccounts her sayfayı okur; bu nedenle bir içe aktarma işlemi ilk sayfada sessizce duramaz. |
Yükseltmeler: kim kimi ücretlendirir
Bir siparişte veya bir yükseltmede Zinn® tarafından müşterinize asla fatura kesilmez. Müşterinize WHMCS üzerinden siz fatura kesersiniz; biz size toptan satış ekstreniz üzerinden fatura keseriz. Dolayısıyla bir Paket Değiştirme işlemi, müşterinizin haklarını ve bir sonraki ekstrenizdeki kalemi taşır ve hiçbir karta dokunmaz — WHMCS müşterinizin parasını zaten almış ve kendi orantılı payını hesaplamıştır.
Bir müşterinin ikinci hizmeti. Aynı planda, o planın kendi site kontenjanı altındaki başka bir sitedir ve daha fazla bir hak tanınmaz. Farklı bir planda ise reddedilir: canlı planın değiştirilmesi iki hizmetten birini faturasız bırakacaktır. Ya her ikisini de aynı planda satın ya da müşteriyi WHMCS'de ayrı bir müşteri kaydı olarak kurun.
Şifre Değiştir yalnızca WordPress için mevcuttur. Zinn® barındırmada tek bir "hizmet şifresi" yoktur — müşteriniz paneline giriş düğmesiyle ulaşır — ve bir php veya static sitenin değiştirilecek bir uygulama hesabı bulunmaz. WHMCS, çalışamayacak bir kutu göstermek yerine kutuyu tamamen gizler.
İkiye indirgememeniz gereken üç yanıt
- Askıyı Kaldır bir ret ile yanıt verebilir. Bu, sitenin sizin tarafınızdan değil, kötüye kullanım ekibimiz
tarafından askıya alındığı ve hiçbir faturalandırma panelinin askıyı kaldıramayacağı anlamına gelir. Mesaj bunu belirtir; yeniden denemek yerine yöneticinize gösterin.
- Sonlandır bir silme işlemini zamanlar, gerçekleştirmez. Tarih
pending_deletion_at olarak geri döner ve
müşteri alanı bunu gösterir. Bir müşteriye verilerinin henüz silinmemişken silindiğini söylemek, hiçbir şey söylememekten daha kötüdür.
- Disk ve bant genişliği bilinmiyor olabilir ve bilinmiyor sıfır demek değildir. Bir okuma yapamadığımızda modül,
0 yazmak yerine rakama dokunmaz — aksi takdirde WHMCS, hiçbir okuma alamadığımız bir site için müşterinize güven verici, boş bir kullanım çubuğu gösterirdi.
Sorun giderme
Bağlantıyı Test Et başarılı oluyor ve ilk sipariş bir izin hatasıyla başarısız oluyor. API anahtarında org.create eksiktir. Modülün sitelerini oluşturabilmesi için önce müşterinin hesabını açması gerekir.
Bir sipariş, kuruluşun barındırma planı olmadığını söyleyerek başarısız oluyor. Bayi planınızda site kontenjanı kalmamıştır veya henüz bir plana sahip değilsinizdir. Yukarıdaki Başlamadan önce bölümüne bakın.
Bir sipariş, bir yığından bahsederek başarısız oluyor. Üründeki Stack alanı boştur veya derlemediğimiz bir şeyin adını vermektedir. Başka bir şey satmıyorsanız bunu wordpress olarak ayarlayın.
İptaller başarısız oluyor. Modül sürümü 1.0.0 veya sonraki bir sürümde olduğunuzdan emin olun. Önceki derlemeler hiçbir silme onayı göndermiyordu ve her sonlandırma işlemi reddediliyordu; bu da hizmetin çalışmaya ve faturalandırılmaya devam etmesine neden oluyordu.
Bir alanı adlandıran bir ret. Doğrulama hatalarımız, mesajın ardından parantez içinde alanı ve nedenini belirtir; örneğin (php_version: 7.2 is not offered on this product line). İşlem yapılabilir kısım budur — önündeki cümle kasıtlı olarak genel tutulmuştur.
İndirmenizi doğrulayın
Her arşiv kendi ana bilgisayar adımızdan TLS üzerinden sunulur ve asla üçüncü taraf bir ana bilgisayara yönlendirilmez. SHA-256 sağlama toplamı, indirmeler sayfasındaki indirme bağlantısının yanında yazılıdır. İndirdikten sonra karşılaştırın:
- macOS veya Linux:
shasum -a 256 zinn-whmcs-1.0.0.zip
- Windows:
certutil -hashfile zinn-whmcs-1.0.0.zip SHA256
WHMCS kullanmıyor musunuz?
Diğer her şey için bir HostBill modülü ve tek dosyalı bir PHP istemcisi mevcuttur; her ikisi de ücretsizdir ve her ikisi de aynı indirmeler sayfasındadır. Modüllerin kullandığı her uç nokta API başvuru kılavuzundadır.