WHMCS (Web Host Manager Complete Solution) — система автоматизации для хостинг-компаний и провайдеров интернет-услуг. Она предлагает функционал для управления клиентами, выставления счетов, поддержки и автоматизации процессов. Дальше приведем инструкцию по установке данного модуля.
Загрузка модуля на сервер через командную строку с помощью scp:
Пример если вы уже находитесь в папке с файлом:
Затем потребуется ввести пароль от сервера.
После загрузки файла на сервер подключитесь к серверу по SSH и распакуйте файл.
Потребуется ввести пароль от сервера.
Затем нужно перейти в папку вашего проекта и куда вы загрузили файл
Архив нужно распаковать в корень проекта
В данном архиве есть 3 версии модуля соответствующие версии php на которой работает whmcs, чтобы узнать свою версию php перейдите в Utilities/System/PHP info.
Затем вам нужно ещё раз распаковать архив версии которую поддерживает ваш whmcs.
Для версии php 7.1, php 7.2, php 7.4 введите
Для версии php 8.1 введите
Для версии php 8.2 введите
Затем нужно (обязательно) выдать права файлам сделать это можно находясь в папке проекта, ввести команду
chmod -R 755 modules/servers/PQH
Модуль загружен.
Или Загрузка модуля на сервер через FileZilla
На своем компьютере распаковать файл module-whmcs-billmanager.zip
Затем вам нужно ещё раз распаковать архив версии которую поддерживает ваш whmcs:
Затем подключиться к своему серверу с помощью filezilla
Перенести файлы в корневую папку сайта из архива соответствующей вашей версии php (как на скриншоте ниже).
Затем нужно (обязательно) выдать права папке и файлам сделать это можно перейдя в папку modules/servers и кликнуть правой кнопкой мыши по папке PQH и выбрать пункт атрибуты файла в всплывающем окне прописать в поле числовое значение 755 и поставить галочку на recurse into subdirectories (как на скриншоте ниже)
Модуль загружен.
На нашем shared-хостинге, поддержка IonCube и его версия зависит от выбранной для пользователя версии PHP. Это актуально для любой линейки тарифных планов хостинга, а также для виртуальных/выделенных серверов с установленной панелью ISPManager.
Предварительные требования к установке IonCube
Если у Вас сервер без какой-либо панели управления, Вы можете столкнуться с необходимостью ручной установки IonCube.
Процесс установки может отличаться в зависимости от Вашей ОС. Вне зависимости от ОС, первым шагом всегда является подключение по SSH и получения root доступа.
Для установки IonCube требуется машина с активным и работающим веб сервером, Apache или Nginx, а также установленная версия PHP из списка поддерживаемых IonCube Loader.
Важно: значение команд, используемых при установке IonCube Loader варьируются в зависимости от некоторых переменных: версии PHP на сервере, локации PHP-директории и версии архитектуры сервера. Здесь и в дальнейшем мы будем выделять значения этих переменных. Вместо них, при установке, необходимо будет подставить соответствующие значения для Вашего сервера.
1 .Подключитесь к серверу по SSH.
2. Проверьте архитектуру текущего сервера:
Как видим из x86_64, наш текущий сервер работает на 64-битной архитектуре. Значения вида i686 указывали бы на обратное – 32-х битную архитектуру.
Далее, переходим директорию tmp и загружаем необходимый архив:
Для 64-битных систем:
Для 32-битных систем:
После загрузки архива необходимо его разархивировать:
Так как в примере у нас используется 64-х битная архитектура, мы загрузили и распаковываем именно такой архив.
5. Переходим в директорию ioncube и просматриваем список файлов.
Вывод
Как видим, в архиве присутствовало множество различный версий модуля для разных версий PHP. Необходимо узнать, какой из этих файлов нужен нам для дальнейшей установки.
6. Зная свою версию PHP(из первого шага), Следующим шагом, определяем локацию директории, в которую необходимо будет устанавливать IonCube Loader.
Вывод
Локация /usr/lib/php/20210902 понадобится нам в дальнейшем процессе установки. В ОС из ветки Centos такая папка может иметь вид /usr/lib64/php/modules.
7. Копируем файлы IonCube в нужную директорию.
8. Теперь необходимо внести правки в файлы конфигурации php.ini. В разных конфигурациях сервера у них может варьироваться локация:
Вставьте строку следующего вида в самое начало php.ini:
9. Выполните рестарт вебсервера:
10. Проверьте правильность установки командой:
Если установка успешна, строка с информацией о текущей версии IonCube будет отображаться следующим образом:
Вывод
Заходим в панель администратора.
Нажимаем добавить новый сервер(Add New Server)
Заполняем форму как на скриншоте ниже
В поле Module находим: PQH
В поле Hostname or IP Address вводим: bill.pq.hosting
Далее вводим свои данные аккаунта(логин, пароль) от bill.pq.hosting
И нажимаем continue.
Далее на следующей странице нужно ввести имя сервера(на ваш выбор) и нажимаем Save Changes
Нужно создать нового администратора.
Это можно сделать перейдя в settings/manage admins
Затем нажать на кнопку Add New Administrator
Роль: Full administrator
Username (обязательно!): apisystem
Остальный данные на ваш выбор
Пример(скриншот ниже)
Такие поля как выбор операционной системы при покупке можно настроить перейдя в settings/system settings/Configurable Options
Нажать на кнопку Create a New Group, далее по своему усмотрению задать имя группы
и нажать кнопку Save Changes, затем нажать на кнопку которая появится Add New Configurable Option
Затем в всплывающем окне ввести в поле Option Name: “VM Template”
Затем добавляем значение в поле Add Options.
Вот список всех поддерживаемых значений:
Нажать Save Changes и в этой вкладке и в вкладке Configurable Option Groups.
Перейти в Settings/System settings/ Products,Services
Создать новую группу нажатием на кнопки Create a New Group.
Далее заполните поля по своему усмотрению
Сохраните и перейдите снова в Settings/System settings/ Products,Services
Остальное заполните по вашему усмотрению
После сохранения, вам доступно настроить этот продукт
В вкладке Details(скриншот ниже) вы можете настроить продукт по своему усмотрению (Product Name,Product Tagline, Product Short Description, Product Description).
Checkbox в значении Require Domain стоит убрать.
Не забудьте сохранить настройки продукта
В вкладке Pricing (скриншот ниже) вы можете настроить оплату за продукт. Не забудьте сохранить настройки продукта
В вкладке Module Settings (скриншот ниже)
Выберите (обязательно) Module Name: PQH
Затем выберите дата центр и тариф который будет соответствовать этому продукту.
Не забудьте сохранить настройки продукта
В вкладке Custom Fields (скриншот ниже) ОБЯЗАТЕЛЬНО в поле Field Name вставьте значение “VMid”
Остальные вкладки настройте по своему усмотрению.
Далее для упрощения процесса добавление продуктов мы можете их дублировать (скриншот ниже)
Создайте пользователя, пополните ему счет и попробуйте заказать услугу с тестового аккаунта. При заказе пользователем модуль передаст в BILLmanager все параметры, закажет сервер автоматический и при активации сервера на стороне BILLmanager, активируется и услуга на стороне WHMCS.