Jual pengehosan Zinn® daripada WHMCS

Modul Zinn Digital® menukar butang WHMCS sendiri kepada tindakan sebenar pada platform kami. Pesanan memperuntukkan pengehosan pelanggan anda. Automasi invois tertunggak WHMCS menggantungkannya. Menandakan invois telah dibayar melepaskannya. Pembatalan menjadualkan pemadaman. Dan pelanggan anda mendapat butang Log masuk ke panel pengehosan di kawasan pelanggan mereka yang log mereka masuk terus.

Ia adalah percuma, berlesen GPL-2.0-or-later, dan tidak mempunyai laluan keistimewaan ke platform kami: setiap panggilan yang dilakukannya ialah titik akhir didokumentasikan yang boleh anda buat sendiri menggunakan kunci API anda sendiri.

Sebelum anda bermula

Anda memerlukan dua perkara, dan perkara kedua memerangkap orang ramai.

1. Akaun peruncit Zinn® dengan program aktif. Daftar di zinndigital.com dan hidupkan peruncitan semula.
2. Pelan peruncit dengan kuota tapak. Tapak yang dipesan oleh pelanggan anda dikira terhadap pelan anda, jadi anda memerlukan pelan yang mempunyai ruang di dalamnya.

⚠️ Ujian Sambungan 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 "Organisasi ini tiada pelan pengehosan, jadi ia belum boleh mengehoskan tapak", itulah yang telah berlaku — beli atau lanjutkan pelan peruncit anda dan buat pesanan semula. Tiada apa-apa yang rosak pada modul.

1. Buat kunci API

Dalam papan pemuka Zinn® anda, buka Kunci API dan buat satu dengan tepat sebelas kebenaran ini:

| Kebenaran | Sebab 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, dan baca disk serta jalur lebar. | | reseller.provision | Gantung, lepaskan, log masuk pelanggan, tetapkan pelan mereka dan tukar pakej mereka. | | billing.view | Baca kos naik taraf sebelum melakukannya. | | sites.manage | Kosongkan cache dan buat sandaran daripada butang. | | sites.panel_access | Tukar kata laluan pentadbir WordPress. | | hosting.php.manage | Tukar versi PHP pada naik taraf atau turun taraf. |

⛔ Jangan berikan reseller.manage. Kunci yang tampal ke dalam panel pengebilan patut dapat menahan pelanggan kerana tidak membayar dan log masuk mereka. Ia tidak patut dapat membaca dan menulis semula kelayakan gerbang pembayaran anda sendiri. reseller.provision wujud supaya anda tidak perlu memberikan yang lebih besar. ⛔ org.create tidak optional. Tanpanya modul boleh membaca akaun anda dan tidak boleh membuka akaun, jadi Ujian Sambungan lulus dan jawapan pesanan pertama ialah 403. ⛔⛔ Berikan keseluruhan jadual, dan ambil perhatian bahawa Ujian Sambungan tidak dapat memberitahu anda jika anda tidak berbuat demikian. Ia membaca program peruncit anda dan tidak memperuntukkan apa-apa, jadi ia berwarna hijau untuk kunci yang tiada mana-mana daripada ini. Perkara yang anda perolehi sebaliknya ialah 403 pada satu operasi yang diliputi oleh kebenaran yang hilang, beberapa bulan kemudian, daripada pelanggan.

2. Pasang modul

1. Muat turun modul dan nyahzipnya.
2. Muat naik direktori zinn ke dalam pemasangan WHMCS anda supaya fail modul mendarat di modules/servers/zinn/zinn.php.

⛔ Direktori mesti dinamakan zinn. WHMCS menerbitkan nama fungsi modul peruntukan daripada nama direktorinya, jadi menamakannya semula kepada zinn-whmcs atau zinndigital menghasilkan modul yang disenaraikan oleh WHMCS, membolehkan anda memilih, dan kemudian tidak pernah memanggilnya — tanpa ralat di mana-mana. Zip sudah mengezip ke nama yang betul; jangan namakannya semula.

3. Tambah pelayan

Dalam WHMCS: Konfigurasi → Tetapan Sistem → Pelayan → Tambah Pelayan Baharu.

• Nama: apa-apa sahaja, cth. Zinn Digital®
• Nama hos: api.zinndigital.com
• Jenis: Zinn Digital®
• Kata laluan: kunci API anda daripada langkah 1

⛔ Kunci dimasukkan ke dalam medan Kata laluan, yang disimpan terenkripsi oleh WHMCS. Jangan masukkannya dalam pilihan konfigurasi produk — pilihan tersebut adalah teks biasa dalam pangkalan data dan kelihatan kepada setiap pentadbir, dan kelayakan ini boleh mencipta dan memusnahkan pengehosan pelanggan anda.

