Értékesítsen Zinn® tárhelyet a WHMCS-en keresztül

A Zinn Digital® modul a WHMCS saját gombjait valós műveletekké alakítja át a platformunkon. Egy megrendelés kiépíti az ügyfél tárhelyét. A WHMCS lejárt számlás automatizmusa felfüggeszti azt. A számla kifizetetté jelölése feloldja. A lemondás beütemezi a törlést. Az ügyfele pedig kap egy Bejelentkezés a tárhelykezelőbe gombot az ügyfélterületén, amellyel egyenesen bejelentkezhet.

Ingyenes, GPL-2.0-or-later licencű, és nincs emelt szintű útvonala a platformunkra: minden általa indított hívás egy dokumentált végpont, amelyet saját maga is meghívhat a saját API-kulcsával.

Mielőtt elkezdené

Két dologra van szüksége, és a második szokott problémát okozni.

1. Egy Zinn® viszonteladói fiókra aktív programmal. Regisztráljon a

zinndigital.com oldalon, és kapcsolja be a viszonteladást.

2. Egy webhelykerettel rendelkező viszonteladói csomagra. Az ügyfelek által megrendelt webhelyek csökkentik az Ön csomagjának keretét, ezért olyanra van szüksége, amelyben van ehhez hely.

⚠️ A kapcsolat tesztelése nem tudja megmondani, hogy egy megrendelés sikeres lesz-e. Beolvassa a programot, de nem épít ki semmit, így olyan egészséges active fiókot jelez, amely még nem tud semmit eladni. Ha az első megrendelése a "This organization has no hosting plan, so it cannot host a site yet" hibával hiúsul meg, akkor ez történt – vásárolja meg vagy hosszabbítsa meg a viszonteladói csomagját, és adja le újra a megrendelést. A modullal nincs semmi probléma.

1. Az API-kulcs létrehozása

A Zinn® vezérlőpultján nyissa meg az API-kulcsok lehetőséget, és hozzon létre egyet pontosan ezzel a tizenegy engedéllyel:

| Engedély | Miért van rá szükség | | -------------------- | ----------------------------------------------------------- | | org.create | Az ügyfél Zinn® fiókjának megnyitása az első megrendelésekor. | | org.read | Az ügyfélfiókok olvasása. | | sites.create | A webhely kiépítése. | | sites.view | Egy szolgáltatás és a használatának olvasása. | | sites.delete | Megszüntetés. | | reseller.view | Az eladottak listázása, valamint a lemezterület és a sávszélesség olvasása. | | reseller.provision | Felfüggesztés, feloldás, ügyfél bejelentkeztetése, a csomagjának beállítása és a csomag módosítása. | | billing.view | Egy frissítés költségének olvasása a végrehajtása előtt. | | sites.manage | Gyorsítótár ürítése és biztonsági mentés készítése a gombokról. | | sites.panel_access | A WordPress-adminisztrátor jelszavának módosítása. | | hosting.php.manage | PHP-verzió váltása frissítéskor vagy visszalépéskor. |

⛔ Ne adja meg a reseller.nem_kezelhető (reseller.manage) engedélyt. Egy számlázási panelbe beillesztett kulcsnak képesnek kell lennie arra, hogy nem fizetés miatt visszatartson egy ügyfelet, és bejelentkeztesse. Nem szabadna képesnek lennie arra, hogy olvassa és átírja a saját fizetési átjáró hitelesítő adatait. A reseller.provision azért létezik, hogy ne kelljen megadnia a nagyobb jogosultságot. ⛔ Az org.create nem választható. Enélkül a modul képes olvasni a fiókokat, de nem tud megnyitni egyet sem, így a kapcsolat tesztelése sikeres lesz, de az első megrendelés 403-mal válaszol. ⛔⛔ Adja meg a teljes táblázatot, és vegye figyelembe, hogy a kapcsolat tesztelése nem tudja megmondani, ha ezt nem tette meg. Beolvassa a viszonteladói programját, és semmit sem épít ki, így zöldet mutat olyan kulcs esetén is, amelyből hiányzik ezen engedélyek bármelyike. Ehelyett hónapokkal később, egy ügyféltől kapott 403-as hibaüzenetet fog kapni arra a műveletre vonatkozóan, amelyet a hiányzó engedély fedne le.

