Modul Zinn Digital® menukarkan butang WHMCS sendiri kepada tindakan sebenar pada platform kami. Pesanan memperuntukkan pengehosan pelanggan anda. Automasi invois tertunggak WHMCS menggantungnya. Menandakan invois sebagai telah dibayar melepaskannya. Pembatalan menjadualkan pemadaman. Dan pelanggan anda mendapat butang Log masuk ke panel pengehosan di kawasan pelanggan mereka yang melog masuk mereka secara terus.
Ia percuma, dilesenkan di bawah GPL-2.0-or-later, dan tiada laluan istimewa ke dalam platform kami: setiap panggilan yang dibuatnya ialah titik akhir terdokumen yang anda sendiri boleh buat dengan kunci API anda sendiri.
Sebelum anda bermula
Anda memerlukan dua perkara, dan perkara kedua sering mengelirukan pengguna.
- Akaun penjual semula Zinn® dengan program yang aktif. Daftar di
zinndigital.com dan aktifkan penjualan semula.
- Pelan penjual semula dengan peruntukan tapak. Tapak yang dipesan oleh pelanggan anda dikira dalam pelan anda,
jadi anda memerlukan pelan yang masih mempunyai ruang.
⚠️ Test Connection tidak dapat memberitahu anda sama ada pesanan akan berjaya. Ia membaca program anda dan tidak memperuntukkan apa-apa, jadi ia melaporkan akaun active yang sihat yang belum boleh menjual apa-apa. Jika pesanan pertama anda gagal dengan "This organization has no hosting plan, so it cannot host a site yet", itulah yang telah berlaku — beli atau lanjutkan pelan penjual semula anda dan buat pesanan itu semula. Tiada masalah dengan modul tersebut.
1. Cipta kunci API
Dalam papan pemuka Zinn® anda, buka API keys dan cipta satu kunci dengan tepat sebelas kebenaran ini:
| Kebenaran | Mengapa ia diperlukan |
|---|
org.create | Buka akaun Zinn® pelanggan anda pada pesanan pertama mereka. |
org.read | Baca akaun pelanggan anda. |
sites.create | Peruntukkan tapak. |
sites.view | Baca perkhidmatan dan penggunaannya. |
sites.delete | Tamatkan. |
reseller.view | Senaraikan perkara yang telah anda jual, serta baca cakera dan lebar jalur. |
reseller.provision | Gantung, lepaskan, log masuk pelanggan, tetapkan pelan mereka dan tukar pakej mereka. |
billing.view | Baca kos naik taraf sebelum melaksanakannya. |
sites.manage | Kosongkan cache dan ambil sandaran daripada butang. |
sites.panel_access | Tukar kata laluan pentadbir WordPress. |
hosting.php.manage | Tukar versi PHP semasa naik taraf atau turun taraf. |
⛔ Jangan berikan reseller.manage. Kunci yang ditampal ke dalam panel pengebilan sepatutnya boleh menahan pelanggan kerana ketiadaan bayaran dan melog masuk mereka. Ia tidak sepatutnya boleh membaca dan menulis semula kelayakan gerbang pembayaran anda sendiri. reseller.provision wujud supaya anda tidak perlu memberikan kebenaran yang lebih besar itu. ⛔ org.create bukan pilihan. Tanpanya modul boleh membaca akaun anda dan tidak boleh membuka akaun, jadi Test Connection lulus dan pesanan pertama membalas 403. ⛔⛔ Berikan keseluruhan jadual, dan ambil perhatian bahawa Test Connection tidak dapat memberitahu anda jika anda tidak berbuat demikian. Ia membaca program penjual semula anda dan tidak memperuntukkan apa-apa, jadi ia berwarna hijau untuk kunci yang kehilangan mana-mana kebenaran ini. Apa yang anda dapat sebaliknya ialah 403 pada satu operasi yang diliputi oleh kebenaran yang hilang itu, beberapa bulan kemudian, daripada pelanggan.
2. Pasang modul
- Muat turun modul dan nyahzipnya.
- Muat naik direktori
zinn ke dalam pemasangan WHMCS anda supaya fail modul berada di
modules/servers/zinn/zinn.php.
⛔ Direktori mesti dinamakan zinn. WHMCS memperoleh nama fungsi modul peruntukan daripada nama direktorinya, jadi menamakannya semula kepada zinn-whmcs atau zinndigital menghasilkan modul yang disenaraikan oleh WHMCS, membolehkan anda memilihnya, dan kemudian tidak pernah dipanggil — tanpa sebarang ralat di mana-mana. Fail zip sememangnya menyahkemas ke nama yang betul; cuma jangan namakannya semula.
3. Tambah pelayan
Dalam WHMCS: Configuration → System Settings → Servers → Add New Server.
- Name: apa sahaja, cth.
Zinn Digital®
- Hostname:
api.zinndigital.com
- Type:
Zinn Digital®
- Password: kunci API anda dari langkah 1
⛔ Kunci tersebut dimasukkan ke dalam medan Password, yang disimpan oleh WHMCS secara disulitkan. Jangan letakkannya dalam pilihan konfigurasi produk — pilihan tersebut adalah teks biasa dalam pangkalan data dan dapat dilihat oleh setiap pentadbir, dan kelayakan ini boleh mencipta dan memusnahkan pengehosan pelanggan anda.
Tekan Test Connection. Ia membuat panggilan sebenar dan melaporkan apa yang dinyatakan oleh platform kami, bukannya sekadar menyemak bahawa medan telah diisi.
4. Cipta produk
Configuration → System Settings → Products/Services, kemudian tetapkan Module Settings kepada pelayan yang baru anda tambahkan. Medannya ialah:
| Medan | Diperlukan | Keterangan |
|---|
| Product line | ya | Barisan Zinn® yang anda jual — mainstream (WordPress diuruskan), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail atau reseller. |
| Stack | ya | Perkara yang dibina: wordpress (lalai), woocommerce, php, static, node, one_click, headless_cms, nextcloud atau owncloud. |
| Application | tidak | Hanya untuk tindanan one_click dan headless_cms — aplikasi yang hendak dipasang. Menamakan satu aplikasi pada mana-mana tindanan lain akan ditolak, kerana tindanan tersebut telah menentukan perkara yang dipasang. |
| PHP version | tidak | cth. 8.3. Biarkan kosong untuk tetapan lalai barisan tersebut. Versi yang tidak ditawarkan oleh barisan tersebut akan ditolak bersama senarai versi yang ditawarkannya. |
| Plan code | ya | Pelan Zinn® yang dijual oleh produk ini. GET /v1/reseller/prices menyenaraikan pelan anda. Pesanan tanpanya akan ditolak — lihat amaran di bawah. |
| Billing interval | tidak | monthly (lalai) atau annual — selang masa pesanan borong anda dinaikkan untuk pelanggan ini. Perkara yang anda caj kepada pelanggan anda sendiri ditetapkan pada produk WHMCS dan tidak terjejas. |
⛔⛔ Plan code diperlukan, dan pesanan tanpa kod ini sengaja ditolak. Sehingga 2026-09-01 medan tersebut hanyalah hiasan dan tiada apa-apa yang membacanya, jadi modul telah memesan pengehosan yang tiada pelan langsung — dan setiap akibat daripada perkara itu berlaku secara senyap. Penyata borong anda dibina daripada langganan langsung pelanggan anda, jadi tiada item baris untuk perkhidmatan tersebut dan anda tidak diinvoiskan apa-apa sepanjang ia berjalan; pelanggan anda tidak mewarisi sebarang peruntukan, jadi tiada kuota cakera atau fail dikenakan pada tapak mereka; dan Change Package tidak mempunyai apa-apa untuk diubah, jadi peningkatan yang anda jual tidak dapat dilaksanakan. Tapak tersebut telah diperuntukkan dan berfungsi dengan sempurna sepanjang tempoh itu.
Modul kini menolak pesanan tersebut sebagai ganti, kerana tiada pelan selamat untuk diteka: tindakan meneka akan memperuntukkan pengehosan pada pelan yang tidak anda pilih dan mungkin belum anda tetapkan harganya, dan — berbeza dengan penolakan, yang anda baca serta-merta — ia hanya akan timbul apabila penyata tiba, jika timbul langsung.
Tetapkan Auto Setup mengikut pilihan anda — modul ini adalah idempoten pada id perkhidmatan WHMCS, jadi percubaan semula peruntukan mengembalikan tapak yang sama dan bukannya mengebilkan anda untuk tapak kedua.
Fungsi setiap tindakan WHMCS
| Tindakan WHMCS | Perkara yang berlaku di pihak kami |
|---|
| Create | Mencipta akaun Zinn® pelanggan (atau menggunakan semula akaun sedia ada mereka) dan memperuntukkan tapak mereka. |
| Suspend | Meletakkan tapak pada penahanan tanpa pembayaran. Kandungan dikekalkan; tiada apa yang dipadamkan. |
| Unsuspend | Melepaskan penahanan anda. |
| Terminate | Menjadualkan pemadaman tapak, dengan tempoh tangguh. Tarikh dipaparkan di kawasan pelanggan. |
| Usage update | Memuat semula cakera dan lebar jalur pada setiap perkhidmatan, sekali sehari. |
| Log in to hosting panel | Membuka pautan log masuk sekali guna secara terus ke panel pelanggan anda. |
| Change Package | Menaik taraf atau menurunkan taraf perkhidmatan. Memindahkan pakej, dan versi PHP jika produk baharu menyatakannya. |
| Change Password | Menetapkan kata laluan pentadbir WordPress. Kotak ini tidak muncul pada tindanan yang tidak mempunyai akaun sedemikian. |
| Renew | Mengesahkan bahawa perkhidmatan masih wujud. Pengehosan Zinn® adalah berterusan, jadi tiada tempoh jarak jauh untuk dilanjutkan. |
| Sync Usage / Purge Cache / Take Backup | Butang pada halaman perkhidmatan pentadbir. Pelanggan anda mendapat Purge Cache dan Take Backup di kawasan pelanggan mereka. |
| Service tab | Status, pelan, cakera, lebar jalur, sebarang pemadaman berjadual, dan pihak yang meletakkan penggantungan. |
| Import | ListAccounts membaca setiap halaman, jadi proses import tidak boleh berhenti secara senyap pada halaman pertama. |
Naik taraf: siapa mengebil siapa
Pelanggan anda tidak pernah diinvoiskan oleh Zinn®, sama ada untuk pesanan atau naik taraf. Anda mengebil mereka melalui WHMCS; kami mengebil anda, pada penyata borong anda. Oleh itu, Change Package memindahkan kelayakan pelanggan anda dan baris pada penyata anda yang seterusnya, dan tidak menyentuh sebarang kad — WHMCS telah mengambil wang pelanggan anda dan mengira prorata sendiri.
Perkhidmatan kedua pelanggan. Pada pelan yang sama, ia merupakan tapak lain di bawah peruntukan tapak pelan itu sendiri, dan tiada apa-apa lagi yang diberikan. Pada pelan yang berbeza, ia ditolak: menggantikan pelan langsung akan menyebabkan salah satu daripada dua perkhidmatan tersebut tidak dibilkan. Sama ada jual kedua-duanya pada pelan yang sama, atau sediakan pelanggan sebagai rekod pelanggan yang berasingan dalam WHMCS.
Change Password hanya wujud untuk WordPress. Pengehosan Zinn® tidak mempunyai satu "kata laluan perkhidmatan" — pelanggan anda mengakses panel mereka dengan butang log masuk — dan tapak php atau static tidak mempunyai akaun aplikasi untuk diubah. WHMCS menyembunyikan kotak tersebut sepenuhnya dan bukannya memaparkan kotak yang tidak boleh berfungsi.
Tiga respons yang tidak boleh disamakan menjadi dua
- Unsuspend boleh membalas dengan penolakan. Ini bermakna tapak tersebut telah digantung oleh pasukan
penyalahgunaan kami, bukan oleh anda, dan tiada panel pengebilan yang boleh melepaskannya. Mesej menyatakan sedemikian; tunjukkan kepada pentadbir anda dan bukannya mencuba lagi.
- Terminate menjadualkan pemadaman, ia tidak melaksanakannya serta-merta. Tarikh dikembalikan sebagai
pending_deletion_at dan kawasan pelanggan menunjukkannya. Memberitahu pelanggan bahawa data mereka telah hilang sedangkan ia belum hilang adalah lebih buruk daripada tidak memberitahu apa-apa kepada mereka.
- Cakera dan lebar jalur boleh menjadi tidak diketahui, dan tidak diketahui bukanlah sifar. Apabila kami tidak dapat mengambil
bacaan, modul membiarkan angka tersebut tanpa diusik dan bukannya menulis 0 — jika tidak, WHMCS akan menunjukkan bar penggunaan kosong yang mengelirukan kepada pelanggan anda untuk tapak yang tiada bacaan daripada kami.
Penyelesaian Masalah
Test Connection lulus dan pesanan pertama gagal dengan ralat kebenaran. Kunci API kehilangan org.create. Modul perlu membuka akaun pelanggan sebelum ia boleh mencipta tapak mereka.
Pesanan gagal dengan menyatakan organisasi tidak mempunyai pelan pengehosan. Pelan penjual semula anda tiada baki peruntukan tapak, atau anda belum memilikinya. Lihat Sebelum anda bermula di atas.
Pesanan gagal dengan menyebut tindanan. Medan Stack pada produk adalah kosong atau menamakan sesuatu yang tidak kami bina. Tetapkan ia kepada wordpress melainkan anda menjual perkara lain.
Pembatalan gagal. Pastikan anda menggunakan modul versi 1.0.0 atau lebih baharu. Binaan terdahulu tidak menghantar pengesahan pemadaman dan setiap penamatan telah ditolak, menyebabkan perkhidmatan terus berjalan dan dibilkan.
Penolakan yang menamakan sesuatu medan. Ralat pengesahan kami menamakan medan dan sebab dalam kurungan selepas mesej, cth. (php_version: 7.2 is not offered on this product line). Itulah bahagian yang memerlukan tindakan — ayat di hadapannya sengaja dibuat secara umum.
Sahkan muat turun anda
Setiap arkib disediakan melalui TLS dari nama hos kami sendiri dan tidak pernah dialihkan ke hos pihak ketiga. Hasil tambah semak SHA-256 dicetak di sebelah pautan muat turun pada halaman muat turun. Bandingkannya selepas memuat turun:
- macOS atau Linux:
shasum -a 256 zinn-whmcs-1.0.0.zip
- Windows:
certutil -hashfile zinn-whmcs-1.0.0.zip SHA256
Tidak menggunakan WHMCS?
Terdapat modul HostBill dan klien PHP fail tunggal untuk apa-apa sistem lain, kedua-duanya percuma dan kedua-duanya berada di halaman muat turun yang sama. Setiap titik akhir yang digunakan oleh modul terdapat dalam rujukan API.