Tekan Ujian Sambungan. Ia membuat panggilan sebenar dan melaporkan apa yang dikatakan oleh platform kami, bukannya menyemak sama ada medan diisi.

4. Buat produk

Konfigurasi → Tetapan Sistem → Produk/Perkhidmatan, kemudian tetapkan Tetapan Modul kepada pelayan yang baru anda tambahkan. Medan tersebut adalah:

| Medan | Diberikan | Apa ia | | ---------------- | --------- | -------------------------------------------------------------------------- | | Barisan produk | ya | Barisan Zinn® yang anda jual — mainstream (WordPress terurus), 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. | | Staple | ya | Perkara yang dibina: wordpress (lalai), woocommerce, php, static, node, one_click, headless_cms, nextcloud atau owncloud. | | Aplikasi | tidak | Hanya untuk stap one_click dan headless_cms — aplikasi yang hendak dipasang. Penamaan satu pada mana-mana stap lain ditolak, kerana stap itu sudah memutuskan perkara yang dipasang. | | Versi PHP | tidak | cth. 8.3. Biarkan kosong untuk lalai barisan. Versi yang tidak ditawarkan oleh barisan ditolak dengan senarai versi yang ditawarkannya. | | Kod pelan | ya | Pelan Zinn® yang dijual oleh produk ini. GET /v1/reseller/prices menyenaraikan milik anda. Pesanan tanpa kod ini ditolak — lihat amaran di bawah. | | Selang pengebilan | tidak | monthly (lalai) atau annual — selang masa barisan borong anda untuk pelanggan ini dinaikkan. Perkara yang anda caj kepada pelanggan anda sendiri ditetapkan pada produk WHMCS dan tidak terjejas. |

⛔⛔ Kod pelan diperlukan, dan pesanan tanpa kod pelan ditolak secara sengaja. Sehinggalah 2026-09-01 medan ini bersifat hiasan dan tiada apa yang membacanya, jadi modul memesan pengehosan yang tiada pelan langsung — dan setiap akibat daripada itu berlaku secara senyap. Penyata borong anda dibina daripada langganan langsung pelanggan anda, jadi tiada barisan untuk perkhidmatan tersebut dan tiada apa-apa yang diinvoiskan kepada anda selagi ia berjalan; pelanggan anda tidak mewarisi sebarang kuota, jadi tiada kuota cakera atau fail dikenakan pada tapak mereka; dan Tukar Pakej tiada apa-apa untuk ditukar, jadi naik taraf yang anda jual tidak boleh dilakukan. Tapak ini diperuntukkan dan berkhidmat dengan sempurna sepanjang masa.

Modul kini menolak pesanan itu sebaliknya, kerana tiada pelan selamat untuk ia teka: tekaan akan memperuntukkan pengehosan pada pelan yang anda tidak pilih dan mungkin tidak menetapkan harga, dan — tidak seperti penolakan, yang anda baca serta-merta — ia hanya akan muncul apabila penyata tiba, jika ada.

Tetapkan Persediaan Automatik kepada mana-mana yang anda suka — modul ini adalah idempoten pada id perkhidmatan WHMCS, jadi peruntukan yang dicuba semula mengembalikan tapak yang sama dan bukannya mengenakan bayaran kepada anda untuk tapak kedua.

Perkara yang dilakukan oleh setiap tindakan WHMCS

| Tindakan WHMCS | Perkara yang berlaku di pihak kami | | --------------------------- | ---------------------------------------------------------------------------------------- | | Cipta | Mencipta akaun Zinn® pelanggan (atau menggunakan semula akaun yang sedia ada) dan memperuntukkan tapak mereka. | | Gantung | Meletakkan tapak pada pegangan bukan pembayaran. Kandungan disimpan; tiada yang dipadamkan. | | Buka gantung | Melepaskan pegangan anda. | | Tamatkan | Menjadualkan pemadaman tapak, dengan tempoh grace. Tarikh ditunjukkan di kawasan pelanggan. | | Kemas kini penggunaan | Menyegarkan cakera dan jalur lebar pada setiap perkhidmatan, sekali sehari. | | Log masuk ke panel pengehosan | Membuka pautan log masuk sekali guna terus ke panel pelanggan anda. | | Tukar Pakej | Menaik taraf atau menurunkan taraf perkhidmatan. Mengalihkan pakej, dan versi PHP jika produk baharu menamakannya. | | Tukar Kata Laluan | Menetapkan kata laluan pentadbir WordPress. Kotak tidak muncul pada stap yang tidak mempunyai akaun sebegitu. | | Perbaharui | Mengesahkan perkhidmatan masih wujud. Pengehosan Zinn® adalah berterusan, jadi tiada tempoh jauh untuk dilanjutkan. | | Segerak Penggunaan / Kosongkan Cache / Ambil Sandaran | Butang pada halaman perkhidmatan pentadbir. Pelanggan anda mendapat Kosongkan Cache dan Ambil Sandaran di kawasan pelanggan mereka. | | Tab perkhidmatan | Status, pelan, cakera, jalur lebar, sebarang pemadaman berjadual, dan siapa yang meletakkan penggantungan. | | Import | ListAccounts membaca setiap halaman, jadi import tidak boleh berhenti secara senyap pada halaman pertama. |

