Февруари 24, 2026

CloudLinux WHMCS Плъгин

 

Плъгинът CloudLinux Licenses for WHMCS ти позволява автоматично да издаваш лицензи за CloudLinux, Imunify360 и KernelCare директно през WHMCS, когато клиент купи продукт. Лицензите могат да се предоставят безплатно или като допълнителна платена опция.

👉 Всички действия, които извършват върху основния продукт (напр. създаване, спиране и т.н.), се прилагат автоматично и към лиценза.

 

👨‍💻 Какво може да прави администраторът:

  • Създава лиценз

  • Изтрива лиценз

  • Спира/пуска лиценз (само за IP-базирани)

  • Променя IP адреса на лиценза

  • Преглежда информацията за лиценза

 

👤 Какво вижда клиентът:

  • Преглежда детайли за лиценза

  • Може да смени IP адреса на лиценза

 

🔧 Допълнителни възможности на плъгина:

  • Свързване на лицензи с основен продукт, допълнение или конфигурируема опция

  • Автоматично добавяне на лиценз при поръчка

  • Връзка между действията – напр. при “Terminate” на сървър, лиценза също се прекратява

  • Гъвкаво търсене и филтриране по лицензи

 

🗣️ Поддържа много езици (само за provisioning модул)
🛠️ Работи с WHMCS версии 6 и нагоре
❗ Все още не поддържа CloudLinux PRO, но се очаква

 

📦 Инсталация и настройка

🔽 Инсталация:

  1. Изтегли плъгина:
    Продукционен
    Бета

  2. Качи архива в основната папка на WHMCS и го разархивирай
    Изпълни следната команда в терминал:
        php <whmcs_root>/clDeploy.php –migrate
  3. ⚠️ Ако хостингът ти изисква конкретни права върху файлове, провери:
    <whmcs_root>/modules/servers/CloudLinuxLicenses

 

⚙️ Конфигуриране на продукт

  1. Влез в WHMCS → Setup → Products/Services

  2. Създай нова продуктова група

  3. Създай нов продукт от тип Other, сложи му име и го скрий (отметни Hidden)

  4. Не задавай цена – тя ще се определя по друг начин

  5. В таба Module Settings, избери CloudLinux Licenses

  6. Въведи потребителско име и API ключ от CLN акаунта си

  7. Избери продукт (напр. Imunify360) и вид лиценз (тип)

  8. Ако искаш лицензи с ключ, отбележи Create Key based license

  9. Ако искаш клиентът да въведе IP при поръчка, добави custom field

 

➕ Добавка като Add-on (допълнителен модул)

Можеш да направиш лиценза добавка към основния продукт, така че клиентът сам да реши дали го иска.

  1. Отиди в Setup → Product Add-ons → Add New Add-on

  2. Попълни име, цена, цикъл на плащане, и избери продукта

  3. После влез в Add-ons → CloudLinux Licenses Add-on → Add-on Relations, за да свържеш добавката с лиценз

 

🔁 Свързване директно към продукт

Ако искаш сървърът винаги да идва с лиценз:

  1. Не слагай цена на лиценза, а просто увеличи цената на сървъра

  2. После свържи двата продукта чрез
    Add-ons → CloudLinux Licenses Add-on → Products Relations

 

⚙️ Свързване чрез конфигурируема опция (Configurable Options)

Позволява клиентът да избере дали иска лиценз по време на поръчка:

  1. Създай Configurable Option с различни възможности

  2. Свържи я с лиценз през
    Add-ons → CloudLinux Licenses Add-on → Configurable Options Relations

⚠️ Не се поддържа опция тип “quantity”
Не можеш да имаш две еднакви лицензирани опции в един продукт

 

🔑 Настройка на лицензи с ключ

CloudLinux OS:

  • Избери тип CloudLinux

  • Отбележи Use Key

  • Въведи API ключ от CLN (IP Registration Token)

  • Въведи брой сървъри

KernelCare:

  • Избери KernelCare

  • Повтори същите стъпки както горе

Imunify360:

  • Избери Imunify360

  • Въведи Max Users и Key Limit

 

🧾 Поръчка и клиентски панел

Клиентите могат:

  • Да видят своите лицензи

  • Да променят IP адреса на лиценза
    (чрез Change, после Save)

Всички продукти са видими в My Products & Services

 

🛠️ Администраторски панел

Администраторът може:

  • Да създава/трие/спира лиценз

  • Да променя IP адрес (това става ръчно)

  • Да видя детайли на лиценза

 

🧮 Списък с лицензи

В аддон секцията ще намериш списък с всички лицензи, включително:

  • По клиент

  • По IP

  • По продукт

  • По ключ

 

⚠️ Чести проблеми

Проблем: След създаване на сървър продукт, лиценза остава в pending
Причина: IP адресът вече е зает
Решение: Смени IP адреса на сървъра

ℹ️ За момента Imunify360 поддържа само лицензиране чрез ключ, но IP-базирана поддръжка ще бъде добавена скоро.