Перепродажа лицензий ispmanager через WHMCS

Модуль ispmanager NOC для WHMCS автоматизирует перепродажу лицензий ispmanager через WHMCS.

Возможности модуля

Требования модуля

Рекомендуемая версия WHMCS — 8.9 или выше.

Модуль ispmanager NOC доступен бесплатно, но требует установки.

Установка модуля

1. Подключитесь к серверу с WHMCS по SSH.

2. Перейдите в директорию modules. Директория modules находится в директории, в которую был установлен WHMCS.

   cd /КОРЕНЬ_WHMCS/modules/

3. Скачайте модуль ispmanager NOC:

    wget https://www.ispmanager.com/static/files/whmcs/whmcs_ispmanager_noc.zip

   Если терминал не распознает утилиту wget

   Установите ее:

   Для Debian-подобных ОС

   apt install wget

   Для RHEL-подобных ОС

   yum install wget

4. Распакуйте модуль в директории modules:

   unzip whmcs_ispmanager_noc.zip

   Если терминал не распознает утилиту unzip

   Установите ее:

   Для Debian-подобных ОС

   apt install unzip
   

   Для RHEL-подобных ОС

   yum install unzip
   

После распаковки модуль активируется автоматически и станет доступен для использования. Для проверки:

1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
2. Перейдите в раздел Configurations → Apps & Integrations.

3. Введите в строке поиска «ispmanager». В списке должен появиться модуль ispmanager NOC с отметкой Active.

   

Настройка интеграции между WHMCS и ispmanager

Для перепродажи лицензий настройте интеграцию между WHMCS и ispmanager. Для этого создайте сервер в WHMCS и укажите в нем данные от личного кабинета в ispmanager. Если для перепродажи используется несколько личных кабинетов ispmanager, создайте по серверу для каждого.

Чтобы заказ лицензий выполнялся автоматически, после создания сервера привяжите его к лицензиям в настройках услуг. Привязка доступна только для:

• сервера по умолчанию для модуля
• серверов в составе группы

Если для перепродажи лицензий, SSL-сертификатов и модулей ispmanager будет использован один личный кабинет ispmanager, достаточно назначить сервер ispmanager сервером по умолчанию.

Если будет использовано несколько аккаунтов, создайте для каждого сервера ispmanager свою группу.

Создание сервера

1. Если у вас еще нет личного кабинета в ispmanager, зарегистрируйтесь.
2. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
3. Перейдите в раздел Configurations → System Settings.
4. Выберите блок Servers.
5. Нажмите Add New Server.
6. Заполните поля. Обязательные поля отмечены звездочками.
   • Module* — выберите «ispmanager NOC»
   • Hostname or IP Address* — укажите доменное имя личного кабинета ispmanager — my.ispmanager.ru или eu.ispmanager.com
   • Username* — имя пользователя в личном кабинете ispmanager
   • Password* — пароль пользователя в личном кабинете ispmanager
   • Access Hash — оставьте пустым
7. Нажмите Continue.
8. Заполните остальные поля. Обязательные поля отмечены звездочками.
   • Общие сведения:
     • Name* — произвольное название, под которым сервер ispmanager сохранится в WHMCS. Название сервера будет доступно для просмотра только администратору WHMCS.
     • Assigned IP Addresses — оставьте поле пустым.
     • Monthly Cost — оставьте поле пустым.
     • Datacenter/NOC — оставьте поле пустым.

     • Maximum No. of Accounts — ограничение на количество лицензий, доступных для перепродажи с использованием сервера. Значение используется для расчета заполненности серверов в группе при распределении заказываемых лицензий между серверами. Если сервер не добавлен в группу или является единственным сервером в группе, значение не применяется. 

       Реальное количество доступных для перепродажи лицензий ispmanager не ограничено.

     • Server Status Address — оставьте поле пустым.
     • Enable/Disable — статус сервера: включен/выключен. Выключенный сервер нельзя будет подключить к новой услуге при ее создании. Действующие услуги, привязанные к выключенному серверу, будут доступны для заказа, но для них не будет автоматически заказана лицензия.
   • Nameservers — оставьте поля пустыми.
   • SSO Access Control — доступ к единому входу:
     • Unrestricted — неограниченный: разрешить всем администраторам WHMCS автоматически авторизовываться в личном кабинете ispmanager
       • Restricted — ограниченный: разрешить автоматическую авторизацию в личном кабинете ispmanager только администраторам и пользователям WHMCS с указанной ролью:
         • Full Administrator — полный администратор
         • Sales Operator — оператор отдела продаж
         • Support Operator — оператор технической поддержки