Naik taraf: siapa mengenakan bayaran kepada siapa

Pelanggan anda tidak pernah diinvois oleh Zinn®, pada pesanan atau pada naik taraf. Anda mengenakan bayaran kepada mereka melalui WHMCS; kami mengenakan bayaran kepada anda, pada penyata borong anda. Jadi Tukar Pakej mengalihkan hak pelanggan anda dan barisan pada penyata seterusnya, dan tidak menyentuh sebarang kad — WHMCS telah pun mengambil wang pelanggan anda dan mengira proratanya sendiri.

Perkhidmatan kedua pelanggan. Pada pelan yang sama, ia adalah tapak lain di bawah kuota tapak pelan itu sendiri, dan tiada apa-apa lagi yang diberikan. Pada pelan berbeza, ia ditolak: menggantikan pelan langsung akan meninggalkan salah satu daripada dua perkhidmatan tidak dibilkan. Sama ada jual kedua-duanya pada pelan yang sama, atau sediakan pelanggan sebagai rekod pelanggan berasingan dalam WHMCS.

Tukar Kata Laluan wujud hanya untuk WordPress. Pengehosan Zinn® tidak mempunyai "kata laluan perkhidmatan" tunggal — pelanggan anda sampai ke panel mereka dengan butang log masuk — dan tapak php atau static tiada akaun aplikasi untuk ditukar. WHMCS menyembunyikan kotak itu sepenuhnya daripada menunjukkan kotak yang tidak boleh berfungsi.

Tiga jawapan yang anda tidak boleh ratakan kepada dua

• Buka gantung boleh menjawab dengan penolakan. Itu bermakna tapak digantung oleh pasukan penderaan kami, bukan oleh anda, dan tiada panel pengebilan boleh melepaskannya. Mesej menyatakan sedemikian; tunjukkan kepada pentadbir anda daripada mencuba semula.
• Tamatkan menjadualkan pemadaman, ia tidak melakukannya. Tarikh kembali sebagai pending_deletion_at dan kawasan pelanggan menunjukkannya. Memberitahu pelanggan bahawa data mereka sudah tiada sedangkan ia tidak adalah lebih teruk daripada tidak memberitahu mereka apa-apa.
• Cakera dan jalur lebar boleh tidak diketahui, dan tidak diketahui bukanlah sifar. Apabila kami tidak dapat mengambil bacaan, modul membiarkan angka itu sebegini rupa daripada menulis 0 — jika tidak, WHMCS akan menunjukkan kepada pelanggan anda bar penggunaan kosong yang meyakinkan untuk tapak yang kami tiada bacaan daripadanya.

Penyelesaian masalah

Ujian Sambungan lulus dan pesanan pertama gagal dengan ralat kebenaran. Kunci API kehilangan org.create. Modul mesti membuka akaun pelanggan sebelum ia boleh mencipta tapak mereka.

Pesanan gagal menyatakan organisasi tiada pelan pengehosan. Pelan peruncit anda tiada kuota tapak yang tinggal, atau anda belum memegang sebarang pelan. Lihat Sebelum anda bermula di atas.

Pesanan gagal menyebut stap. Medan Stap pada produk kosong atau dinamakan sesuatu yang tidak kami bina. Tetapkan ia kepada wordpress melainkan anda menjual sesuatu yang lain.

Pembatalan gagal. Pastikan anda berada pada versi modul 1.0.0 atau lebih baharu. Binaan terdahulu tidak menghantar pengesahan pemadaman dan setiap penamatan ditolak, yang meninggalkan perkhidmatan berjalan dan dibilkan.

Penolakan yang menamakan medan. Ralat pengesahan kami menamakan medan dan sebab dalam kurungan selepas mesej, cth. (php_version: 7.2 tidak ditawarkan pada barisan produk ini). Itulah separuh yang boleh diambil tindakan — ayat di hadapannya sengaja generik.

Sahkan muat turun anda

Setiap arkib disajikan melalui TLS daripada nama hos kami sendiri dan tidak pernah dialihkan ke hos pihak ketiga. Checksum 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

Bukan pada WHMCS?

Terdapat modul HostBill dan klien PHP fail tunggal untuk apa-apa sahaja, kedua-duanya percuma dan kedua-duanya pada halaman muat turun yang sama. Setiap titik akhir yang digunakan oleh modul ada dalam rujukan API.