გაყიდეთ Zinn® ჰოსტინგი WHMCS-დან

Zinn Digital®-ის მოდული გარდაქმნის WHMCS-ის საკუთარ ღილაკებს რეალურ მოქმედებებად ჩვენს პლატფორმაზე. შეკვეთა უზრუნველყოფს თქვენი კლიენტის ჰოსტინგის გააქტიურებას. WHMCS-ის ვადაგადაცილებული ინვოისების ავტომატიზაცია აჩერებს მას. ინვოისის გადახდილად მონიშვნა ხსნის შეჩერებას. გაუქმება დაგეგმავს წაშლას. ხოლო თქვენი კლიენტი თავის კლიენტის ზონაში იღებს ღილაკს Log in to hosting panel, რომელსაც ის პირდაპირ სისტემაში შეჰყავს.

ეს არის უფასო, GPL-2.0-or-later ლიცენზიის მქონე და არ გააჩნია პრივილეგირებული წვდომა ჩვენს პლატფორმაზე: თითოეული მოთხოვნა, რომელსაც ის ახორციელებს, არის დოკუმენტირებული საბოლოო წერტილი (endpoint), რომლის განხორციელებაც თავად შეგიძლიათ თქვენი საკუთარი API გასაღებით.

სანამ დაიწყებთ

თქვენ გჭირდებათ ორი რამ, ხოლო მეორე მათგანს ხშირად ყურადღებას არ აქცევენ.

1. Zinn®-ის რესელერის ანგარიში აქტიური პროგრამით. დარეგისტრირდით მისამართზე zinndigital.com და ჩართეთ რესელინგი.
2. რესელერის გეგმა საიტების ხელმისაწვდომი ლიმიტით. საიტები, რომლებსაც თქვენი კლიენტები უკვეთენ, აისახება თქვენს გეგმაზე, ასე რომ გჭირდებათ გეგმა, რომელშიც არის თავისუფალი ადგილი.

⚠️ Test Connection-ს არ შეუძლია გითხრათ, წარმატებით დასრულდება თუ არა შეკვეთა. ის კითხულობს თქვენს პროგრამას და არაფერს აქტიურებს, ამიტომაც იტყობინება გამართული active ანგარიშის შესახებ, რომელსაც ჯერ არ შეუძლია არაფრის გაყიდვა. თუ თქვენი პირველი შეკვეთა შეცდომით დასრულდება: "This organization has no hosting plan, so it cannot host a site yet", სწორედ ეს მოხდა — შეიძინეთ ან გააფართოვეთ თქვენი რესელერის გეგმა და ხელახლა განათავსეთ შეკვეთა. მოდულს არანაირი ხარვეზი არ აქვს.

1. შექმენით API გასაღები

თქვენს Zinn®-ის მართვის პანელში გახსენით API keys და შექმენით გასაღები ზუსტად ამ თერთმეტი უფლებით:

| უფლება | რატომ არის საჭირო | | -------------------- | ----------------------------------------------------------- | | org.create | გახსენით თქვენი კლიენტის Zinn® ანგარიში მისი პირველი შეკვეთისას. | | org.read | წაიკითხეთ თქვენი კლიენტების ანგარიშები. | | sites.create | საიტის გააქტიურება. | | sites.view | სერვისისა და მისი მოხმარების მონაცემების წაკითხვა. | | sites.delete | გაუქმება/წაშლა. | | reseller.view | გაყიდულების სიის ნახვა, დისკისა და გამტარუნარიანობის მონაცემების წაკითხვა. | | reseller.provision | შეჩერება, გათავისუფლება, კლიენტის სისტემაში შესვლა, მათთვის გეგმის დაყენება და პაკეტის შეცვლა. | | billing.view | წაიკითხეთ, რა დაჯდება განახლება მის განხორციელებამდე. | | sites.manage | ქეშის გასუფთავება და სარეზერვო ასლის შექმნა ღილაკებიდან. | | sites.panel_access | WordPress-ის ადმინისტრატორის პაროლის შეცვლა. | | hosting.php.manage | PHP ვერსიის გადართვა პაკეტის გაზრდის ან შემცირებისას. |

