Документация ISPmanager 5 Business

Интеграция с WHMCS

Это документация по устаревшему продукту. Перейти в актуальную документацию

 

Возможности интеграции

Мы разработали два модуля интеграции ISPmanager с WHMCS:

  • ISPmanager
  • ISPmanager Reseller

Общие возможности:

  • Создание пользователя на сервере ISPmanager
  • Включение/выключение пользователя
  • Удаление пользователя
  • Переход в панель со стороны администратора и клиента
  • Изменение тарифного плана пользователя

Особенности:

  • ISPmanager Reseller предназначен для создания услуг с типом "Reseller Account", для интеграции необходим административный пользователь панели ISPmanager.
  • ISPmanager предназначен для создания услуг с типом "Hosting Account", интеграция может быть проведена как под пользователем с административными правами, так и под пользователем с правами реселлера.
Обратите внимание!
Работа модуля интеграции не тестировалась с WHMCS версии 7.8.3 и выше.

Установка модулей интеграции

Для установки модулей интеграции с ISPmanager нужно перейти в директорию modules, расположенную в корневом каталоге установки WHMCS, скачать и распаковать следующие файлы:

Для WHMCS v7.x

http://download.ispsystem.com/extras/whmcs/7/whmcs_isp_isp.tar.gz

Для предыдущих версий

http://download.ispsystem.com/extras/whmcs/whmcs_isp_isp.tar.gz

После установки модулей необходимо перейти в раздел "Setup -> Addon Modules", и нажать "Activate" для модуля "ISPmanager global module". На этом установка модуля завершена. Можно переходить к настройке подключений к серверам и тарифных планов.

Настройка подключения

Для настройки подключения к ISPmanager нужно перейти в раздел "Setup -> Products/Services -> Servers" и нажать "Add New Server" (рекомендуется объединять сервера в группы при добавлении).

Действия при добавлении сервера:

  • Выбрать соответствующий тип сервера: ISPmanager / ISPmanager Reseller
  • Указать URL панели управления ISPmanager,
  • Указать логин и пароль пользователя. В случае с ISPmanager Reseller это будет пользователь с правами администратора. В случае с ISPmanager это может быть как административный пользователь, так и реселлер, в зависимости от необходимости.

Все обращения будут происходить по IP адресу указанному в настройках подключения на порт 1500 по HTTPS протоколу. Для каждого подключения будет доступна кнопка перехода в панель управления, с автоматической авторизацией по временному ключу.

Настройка тарифного плана

При настройке тарифного плана, на первом шаге выбираются следующие значения:

  • Product Type — Hosting Account
  • Product Group — нужная группа продуктов
  • Product Name — нужное наименование тарифного плана

На вкладке "Module Settings" нужно выбрать:

  • Module Name — ISPmanager или ISPmanager Reseller (в зависимости от необходимости)
  • Server Group — группа соответствующих серверов

Далее необходимо указать параметры, с которыми пользователь будет создаваться в ISPmanager. Параметры модулей будут разнится, ниже приведены параметры модуля ISPmanager.

  • Package Name — наименование существующего шаблона пользователя в панели управления ISPmanager. Узнать можно в разделе "Шаблоны"
  • Traffic quota — лимит на потребление трафика
  • Db user count — количество пользователей баз данных
  • Web domains count — количество веб доменов
  • Email box count — количество почтовых ящиков
  • Memory limit — лимит на использование оперативной памяти
  • Email box quota — лимит на использование дискового пространства одним почтовым ящиком
  • Disk quota — лимит на использование дискового пространства
  • Db count — количество баз данных
  • FTP user count — количество FTP пользователей
  • Email domains count — количество почтовых доменов
  • CPU time — условное количество единиц процессорного времени
  • Processes count limit — лимит на количество запущенных процессов
  • Main IP address type — тип выделяемого IP адреса
  • Domain template — шаблон доменного имени. При пустом значении будет использовано доменное имя, введенное пользователем при оформлении заказа в WHMCS.
  • Username template — шаблон имени пользователя. При пустом значении будет использовано имя пользователя, сгенерированное WHMCS

Если значение параметра не заполнено, будет взято значение из шаблона пользователя.

Так же для тарифных планов можно настроить дополнительные опции - IPv4 и IPv6 адреса. Для этого необходимо в разделе "Configurable Options" создать новую группу опций (желательно для каждого подключения к панели управления иметь свою группу опций, либо список шаблонов диска должен подходить для всех используемых подключений), в которой можно создать соответствующие опции. Для IPv4 адресов имя опции должно быть IP, для IPv6 адресов IPv6.
При такой настройке можно дать клиенту возможность заказать более одного IP адреса.