Для партнеров

/
/
/
Перепродажа модулей ispmanager через WHMCS

Перепродажа модулей 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, например «Веб-сервер LiteSpeed, инструменты для защиты сайтов Bitninja и DDoS-Guard и др.».

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

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

Услуги

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

  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 при заказе другой услуги, например «Защитите сервер от атак» при рекомендации модуля BitNinja.
    • Product Short Description — краткое описание, с которым услуга будет отображаться в качестве рекомендованной в клиентской зоне WHMCS при заказе другой услуги, например «BitNinja защищает сервер от SQL-инъекций, исходящих спам-атак, межсайтового скриптинга, вирусов и множественных подключений».
    • 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.

      Пример

      Чтобы клиенту при покупке модуля BitNinja был отправлен номер лицензии, используйте в шаблоне приветственного письма переменную {$service_custom_field_bitninjakey}.

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

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

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

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

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

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

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

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

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

      • One Time/Monthly — ежемесячно
      • Quarterly — раз в 3 месяца
      • Semi-Annually — раз в полгода
      • Annually — раз в год

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

      • Setup Fee — единовременный платеж за открытие услуги
      • Price — стоимость услуги
    • 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 модулей будут указаны в разделе «ispmanager modules», а ID сторонних лицензий — в разделе «Other software» в колонке «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, например, ID лицензии ispmanager, для которой заказывается модуль, или доменное имя клиента.

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

    • item|ID of the ispmanager license for which the module is purchased — ID лицензии ispmanager, для которой заказывается модуль. По умолчанию обязательно для заполнения клиентом при заказе.
    • bitninja_email|BitNinja E-mail — почта клиента для авторизации в BitNinja. По умолчанию предлагается для заполнения клиенту при заказе.
    • bitninjakey|BitNinja key — ключ BitNinja.
    • bitninja_password|BitNinja password — пароль клиента для авторизации в BitNinja.
    • order_id|Order ID — поле для ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.
    • item|ID of the ispmanager license for which the module is purchased — ID лицензии ispmanager, для которой заказывается модуль. По умолчанию обязательно для заполнения клиентом при заказе.
    • domain|Domain name — доменное имя клиента, для которого будет настроена защита DDos-Guard. По умолчанию обязательно для заполнения клиентом при заказе.
    • target_ip|Resource IP address — IP-адрес сервера клиента. По умолчанию обязательно для заполнения клиентом при заказе.
    • order_id|Order ID — поле для ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.
    • item|ID of the ispmanager license for which the module is purchased — ID лицензии ispmanager, для которой заказывается модуль. По умолчанию обязательно для заполнения клиентом при заказе.
    • order_id|Order ID — поле для ID заказа. ID генерируется автоматически ispmanager и отображается в вашем личном кабинете в ispmanager.
    • item|ID of the ispmanager license for which the module is purchased — ID лицензии ispmanager, для которой заказывается модуль. По умолчанию обязательно для заполнения клиентом при заказе.
    • 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 — повышения и понижения тарифа

    Для модулей смена тарифа не поддерживается. Оставьте поля без изменений.

    Free 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 создайте отдельную услугу.

Проверка создания услуги

Если услуга была создана корректно, она станет доступна для заказа в клиентской зоне WHMCS. Для проверки: 

  1. Авторизуйтесь в 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.
  2. Перейдите в раздел Services → Order New Services.
  3. Выберите группу услуг в меню Categories. На странице отобразится созданная вами услуга.

Действия с модулями

  1. Авторизуйтесь в WHMCS под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Orders → List All Orders.
  3. Выберите нужный заказ из списка.
  4. В таблице Order Items нажмите Product/Service.
  5. В открывшейся форме выполните нужное действие:

    • Module Commands:

      • Create — заказать модуль
      • Renew — продлить модуль
      • Terminate — отключить модуль
      • Sync — синхронизировать статус (Status), дату окончания действия (Termination Date) и адрес электронной почты (BitNinja E-mail) с данными из личного кабинета ispmanager
  6. Сохраните изменения.
  1. Авторизуйтесь в WHMCS под тестовой учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php.
  2. Перейдите в раздел Services → My services.
  3. Выберите нужную услугу из списка.

  4. На открывшейся странице перейдите на вкладку Additional Information для просмотра информации об услуге:

В этой статье