⛔ არ მიანიჭოთ reseller.manage. საგადახდო პანელში ჩასმულ გასაღებს უნდა შეეძლოს კლიენტის შეჩერება გადაუხდელობის გამო და მისი სისტემაში შესვლა. მას არ უნდა შეეძლოს თქვენი საკუთარი საგადახდო სისტემის მონაცემების წაკითხვა და გადაწერა. reseller.provision არსებობს იმისათვის, რომ არ მოგიწიოთ უფრო დიდი უფლებამოსილების მინიჭება. ⛔ org.create არ არის არჩევითი. მის გარეშე მოდულს შეუძლია წაიკითხოს თქვენი ანგარიშები, მაგრამ არ შეუძლია ანგარიშის გახსნა, ამიტომ Test Connection გაივლის, ხოლო პირველი შეკვეთა დააბრუნებს 403 შეცდომას. ⛔⛔ მიანიჭეთ მთელი ცხრილი და გაითვალისწინეთ, რომ Test Connection ვერ გეტყვით, თუ რომელიმე მათგანი აკლია. ის კითხულობს თქვენს რესელერის პროგრამას და არაფერს აქტიურებს, ამიტომ მწვანეა იმ გასაღებისთვისაც, რომელსაც აკლია რომელიმე ეს უფლება. სანაცვლოდ, თვეების შემდეგ, მომხმარებლისგან მიიღებთ 403 შეცდომას იმ ერთ ოპერაციაზე, რომელსაც ნაკლული უფლება ფარავს.

2. დააინსტალირეთ მოდული

1. ჩამოტვირთეთ მოდული და ამოარქივეთ იგი.
2. ატვირთეთ zinn დირექტორია თქვენს WHMCS ინსტალაციაში ისე, რომ მოდულის ფაილი აღმოჩნდეს მისამართზე modules/servers/zinn/zinn.php.

⛔ დირექტორიას აუცილებლად უნდა ერქვას zinn. WHMCS სერვისის გააქტიურების მოდულის ფუნქციების სახელებს მისი დირექტორიის სახელიდან აწარმოებს, ამიტომ მისი გადარქმევა zinn-whmcs-ად ან zinndigital-ად წარმოქმნის მოდულს, რომელსაც WHMCS აჩვენებს სიაში, გაძლევთ არჩევის საშუალებას და შემდეგ არასოდეს გამოიძახებს — ყოველგვარი შეცდომის ჩვენების გარეშე. არქივი უკვე სწორი სახელით ამოარქივდება; უბრალოდ არ შეუცვალოთ სახელი.

3. დაამატეთ სერვერი

WHMCS-ში: Configuration → System Settings → Servers → Add New Server.

• Name: ნებისმიერი, მაგ. Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: თქვენი API გასაღები ნაბიჯი 1-დან

⛔ გასაღები იწერება Password ველში, რომელსაც WHMCS დაშიფრულად ინახავს. არ ჩასვათ ის პროდუქტის კონფიგურაციის პარამეტრებში — ეს ველები მონაცემთა ბაზაში ღია ტექსტია და ხილვადია ყველა ადმინისტრატორისთვის, ხოლო ამ მონაცემებს შეუძლია თქვენი კლიენტების ჰოსტინგის შექმნა და წაშლა.

დააჭირეთ Test Connection. ის ახორციელებს რეალურ მოთხოვნას და იტყობინება, თუ რა უპასუხა ჩვენმა პლატფორმამ, იმის ნაცვლად, რომ უბრალოდ შეამოწმოს, შევსებულია თუ არა ველები.

4. შექმენით პროდუქტი

Configuration → System Settings → Products/Services, შემდეგ დააყენეთ Module Settings იმ სერვერზე, რომელიც ახლახან დაამატეთ. ველებია:

| ველი | სავალდებულოა | რა არის ეს | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | დიახ | Zinn®-ის ხაზი, რომელსაც ყიდით — mainstream (მართვადი WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail ან reseller. | | Stack | დიახ | რა იქმნება: wordpress (ნაგულისხმევი), woocommerce, php, static, node, one_click, headless_cms, nextcloud ან owncloud. | | Application | არა | მხოლოდ one_click და headless_cms სტეკებისთვის — რომელი აპლიკაცია დაინსტალირდეს. ნებისმიერ სხვა სტეკზე მისი მითითება უარყოფილია, რადგან ეს სტეკი უკვე განსაზღვრავს, რა დაინსტალირდება. | | PHP version | არა | მაგ. 8.3. დატოვეთ ცარიელი ხაზის ნაგულისხმევი მნიშვნელობისთვის. ვერსია, რომელსაც ხაზი არ გთავაზობთ, უარყოფილია იმ ვერსიების სიით, რომლებსაც ის გთავაზობთ. | | Plan code | დიახ | Zinn®-ის გეგმა, რომელსაც ეს პროდუქტი ყიდის. GET /v1/reseller/prices ჩამოთვლის თქვენსას. შეკვეთა მის გარეშე უარყოფილია — იხილეთ გაფრთხილება ქვემოთ. | | Billing interval | არა | monthly (ნაგულისხმევი) ან annual — ინტერვალი, რომლითაც ირიცხება თქვენი საბითუმო ხაზი ამ კლიენტისთვის. რას ანიჭებთ თქვენს კლიენტს, მითითებულია WHMCS პროდუქტზე და ეს არ მოქმედებს მასზე. |

⛔⛔ Plan code სავალდებულოა, და შეკვეთა მის გარეშე განზრახ უარყოფილია. 2026-09-01-მდე ველი დეკორატიული იყო და არაფერი კითხულობდა მას, ასე რომ მოდული უკვეთავდა ჰოსტინგს, რომელსაც საერთოდ არ ჰქონდა გეგმა — და ამის ყველა შედეგი უხმო იყო. თქვენი საბითუმო ამონაწერი იქმნება თქვენი კლიენტების აქტიური გამოწერებიდან, ასე რომ სერვისისთვის არ არსებობდა ხაზი და თქვენ არაფერი დაგერიცხათ მისი მუშაობის განმავლობაში; თქვენს კლიენტს არ გადაეცემოდა ლიმიტები, ასე რომ მათ საიტზე არ ვრცელდებოდა დისკის ან ფაილების კვოტა; და Change Package-ს არაფერი ჰქონდა შესაცვლელი, ასე რომ თქვენ მიერ გაყიდული განახლება ვერ განხორციელდებოდა. საიტი მუშაობდა და ფუნქციონირებდა სრულყოფილად ამ ხნის განმავლობაში.

ახლა მოდული უარს ამბობს შეკვეთაზე, რადგან არ არსებობს უსაფრთხო გეგმა, რომლის სავარაუდოდ არჩევაც შეეძლო: ვარაუდი გაააქტიურებდა ჰოსტინგს იმ გეგმაზე, რომელიც არ აგირჩევიათ და შესაძლოა ფასიც არ დაგიწესებიათ, და — უარის თქმისგან განსხვავებით, რომელსაც დაუყოვნებლივ ხედავთ — ის გამოჩნდებოდა მხოლოდ ამონაწერის მოსვლისას, ასეთის არსებობის შემთხვევაში.

დააყენეთ Auto Setup თქვენთვის სასურველ პარამეტრზე — მოდული იდემპოტენტურია WHMCS სერვისის ID-ზე, ასე რომ ხელახლა ცდილი გააქტიურება აბრუნებს იმავე საიტს, ნაცვლად იმისა, რომ დაგარიცხოთ საფასური მეორე საიტისთვის.

რას აკეთებს WHMCS-ის თითოეული მოქმედება

| WHMCS მოქმედება | რა ხდება ჩვენს მხარეს | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | ქმნის კლიენტის Zinn® ანგარიშს (ან ხელახლა იყენებს უკვე არსებულს) და უზრუნველყოფს მათი საიტის გააქტიურებას. | | Suspend | აყენებს საიტს გადაუხდელობის გამო შეჩერებაზე. კონტენტი ინახება; არაფერი იშლება. | | Unsuspend | ხსნის თქვენს შეჩერებას. | | Terminate | გეგმავს საიტის წაშლას, საშეღავათო პერიოდით. თარიღი ჩანს კლიენტის ზონაში. | | Usage update | აახლებს დისკისა და გამტარუნარიანობის მონაცემებს თითოეულ სერვისზე, დღეში ერთხელ. | | Log in to hosting panel | ხსნის ერთჯერად შესვლის ბმულს პირდაპირ თქვენი კლიენტის მართვის პანელში. | | Change Package | ზრდის ან ამცირებს სერვისის პაკეტს. გადააქვს პაკეტი და PHP ვერსია, თუ ახალ პროდუქტში მითითებულია ასეთი. | | Change Password | აყენებს WordPress-ის ადმინისტრატორის პაროლს. ველების ბლოკი არ ჩნდება იმ სტეკებზე, რომლებსაც არ აქვთ ასეთი ანგარიში. | | Renew | ადასტურებს, რომ სერვისი კვლავ არსებობს. Zinn® ჰოსტინგი უწყვეტია, ასე რომ არ არსებობს დაშორებული ვადა გასახანგრძლივებლად. | | Sync Usage / Purge Cache / Take Backup | ღილაკები ადმინისტრატორის სერვისის გვერდზე. თქვენი კლიენტი იღებს Purge Cache და Take Backup ფუნქციებს თავის კლიენტის ზონაში. | | Service tab | სტატუსი, გეგმა, დისკი, გამტარუნარიანობა, ნებისმიერი დაგეგმილი წაშლა და ვინ დააწესა შეჩერება. | | Import | ListAccounts კითხულობს თითოეულ გვერდს, ასე რომ იმპორტი ვერ გაჩერდება უხმოდ პირველ გვერდზე. |

განახლებები: ვინ ვის რიცხავს

თქვენს კლიენტს არასოდეს ერიცხება თანხა Zinn®-ის მიერ, არც შეკვეთისას და არც განახლებისას. თქვენ ანიჭებთ მათ ანგარიშს WHMCS-ის მეშვეობით; ჩვენ გარიცხავთ თქვენ, თქვენს საბითუმო ამონაწერში. ასე რომ, Change Package გადააქვს თქვენი კლიენტის უფლებები და ხაზი თქვენს შემდეგ ამონაწერში, და არ ეხება ბარათს — WHMCS-ს უკვე აღებული აქვს თქვენი კლიენტის თანხა და გამოთვლილი აქვს საკუთარი პროპორციული წილი (proration).

კლიენტის მეორე სერვისი. იმავე გეგმაზე ეს არის კიდევ ერთი საიტი ამ გეგმის საკუთარი საიტების ლიმიტის ფარგლებში, და დამატებით არაფერი გაიცემა. სხვა გეგმაზე ის უარყოფილია: აქტიური გეგმის შეცვლა ორ სერვისს შორის ერთ-ერთს დაუტოვებდა დაურიცხავს. ან გაყიდეთ ორივე იმავე გეგმაზე, ან დაარეგისტრირეთ კლიენტი ცალკე კლიენტის ჩანაწერად WHMCS-ში.

Change Password არსებობს მხოლოდ WordPress-ისთვის. Zinn® ჰოსტინგს არ გააჩნია ერთიანი "სერვისის პაროლი" — თქვენი კლიენტი აღწევს თავის პანელს შესვლის ღილაკით — ხოლო php ან static საიტს არ გააჩნია აპლიკაციის ანგარიში შესაცვლელად. WHMCS მთლიანად მალავს ამ ბლოკს, ნაცვლად იმისა, რომ აჩვენოს ის, რაც ვერ იმუშავებს.

სამი პასუხი, რომლებიც არ უნდა დაიყვანოთ ორამდე

• Unsuspend-მა შეიძლება უპასუხოს უარით. ეს ნიშნავს, რომ საიტი შეჩერდა ჩვენი დარღვევების მონიტორინგის გუნდის მიერ და არა თქვენ მიერ, და არცერთ საგადახდო პანელს არ შეუძლია მისი გათავისუფლება. შეტყობინება ამას ამბობს; აჩვენეთ ის თქვენს ადმინისტრატორს ხელახლა ცდის ნაცვლად.
• Terminate გეგმავს წაშლას, ის არ ახორციელებს მას. თარიღი ბრუნდება როგორც pending_deletion_at და კლიენტის ზონა აჩვენებს მას. მომხმარებლისთვის იმის თქმა, რომ მისი მონაცემები უკვე წაშლილია, როდესაც ეს ასე არ არის, უფრო ცუდია, ვიდრე არაფრის თქმა.
• დისკი და გამტარუნარიანობა შეიძლება იყოს უცნობი, ხოლო უცნობი არ ნიშნავს ნულს. როდესაც ჩვენ ვერ შევძელით მონაცემების წაკითხვა, მოდული ხელუხლებლად ტოვებს ციფრს 0-ის ჩაწერის ნაცვლად — წინააღმდეგ შემთხვევაში WHMCS აჩვენებდა თქვენს მომხმარებელს მოხმარების დამამშვიდებელ ცარიელ ზოლს იმ საიტისთვის, რომლიდანაც მონაცემები არ გვაქვს.

პრობლემების აღმოფხვრა

Test Connection გადის, ხოლო პირველი შეკვეთა წარუმატებელია უფლებების შეცდომით. API გასაღებს აკლია org.create. მოდულმა უნდა გახსნას კლიენტის ანგარიში, სანამ შეძლებს მათთვის საიტის შექმნას.

შეკვეთა უარყოფილია შეტყობინებით, რომ ორგანიზაციას არ აქვს ჰოსტინგის გეგმა. თქვენს რესელერის გეგმას არ დარჩა საიტების ლიმიტი, ან ჯერ არ ფლობთ მას. იხილეთ სანამ დაიწყებთ ზემოთ.

შეკვეთა უარყოფილია სტეკის მოხსენიებით. პროდუქტის Stack ველი ცარიელია ან მიუთითებს რაღაცას, რასაც ჩვენ არ ვქმნით. დააყენეთ ის wordpress-ზე, თუ არ ყიდით რაიმე სხვა რამეს.

გაუქმებები უარყოფილია. დარწმუნდით, რომ იყენებთ მოდულის ვერსიას 1.0.0 ან უფრო ახალს. ადრინდელი ვერსიები არ აგზავნიდნენ წაშლის დადასტურებას და თითოეული გაუქმება უარყოფილი იყო, რაც სერვისს ტოვებდა აქტიურ მდგომარეობაში და აგრძელებდა დარიცხვას.

უარი, რომელიც ასახელებს ველს. ჩვენი ვალიდაციის შეცდომები ასახელებენ ველს და მიზეზს ფრჩხილებში შეტყობინების შემდეგ, მაგ. (php_version: 7.2 is not offered on this product line). ეს არის ის ნაწილი, რომელზეც რეაგირებაა საჭირო — მის წინ არსებული წინადადება განზრახ ზოგადია.

შეამოწმეთ თქვენი ჩამოტვირთვა

თითოეული არქივი მიეწოდება TLS პროტოკოლით ჩვენი საკუთარი ჰოსტის სახელიდან და არასოდეს გადამისამართდება მესამე მხარის ჰოსტზე. მისი SHA-256 საკონტროლო ჯამი მითითებულია ჩამოტვირთვის ბმულის გვერდით ჩამოტვირთვების გვერდზე. შეადარეთ ის ჩამოტვირთვის შემდეგ:

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

არ იყენებთ WHMCS-ს?

არსებობს HostBill-ის მოდული და ერთფაილიანი PHP კლიენტი ნებისმიერი სხვა სისტემისთვის, ორივე უფასოა და ორივე ხელმისაწვდომია იმავე ჩამოტვირთვების გვერდზე. თითოეული საბოლოო წერტილი (endpoint), რომელსაც მოდულები იყენებენ, მითითებულია API ცნობარში.