9. Нажмите Save Changes.

Создание группы серверов

Создайте группу серверов, если для перепродажи используется несколько личных кабинетов ispmanager. Это позволит привязать группу к лицензиям в настройках услуг и автоматизировать их заказ.

1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
2. Перейдите в раздел Configurations → System Settings.
3. Выберите блок Servers.
4. Нажмите Create New Group.
5. Заполните поля:
   • Name — название, под которым группа сохранится в WHMCS. Название группы будет доступно для просмотра только администратору WHMCS.

   • Fill Type — правило, по которому из группы будет выбираться сервер для заказа лицензий ispmanager, если в группе несколько серверов.

     • Add to the least full server — лицензии будут заказываться через самый свободный сервер.
     • Fill active server until full then switch to next least used — лицензии будут заказываться через сервер по умолчанию или первый сервер по алфавиту, если сервер по умолчанию не входит в группу, пока он не заполнится, а затем — через самый свободный сервер.

     Заполненность сервера вычисляется по соотношению уже созданных заказов к максимально допустимому количеству.

   • Selected Servers — серверы в группе. Для добавления сервера в группу выделите его в левой колонке и нажмите Add:

     

6. Нажмите Save Changes.

Сервер по умолчанию

Для каждого модуля в WHMCS назначается сервер по умолчанию. Сервер по умолчанию используется для обработки услуг: 

• если в настройках модуля при создании услуги не указана группа серверов (выбрана опция «None»)
• в качестве приоритетного в составе группы серверов 

Единственный сервер автоматически назначается сервером по умолчанию.

Если серверов несколько, чтобы назначить один из них сервером по умолчанию, нажмите на его название в списке. Рядом с сервером по умолчанию появится звездочка:

Создание услуг в WHMCS

Группы услуг

При добавлении услуг в группы в клиентской зоне WHMCS услуги будут объединены в группы в разделе Categories.

1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
2. Перейдите в раздел Configurations → System Settings.
3. Выберите блок Products/Services.

4. Нажмите Create a New Group.

   

5. Заполните поля. Обязательные поля отмечены звездочками.
   • Product Group Name* — название группы услуг, под которым она будет отображаться в клиентской зоне WHMCS, например «Лицензии ispmanager»
   • URL — ссылка на группу в клиентской зоне WHMCS. При скрытии группа будет доступна по указанной ссылке.
   • Product Group Headline — заголовок, c которым группа будет отображаться в клиентской зоне WHMCS, например «Три тарифных плана на выбор».
   • Product Group Tagline — подзаголовок, c которым группа будет отображаться в клиентской зоне WHMCS, например «Первые две недели — бесплатно!».

   • Group Features — возможности, которые будут доступны клиенту при заказе любой услуги из группы.

     

   • Order Form Template — шаблон страницы заказа. Шаблон становится доступен для выбора при редактировании группы после ее создания.
     • Use System Default (Standard Cart) — использовать стандартную страницу заказа
     • Use Specific Template — выбрать другую страницу заказа для услуги
   • Available Payment Gateways — доступные платежные системы.
   • Hidden — установите галочку, чтобы скрыть группу услуг из клиентской зоны WHMCS. Группа будет доступна только по прямой ссылке.
6. Нажмите Save Changes.

Услуги

1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
2. Перейдите в раздел Configurations → System Settings.
3. Выберите блок Products/Services.
4. Нажмите Create a New Product.
5. Заполните поля. Обязательные поля отмечены звездочками.
   • Product Type* — выберите Other.
   • Product Group* — группа услуг.
   • Product Name* — название услуги, под которым она будет отображаться в клиентской зоне WHMCS.
   • URL — ссылка на услугу в клиентской зоне WHMCS. При скрытии услуги она будет доступна по указанной ссылке.
   • Module — выберите «ispmanager NOC».
   • Create as Hidden:
     • ON — услуга будет скрыта из клиентской зоне WHMCS и доступна только по прямой ссылке
     • OFF — услуга отобразится в клиентской зоне WHMCS сразу после создания
6. Нажмите Continue.