2. A modul telepítése

1. Töltse le a modult, és csomagolja ki.
2. Töltse fel a zinn könyvtárat a WHMCS-telepítésbe úgy, hogy a modulfájl a modules/servers/zinn/zinn.php helyre kerüljön.

⛔ A könyvtárnak zinn néven kell szerepelnie. A WHMCS a könyvtárnevéből származtatja a kiépítési modul függvényneveit, így ha átnevezi zinn-whmcs vagy zinndigital névre, az olyan modult eredményez, amelyet a WHMCS megjelenít a listában, enged a kiválasztásához, de soha nem hív meg – méghozzá bárhol jelentkező hiba nélkül. A zip-fájl eleinte a megfelelő névre csomagol ki; egyszerűen ne nevezze át.

3. A kiszolgáló hozzáadása

A WHMCS-ben: Konfiguráció → Rendszerbeállítások → Kiszolgálók → Új kiszolgáló hozzáadása.

• Név: bármi, pl. Zinn Digital®
• Állomásnév: api.zinndigital.com
• Típus: Zinn Digital®
• Jelszó: az 1. lépésben kapott API-kulcs

⛔ A kulcs a Jelszó mezőbe kerül, amelyet a WHMCS titkosítva tárol. Ne tegye be a termékkonfigurációs opciók közé – azok sima szövegként szerepelnek az adatbázisban, és minden adminisztrátor számára láthatók, ez a hitelesítő adat pedig képes létrehozni és megsemmisíteni az ügyfelek tárhelyét.

Nyomja meg a Kapcsolat tesztelése gombot. Ez valós hívást indít, és azt jelenti jelentést, amit a platformunk válaszolt, ahelyett, hogy azt ellenőrizné, hogy a mezők ki vannak-e töltve.

4. A termék létrehozása

Konfiguráció → Rendszerbeállítások → Termékek/Szolgáltatások, majd állítsa a Modulbeállítások lehetőséget az újonnan hozzáadott kiszolgálóra. A mezők a következők:

| Mezõ | Kötelező | Mi ez | | ---------------- | -------- | -------------------------------------------------------------------------- | | Termékcsalád | igen | Az értékesített Zinn® termékcsalád – mainstream (felügyelt WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail vagy reseller. | | Verem | igen | Mi épül fel: wordpress (alapértelmezett), woocommerce, php, static, node, one_click, headless_cms, nextcloud vagy owncloud. | | Alkalmazás | nem | Csak a one_click és headless_cms veremhez – hogy melyik alkalmazást kell telepíteni. Bármely más veremnél a megadott név elutasításra kerül, mivel az a verem már eldönti, hogy mi kerül telepítésre. | | PHP-verzió | nem | pl. 8.3. Hagyja üresen a termékcsalád alapértelmezett értékéhez. A termékcsalád által nem kínált verzió elutasításra kerül az általa kínált verziók listájával együtt. | | Csomagkód | igen | Az a Zinn® csomag, amelyet ez a termék értékesít. A GET /v1/reseller/prices felsorolja az Önéit. Enélkül a megrendelés elutasításra kerül – lásd az alábbi figyelmeztetést. | | Számlázási időszak | nem | monthly (alapértelmezett) vagy annual – az az időszak, amelyre az Ön ezen ügyfélre vonatkozó nagykereskedelmi csomagja szól. Az ügyféltől felszámított díj a WHMCS-terméken van beállítva, és ez nem érinti. |

⛔⛔ A csomagkód kötelező, és a kód nélküli megrendelés szándékosan elutasításra kerül. 2026-09-01-ig a mező dekoratív jellegű volt, és semmi sem olvasta, így a modul olyan tárhelyet rendelt meg, amely semmilyen csomagot nem tartalmazott – és ennek minden következménye észrevétlen maradt. A nagykereskedelmi számlája az ügyfelei élő előfizetéseiből épül fel, így nem volt sor a szolgáltatáshoz, és önnek semmi sem lett kiszámlázva ameddig futott; az ügyfele nem örökölt kereteket, így semmilyen lemez- vagy fájlkvóta nem lett alkalmazva a webhelyére; és a Csomag módosításának sem volt mit módosítania, így az Ön által eladott frissítés nem volt végrehajtható. A webhely mindvégig tökéletesen kiépült és üzemelt.

A modul mostantól inkább elutasítja a megrendelést, mivel nincs olyan biztonságos csomag, amelyet kitalálhatna: egy találgatás olyan csomagon építené ki a tárhelyet, amelyet Ön nem választott ki, és lehetséges, hogy nem árazott be, és – ellentétben az elutasítással, amelyet azonnal észlel – csak egy számla érkezésekor tűnne fel, ha egyáltalán feltűnne.

Állítsa az Automatikus beállítás lehetőséget a tetszőlegesre – a modul idempotens a WHMCS-szolgáltatási azonosítón, így az újrapróbált kiépítés ugyanazt a webhelyet adja vissza ahelyett, hogy egy másodikért számlázna.

Mit csinál az egyes WHMCS-műveletek

| WHMCS-művelet | Mi történik a mi oldalunkon | | --------------------------- | ---------------------------------------------------------------------------------------- | | Létrehozás | Létrehozza az ügyfél Zinn® fiókját (vagy újrahasznosítja a már meglévőt), és kiépíti a webhelyét. | | Felfüggesztés | Nem fizetés miatti zárolás alá helyezi a webhelyet. A tartalom megmarad; semmi sem törlődik. | | Felfüggesztés feloldása | Feloldja az Ön zárolását. | | Megszüntetés | Türelmi idővel beütemezi a webhely törlését. A dátum megjelenik az ügyfélterületen. | | Használat frissítése | Naponta egyszer frissíti a lemezt és a sávszélességet minden szolgáltatáson. | | Bejelentkezés a tárhelykezelőbe | Egy egyszeri, egyszer használatos bejelentkezési hivatkozást nyit meg egyenesen az ügyfél kezelőfelületére. | | Csomag módosítása | Frissíti vagy visszaminősíti a szolgáltatást. Áthelyezi a csomagot, valamint a PHP-verziót, ha az új termék megad ilyet. | | Jelszó módosítása | Beállítja a WordPress-adminisztrátor jelszavát. A mező nem jelenik meg olyan vermeken, amelyek nem rendelkeznek ilyen fiókkal. | | Megújítás | Megerősíti, hogy a szolgáltatás továbbra is létezik. A Zinn® tárhely folyamatos, így nincs távoli, meghosszabbítandó időszak. | | Használat szinkronizálása / Gyorsítótár ürítése / Biztonsági mentés készítése | Gombok az adminisztrátori szolgáltatási oldalon. Az ügyfele megkapja a Gyorsítótár ürítése és a Biztonsági mentés készítése lehetőséget az ügyfélterületén. | | Szolgáltatás fül | Állapot, csomag, lemez, sávszélesség, bármilyen ütemezett törlés, és hogy ki indította el a felfüggesztést. | | Importálás | A ListAccounts minden oldalt beolvas, így az importálás nem állhat le észrevétlenül az elsőnél. |

Frissítések: ki kinek számláz

A Zinn® soha nem számláz az ügyfelének sem megrendeléskor, sem frissítéskor. Ön számláz nekik a WHMCS-en keresztül; mi pedig Önnek számlázunk a nagykereskedelmi számláján. Így a Csomag módosítása áthelyezi az ügyfél jogosultságait és a következő számláján szereplő tételt, és nem nyúl semmilyen kártyához – a WHMCS már levonta az ügyfél pénzét, és kiszámította a saját időarányos részét.

Egy ügyfél második szolgáltatása. Ugyanazon a csomagon ez egy másik webhely az adott csomag saját webhelykeretén belül, és semmi további nem kerül jóváírásra. Eltérő csomagon a rendszer elutasítja: az élő csomag cseréje azt eredményezné, hogy a két szolgáltatás egyike számlázatlan maradna. Vagy értékesítse mindkettőt ugyanazon a csomagon, vagy hozza létre az ügyfelet külön ügyfélrekordként a WHMCS-ben.

A Jelszó módosítása csak a WordPresshez létezik. A Zinn® tárhely nem rendelkezik egységes „szolgáltatási jelszóval” – az ügyfél a bejelentkezési gombbal éri el a kezelőfelületét –, és a php vagy static webhelyeknek nincs módosítható alkalmazási fiókja. A WHMCS ahelyett, hogy olyan mezőt jelenítene meg, amely nem működhet, teljesen elrejti azt.

Három válasz, amelyet nem szabad kettővé tömöríteni

• A felfüggesztés feloldása elutasítással válaszolhat. Ez azt jelenti, hogy a webhelyet a visszaélésekkel foglalkozó csapatunk függesztette fel, nem pedig Ön, és egyetlen számlázási panel sem oldhatja fel. Az üzenet ezt írja; mutassa meg az adminisztrátornak ahelyett, hogy újrapróbálná.
• A megszüntetés törlést ütemez, nem hajt végre egyet. A dátum pending_deletion_at értékként érkezik vissza, és az ügyfélterületen láthatóvá válik. Azt mondani egy ügyfélnek, hogy az adatai már eltűntek, amikor nem is, rosszabb, mint semmit sem mondani.
• A lemez és a sávszélesség lehet ismeretlen, és az ismeretlen nem egyenlő a nullával. Ha nem tudtunk olvasást végezni, a modul ahelyett, hogy 0-t írna be, változatlanul hagyja az értéket – különben a WHMCS megnyugtató, üres használati sávot mutatna az ügyfélnek egy olyan webhelyhez, amelyről nincsen olvasásunk.

Hibaelhárítás

A kapcsolat tesztelése sikeres, az első megrendelés pedig engedélyezési hibával meghiúsul. Az API-kulcsból hiányzik az org.create engedély. A modulnak meg kell nyitnia az ügyfél fiókját, mielőtt létrehozhatná a webhelyét.

Egy megrendelés azzal a hibaüzenettel hiúsul meg, hogy a szervezetnek nincs tárhelycsomagja. A viszonteladói csomagjában nem maradt webhelykeret, vagy még nem is rendelkezik ilyennel. Lásd a fenti Mielőtt elkezdené részt.

Egy megrendelés veremre hivatkozva hiúsul meg. A termék Verem mezője üres, vagy olyan nevet tartalmaz, amelyet nem építünk fel. Állítsa be wordpress értékre, hacsak nem mást értékesít.

A lemondások sikertelenek. Győződjön meg arról, hogy az 1.0.0-s vagy újabb modulverziót használja. A korábbi buildek nem küldtek törlési megerősítést, és minden megszűntetést elutasított a rendszer, ami miatt a szolgáltatás futott és számlázott.

Olyan elutasítás, amely megnevez egy mezőt. Érvényesítési hibáink zárójelben, az üzenet után adják meg a mezőt és az okot, pl. (php_version: 7.2 is not offered on this product line). Ez a hasznos fele – az előtte lévő mondat szándékosan általános.

A letöltés ellenőrzése

Minden archívum TLS-en keresztül érhető el a saját hosztnevünkről, és soha nem irányítják át harmadik fél hosztjára. Az SHA-256 ellenőrző összege a letöltési oldalon a letöltési hivatkozás mellett olvasható. Letöltés után hasonlítsa össze:

• macOS vagy Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
• Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

Nem a WHMCS-t használja?

Létezik egy HostBill-modul és egyfájlos PHP-kliens minden egyébhez, amelyek mindketten ingyenesek, és ugyanazon a letöltési oldalon találhatók meg. Minden olyan végpont, amelyet a modulok használnak, megtalálható az API-referenciában.