7. Настройте остальные параметры услуги. Обязательные поля отмечены звездочками.

   Details — общие сведения

   • Product Tagline — слоган, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS при заказе другой услуги, например «Управлять сервером — легко!».
   • Product Short Description — краткое описание, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS при заказе другой услуги, например «Подойдет как для управления собственными проектами, так и для организации виртуального хостинга».
   • Product Description — описание, с которым услуга будет отображаться на странице заказа, например список возможностей.

   • Product Color — цвет темы, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS.
     Чтобы услуга отображалась как рекомендованная при заказе другой услуги, она должна быть добавлена в качестве рекомендованной в настройках другой услуги на вкладке Cross-sells.

     

   • Welcome Email — шаблон приветственного письма, которое будет автоматически отправлено клиенту на электронную почту при активации услуги.

     • None — письмо не будет отправлено автоматически
     • Other Product/Service Welcome Email — будет использован шаблон по умолчанию «Other Product/Service Welcome Email»

     Редактирование шаблона по умолчанию и создание собственных шаблонов доступно в разделе Configuration → System Settings → Email Templates.

     Пример

     Чтобы клиенту при покупке лицензии был отправлен номер лицензии и адрес панели управления, используйте в шаблоне приветственного письма переменные: 

     • {$service_custom_field_licensekey} — ключ лицензии.
     • https://{$service_custom_field_ipaddress}:1500 — адрес панели ispmanager. Значение будет доступно, если клиент укажет IP-адрес при заказе или настройке лицензии в своем личном кабинете WHMCS.
   • Require Domain — оставьте поле пустым.
   • Stock Control — установите галочку, чтобы ограничить количество доступных для заказа услуг, и укажите доступное количество в поле. При достижении этого количества услуга станет недоступной для заказа.
   • Apply Tax — добавить к стоимости услуги налог. Налоги настраиваются в разделе Configuration → System Settings → Tax Configuration.
   • Featured — установите галочку, чтобы услуга отображалась на странице заказа как самая популярная. Доступно не для всех шаблонов страниц заказа.
   • Hidden — установите галочку, чтобы скрыть услугу из клиентской зоны WHMCS. Услуга будет доступна для заказа по прямой ссылке.
   • Retired — установите галочку, чтобы услугу невозможно было заказать ни из клиентской, ни из административной зоны WHMCS, в т. ч. по прямой ссылке.
   Pricing — стоимость и оплата

   • Payment Type* — тип оплаты:

     FreeOne TimeRecurring

     Услуга будет доступна бесплатно.

     Для услуги будет доступна единовременная оплата.

     Установите галочку Enable рядом с валютой EUR/RUB, чтобы активировать цену в этой валюте и укажите:

     • Setup Fee — стоимость услуги
     • Price — единовременный платеж за открытие услуги

     Услуга будет доступна по подписке.

     Используйте расчетные периоды «ежемесячно» и «раз в год». При выборе других периодов заказ лицензии завершится ошибкой.

     Чтобы активировать расчетный период, установите галочку Enable рядом с нужным периодом:

     • One Time/Monthly — ежемесячно
     • Annually — раз в год

     Для каждого активированного периода укажите:

     • Setup Fee — единовременный платеж за открытие услуги
     • Price — стоимость услуги

     

     Для тарифного плана ispmanager trial используйте тип оплаты «Free» или «One Time» с ценой «0».

   • Allow Multiple Quantities* — разрешить заказ нескольких услуг этого вида:
     • No — не разрешать
     • Yes - Multiple Services — при заказе нескольких услуг каждая услуга будет оформлена как отдельный заказ.
     • Yes - Scaling Service — при заказе нескольких услуг все услуги будут оформлены как один заказ. Стоимость заказа будет равна стоимости услуги, умноженной на количество услуг.
   • Recurring Cycles Limit — сколько раз будет продлеваться услуга, для которой выбран тип оплаты «Подписка» (Recurring). При достижении этого количества услуга клиента будет автоматически отменена. Если указать 0, услуга будет продлеваться бесконечно, пока не будет отменена вручную.
   • Auto Terminate/Fixed Term — количество дней, через которое услуга будет автоматически отменена.
   • Termination Email — шаблон письма, которое будет автоматически отправлено клиенту на электронную почту при автоматической отмене услуги, если настроен параметр Auto Terminate/Fixed Term. Создание и редактирование шаблонов доступно в разделе Configuration → System Settings → Email Templates.
   • Prorata Billing — установите галочку, чтобы включить пропорциональную оплату. В этом случае первый платеж при заказе услуги будет рассчитан от даты заказа до даты следующего регулярного списания, а дата регулярного списания будет одинаковой для всех клиентов. Параметры:
     • Prorata Date — день месяца регулярного списания

     • Charge Next Month — день месяца, при заказе после которого платеж за следующий расчетный период будет добавлен к первому платежу. Например, если установить значение 20, для заказов, совершенных после 20 числа, первый платеж будет включать остаток месяца + весь следующий расчетный период. Если оставить значение «0», следующий расчетный период всегда будет включен в первый платеж. Если установить значение «32» — никогда.

       Пример

       Для услуги выбран ежемесячный расчетный период, включена пропорциональная оплата, регулярное списание настроено на 1 число месяца, параметр Charge Next Month равен 20.

       Клиент заказывает услугу 22 января. 

       Его первый платеж будет включать остаток января и весь февраль. Следующий счет будет выставлен 1 марта.

   • On-Demand Renewals* — раннее продление услуги:
     • Use System Default — использовать глобальные настройки, заданные на вкладке Ordering в разделе Configuration → System Settings → General Settings
     • Use Product-Specific Configuration — переопределить глобальные настройки для услуги
     • Check to allow clients to place renewal orders early — установите галочку, чтобы разрешить клиентам создавать заказы на продление услуги и укажите максимальное количество дней до срока оплаты, за которое клиенты могут заказывать продление, для каждого расчетного периода. Чтобы отключить раннее продление для конкретного периода, укажите 0.
   Module Settings — настройки модуля

   • Server Group* — сервер или группа серверов ispmanager. Выберите из списка группу или None, если для услуги будет использоваться сервер по умолчанию.

   • Product ID* — укажите ID нужного тарифа ispmanager.

     Как узнать ID тарифа ispmanager

     Чтобы список ID отобразился корректно, назначьте сервер, который будет использоваться для предоставления услуги, сервером по умолчанию.

     1. Перейдите в раздел Configurations → Apps & Integrations.
     2. Введите в строке поиска «ispmanager».
     3. В списке выберите модуль ispmanager NOC partner module.

     4. В открывшейся форме нажмите Use app. Откроется список лицензий с ID. ID лицензий будут указаны в разделе «Licenses» в колонке «ID».

        

   • Admin phone — оставьте поле пустым.

   Настройте автоматизацию:

   • Automatically setup the product as soon as an order is placed — автоматически заказывать лицензию ispmanager для клиента при размещении заказа
   • Automatically setup the product as soon as the first payment is received — автоматически заказывать лицензию ispmanager для клиента при получении первого платежа по заказу
   • Automatically setup the product when you manually accept a pending order — автоматически заказывать лицензию ispmanager для клиента после подтверждения заказа администратором WHMCS
   • Do not automatically setup this product — не заказывать лицензию ispmanager для клиента автоматически 
   Custom Fields — дополнительные поля

   Дополнительные поля позволяют получать и хранить информацию о клиентах и услугах в административной и клиентской зонах WHMCS, например, IP-адрес клиента или ключ лицензии.

   Для лицензий ispmanager автоматически создаются следующие поля: 

   • licname|License name — поле для названия лицензии, которое будет отображаться в вашем личном кабинете в ispmanager. По умолчанию предлагается для заполнения клиенту при заказе.
   • ip|IP address — поле для IP-адреса клиента. По умолчанию предлагается для заполнения клиенту при заказе.
   • lickey|License key — поле для ключа лицензии. Ключ генерируется автоматически ispmanager и доступен для просмотра в клиентской зоне WHMCS.
   • order_id|Order ID — поле для ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.

   Для добавления собственного поля укажите его параметры в блоке Add New Custom Field:

   • Field Name — название поля.
   • Display Order — порядок отображения поля. По умолчанию поля отображаются в том порядке, в котором они добавлены.
   • Field Type — тип поля:
     • Text Area — текстовое поле в несколько строк
     • Text Box — текстовая строка
     • Link/URL — ссылка/URL
     • Password — пароль
     • Drop Down — выпадающий список
     • Checkbox — чекбоксы
   • Description — описание поля для клиента.
   • Validation — регулярное выражение для проверки введенного значения.
   • Select Options — укажите опции для поля типа «выпадающий список» через запятую.
   • Admin Only — установите галочку, чтобы скрыть поле из клиентской зоны WHMCS. Поле будет доступно только для администратора WHMCS.
   • Required Field — установите галочку, чтобы сделать поле обязательным для заполнения.
   • Show on Order Form — установите галочку, чтобы поле отображалось на странице заказа услуги.
   • Show on Invoice — установите галочку, чтобы поле отображалось в счетах на оплату.

   Чтобы сохранить поле и добавить новое, нажмите Save Changes.

   Configurable options — настраиваемые опции

   Оставьте поля без изменений.

   Upgrades — повышения и понижения тарифа

   При переходе на более дорогой тариф с клиента взимается доплата. Она равна стоимости нового тарифа, умноженной на остаток срока действия лицензии по текущему тарифу.

   Если новый тариф дешевле текущего, разница не возвращается.

   • Packages Upgrades — услуга или услуги, на которые клиент сможет перейти с текущей.
   • Configurable Options — оставьте поле пустым.
   • Upgrade Email — шаблон письма, которое будет автоматически отправлено клиенту на электронную почту при повышении/понижении тарифа. Создание и редактирование шаблонов доступно в разделе Configuration → System Settings → Email Templates.

   Подробнее об повышениях и понижениях тарифа — в официальной документации WHMCS.

   Free Domain — бесплатный домен

   Бесплатный домен может идти бонусом при заказе услуги, например, на 1 год.

   • Free Domain — настройте предоставление бесплатного домена с услугой:
     • None — домен не будет предоставлен.
     • Offer a free domain registration/transfer only (renew as normal) — предлагать бесплатную регистрацию и перенос домена. За продление домена с клиента будет взиматься плата.

     • Offer a free domain registration/transfer and free renewal (if product is renewed) — предлагать бесплатную регистрацию и перенос домена. Продление домена будет для клиента бесплатным.

       Подробнее о настройках продления домена — в официальной документации WHMCS.

   • Free Domain Payment Terms — расчетный период или периоды, при выборе которых при заказе услуги клиенту будет предложен бесплатный домен:
     • One Time/Monthly — ежемесячно
     • Annually — раз в год
   • Free Domain TLD's — доменные зоны верхнего уровня, в которых будет доступен бесплатный домен.

   Чтобы бесплатный домен стал доступен для заказа:

   • активируйте возможность регистрации домена в разделе Configuration → System Settings → General Settings на вкладке Domains:

     

   • в настройках услуги на вкладке Details установите галочку Require Domain
   Cross-sells — рекомендованные товары и услуги

   Рекомендованные товары и услуги будут предложены клиенту при заказе текущей услуги.

   Чтобы добавить товар или услугу в рекомендованные, выберите их из списка Product Cross-sells и нажмите Save Changes.

   Активация и настройка рекомендаций выполняется в разделе Configuration → System Settings → General Settings на вкладке Ordering.

   Other — прочие настройки

   • Custom Affiliate Payout — партнерские выплаты:
     • Use Default — использовать выплаты по умолчанию
     • Percentage — выплачивать процент от стоимости услуг, заказанных привлеченным клиентом
     • Fixed Amount — выплачивать фиксированную сумму
     • No Commission — не выплачивать партнерские выплаты
   • Affiliate Pay Amount — процент или сумма партнерской выплаты. По умолчанию сумма будет выплачиваться регулярно. Чтобы выплата была разовой, установите галочку One Time Payout.
   • Subdomain Options — оставьте поле пустым.
   • Associated Downloads — оставьте поле пустым.
   • Overages Billing — оставьте поле пустым.
   Links — ссылки

   • Direct Shopping Cart Link — прямая ссылка на корзину с добавленной услугой
   • Direct Shopping Cart Link Specifying Template — прямая ссылка на корзину с добавленной услугой и кастомным шаблоном страницы заказа
   • Direct Shopping Cart Link Including Domain — прямая ссылка на корзину с добавленной услугой, на форму выбора домена
   • Product Group Cart Link — прямая ссылка на группу услуг
   • Product URLs — прямая ссылка на услугу 
8. Нажмите Save Changes.
9. Для каждого тарифа ispmanager создайте отдельную услугу.

Перепродажа лицензий в составе VPS/VDS-хостинга

Перепродажа лицензий ispmanager в составе VPS/VDS-хостинга настраивается:

• через дополнение к основной услуге (addon) — в этом случае заказ лицензии необязателен, сервер доступен для заказа и без панели
• через пакет услуг (bundle) — сервер предоставляется только вместе с панелью, от панели нельзя отказаться при заказе

Как правило, пакеты услуг используются для настройки специальных предложений и скидок при покупке клиентом сразу нескольких услуг или заказе на определенный период.

Для настройки перепродажи лицензий ispmanager:

1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
2. Создайте услугу VPS/VDS-хостинга, используя модуль виртуализации.

3. Настройте лицензии ispmanager:

   как дополненияв составе пакета услуг

   1. Перейдите в раздел Configurations → System Settings.
   2. Выберите блок Product Addons.
   3. Нажмите Add New Addon.
   4. Заполните поля. Обязательные поля отмечены звездочками.
      • Addon Type* — выберите Independent Product.
      • Name* — название дополнения, под которым оно будет доступно для заказа в клиентской зоне WHMCS.
      • Module* — модуль для предоставления услуги. Выберите «ispmanager NOC».
      • Create as Hidden*:
        • ON — услуга будет скрыта из клиентской зоне WHMCS и доступна только по прямой ссылке
        • OFF — услуга отобразится в клиентской зоне WHMCS сразу после создания
   5. Нажмите Continue.

   6. Настройте остальные параметры услуги. Обязательные поля отмечены звездочками.

      Details — общие сведения

      • Description — описание, с которым дополнение будет отображаться на странице заказа, например список возможностей.
      • Tax Addon — добавить к стоимости дополнения налог.
      • Show on Order — установите галочку, чтобы дополнение было доступно для заказа с новой услугой. Если галочка не установлена, заказ дополнения будет доступен только для существующих услуг.
      • Suspend Parent Product — установите галочку, чтобы при автоматической заморозке дополнения в связи с просрочкой платежа также замораживалась связанная основная услуга. Настройка автоматической заморозки услуг выполняется в разделе Configuration → System Settings → Automation Settings.
      • Welcome Email — шаблон приветственного письма, которое будет автоматически отправлено клиенту на электронную почту при активации дополнения.
      • Addon Weighting — порядковый номер дополнения в списке дополнений при заказе основной услуги. По умолчанию дополнения отображаются на форме заказа в алфавитном порядке.
      • Hidden — установите галочку, чтобы скрыть дополнение из клиентской зоны WHMCS. Дополнение будет доступно для заказа по прямой ссылке.
      • Retired — установите галочку, чтобы дополнение невозможно было заказать ни из клиентской, ни из административной зоны WHMCS, в т. ч. по прямой ссылке.
      Pricing — стоимость и оплата

      • Payment Type* — тип оплаты:

        FreeOne TimeRecurring

        Дополнение будет доступно бесплатно.

        Для дополнения будет доступна единовременная оплата.

        Установите галочку Enable рядом с валютой EUR/RUB, чтобы активировать цену в этой валюте и укажите:

        • Setup Fee — стоимость дополнения
        • Price — единовременный платеж за открытие дополнения 

        Дополнение будет доступно по подписке.

        Используйте расчетные периоды «ежемесячно» и «раз в год». При выборе других периодов заказ лицензии завершится ошибкой.

        Чтобы активировать расчетный период, установите галочку Enable рядом с нужным периодом:

        • One Time/Monthly — ежемесячно
        • Annually — раз в год

        Для каждого активированного периода укажите:

        • Setup Fee — единовременный платеж за открытие дополнения
        • Price — стоимость дополнения
        Для тарифного плана ispmanager trial используйте тип оплаты «Free» или «One Time» с ценой «0».

      • Prorata Billing — установите галочку, чтобы синхронизировать дату оплаты дополнения с датой оплаты основной услуги
      • Allow Multiple Quantities* — разрешить заказ нескольких дополнений этого вида:
        • No — не разрешать
        • Yes - Scaling Service — при заказе нескольких дополнений все дополнения будут оформлены как один заказ. Стоимость заказа будет равна стоимости дополнения, умноженной на количество дополнений.
      • On-Demand Renewals* — раннее продление дополнения:
        • Use System Default — использовать глобальные настройки, заданные на вкладке Ordering в разделе Configuration → System Settings → General Settings
        • Use Product-Specific Configuration — переопределить глобальные настройки для дополнения
        • Check to allow clients to place renewal orders early — установите галочку, чтобы разрешить клиентам создавать заказы на продление дополнения и укажите максимальное количество дней до срока оплаты, за которое клиенты могут заказывать продление, для каждого расчетного периода. Чтобы отключить раннее продление для конкретного периода, укажите 0.
      Module Settings — настройки модуля

      • Product Type* — выберите «Other»
      • Server Group* —  сервер или группа серверов ispmanager. Выберите из списка группу или None, если для дополнения будет использоваться сервер по умолчанию.

      • Product ID* — укажите ID нужного тарифа ispmanager.

        Как узнать ID тарифа ispmanager

        Чтобы список ID отобразился корректно, назначьте сервер, который будет использоваться для предоставления услуги, сервером по умолчанию.

        1. Перейдите в раздел Configurations → Apps & Integrations.
        2. Введите в строке поиска «ispmanager».
        3. В списке выберите модуль ispmanager NOC partner module.
        4. В открывшейся форме нажмите Use app. Откроется список лицензий с ID. ID лицензий будут указаны в разделе «Licenses» в колонке «ID».
      • Admin phone — оставьте поле пустым.

      Настройте автоматизацию:

      • Automatically setup the addon as soon as an order is placed — автоматически заказывать лицензию ispmanager для клиента при заказе дополнения
      • Automatically setup the addon as soon as the first payment is received — автоматически заказывать лицензию ispmanager для клиента при получении первого платежа по заказу
      • Automatically setup the addon when you manually accept a pending order — автоматически заказывать лицензию ispmanager для клиента после подтверждения заказа администратором WHMCS
      • Do not automatically setup this addon — не заказывать лицензию ispmanager для клиента автоматически
      Custom Fields — дополнительные поля

      Дополнительные поля позволяют получать и хранить информацию о клиентах и услугах в административной и клиентской зонах WHMCS, например, IP-адрес клиента или ключ лицензии.

      Для лицензий ispmanager автоматически создаются следующие поля: 

      • licname|License name — поле для названия лицензии, которое будет отображаться в вашем личном кабинете в ispmanager. По умолчанию предлагается для заполнения клиенту при заказе.
      • ip|IP address — поле для IP-адреса клиента. По умолчанию предлагается для заполнения клиенту при заказе.
      • lickey|License key — поле для ключа лицензии. Ключ генерируется автоматически ispmanager и доступен для просмотра в клиентской зоне WHMCS.
      • order_id|Order ID — поле для ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.

      Для добавления собственного поля укажите его параметры в блоке Add New Custom Field:

      • Field Name — название поля.
      • Display Order — порядок отображения поля. По умолчанию поля отображаются в том порядке, в котором они добавлены.
      • Field Type — тип поля:
        • Text Area — текстовое поле в несколько строк
        • Text Box — текстовая строка
        • Link/URL — ссылка/URL
        • Password — пароль
        • Drop Down — выпадающий список
        • Checkbox — чекбоксы
      • Description — описание поля для клиента.
      • Validation — регулярное выражение для проверки введенного значения.
      • Select Options — укажите опции для поля типа «выпадающий список» через запятую.
      • Admin Only — установите галочку, чтобы скрыть поле из клиентской зоны WHMCS. Поле будет доступно только для администратора WHMCS.
      • Required Field — установите галочку, чтобы сделать поле обязательным для заполнения.
      • Show on Order Form — установите галочку, чтобы поле отображалось на странице заказа услуги.
      • Show on Invoice — установите галочку, чтобы поле отображалось в счетах на оплату.

      Чтобы сохранить поле и добавить новое, нажмите Save Changes.

      Applicable Products — основные услуги

      Укажите услуги VPS/VDS-хостинга, для которых услуга будет доступна как дополнение. Для этого выделите ее в колонке Available Products. Услуга будет автоматически перемещена в колонку Selected Products. Для выбора всех услуг нажмите на стрелочки:

      

      Associated Download — файлы для скачивания

      Оставьте без изменений.

   7. Нажмите Save Changes.
   8. Для каждого тарифа ispmanager создайте отдельное дополнение.

   1. Настройте лицензии ispmanager как дополнения.
   2. Перейдите в раздел Configurations → System Settings.
   3. Выберите блок Product Bundles.
   4. Нажмите Create New Bundle.
   5. Заполните поля. Обязательные поля отмечены звездочками.
      • Name* — название пакета услуг, под которым он будет доступен для заказа в клиентской зоне WHMCS.
      • Valid From* — дата, начиная с которой пакет услуг будет доступен для заказа.
      • Valid Until* — дата, до которой пакет услуг будет доступен для заказа. Чтобы пакет услуг был доступен всегда, установите галочку No Expiry.
      • Uses* — оставьте без изменений.
      • Maximum Uses* — оставьте без изменений.
      • Bundle Items — поле станет доступно для заполнения после сохранения пакета.
      • Allow Promotions — установите галочку, чтобы разрешить использование промокодов при заказе пакета услуг.
      • Show in Product Group — установите галочку, чтобы пакет услуг отображался в клиентской зоне WHMCS. Если галочка не установлена, пакет будет доступен для заказа только по прямой ссылке.
        • Product Group* — группа услуг, в которой в клиентской зоне WHMCS будет отображаться пакет услуг. Выберите «Hosting».
        • Product Description — описание, с которым пакет услуг будет отображаться на странице заказа, например список возможностей.
        • Display Price — цена, с которой пакет услуг будет отображаться на странице заказа.
        • Sort Order — порядковый номер пакета в списке пакетов услуг на странице заказа.
        • Featured — установите галочку, чтобы услуга отображалась на странице заказа как популярная.
        • Order Link — ссылка для заказа пакета услуг.
   6. Нажмите Save Changes.
   7. Чтобы добавить услугу к пакету услуг, нажмите Add Another в поле Bundle Items и заполните параметры услуги. Если для пакета предусмотрены скидки и акции, заказ должен отвечать указанным параметрам для получения скидки/участия в акции. Обязательные поля отмечены звездочками.
      • Type* — выберите Product/Service.
      • Product/Service* — выберите услугу VPS/VDS-хостинга из списка.
      • Billing Cycle — период, на который клиент должен будет заказать услугу. Например, чтобы получить панель ispmanager со скидкой, клиент должен заказать услугу VPS/VDS-хостинга на 1 год.
      • Price Override — чтобы услуга VPS/VDS-хостинга была доступна со скидкой, установите галочку Enable и укажите новую цену в поле Amount. Цена не включает стоимость дополнений и настраиваемых опций.
      • Configurable Options — если для услуги доступны настраиваемые опции и для получения особых условий клиент должен выбрать одну или несколько таких опций, установите галочку Restrict рядом с нужной опцией и укажите ее значение.
      • Addons — установите галочку рядом с лицензией ispmanager.
      • Если при заказе услуги от клиента требуется зарегистрировать домен, настройте требования к домену:
        • Qualifying TLDs — укажите доменные зоны, в которых должен быть зарегистрирован домен клиента
        • Registration Period — укажите срок, на который должен быть зарегистрирован домен:
          • No Restriction — на любой срок
          • 1 Year — на один год
          • 2 Year — на два года
          • и т. д.
        • Price Override — чтобы услуга регистрации домена была доступна со скидкой, установите галочку Enable и укажите новую цену в поле Amount. Цена не включает стоимость дополнений.
        • Domain Addons — если для доменов доступны дополнения и для получения особых условий клиент должен выбрать одно или несколько таких дополнений, установите галочку рядом с нужным дополнением.
   8. Сохраните изменения.

Тестовый заказ в WHMCS

1. Создайте тестовую лицензию. 

   Чтобы при тестовом заказе средства не списывались с вашего счета в ispmanager, используйте для тестовой лицензии в настройках модуля бесплатный тариф ispmanager trial.

2. Авторизуйтесь в WHMCS под тестовой учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php или создайте новую учетную запись.

   Как создать тестовую учетную запись клиента в WHMCS

   1. Нажмите Account → Register. 

      

   2. Заполните поля. Обязательные поля отмечены звездочками. Данные могут быть выдуманными.
      • Personal Information:
        • First Name* — имя тестового клиента
        • Last Name* — фамилия тестового клиента
        • Email Address* — email тестового клиента
        • Phone Number — номер телефона тестового клиента
      • Billing Address:
        • Company Name — место работы
        • Street Address — адрес 1
        • Street Address 2 — адрес 2
        • City — город
        • State — область/край/округ/регион
        • Postcode — почтовый индекс
        • Выберите страну из списка
      • Additional Information:
        • Выберите валюту из списки, например RU или EUR
      • Account Security:
        • Password* — пароль
        • Confirm Password* — подтверждение пароля
        • Generate Password — сгенерировать пароль:
          • Password Length — длина пароля
          • Generated Password — сгенерированный пароль
          • Generate New Password — сгенерировать новый пароль
          • Copy — скопировать сгенерированный пароль
          • Copy to Clipboard and Insert — скопировать и использовать сгенерированный пароль
   3. Нажмите Register.

3. Закажите лицензию.

   Как заказать лицензию в WHMCS

   Внешний вид и набор параметров тестовой лицензии могут отличаться в зависимости от настроек, выбранных при ее создании.

   1. Перейдите в раздел Services → Order New Services.
   2. Выберите группу услуг в меню Categories.
   3. Выберите услугу и нажмите Order Now.
   4. Ознакомьтесь с информацией о заказе и нажмите Checkout.
   5. На шаге Checkout выберите тестовый аккаунт клиента и платежную систему.
   6. Нажмите Complete Order.

   В случае успеха появится подтверждение заказа и его номер:

   

4. Если при создании лицензии на вкладке Module Settings была настроена автоматизация, лицензия ispmanager для тестового клиента будет заказана автоматически. Вам на почту придет письмо от ispmanager с номером лицензии, а в вашем личном кабинете ispmanager в разделе Лицензии ispmanager появится заказанная лицензия.

5. При необходимости удалите тестовый заказ.

   Как удалить тестовый заказ в WHMCS

   1. В административной зоне WHMCS перейдите в раздел Orders → List All Orders.
   2. Выделите нужный заказ в списке.
   3. Нажмите Cancel Order, чтобы отменить его.
   4. Подтвердите отмену.
   5. Выделите заказ и нажмите Delete Order, чтобы удалить его из списка заказов в административной и клиентской зонах WHMCS.

Действия с лицензиями