Информация - BPanel.Ru

BPanel v3
The leading russian billing software for hosting
...since 2004.
CopyRight © 2004-2016 BPanel.Ru
Оглавление
Информация .................................................................................................................................................................... 5
Системные требования ................................................................................................................................................... 5
Обновление с предыдущих версий ............................................................................................................................... 7
Установка ......................................................................................................................................................................... 7
Шаблоны ........................................................................................................................................................................ 11
Модули оплаты.............................................................................................................................................................. 14
WebMoney Merchant................................................................................................................................................. 14
Яндекс.Деньги – прием средств на кошелек физического лица вручную ........................................................... 15
Яндекс.Деньги – прием средств на кошелек физического лица автоматически ................................................ 15
Яндекс.Деньги – прием средств на счет юридического лица ............................................................................... 16
Яндекс.Деньги – прием средств через prochange.ru ............................................................................................. 17
Оплата через банк: физические лица ...................................................................................................................... 17
RBK Money .................................................................................................................................................................. 18
RoboxChange .............................................................................................................................................................. 19
E-Gold .......................................................................................................................................................................... 20
MoneyMail.Ru ............................................................................................................................................................. 20
Z-Payment ................................................................................................................................................................... 21
LendShop..................................................................................................................................................................... 23
LiqPay .......................................................................................................................................................................... 23
IntellectMoney ............................................................................................................................................................ 23
InterKassa.................................................................................................................................................................... 24
TeleMoney .................................................................................................................................................................. 24
PayPal .......................................................................................................................................................................... 25
2CheckOut ................................................................................................................................................................... 25
OkPay .......................................................................................................................................................................... 25
QiWi ............................................................................................................................................................................ 26
PayMaster ................................................................................................................................................................... 26
AdvCash....................................................................................................................................................................... 27
Оплата через банк: юридические лица ................................................................................................................... 27
Карты экспресс-оплаты ............................................................................................................................................. 30
Автоматическая регистрация доменов ....................................................................................................................... 32
.RU / .SU., gTLD и др. .................................................................................................................................................. 32
WNames.Ru ................................................................................................................................................................ 32
WebNames.Ru ............................................................................................................................................................ 32
Naunet.Ru ................................................................................................................................................................... 33
Reg.Ru ......................................................................................................................................................................... 33
Nic.Ru .......................................................................................................................................................................... 33
41651.myorderbox.com.............................................................................................................................................. 34
DirectI.com .................................................................................................................................................................. 34
Регистрация доменов в панелях LogicBoxes ........................................................................................................... 35
UkrNames.com............................................................................................................................................................ 35
Internet.Bs................................................................................................................................................................... 35
AhNames.com ............................................................................................................................................................. 36
Начало работы с другим регистратором доменов ................................................................................................. 36
Тестирование на хосте 127.0.0.* работы интеграции с регистраторами домена ............................................... 36
Продажа SSL сертификатов через ПО LogicBoxes ....................................................................................................... 36
Продажа свидетельств о регистрации доменов ........................................................................................................ 37
Автоматическое присвоение IP адресов в cPanel....................................................................................................... 38
Панель Администратора............................................................................................................................................... 38
Автоматическая активация аккаунтов ......................................................................................................................... 43
Автоматическое выполнение действий на загруженных серверах .......................................................................... 43
CRON: выполнение заданий по расписанию .............................................................................................................. 43
Автоматическое заполнение договоров ..................................................................................................................... 46
Конструктор тарифов: рекомендации ......................................................................................................................... 47
Стол помощи.................................................................................................................................................................. 49
Автоматическое открытие билета ........................................................................................................................... 50
Звуковое оповещение............................................................................................................................................... 50
ICQ-боты ......................................................................................................................................................................... 50
LoadUsage модуль ......................................................................................................................................................... 51
Модуль WhoIs ................................................................................................................................................................ 51
RSS-канал........................................................................................................................................................................ 51
Новостной модуль......................................................................................................................................................... 52
Регистрация сайтов на 1PS.ru ....................................................................................................................................... 52
SMS-верификация и уведомления............................................................................................................................... 53
Captcha (защита от ботов)............................................................................................................................................. 53
Firewall CSF ..................................................................................................................................................................... 53
Обратная связь .............................................................................................................................................................. 53
Отправка ссылки другу ................................................................................................................................................. 54
Основная валюта ........................................................................................................................................................... 54
Графики дежурств ......................................................................................................................................................... 54
Логи Skype/ICQ............................................................................................................................................................... 54
Пути к файлам................................................................................................................................................................ 55
Кодировки различных языков...................................................................................................................................... 56
Изменение серверного часовой пояса........................................................................................................................ 57
Расшифровка системных ошибок ................................................................................................................................ 58
Отличия версии PRO...................................................................................................................................................... 58
API (Applictaion Programming Interface) ....................................................................................................................... 59
Методы GET, POST ..................................................................................................................................................... 59
Включение в скрипт (include, require) ..................................................................................................................... 59
Обязательные параметры ........................................................................................................................................ 60
Действия..................................................................................................................................................................... 60
Пример запроса......................................................................................................................................................... 62
Добавление мерчантов ................................................................................................................................................ 62
Добавление своих модулей в панель клиента ........................................................................................................... 62
Общая информация по регистраторам доменов и панелям управления сайтом................................................... 64
Информация по DirectAdmin (D.A.) .............................................................................................................................. 64
Информация по ISPmanager ......................................................................................................................................... 64
Информация по Plesk .................................................................................................................................................... 65
Информация по OpenVZ ............................................................................................................................................... 65
Использованные модули .............................................................................................................................................. 66
Работа скрипта на нескольких доменах ...................................................................................................................... 66
Проверка лицензии ....................................................................................................................................................... 67
Техническая Поддержка ............................................................................................................................................... 67
Информация
BPanel – многофункциональное программное обеспечение биллинга хостинга и любых других услуг,
выполняющее всевозможные разнонаправленные задачи по учету клиентских аккаунтов и
закрепленных
за
ними
сервисов
и
товаров,
адаптированное
для
работы
с
cPanel/DirectAdmin/ISPmanager/Plesk и автоматического приема платежей через системы WebMoney,
Яндекс.Деньги, RBK Money, MoneyMail, E-Gold, RoboxChange, Z-Payment и др.
Структура BPanel состоит из трех уровней: клиентский, для сотрудников и администраторский.
Предполагается, что администраторский уровень присваивается главному менеджеру, который
контролирует финансы, сотрудников и клиентов. Сотрудники же помогают клиентам решать
проблемы, отвечают на вопросы, выполняют различные действия. Для контроля эффективности
работы подчиненных имеется функция отображения графической статистики. Функция также
доступна и в панели сотрудников, что влечет за собой конкуренцию среди них при выполнении
всеразличных работ и заданий.
Продукт изначально создавался для учета клиентов www.advanta.org, а с середины 2004 года стал
доступен широкой аудитории. За годы работы и совершенствования реализованы самые необычные
идеи, разработаны уникальные алгоритмы выполнения задач, максимально упрощены и
автоматизированы действия администратора.
Постоянная модернизация скрипта направлена на предельно возможную экономию времени и
удовлетворение как клиентов, так и администратора. Внедрение стола помощи позволило
сотрудникам компании совместно обрабатывать входящую почту, а настраиваемые фильтры –
отсечь нежелаемую корреспонденцию.
Создание нового и общественно-полезного морально удовлетворяет разработчика, однако, для
компенсации затрачиваемых сил и времени, скрипт вынужден быть платным.
Пожалуйста, полностью прочитайте данную инструкцию, это сэкономит наше общее время.
Системные требования
PHP 5.4.x с Zend Guard Loader и модулями BCMath, Calendar и MbString.
MySQL 5.x.x; рекомендуемая кодировка базы: cp1251_general_ci.
Для автоматической активации, блокировки и удаления аккаунтов на сервере требуется cPanel 11 и
выше, DirectAdmin 1.29 и выше, ISPmanager 4.3 и выше или Plesk 10.2.0 и выше.
E-Mail piping в столе помощи: необходимы php-библиотеки imap.
Защита от регистраций и отправок писем ботами: библиотека GD.
Поддержка сокетов для отправки сообщений в ICQ: функция socket_create.
Автоматическое обновление файлов скрипта: ZIP.
Работа с API WebNames.Ru и некоторых других регистраторов: OpenSSL и cURL.
При установке скрипта (setup.php) программа выведет информацию о соответствии требованиям скрипта
установленных на сервере модулей.
Рекомендуем увеличить до 57 секунд время выполнения скрипта (max_execution_time в php.ini) и
таймаут MySQL (wait_timeout в my.cnf), а выделяемую память (memory_limit в php.ini) – до 128+ MB.
Причина: на некоторых серверах возможно длительное создание аккаунта в панели управления
сервером.
При большой клиентской базе (500+ аккаунтов), многовероятно, что для корректного выполнения
заданий cron.php потребуется увеличить max_execution_time до 100+ секунд.
Для повышения уровня безопасности установите в php.ini magic_quotes_gpc и safe_mode в значение On, а
register_globals в Off.
Обновление с предыдущих версий
1. Распакуйте архив со скриптом у себя на компьютере.
2. Правильно измените данные в файлах config.php, admin/conf/admin.php, admin/conf/whm.php
3. Сделайте резервную копию базы данных.
4. Обновите файлы скрипта на сервере.
или
1-4*.
Для загрузки автоматической загрузки файлов на сервер можно запустить
/admin/autoupdate.php. Как правило, обновление конфигурационных файлов (config.php и т.п.) – не
требуется.
Код скрипта и домен – такие же как и для загрузки с order.bpanel.ru, обновление лицензии –
обновление файла license.php (как правило не требуется, см. историю изменений для версии,
которую хотите установить).
* - при некоторых настройках PHP автоматическая загрузка и распаковка файлов невозможна.
Устранить ошибку “Permission denied” при автоматической загрузке файлов во многих случаях можно
временной установкой атрибутов 777 на папку со скриптом и на /admin/.
5. Запустите admin/upgrade/index.php и поочередно перейдите по предложенным ссылкам.
6. После завершения обновления рекомендуется запустить скрипт /admin/database_check.php для
проверки правильности обновления структуры базы данных.
За дополнительную плату возможно обновление скрипта непосредственно разработчиком.
Подробная информация на http://bpanel.ru/order.php
Установка
1. Отредактируйте в блокноте файлы
/config.php (пользователя и базу MySQL необходимо создать через панель управления сайтом)
/admin/conf/admin.php;
/admin/conf/whm.php (в $whmpass[1] ($directadmin[1]) впишите пароль на реселлерский аккаунт);
2. Ручная загрузка файлов. Загрузите по FTP (можно в папку order) в режиме Binary файлы скрипта;
Необходимо, чтобы файл license.php (лицензия на домен, выдается на order.bpanel.ru) находился в
корневой папке скрипта (вместе с файлами calc.php, catalog.php и др.);
или
1-2*. Автоматическая загрузка файлов. Создайте на FTP папку admin, загрузите в нее файл
autoupdate.php и запустите его в браузере. В форме укажите домен и код загрузки скрипта (выдается
на order.bpanel.ru), данные доступа к базе MySQL (создать самому), папку со скриптом и пр. данные.
Файлы последней версии ПО будут закачаны к Вам на сервер.
Загрузите по FTP отредактированный файл /admin/conf/whm.php
* - при некоторых настройках PHP автоматическая загрузка и распаковка файлов невозможна.
Устранить ошибку “Permission denied” при автоматической загрузке файлов во многих случаях можно
временной установкой атрибутов 777 на папку со скриптом и на /admin/.
3. На папки admin/backup и admin/helpdesk (в т.ч. и папки внутри) установите атрибуты 755 или 777;
4. В панели управления сайтом обязательно запаролируйте доступ к папке /admin/;
5. Введите в браузере: http://сайт/папка_скрипта/setup.php и перейдите по ссылке "начать
установку";
6. Зайдите в Панель Администратора и измените настройки:
Настройки => Серверы Хостинга
Добавьте Основной IP сервера и обновите страницу.
Реселлерский Логин – логин на WHM (D.A./ISPmanager/Plesk) для автоматического создания аккаунта
клиента;
Главный Домен – используется в письме об активации аккаунта для генерации ссылки на cPanel
(D.A./ISPmanager/Plesk), ( http://гл.домен:2082); пример заполнения поля: antanta.org;
FTP – напр. "ftp.домен_на_сервере" (для письма об активации аккаунта);
NS – можно указывать вида "NS (IP)" (для письма об активации аккаунта);
Запрещенные Доменные Зоны – запрещено создавать аккаунты на сервере с доменами в этих зонах:
аккаунт создается на другом сервере, указанном в поле ниже. Полезно, например, для доменов .RU
(если на сервере нет 2 IP в сетях класса С). Пример: ".localserver.ru, .ru";
IP на котором располагаются сайты – необходим для письма об активации аккаунта;
Пароли доступа к WHM (D.A./ISPmanager/Plesk/OpenVZ/VM Manager) сервера необходимо записать в
файл admin/conf/whm.php;
Если у созданного сервера ID, например, 6, то пароль необходимо записать переменной:
$whmpass[6] = "пароль"; // (для панели cPanel);
$directadmin[6] = "пароль"; // (для панели D.A.) ;
$ispmanager[6] = "пароль"; // (для панели ISPmanager);
$plesk[6] = "пароль"; // (для панели Plesk);
$openvz[6] = "пароль"; // (для панели OpenVZ);
$vmmanager[6] = "пароль"; // (для панели VM Manager).
Панель Администратора => Настройки => Скрипт (общие)
Идентификатор
Сессии.
Обычно
это
"PHPSESSID"
например,
в
строке
http://127.0.0.1/order/admin/index.php?mod=service&PHPSESSID=d8502f262c95a52ee8425cad0ff2b231
Замените на: Панель Администратора => Настройки => Страницы & Разделы => Оформление Заказа
=> Наши Бесплатные Доменные Зоны (через запятую)
Домены, которые автоматически "регистрируются" панелью WHM при активации аккаунта
(слово.вашсайт).
Для того, чтобы не создавать лишних записей в базе доменов, когда клиент указывает, что домен
вида "слово.вашсайт" "регистрируется у нас" и предусмотрена данная функция.
Пример заполнения поля: .myhosting.ru, .myhosting2.ru
Панель администратора => Настройки => Страницы & Разделы => Оформление Заказа => Запрет
ввода дом. зон при регистрации (через запятую)
Домены в данных зонах будет запрещено вводить при заказе хостинга etc. (вне зависимости от
заполнения поля "информация по домену").
Панель администратора => Настройки => Страницы & Разделы => Оформление Заказа => RIPN-NICHANDLE для дом. зон (через запятую)
Домены, для регистрации которых на имя клиента достаточно указать лишь RIPN-NIC-HANDLE (зоны
.com.ru, .net.ru, .org.ru, .pp.ru).
Панель администратора => Настройки => Страницы & Разделы => Панель Клиента
Сравнение IP сайтов, добавляемых в каталог – это IP адреса Ваших серверов, чтобы было
невозможно добавить сайт, расположенный не у Вас. Поле можно заполнять записями вида
127.0.0.*
Услуги => Тарифные Планы
Название в WHM (D.A./ISPmanager Plesk): пример: "reslogin_mini".
Сервер для Создания Аккаунтов - настройки серверов задаются в "Настройки => Хостинг-Серверы"
Услуги => Стоимость Доменов
Комментарии к доменной зоне выдаются клиенту при заказе домена.
Услуги => Дополнительные Услуги
Названия и стоимости операционных систем и панелей для выделенных серверов и VPS задаются в
этом разделе.
Панель Администратора => Услуги => Домены в Подарок
Названия Тарифов через запятую, пример: "мини,эко,бизнес".
Бесплатная регистрация в зонах через запятую, пример: ".com,.net,.org,.com.ru".
Для того, чтобы информация по домену была внесена в базу, за его регистрацию на год у клиента
будет запрошена символическая плата в 0.01.
CRON
Письма-Уведомления об истечение срока действия аккаунтов
За сколько дней до истечения отсылается письмо-уведомление. Указывает по одному дню в строку.
/admin/LANGUAGE/mail/ - почтовые шаблоны (обязательно подкорректируйте под Вас почтовые
шаблоны активации аккаунтов /admin/mail/LANGUAGE/activate_)
/admin/lang/ - языковые файлы
Рекомендация: если у Вас есть root доступ к серверу, создайте специального реселлера для работы с
BPanel и предоставьте ему доступ только на создание, блокировку и разблокировку аккаунтов, а
также на изменение тарифных планов. Удаление - запретить, делать это вручную через панель
управления администратора при вводе root-пароля.
Запишите пароль доступа к панели управления сайтом в whm.php
Демонстрационный доступ в панель. Первоначально создается аккаунт с логином и паролем "demo",
его задумано использовать как тестовый, чтобы клиенты могли бегло ознакомиться с панелью
управления счетами. Удалять демонстрационный аккаунт крайне нежелательно.
Прежде “боевого” запуска скрипта рекомендуется бегло просмотреть все страницы в админ-панели,
указать свои реквизиты для автоматической оплаты и проверить их правильность, совершив
тестовые платежи.
База биллинга уже содержит несколько аккаунтов, это сделано для скорейшего ознакомления со
скриптом. По завершении ознакомления данные аккаунты, за исключением “demo”, можно удалить.
Шаблоны
Шаблоны для скрипта находятся в /admin/template/LANGUAGE/
contacts.inc
- дополнительный текст для страницы контактов (contacts.php)
dedicated.inc - меню для клиентов на серверы
domenreg.inc - меню для клиентов только на домены
hosting.inc
- меню для клиентов на хостинг
partner.inc
- меню для партнеров
reselling.inc
- меню для клиентов на реселлинг
support.inc
- меню для сотрудников (сапортов)
panel_head.inc - Верхняя часть панели управления счетами
panel_foot.inc - Нижняя часть панели управления счетами
domen.inc
- дополнительный текст низа страницы domen.php
help.php
- шаблон страницы описания дополнительных услуг
bank.php
- шаблон квитанции для оплаты через банк
ur.php
- шаблон счета на оплату для юридических лиц
ur_akt.php
- шаблон акта на выполнение работ
ur_sf.php
- шаблон счет-фактуры
with_nds_ur.php
- опционально. Шаблон счета на оплату для юридических лиц при НДС=0
with_nds_ur_akt.php - опционально. Шаблон акта на выполнение работ при НДС=0
with_nds_ur_sf.php
- опционально. Шаблон счет-фактуры при НДС=0
Создайте эти три шаблона после перехода с/на упрощенную систему налогообложения. Документы по
шаблонам with_nds_* (если они будут залиты на сервере) будут отображаться для платежей с НДС>0, а ur.php
– без НДС.
Если никаких переходов между системами налогообложения не было, то просто используйте три шаблона без
“with_nds_*”.
fiz.php
- шаблон информационного счета для физических лиц
root_head.inc
- Верхняя часть панели управления администратора
root_foot.inc
- Нижняя часть панели управления администратора
Дополнительно. Если страницы для регистрации клиента или партнера должны отличаться по дизайну от
страниц непосредственно панели управления, подкорректируйте названия Файлов Шаблонов Регистрации в
config.php
reg_head.inc (по умолчанию) - Верхняя часть страницы регистрации
reg_foot.inc (отсутствует)
- Нижняя часть страницы регистрации
friends_head.inc
- Верхняя часть страницы “отправить ссылку другу”
friends_foot.inc
- Нижняя часть страницы “отправить ссылку другу”
hd_print_head.inc
- Верхняя часть страницы-распечатки билета в столе помощи
hd_print_foot.inc
- Нижняя часть страницы-распечатки билета в столе помощи
При желании названия страниц редактируются в языковом файле.
Обратите внимание, что в шаблоне страницы регистрации необходимо наличие Java-скрипта:
<script language="JavaScript" type="text/javascript">
<!-function MM_openBrWindow(theURL,winName,features) {
window.open(theURL,winName,features);
}
-->
</script>
--------------Для того, чтобы вывести название или меню, вставьте в шаблон страницы следующий HTML-код:
<? echo $template_name ?>
--------------Стили текста - во всех шапках шаблонов должен быть код
<link href="img/styles/styles.css" rel="stylesheet" type="text/css">
и
<body background="img/bg.gif" link="#000000" vlink="#000000" alink="#000000">
<script language="javascript" src="img/styles/hint.js" type="text/javascript"></script>
<script language="javascript" src="img/styles/textarea.js" type="text/javascript"></script>
Модули оплаты
Укажите настройки в панели управления администратора для каждого модуля (Настройки => Мерчанты) и
установите дополнительные настройки, описанные ниже.
Общая рекомендуемая настройка для автоматических мерчантов: “Засчитывать оплату при несоответствии
данных платежа“: No.
WebMoney Merchant
URL: http://www.webmoney.ru
Для автоматического зачисления платежей необходимо иметь Аттестат Продавца.
Настройка Merchant: https://merchant.webmoney.ru/conf/purses.asp
После авторизации выберите кошелек и установите галочку напротив "Позволять использовать URL,
передаваемые в форме".
Secret Key – заполнить в соответствии с одноименным полем в настройках мерчанта в биллинге.
Высылать Secret Key на Result URL – нет.
Метод формирования контрольной подписи: SHA256
Выберите рабочий режим работы и активность "Вкл."
Прием чеков Paymer.com и пр. – по желанию.
Для тестирования рекомендуем выставить режим работы кошельков: тестовый (перевод средств не
происходит).
При соотв. настройках активация аккаунтов и регистрация доменов происходит автоматически.
Подключение дополнительных услуг производится самостоятельно администратором.
Домены, ручная активация. На гл. стр. админ-панели вводим номер домена, получаем информацию по
будущему владельцу, регистрируем домен у регистратора и жмем на кнопку "Добавить".
Дополнительные услуги. B BPanel находим заказанную дополнительную услугу, подключаем ее вручную и
ставим статус заявке "PAID".
Дополнительный параметр для мерчанта: при необходимости (если у Вас подключены дополнительные
способы приема платежей через WebMoney) можно заполнить данное поле значением “Тип e-invoicing
платежа”
(LMI_SDP_TYPE)
со
страницы
http://wiki.webmoney.ru/projects/webmoney/wiki/Web_Merchant_Interface
Можно создать несколько способов оплаты через webmoney (например, один для альфа-клик, другой для
приема платежей через российские банки и пр.). В данном случае главный способ оплаты нужно назвать
например “WebMoney” и за этим способом закрепить мерчант (настройки –> финансы –> мерчанты –>
webmoney), а дополнительные способы оплаты должны будут содержать в имени слово “WebMoney”,
например “альфа-клик через webmoney”, “российские банки через webmoney” и т.п.
Яндекс.Деньги – прием средств на кошелек физического лица вручную
URL: http://www.money.yandex.ru
Проверка платежей осуществляется администратором после соответствующего письма от клиента.
Открытие аккаунта
При включенной опции приема оплаты на Яндекс.Кошелек, сразу после регистрации клиента на странице
появится форма, в которой будет предложено произвести оплату за активацию аккаунта. Ссылка на данную
процедуру будет также добавлена в письмо-уведомление о регистрации.
На следующей странице клиент нажимает на ссылку "оплатить" (инструкция по оплате находится на самой
странице), производит перевод средств на Яндекс.Кошелек и жмет на кнопку "Оплату Подтверждаю", Вам на
e-mail приходит письмо, что клиент уведомил Вас об оплате через Яндекс.Деньги. Проверяем, поступили ли
средства и потом открываем аккаунт в ручном режиме.
Продление срока хостинга
Аналогично активации аккаунта - в BPanel будет находиться ссылка, что можно оплатить через Яндекс.Деньги.
Клиент оплачивает, уведомляет Вас об оплате, и Вы вручную добавляете срок хостинга.
В панели администратора заполняются только поля “Включить”, “Закрепить за” и “Номер Кошелька”.
Яндекс.Деньги – прием средств на кошелек физического лица автоматически
URL: http://www.money.yandex.ru
Проверка поступления платежей осуществляется автоматически.
1. Зарегистрируйте приложение на https://money.yandex.ru/myservices/new.xml
Redirect URI: https://адрес_биллинга/admin/?mod=yandexid
2. Запишите в блокнот
Идентификатор приложения, вида:
XXXXXXXXXXXXXXXXXXXXYYYYYYYYYZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
и OAuth2 client_secret, вида:
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBC
CCCCCCCCCCCCCCCCCCCCCCC
Использовать проверку подлинности приложения (OAuth2 client_secret): да
3. В панели администратора –> настройки –> финансы и мерчанты –> Яндекс.Деньги укажите “ClientID
приложения YandexMoney” и “OAuth2 client_secret YandexMoney”. После правильного заполнения данных
полей будет произведена переадресация на сайт Яндекс.Денег, где Вам будет предложено указать
платежный пароль к аккаунту, на который будут зачисляться средства. Данное действие необходимо для
правильной автоматической проверки получения платежей по указанным в них примечаниям.
При ошибке “invalid_request” убедитесь, что вводимый Вами в поле “Redirect URI” такой же, как для
информации указан программной BPanel под полем “OAuth2 client_secret YandexMoney”.
4. После указания пароля выше система автоматически заполнит поле “Yandex Token (HTTP-уведомления,
заполнится после ввода 2 полей выше)”.
5. На сайте money.yandex.ru в разделе Информирование (нажмите на ссылку с таким названием) укажите URL:
https://order.advanta.org/ya.php?mod=check, а также скопируйте и сохраните в настройки биллинга (Пароль
(секрет) для HTTP-уведомлений) данные, которые покажет кнопка “показать секрет”. Отправлять
уведомления: да.
6. Можно начинать прием платежей.
Яндекс.Деньги – прием средств на счет юридического лица
URL: http://www.money.yandex.ru
Биллинг должен быть доступен по https-протоколу (однако в настройках админ-панели может быть указано
http).
Заключите договор с платежной системой от имени своего юридического лица.
Пример заполнения некоторых полей анкеты магазина:
Наличие АСП: НЕТ (используется криптографический хэш MD5)
paymentAvisoURL
https://адрес_биллинга/yandex.php
successURL
http://адрес_биллинга/yandex.php?mod=ok
failURL
http://адрес_биллинга/yandex.php?mod=fail
checkURL
https://адрес_биллинга/yandex.php?mod=check
authMethod
md5
shopPgpKey
(пусто)
shopPassword PASSWORD (придумайте)
После заключения договора отредактируйте секцию настроек мерчанта в админ-панели.
Дополнительный параметр для мерчанта: при необходимости (если у Вас подключены дополнительные
способы приема платежей через YandexMoney) можно заполнить данное поле из Таблицы 6.6.1 со страницы
https://money.yandex.ru/doc.xml?id=526537
Можно создать несколько способов оплаты через yandexmoney (например, один для банковской карты,
другой для приема платежей альфа-клик и пр.). В данном случае главный способ оплаты нужно назвать
например “YandexMoney” и за этим способом закрепить мерчант (настройки –> финансы –> мерчанты –>
яндекс.деньги), а дополнительные способы оплаты должны будут содержать в имени слово “ YandexMoney ”,
например “альфа-клик через YandexMoney ”, “просмсящьбанк банки через YandexMoney” и т.п.
Яндекс.Деньги – прием средств через prochange.ru
URL: http://prochange.ru
Зарегистрируйтесь на сайте и перейдите в ЯД мерчант -> Настройки.
Пример заполнения некоторых полей:
Result URL: http://URL/prochange.php
Success URL: http://URL/ prochange.php?mod=ok
Fail URL: http://URL/ prochange.php ?mod=fail
Укажите на сайте и сохраните в блокнот Секретный ключ.
Перейдите по ссылке ЯД мерчант -> Описание.
И сохраните в блокнот две цифры из “PRO_CLIENT” и “PRO_RA”.
Отредактируйте секцию настроек мерчанта в админ-панели.
Отправьте запрос на верификацию Вашего аккаунта на сайте prochange.ru (ЯД мерчант -> Настройки).
Оплата через банк: физические лица
Необходимо иметь счет в банке или Яндекс.Кошелек.
Измените шаблон страницы /admin/template/LANGUAGE/bank.php, указав Ваши данные вместо тех, что
прописаны первоначально.
Переменные:
$t_name
- Ф.И.О. плательщика
$t_address
- Адрес плательщика
$t_phone
- Телефон плательщика
$t_email
- E-Mail плательщика
$t_yandex
- Номер Вашего Яндекс.Кошелька
$t_date
- Дата в формате "ДЕНЬ-МЕСЯЦ-ГОД"
$t_cost
- Сумма в рублях (или др. валюте по курсу, установленному в админ-панели)
$t_usd_cost
- Сумма в основной валюте (без учета курса дополнительной валюты)
$t_dated
- Номер дня
$t_datem
- Месяц в родительном падеже
$t_datey
- Год формата YYYY
$t_order
- Номер аккаунта
$t_invoicenum - Номер платежа в базе биллинга
$t_thedate
- Дата выписки квитанции
TMPL_our_*
- переменные по данным об организации (TMPL_our_company и др.)
Для того чтобы в текст квитанции подставлялись данные из дополнительных созданных администратором
полей профиля клиента необходимо добавить в шаблон квитанции переменную вида “$field_NAME”, где
“NAME” – название поля на русском или другом языке. Пример названия переменной для дополнительного
поля для апример при названии дополнительного поля “ИНН”: $field_ИНН; при названии поля “Доп. поле”:
$field_ Доп. поле
Далее в панели управления администратора включите этот модуль оплаты: ссылка "Банк от физ.лиц".
Получать курс доллара из Центрального Банка - скрипт может получать курс доллара в российских рублях на
день оплаты прямо из Центрального Банка! При выключении данной функции курс будет браться из
стандартного (настройки финансов).
До скольких символов растягивать строку имени знаками "_" - корректируйте под размер Вашей квитанции.
Для той, что поставляется со скриптом стандартные размеры: 48 и 72.
RBK Money
URL: http://www.rbkmoney.ru
После авторизации на сайте RBK Money нажмите на ссылку "система приема платежей для интернетмагазинов".
Далее "Зарегистрировать" перед словами "свой сайт, каждому сайту присваивается индивидуальный номер
ID, который отличает один сайт от другого и указывает кому оплачивать при поступлении денег".
После регистрации сайта ему будет присвоен уникальный номер.
Перейдите по ссылке "мои сайты" в правом меню и нажмите на картинку напротив описания сайта в верхней
таблице.
В поле "Оповещение о платеже" введите "http://Ваш_домен/папка_скрипта/rbk.php" и выберите способы
оплаты, через которые Вы хотите принимать деньги.
Нажмите edit.
Поскольку большинство из способов приема оплаты на сайте RBK Money являются offline, то для самого
перевода средств и проверки платежа администраторами системы RBK Money необходимо время. Как только
администратор системы RBK Money дает скрипту "отмашку", что деньги поступили, BPanel в автоматическом
режиме выполняет действие по активации аккаунта или продлению хостинга.
RoboxChange
URL: https://www.roboxchange.com
Через Робокассу заходим свой личный кабинет. Статус продавца д.б. “активен”.
Переходим по ссылке “Администрирование” устанавливаем произвольные пароли, отличные друг от друга,
Result URL: http://URL/robo.php
Метод отсылки в Result URL: POST
Success URL: http://URL/robo.php?ok
Метод отсылки в Success URL: POST
Fail URL: http://URL/robo.php ?fail
Метод отсылки в Fail URL: POST
В настройках мерчанта в админ-панели биллинга указываем логин на Робокассе и два пароля из
“Администрирование” выше.
E-Gold
URL: http://www.e-gold.com
Заходим в e-gold аккаунт => Account Info; Находим "New Alternate Passphrase" и вносим любую комбинацию
символов.
В панели управления администратора в поле "Generate Alternate Merchant Passphrase Hash" вносим
введенный ранее пароль, а в "Номер счета в системе E-Gold" соответственно номер e-gold аккаунта.
При последующих обновлениях настроек e-gold мерчанта поле "Generate Alternate Merchant Passphrase Hash"
не заполнять.
MoneyMail.Ru
URL: http://www.moneymail.ru
Аккаунт должен иметь статус “Магазин”. После заключения договора с moneymail перейдите по ссылкам в
меню: Счета -> Профайл -> Получение платежей -> Настройка получения платежей и заполните данные в
соответствии со скриншотом ниже:
URL для оповещения должен быть вида http://сайт/папка/mmail.php
В настройках админ-панели BPanel укажите секретный ключ.
Z-Payment
URL: http://www.z-payment.ru
Необходимо получить аттестат и зарегистрировать магазин.
Валюту рекомендуется установить Рубль РФ.
Установите настройки, ориентируясь на скриншот выше.
Секретный ключ Merchant Key и Пароль инициализации магазина должны совпадать.
В настройках мерчанта в BPanel укажите номер магазина и его пароль.
LendShop
URL: https://lendshop.ru/
Необходимо иметь аттестат продавца вебмани.
Отправьте запрос на сайте lendshop.ru на подключение своего сайта к системе:
ResultURL - http://URL/lendshop.php
SuccessURL- http://URL/lendshop.php?ok
FailURL- http://URL/lendshop.php?fail
SecretKey – придумайте пароль
Отредактируйте секцию настроек мерчанта в админ-панели.
LiqPay
URL: https://www.liqpay.com/
Подключите магазин на сайте liqpay.com:
Наличие order_id –ДА
Наличие подписи –ДА
URL магазина и уведомлений – оставить пустыми.
Отредактируйте секцию настроек мерчанта в админ-панели.
IntellectMoney
URL: https://intellectmoney.ru
Необходимо зарегистрировать бизнес-аккаунт в системе IntellectMoney.
Подключите магазин на сайте intellectmoney.ru:
Протокол: IntellectMoney
URL Inform: http://URL/intellect.php
Сохраните в блокнот секретный ключ и идентификатор магазина.
Отредактируйте секцию настроек мерчанта в админ-панели.
InterKassa
URL: https://interkassa.com/
Подключите магазин на сайте interkassa.com:
Сохраните в блокнот Идентификатор магазина (ik_shop_id)
Success URL: http://URL/interkassa.php?ok метод POST
Fail URL: http://URL /interkassa.php?fail метод POST
Status URL: http:// URL /interkassa.php метод POST
Выберите валюту и установите ее курс как 1
Сохраните в блокнот секретный ключ
Отредактируйте секцию настроек мерчанта в админ-панели.
Для работы с interkassa v2.0 в настройках кассы в разделе “Интерфейс” включите “разрешить переопределять
в запросе” либо заполните поля URL также, как описано выше.
В разделе безопасность: алгоритм шифрования MD5, ключ брать из “секретный ключ”.
В настройках платежных систем отключите тестовую платежную систему.
TeleMoney
URL: https://telemoney.ru/
Подключите магазин на сайте telemoney.ru:
Callback URL: http://URL/telemoney.php метод POST
Success URL: http://URL/telemoney.php?mod=ok
Failure URL: http://URL /telemoney.php?mod=fail
Отредактируйте секцию настроек мерчанта в админ-панели.
PayPal
URL: https://paypal.com
Необходимо иметь аккаунт типа Premier или Business.
Добавьте его e-mail в настройки админ-панели.
2CheckOut
URL: https://www.2checkout.com/
На сайте платежной системы в вкладке Account –> Site Management укажите
Demo Setting: Parameter
Secret Word: секретное слово
Approved URL: http://URL/2checkout.php?ok
В Notifications укажите Global URL: http://URL/2checkout.php и включите оповещения по всем действиям.
В настройках мерчанта в BPanel укажите номер своего аккаунта 2checkout и секретное слово.
Название валюты: USD
OkPay
URL: https://okpay.com/
Добавьте номер кошелька и e-mail аккаунта в настройки админ-панели.
QiWi
URL: http://qiwi.ru
На сайте https://ishop.qiwi.com/ в разделе данных о магазине сгенерируйте аутентификационный ID и пароль
к нему. Сохраните сгенерированные данные в соответствующих настройках BPanel.
Включите протоколы Pull (REST) и SOAP.
URL для оповещения по протоколам Pull (REST) и SOAP: http://адрес_биллинга/qiwi.php?mod=check
Включите уведомления по обоим протоколам.
Подпись для протокола Pull (REST): не использовать
Тип уведомлений SOAP: простая подпись MD5.
Пароли на SOAP и REST должны быть одинаковыми.
На сервере должен быть установлен PHP-модуль SOAP (как правило, уже включен в сборку PHP).
Если ранее Вы использовали https://ishop.qiwi.ru , то на этом сайте нужно отключить работу протокола SOAP.
PayMaster
URL: http://www.paymaster.ru
Заключите договор с платежной системой, после его запросите у них тестовый режим, далее проведите 1-2
тестовых платежа. Если все автозачисление платежей сработает, то попросите у технической поддержки
платежной системы, чтобы они включили рабочий режим.
Настройка Merchant на странице платежной системы:
Тип подписи: MD5 или SHA256 (работает и тот и другой).
Секретный ключ – укажите и запишите себе в блокнот.
Галочки напротив “Проверять уникальность номера счета” и др. – не устанавливать.
Обратные вызовы – все POST с пустым значением URL.
Установить галочку напротив "Разрешена замена URL".
В настройках мерчанта в биллинге укажите “Идентификатор сайта в системе PayMaster” и “Секретный ключ”.
Если Вы являетесь интегратором, укажите “Внешний идентификатор магазина”.
AdvCash
URL: https://advcash.com/
Добавьте SCI на сайте платежной системы, после чего в биллинге укажите настройки автоматизации.
Успешная транзакция Url: http://ПУТЬ_ДО_ФАЙЛА/advcash.php?mod=ok
Неудачная транзакция Url: http://ПУТЬ_ДО_ФАЙЛА/advcash.php?mod=error
Статусный Url: http://ПУТЬ_ДО_ФАЙЛА/advcash.php
Метод передачи данных: POST.
Оплата через банк: юридические лица
Необходимо иметь счет в банке и самому быть юридическим лицом.
Измените шаблон страницы /admin/template/ur.php, указав Ваши данные вместо тех, что прописаны
первоначально (переменные, начинающиеся на "$" не убирать!)
Далее в панели управления администратора включите этот модуль оплаты: ссылка "Яндекс.Деньги &
Юридические Лица".
Получать курс доллара из Центрального Банка - скрипт может получать курс доллара в российских рублях на
день оплаты прямо из Центрального Банка! При выключении данной функции курс будет браться из
стандартного (настройки финансов).
Курс доллара на день оплаты + XX % - обычно, если курс берется из ЦБ, то к полной стоимости прибавляется
еще 2%. В скрипте эта возможность также реализована.
Для каждого выставленного счета в базе платежей сохраняются данные по названию фирмы-получателя
счета, адресу, ИНН, КПП и пр.: в поле “комментарии в базу” добавляется следующая строка:
UR_PROFILE:$company||$address||$zip||$city||$inn||$nrs||$inrs||$ks||$bik||$kpp||$director||$ustav||$post
||$thecode||$phone||
которую при необходимости можно самостоятельно изменить, например, если в биллинге указана одна
организация, а платеж был со счета другой (и соответственно нужны акт и счет-фактура на имя другой
организации).
Переменные шаблона /admin/template/LANG/ur.php:
TMPL_number
– номер заказа (договора)
TMPL_userlogin
– логин клиента
TMPL_useremail
– основной e-mail клиента
TMPL_invoicenum
– номер платежа в базе биллинга
TMPL_company
– название компании клиента
TMPL_address
– юридический адрес
TMPL_postaddress
– почтовый адрес
TMPL_inn
– ИНН
TMPL_kpp
– КПП
TMPL_nrs
– номер расчетного счета
TMPL_inrs
– имя банка
TMPL_ks
– к/c
TMPL_bik
– БИК
TMPL_client_director – ФИО представителя клиента
TMPL_client_ustav
– на основании чего он действует
TMPL_contract_director– ФИО представителя клиента в родительном падеже (кого/чего)
TMPL_contract_position– должность представителя клиента в родительном падеже (кого/чего)
TMPL_contract_ustav – на основании чего он действует в родительном падеже (кого/чего)
TMPL_fax
– номер факса
TMPL_ date
– дата выставления счета
TMPL_contractdate
– дата заключения договора
TMPL_invcount
– порядковый номер счета за день для одного и того же аккаунта
TMPL_inwords
– сумма к оплате словами
TMPL_item
– название услуги, эту переменную можно указать вместо текста “размещение
информации” в ur.php
TMPL_smallcost
– сумма без НДС
TMPL_firstcost
TMPL_smallcost)
– сумма за услугу (если не заказаны документы почтой и т.п., то как правило, равно
TMPL_fullcost
– первая оплаченная сумма цифрами
TMPL_bank1
– курс вторичной валюты (типа RUR для счета)
TMPL_bank2
– курс вторичной валюты (типа RUR для счета) + XX% согласно настройкам
TMPL_nds1
– процент НДС
TMPL_nds2
– сумма НДС
TMPL_postinv
– строка таблицы с информацией о почтовых расходах
TMPL_email
– контактный e-mail хостинга для уведомления об оплате счета
TMPL_addon
– информация по заказанным дополнительным услугам
TMPL_orderby
– способ оплаты
TMPL_comment
– примечание к заказу
TMPL_percent
– курс ЦБ + XX% - переменная показывает кол-во процентов
TMPL_our_url
– адрес сайта поставщика услуг из config.php
TMPL_our_name
– название поставщика услуг из config.php
TMPL_http
– http или https для URL выше
TMPL_hosturl
– автоматически генерируемый http-адрес страницы host.php
TMPL_email
– контактный e-mail хостинга для уведомления об оплате счета
TMPL_our_company
– название компании-поставщика услуг
TMPL_our_inn
– ИНН
TMPL_our_kpp
– КПП
TMPL_our_address
– юридический адрес
TMPL_our_postaddress – почтовый адрес
TMPL_our_rs
– номер расчетного счета
TMPL_our_inrs
– имя банка
TMPL_our_ks
– к/с
TMPL_our_bik
– БИК
TMPL_our_phone
– номер телефона
TMPL_our_fax
– номер факса
TMPL_director
– ФИО представителя
TMPL_position
– должность представителя
TMPL_ustav
– на основании чего действует представитель
Тоже самое, но в родительном падеже (кого/чего):
TMPL_2director
– ФИО представителя
TMPL_2position
– должность представителя
TMPL_2ustav
– на основании чего действует представитель
TMPL_seal
– картинка с печатью организации
TMPL_sign
– картинка с подписью представителя
TMPL_sales_name
– ФИО бухгалтера
TMPL_ALREADY_EXIST – текст, добавляемый в счет, если клиент в один и тот же день получает не первый счет
на одну и ту же услугу
Переменные для договора:
TMPL_additional
– список услуг для договора (/admin/template/LANG/contract*), нумеруется с “2.”
TMPL_specification
–
спецификации
дополнительных
(/admin/template/LANG/contract_specification_fiz.php или contract_specification_ur.php)
TMPL_moneyback_first
– сумма moneyback в первичной валюте
TMPL_moneyback_second
– сумма moneyback во вторичной валюте
TMPL_cancellation_paylist1
– <tr></tr> список платежей через любые мерчанты в первичной валюте
TMPL_cancellation_paylist2
– <tr></tr> список платежей через мерчант UR_Bank в валюте для юр. лиц
услуг
TMPL_cancellation_paytotal1 – сумма всех платежей через любые мерчанты в первичной валюте
TMPL_cancellation_paytotal2 – сумма всех платежей через мерчант UR_Bank в валюте для юр. лиц
TMPL_cancellation_wo_rest1 – сумма всех платежей через любые мерчанты в первичной валюте минус
остаток
TMPL_cancellation_wo_rest2 – сумма всех платежей через мерчант UR_Bank в валюте для юр. лиц минус
остаток
Переменные шаблона /admin/template/LANG/ur_akt.php и /admin/template/LANG/ur_sf.php
TMPL_dateaktsf– дата акта выполненных работ или счет-фактуры
TMPL_dateold – дата начала срока действия услуг
TMPL_datelast – дата окончания срока действия услуг по платежу
Карты экспресс-оплаты
Панель Администратора => Навигация => Карты Экспресс-оплаты
В админ-панели для создания карты для конкретного в поле "Логины" введите один логин клиента. В этом
случае клиенту придет соответствующее письмо.
Для генерации партии введите список любых по одному в строку либо установите галочку напротив
"Генерация" и укажите количество карт.
Карты м.б. использованы только при статусе "PAID".
При добавлении на неактивированную карту (статус WAITING) средств через админ-панель (форма ниже
листинга данных) карта станет “PAID”.
Карты полезны при ежемесячной оплате услуг через банк. Чтобы не ходить помногу раз в банк, клиент может
заказать карту например с $100 и оплатить ее, чтобы впоследствии производить платежи именно с нее.
Автоматическая регистрация доменов
BPanel позволяет автоматически регистрировать домены в определенных зонах через указанных далее
регистраторов.
Предполагается, что одним из главных параметров выбора регистратора доменов является стоимость
приобретения последних.
Наиболее оптимальные варианты по цене предложены ниже.
.RU / .SU., gTLD и др.
Доступные автоматические действия: регистрация, продление, изменение DNS, изменение контактных
данных.
В /admin/conf/whm.php для соответствующего регистратора измените значения переменных
$***_username – логин
$***_password – пароль
Услуги => Стоимость Доменов => Регистратор: REGISTRAR
В настройках доменной зоны: кол-во лет для регистрации/продления: 1 (продление домена возможно только
за два месяца до его истечения, BPanel принудительно ограничит возможность продления домена на соотв.
стр. до наступления нужного срока).
WNames.Ru
Прайс-лист: http://wnames.ru/price.php
$wnames_password – укажите MD5 hash, который можно получить авторизировавшись на wnames.ru => мой
аккаунт => заполнить форму внизу страницы.
Тестирование скрипта: логин и MD5: test
WebNames.Ru
URL: http://webnames.ru
Тестирование скрипта: логин и пароль: test
Также поддерживается работа с доменами gTLD и т.п.
Для работы с domenonline.ru (партнером WebNames.Ru) добавьте в whm.php перед переменную
$webnames_config = "domenonline.ru";
а логин и пароль укажите в $webnames_username и $webnames_password соответственно.
В данном случае запросы для доменных зон, в которых указан регистратор “webnames” будут отправляться к
API domenonline.
Naunet.Ru
URL: http://naunet.ru
Тестирование скрипта: невозможно, проверяйте на “боевом” режиме.
Для автоматической регистрации доменов необходимо получить статус реселлера в панели наунета.
Информация: при тестировании выявлено, что выполнение действий на стороне регистратора после запроса
скрипта к API Наунета может достигать до двух с половиной минут.
Автоматическое изменение контактных данных не предусмотрено в API этого регистратора.
Reg.Ru
URL: http://reg.ru/
Тестирование скрипта: логин и пароль: test
Также поддерживается работа с доменами gTLD и т.п.
При добавлении в whm.php переменной
$regru_config="reg.domen-reg.ru";
Запрос пойдет на “reg.domen-reg.ru”, аналогично можно сделать и для других сервисов, использующих
reg.panel.
Nic.Ru
URL: http://nic.ru/
Тестирование скрипта: логин: 370/NIC-REG/adm, пароль: dogovor
В настройке BPanel по логину на nic.ru к XXXX/NIC-REG всегда нужно добавлять “/adm ”.
Также поддерживается работа с доменами gTLD и т.п.
В админ-панели –> настройки –> скрипт –> Паспортные данные требуются для зон
Перечислите все доменные зоны, в которых Вы будете регистрировать домены через nic.ru.
41651.myorderbox.com
Автоматическая регистрация, продление и изменение DNS у доменов .COM, .NET, .ORG, .BIZ, .INFO, .NAME, .US,
.IN, .*.IN, .MOBI, .BZ, .CC, .TV и др.
Прайс-лист: http://advanta.org/reseller.php#domains
В admin/conf/whm.php
Измените значения переменных
$directi_reseller
$directi_key
Указав в них ID (номер) реселлера и API key (DirectI Panel -> Settings -> API).
Узнать directi_reseller: DirectI Panel => Авторизация => Settings => Personal Information => Primary Profile =>
Reseller Id.
Во вкладке Settings после авторизации выше -> API -> HTTP укажите IP адрес Вашего сервера.
Услуги => Стоимость Доменов => Регистратор: directi
DirectI.com
Автоматическая регистрация, продление и изменение DNS у доменов .COM, .NET, .ORG, .BIZ, .INFO, .NAME, .US,
.IN, .*.IN, .MOBI, .BZ, .CC, .TV и др.
Прайс-лист: http://resellerclub.com/pricing/#domain_reg
В admin/conf/whm.php
Измените значения переменных
$directi_reseller
$directi_password
Указав в них ID (номер) реселлера и пароль.
Узнать directi_reseller: http://manage.resellerclub.com/reseller => Авторизация => Settings => Personal
Information => Primary Profile => Reseller Id.
Во вкладке Settings после авторизации выше -> API -> HTTP укажите IP адрес Вашего сервера (IP адрес, с
которого будут идти запросы к API).
Услуги => Стоимость Доменов => Регистратор: directi
Регистрация доменов в панелях LogicBoxes
Настройки идентичны предыдущим, в файле /admin/conf.php заполните
$directi_config =
указав в настройке домен, на котором расположено API регистратора (для вызова адресов типа
https://$directi_config/api/customers/details.json?auth-userid=...)
BPanel поддерживает одновременную работу с тремя регистраторами типа directi.
UkrNames.com
URL: http://ukrnames.com/
Запросите у технической поддержки данные доступа к EPP для Вашего аккаунта, сообщив им логин и ID
аккаунта и IP адрес сервера, с которого будут подключения.
Тестирование скрипта: раскомментируйте переменную $ukrnames_config = "test.ukrnames.com"; в whm.php
Контактные данные по доменам *.UA редактируются на сайте https://hostmaster.net.ua/ (пароль доступа
клиент может получить путем выполнения процедуры его восстановления на этом сайте).
Internet.Bs
URL: http://www.internetbs.net/
Тестирование скрипта: username: testapi; password: testpass.
Для
автоматической
работы
с
доменами,
в
соответствии
с
http://www.internetbs.net/ResellerRegistrarDomainNameAPI/DomainNameResellerRegistrarAPI.pdf, You will then
need to request an API key (apikey-request@internet.bs) providing the IP from where you will access the API. For
testing purposes we have set a test server accepting и указать apikey и пароль в файле /admin/conf/whm.php
AhNames.com
ALPHA-версия. При обнаружении ошибок – сообщайте, - будет исправлено в с высочайшим приоритетом.
URL: http://www.ahnames.com/
Тестирование скрипта: username: demo; password: demo.
Для боевого доступа, согласно https://ahnames.com/api, укажите в файле /admin/conf/whm.php
$ahnames_login
= "ЛОГИН"; // свой логин на ahnames
$ahnames_password
= "ПАРОЛЬ"; // пароль
$ahnames_config
= "evoface.ahnames.com"; // URL боевого доступа
Начало работы с другим регистратором доменов
В биллинг можно добавить несколько записей одной и той же доменной зоны, но с различными
регистраторами и ценами продления. Новые регистрации производятся у того регистратора и по тем ценам,
ID доменной записи которого в листинге доменных зон меньше (находится выше).
Пример. Ранее регистрации (продления) .RU производились по цене 20 (15) USD у регистратора webnames.
Хостер перешел к регистратору wnames с ценами 10/5 USD. Для этого нужно у доменной зоны изменить
регистратора с webnames на wnames, изменить стоимости и добавить вторую запись доменной зоны .ru, но
уже с ценами webnames и регистратором webnames и статусом Off.
Тестирование на хосте 127.0.0.* работы интеграции с регистраторами домена
Для возможности тестирования на хосте 127.0.0.* работы интеграции скрипта с регистраторами доменов и
недопущения случайного списания средств за реальную регистрацию тестовых доменов, предназначенных
исключено для проверки API регистратора, BPanel автоматически подставляет в поля логина и пароля
тестовые данные (test/test или т.п.) у следующих регистраторов: internet.bs, nic.ru, reg.ru, webnames, wnames.
Тестирование на регистрацию и продление доменов в боевом режиме у регистраторов выше производите на
хосте, отличном от 127.0.0.*.
Продажа SSL сертификатов через ПО LogicBoxes
Установите конфигурационные настройки в admin/conf/whm.php (см. выше).
При добавлении дополнительной услуги:
Интегрировать в аккаунт: нет.
Специальная услуга: SSL сертификат.
Буквенно-числовое значение:
300 для Positive SSL
299 для Comodo SSL
301 для Positive SSL Wildcard
Ранее: sgc (для SGC SuperCert), ssl (для Web Server Certificate), fssl (для SSL123 Certificate) или wild (для Wildcard Server Certificate).
Настройки отдельного счета -> Дней на оплату: 30 (счет на продление будет выставлен за 30 дней до
окончания срока действия сертификата).
Блокировать при неуплате: нет.
Выставлять счет каждый: 1 год (для того, чтобы SSL выдавался на 2 года, выберите “ Выставлять счет каждый:
2 год”, продление в данном случае будет производиться также на два года). По желанию, можно выдавать SSL
и помесячно (выбирайте выставлять счет каждый ХХ “месяц”).
При ручной активации услуги в поле “ID счета для SSL” нужно указать ID счета за сертификат на DirectI.
При заказе дополнительной услуги на reg.php или через одноименную функцию после авторизации в панели
управления счетами клиенту будет выставлен персональный счет, после оплаты которого и перехода в меню
“дополнительные услуги” и последующего нажатия на картинку “управление сертификатом” станут доступны
функции: создания (после оплаты соотв. счета), продления (после оплаты соотв. счета), или пересоздания
сертификата (при наличии действующего сертифката).
Для установки суммы выдачи большей, чем сумма продления, при добавлении дополнительной услуги
укажите разницу в стоимостях в поле “Установка”.
Сумма со счета реселлера на LogicBoxes списывается после отправки клиентом запроса на создание или
продление сертификата.
Удаление сертификата из админ-панели – вручную. Действие удаления из биллинга не отражается на записи в
панели LogicBoxes.
Автоматическая отправка запроса к LogicBoxes при неавтоматической оплате от клиента: услуги –>
выставление счетов –> найдите счет по номеру и нажмите на “-” в колонке “опл.”.
Продажа свидетельств о регистрации доменов
При добавлении дополнительной услуги стоимость укажите в поле “Установка”, в “Специальная услуга”
выберите “Свидетельство”.
На странице reg.php при выборе услуги и отсутствии регистрации домена сумма за свидетельство добавляться
к конечной стоимости не будет.
В панели клиента на странице листинга доменов будет кнопка для заказа свидетельства, а на странице
регистрации домена – соответствующий чекбокс.
Автоматическое присвоение IP адресов в cPanel.
При добавлении дополнительной услуги в поле “Специальная услуга” выберите “IP адрес”.
Функция работает только с cPanel при использовании логина “root” или наличии у используемого
реселлерского аккаунта привилегий “Root Access”.
Панель Администратора
Пароли. При изменении данных рекомендуется, чтобы пароли аккаунтов клиентов, сотрудников и пр.
содержали только символы a-z, A-Z, 0-9 и “-”. Логины – только a-z и 0-9.
Вход
При установке галочки напротив пароля страница с запросом авторизации появляться более не будет
(cookies).
Главная Страница
Для активации аккаунта или домена введите номер в форму и нажмите на кнопку "На Активацию". (Если
установить галочку, скрипт автоматически создаст аккаунт в WHM (D.A./ISPmanager/Plesk) и при
необходимости зарегистрирует домен).
Для продления срока действия аккаунта или домена введите номер и срок в поля и нажмите на кнопку
"Продлить" (для аккаунта срок в месяцах, для домена – в годах).
Поля textarea предназначены для комментариев в письма клиентам.
Экспресс Карты (пин-коды)
Активация или деактивация, изменение статуса карты и/или даты окончания ее срока действия и статуса
заказа происходит после нажатия на картинку с карандашом.
Поступления
Список платежей через мерчанты или посредством карт экспресс-оплаты.
В настройках CRON переменную "Удаление записи об оплате со статусом "WAITING", через XX дней"
рекомендуется выставлять на 60 или более дней.
Расходы
В базу можно вносить и расходы. Это даст наглядную примерную статистику по доходам.
Очистка Базы.
Удаление из базы данных MySQL старых записей неоплаченных заказов, переходов по ссылкам в партнерской
программе и др. Данные для очистки задаются в разделе CRON.
Массовое Продление Хостинга
Массовое добавление дней хостинга клиентам. Задается датой регистрации клиентов, от одного дня по
другой. Все, кто попал под этот срок, получают письмо с уведомлением об изменениях.
Изменение Паролей
Данная опция внедрена для повышения безопасности - она изменяет пароли на всех аккаунтах, причем новый
пароль генерируется длиной согласно настройкам “Длина пароля для cPanel (D.A./ISPmanager/Plesk) ”. При
изменении пароля идет отсылка писем владельцам аккаунтов.
IP LookUp
Проверка IP адресов доменов клиентов. Если IP адрес в домене не наш, то он отображается красным цветом.
Base check
В форме вводится список доменов (по одному в строку), а скрипт проверяет каждый домен на наличие записи
о нем в биллинге как об основном на аккаунте (HOSTING и RESELLING).
Клонирование Данных
Копирует данные по клиенту из одного заказа в другой. Некопируемые поля выведены в форму. Логи доступа,
логи почты и данные по партнерской программе не копируются.
Стоимость Доменов
Добавление, изменение и удаление стоимости регистрации домена в конкретной доменной зоне. В поле
"Комментарии" вводится текст, который будет отправлен или показан клиенту при выборе регистрации
домена именно в этой зоне.
Для того, чтобы при регистрации домена клиенту необходимо было ввести паспортные данные, необходимо
добавить доменные зоны в Панель Администратора => Настройки => Скрипт (общие).
WhoIs-сервер –
адреса whois
для специфических доменных зон можно получить на
http://www.iana.org/domains/root/db/, напр. http://www.iana.org/domains/root/db/ru.html: WHOIS Server:
whois.ripn.net.
WhoIs-слово – слово или словосочетание из ответа whois-сервера, на основе которого BPanel будет считать
домен свободным, напр. при проверке свободного домена на domen.php?mod=info&domen=1231230.com в
ответе выдает No match for "1231230.COM", значит в качестве словосочетания можно использовать “No match
for”. Поле заполнять обязательно.
При установке значения “1” в поле “Кол-во лет для регистрации/продления” настройки доменной зоны и
неуказании регистратора, продлить такой домен клиент сможет только в срок за 30 дней до момента
окончания регистрации домена.
Дополнительные Услуги
Добавление, изменение и удаление дополнительных услуг. Идентификатор услуги должен быть только на
английском языке (для клиента он виден не будет).
При указании в поле "Это Контрольная Панель?" или "Это Операционная Система?" значения "Yes", данные
дополнительные услуги будут распознаваться скриптом для Dedicated и VPS как Control Panel и OS
соответственно.
Истекающие Аккаунты & Домены
Статистика по истекающим аккаунтам и доменам.
Настройки задаются в меню опции "Админ-Панель"
При нажатии на цифру отсылается письмо владельцу аккаунта. При нажатии на "разослать уведомления"
производится автоматическая рассылка предупреждений об истечение срока действия аккаунта и/или
домена.
Активация аккаунта
После ввода на главной странице номера аккаунта клиента попадаем сюда.
Сперва необходимо нажать на кнопку в правой форме (WHM/D.A./ISPmanager/Plesk), потом в левой.
Текст для клиента – отправляется клиенту в письме об активации аккаунта.
Цифры под комментариями – подсчет суммы, которую должен был клиент заплатить за услуги.
Хостинг-Серверы
Данные по серверам, на которых будут располагаться сайты.
Хостинг-Серверы => Реальное Местонахождение Сайтов
Функция проверяет, соответствуют ли реальные данные о сервере, на котором находится сайт с теми, что есть
в базе данных.
Поля заполняются по одной записи в строчку так, чтобы каждому IP соответствовал ID сервера.
Пример:
IP Адреса: "64.191.80.*
65.195.80.*
66.191.80.*"
ID Серверов: "2
1
3"
В данном случае, если например сайт находится на IP 65.195.80.*, а в базе другая информация (напр. сервер с
ID 1), то она будет обновлена на "2".
Функция полезна в том случае, если Вы размещаете сайты на нескольких серверах.
Партнерская Программа
Flash-баннеры должны быть созданы с передачей параметров через GET на скрипт host.php, пример:
Статусы аккаунтов
Active - активный
Un-Rules – активный, не поддается блокировке и удалению через cron, уведомления об истечении срока
действия аккаунта не высылаются
Locked-BP – нет доступа в BPanel
Locked-CP – нет доступа в панель управления сервером
Locked-ALL – нет доступа в BPanel и панель управления сервером
Если изменение аккаунта подвластно только пользователю root, введите его данные в форме внизу страницы.
При просмотре информации по аккаунту, если он неактивирован, скрипт выведет стоимость его активации,
учитывается является клиент юридическим лицом (НДС и т.п.) или нет.
В случае, если аккаунт уже активирован, то выводится сумма moneyback как в долларах, так и в рублях. НДС
для юридических лиц также учитывается.
Для ручного создания аккаунтов и добавления или изменения тарифов в WHM скрипт генерирует
специальные ссылки. Вида http://whmlogin:whmpassword@link
Если Ваш браузер не поддерживает переходы по таким ссылками и пишет "ошибка синтаксиса", используйте
браузер opera или вручную копируйте ссылку и убирайте из нее "whmlogin:whmpassword@".
Экспорт тарифов
Знаки разделения между полями: “_||_”, между записями: перенос строки “\r\n”. Функция добавлена для
экспорта тарифов в текстовый файл и последующего их отображения на страницах, напр.
http://advanta.org/vps.php. При изменении данных в биллинге достаточно лишь выполнить экспорт и
заменить 1 файл на FTP, т.о. можно создать практически динамическое отображение тарифных планов.
Однако, необходимо самостоятельно написать динамическую страницу, которая бы брала данные из
текстового файла.
Услуги –> Персональные услуги
Посредством данной функции можно превратить BPanel не только в биллинг хостинга, но и других
ежемесячных/ежеквартальных и т.п. услуг.
Функция используется для автоматического выставления счетов на определенную персонально названную
услугу с конкретной стоимостью за заранее заданный период времени.
После добавления записи она автоматически будет обработана (добавлен счет по ней) в день “Дата начала
выставления счета” после первого же запуска CRON. Скрипт выставит счет однократно, вне зависимости от
количества запусков CRON (контролируется полем “дата последнего выставленного счета”, которое
самостоятельно заполнять/изменять не рекомендуется).
Всплывающее меню.
Для того чтобы меню всплывало при наведении на него мыши, измените в файле
/admin/template/LANG/admin_data.js в строке, начинающейся с startMenu последний параметр с true на false.
Автоматическая активация аккаунтов
На E-Mail администратору приходит письмо с данными по платежу и по сайту клиента.
DOMAIN REGISTRATION – необходима регистрация домена.
ADDITIONAL SERVICES – оплата была совершена с включением стоимости дополнительных услуг.
RESELLER – необходимо вручную добавить соответствующие привилегии аккаунту и уведомить клиента по EMail за исключением:
WHM при логине “root” и наличии на сервере ACL List с названием “reseller”.
DirectAdmin при логине “admin”.
ISPmanager при логине “root”.
Plesk при логине “root” или “admin”.
Автоматическое выполнение действий на загруженных серверах
Если на Вашем сервере действия по активации и разблокировке аккаунтов, а также изменению тарифов после
автоматической оплаты выполняются долго, что вызывает ошибки при работе с платежными системами, то
проблему можно решить отключением автоматических действий на сервере:
Настройки -> серверы хостинга -> автоматические действия над хостинг-аккаунтами: No
Также при долгих ответах от регистраторов доменов (при регистрации доменов или их продлении) можно
отключить и автоматические действия над доменами:
Настройки -> скрипт -> при возможности регистрировать и продлять домены сразу после автоматической
оплаты: No
После чего добавить в CRON скрипт cron_actions.php с запуском, например, раз в 5 минут.
В базу ожидаемых действий после оплаты через мерчант добавляется соответствующая запись со статусом
PAID. При запуске скрипта cron_actions.php биллинг однократно автоматически попытается выполнить
ожидаемое действие.
Поддерживаемые действия:
1. Активация аккаунтов.
2. Разблокировка аккаунтов.
3. Изменение тарифных планов.
4. Регистрация доменов.
5. Продление доменов.
CRON: выполнение заданий по расписанию
Обычный (выполнение всех заданий)
/usr/bin/php /home/логин/public_html/папка/admin/cron.php
Ручной (выполнение указанных заданий)
/usr/bin/php /home/логин/public_html/папка/admin/cron.php go=manual ПАРАМЕТРЫ
Если заполнить поле "каждый XX день" или "через XX дней" числом "-1", то выполнение конкретного задания
будет отключено.
Параметры:
order_delete=1 удаление заказов на хостинг, реселлинг, серверы, домен-аккаунты;
domen1_delete=1 удаление заказов на домены;
cards_delete=1 удаление заказов на экспресс-карты;
addon_delete=1 удаление заказов на доп. услуги;
partner_delete=1 удаление старых переходов по партнерским ссылкам;
pcards_delete=1 удаление записей незавершенных платежей;
invoice_admin=1 письмо администратору о неоплате счетов;
invoice_user=1 письма клиентам о неоплате счетов;
invoice_suspend=1 блокировка HOSTING-аккаунтов при неоплаченных счетах;
invmaker=1 автоматическое выставление счетов по расписанию;
shedule=1 генерация графиков дежурств;
birthday=1 поздравление клиентов с днем рождения;
rudocs=1 отправка уведомлений о незагрузки документов для доменов .Ru/.Su/.РФ;
cron_accounts=1 автоматическое продление аккаунтов с карты экспресс-оплаты
cron_domains=1 автоматическое продление доменов с карты экспресс-оплаты
hosting_email=1 рассылка уведомлений об истечении хостинга;
reselling_email=1 рассылка уведомлений об истечение реселлинга;
dedicated_email=1 рассылка уведомлений об истечении аренды сервера;
domen_email=1 рассылка уведомлений об истечении регистрации домена;
order_email=1 рассылка уведомлений неоплате неактивированных аккаунтов;
active_email=1 рассылка уведомлений о ненажатии владельцами активированных аккаунтов на спец. ссылку;
server_email=1 уведомление администратора о необходимости отключения серверов;
ur_email=1 уведомление юр. лиц об отправленных им и неполученных обратно документах по платежам;
account_block=1 блокировка хостинг-аккаунтов;
account_delete=1 удаление хостинг-аккаунтов;
domen2_delete=1 удаление просроченных оплаченных доменов;
hosting_sms=1 отправка SMS об истечении услуги hosting;
reselling_sms отправка SMS об истечении услуги reselling;
dedicated_sms отправка SMS об истечении услуги dedicated;
vps_sms отправка SMS об истечении услуги vps;
domen_sms отправка SMS об истечении услуги domen;
emailadmin=no не отправлять письмо администратору.
принудительный запуск при go=manual
backup=1 резервное копирование базы данных на e-mail
download_ur=1 получать из ЦБ курс доллара для юр. лиц
download_webmoney=1 получать из ЦБ курс доллара для WebMoneyR
download_yandex_fiz=1 получать из ЦБ курс доллара для Яндекс.Деньги, физ.
download_yandex_ur=1 получать из ЦБ курс доллара для Яндекс.Деньги, юр.
download_yandex_prochange получать из ЦБ курс доллара для Яндекс.Деньги, prochange
download_yandex_qiwi получать из ЦБ курс доллара для qiwi
download_fiz=1 получать из ЦБ курс доллара для физ. лиц
download_rbk=1 получать из ЦБ курс доллара для RBK Money
download_mmail=1 получать из ЦБ курс доллара для Money.Mail.ru
download_zp=1 получать из ЦБ курс доллара для Z-Payment.Ru
download_intellect=1 получать из ЦБ курс доллара для IntellectMoney.Ru
download_robo=1 получать из ЦБ курс доллара для RoboxChange.com
changedate=no не изменять в базе дату последнего запуска cron (если параметр не указан и значение “go“ не
“manual”, то дата изменяется)
для изменения даты при запуске go=manual обязательно указывайте changedate=yes
пример
/usr/bin/php /home/логин/public_html/папка/admin/cron.php go=manual account_delete=1 account_block=1
запуск без параметра go=manual и отмена действий
пример
/usr/bin/php /home/логин/public_html/папка/admin/cron.php hosting_email=0
значит все действия кроме отправки уведомлений об истечении хостинга
Ручной запуск крон полезен в тех случаях, когда сервер не справляется с обработкой всех или при
необходимости тестировании выполнения конкретной функции.
Настроить время выполнения CRON можно в панели управления сайтом.
Обновление курсов валют полезно только при основной валюте – USD.
Автоматическое заполнение договоров
Шаблоны договоров: /admin/LANGUAGE/template/contract_*_**.php
Шаблоны соглашений расторжения договоров: /admin/LANGUAGE/template/cancellation_*_**.php
* hosting, reselling, dedicated, vps, domenreg, partner
** fiz – для физических лиц; ur – для юридических лиц
Переменные:
TMPL_number
– номер заказа (договора)
TMPL_userlogin
– логин клиента
TMPL_dated
– порядковый номер дня первого платежа
TMPL_datem
– название месяца первого платежа
TMPL_datey
– год первого платежа
TMPL_current_dated – порядковый номер текущего дня
TMPL_current_datem – название текущего месяца
TMPL_current_datey
– текущий год
TMPL_telephone
– номер телефона
TMPL_mobilephone
– номер мобильного телефона
TMPL_term
– срок первого платежа в месяцах
TMPL_domen
– главный домен
TMPL_email
– email
TMPL_package
– название тарифного плана
TMPL_disk
– дисковое пространство
Только для юридических лиц при оплате безналичным переводом (UR_Bank):
TMPL_company
– название компании клиента
TMPL_address
– адрес
TMPL_inn
– ИНН
TMPL_kpp
– КПП
TMPL_nrs
– номер расчетного счета
TMPL_inrs
– имя банка
TMPL_ks
– к/c
TMPL_bik
– БИК
TMPL_fullcost
– первая оплаченная сумма цифрами
TMPL_inwords
– первая оплаченная сумма словами
TMPL_nds1
– процент НДС
TMPL_nds2
– сумма НДС
Рекомендуется набирать договоры в MS Word, после чего сохранять их в формате .html (сохранить как).
Конструктор тарифов: рекомендации
Создайте тариф с названием RESELLERLOGIN_custom, его параметры неважны. Не изменяйте его в будущем.
WHM -> Reseller Center. Реселлерскому аккаунту должны быть предоставлены все Super Privs (за исключением
demo-режима).
Стол помощи
Просмотр и работа с билетами клиентами и сотрудниками – из соответствующих панелей.
Просмотр и работа с билетами по ключу: helpdesk.php
Запуск e-mail piping: admin/imap.php, рекомендуется выполнять через CRON раз в 5-10 минут, для получения
почты через протокол POP (по умолчанию – IMAP “143/notls”) при создании записей в “Админ-Панель ->
Настройки -> Стол Помощи -> E-Mail” в поле “сервер” укажите “mail.server.com/pop”, порт: 110 (или 110/notls,
если выдает ошибки о незащищенном соединении).
Если сервер поддерживает IMAP SSL, то в поле порт можно указать “993/ssl” или при ошибке проверки
сертификата – “993/ssl/novalidate-cert ”.
Интеллектуальный поиск в F.A.Q. – функция, проверяющая страницу вопросов и ответов на наличие слов,
указанных в билете.
Перед настройкой стола помощи рекомендуется добавить разделы на страницу контактов, именно с ними и
ассоциируются категории стола помощи и e-mail piping.
Файлы-аттачменты в папке /admin/helpdesk/ :
a* - ответы в столе помощи
c* - файлы, загружаемые через сontacts.php, helpdesk в промежуточный период до добавления записи в базу
d *- уведомления об оплате
f* - записи faq
m* - мелодии для стола помощи
p* - платежи
s* - дополнительные услуги
t* - билеты в столе помощи
u* - аватары клиентов
x* - файлы, загружаемые клиентами
z* - аватары сотрудников
"b","e","g","h","i","j","k","l","n","o","q","r","v","w","y" - неиспользуемые папки про запас.
Автоматическое открытие билета
Сотрудники могут установить время автоматического открытия билета с постановкой его на HOLD.
Задание выполняется при запуске imap.php. Если Вы не настраивали imap.php на e-mail piping, все равно для
работоспособности функции автооткрытия нужно запускать imap.php.
Звуковое оповещение
Звуковое оповещение сотрудников выбранными ими мелодиями происходит при автоматическом
обновлении страницы открытых билетов и появлении на ней с предыдущего обновления обновленных
билетов (соответствующие настройки в профиле сотрудника).
Если звук не проигрывается, попробуйте установить QuickTime и/или проверьте настройки браузера.
Content-type для файлов:
.mp3 = audio/mpeg
.wav = audio/wav
.mid = audio/midi
ICQ-боты
Используются для оповещения сотрудников и клиентов о новых билетах, ответах, автооткрытиях билетов и
оценках в столе помощи.
Админ-панель –> настройки -> стол помощи -> ICQ боты. При большом количестве клиентов (запросов от них)
рекомендуется добавить несколько ботов (т.к. сервер icq блокирует многочисленные подключения с одного
уина).
Регистрируем уин на icq.com, после чего добавляем его в биллинг. Оповещение одностороннее, т.е. если
ответить боту, никакого действия не произойдет.
Уведомления в ICQ приходят только при online-статусе получателя.
LoadUsage модуль
Расположение: admin/usage.php
Предназначен для получения статистики WHM Daily Process Log.
Также, как и на вход в админ-панель, идет проверка по IP адресу администратора.
Данные сохраняются в таблицу "активированные" и доступны пользователю для просмотра через мойаккаунт => дополнительная информация.
Ссылка на статистику LoadUsage появляется у пользователя только при наличии в базе данных по нагрузкам.
Запуск по CRON:
/usr/bin/php /home/логин/public_html/папка/admin/usage.php go=start ip=IP
Где IP – основной IP адрес сервера в соответствии с одноименным листингом в панели администратора.
Root пароль будет взят из /admin/conf/whm.php
Добавлять root пароль в параметр запуска CRON категорически нельзя, т.к. он может отобразиться в
служебной части письма, отправляемого клиенту.
Модуль WhoIs
Расположение: domen.php
Для удобства и простоты в работе используется только одна форма: массовой проверки, в ней можно
указывать и 1 домен. Для добавления собственного текста вниз страницы необходимо изменить файл
admin/template/LANGUAGE/domen.inc
RSS-канал
По умолчанию в шаблоны страниц добавлен код, информирующий браузер о наличии RSS-канала:
<link rel="alternate" type="application/rss+xml" title="RSS-news" href="news.php?mod=rss">
Данные формируются “на лету” из news.php.
Новостной модуль
Расположение: news.php
Для
добавления
новостей
на
страницу
сайта
подкорректируйте
под
себя
шаблон
admin/template/LANGUAGE/news_small.php
и
добавьте
содержимое
файла
http://сайт/папка/news.php?mod=simple например постоянно скачивая и импортируя его в страницу, напр.
добавьте в php-файл следующий код:
<?php
error_reporting(0);
$array=file("http://сайт/папка/news.php?mod=simple");
foreach($array as $string) {$fileview=@$fileview."$string";}
echo $fileview;
error_reporting(E_ALL);
?>
Ограничение количества новостей для вывода производится в админ-панели –> настройки -> Панель
Администратора –> количество записей на странице новостей.
При
вызове
http://сайт/папка/news.php будет
отображен расширенный вариант новостей
(admin/template/LANGUAGE/news_big.php – этот же файл используется и для шаблона вывода статуса сети).
Дополнительные переменные для шаблона news_small.php:
TMPL_just_subj – только тема новости (без ссылки, просто текст)
TMPL_just_link – ссылка на подробности
TMPL_just_id – ID новости
Регистрация сайтов на 1PS.ru
Расположение формы заявки: catalog.php
Можно либо как самостоятельно регистрировать сайты в каталогах и поисковиках, либо оплачивать наши
услуги и перенаправлять нам данные посредством http://order.advanta.org/catalog.php.
Информация и стоимость регистрации через advanta.org: http://advanta.org/hosting.php внизу страницы,
способы оплаты: http://advanta.org/order.php.
SMS-верификация и уведомления
URL сервиса: http://www.epochtasms.ru/
После регистрации и пополнения счета перейдите в на сайте сервиса в раздел “Панель управления ePochta
SMS” -> ePochta SMS -> настройки и укажите там:
Включить XML интерфейс:
Режим XML интерфейса: рабочий
Далее перейдите в BPanel –> панель управления администратора –> настройки –> скрипт и укажите настройки
подключения к сервису SMS-сообщений.
Captcha (защита от ботов)
При ошибках вида “Warning: file_put_contents(captcha.jpg)” установите на файл “ captcha.jpg ” атрибуты,
позволяющие производить его изменение (666 или другие в соответствии с настройками Вашего сервера).
Firewall CSF
При наличии на сервере файроволла CSF можно предоставить сотрудникам возможность вносить, удалять и
проверять
IP
адреса
в
CSF.
Добавьте
в
“Edit
csf.resellers”
“логин_реселлера_на_сервере:0:USE,ALLOW,DENY,UNBLOCK,GREP”.
Согласно документации CSF,
# NOTE: As of version cPanel v11.38 you must additionally grant resellers
# access via "WHM > Edit Reseller Nameservers and Privileges > Third Party
# Services > ConfigServer Security & Firewall (Reseller UI)".
Обратная связь
Расположение: contacts.php
Используется также для добавления билетов в стол помощи (необходим cron-запуск e-mail piping:
admin/imap.php).
Форма отправки СМС. Необходимо подключить на мобильный телефон администратора функцию email2SMS,
отправляемые из формы сообщения будут доставляться на e-mail, а после чего – на телефон администратору.
Отправка ссылки другу
Расположение: contacts.php?mod=friends
Для открытия страницы в новом окне в HTML-коде первоначальной страницы д.б.
<script language="javascript" src="img/styles/friends.js" type="text/javascript"></script>
<div id=friends style="display:none;position:absolute">
<a
href="javascript:void(0);"
style="background-color:white;
onclick="getE('friends').style.display='none'">[X] закрыть окно</a>
text-decoration:
none"
<iframe id='sframe' height="434" width="526"></iframe>
</div>
А ссылка должна иметь вид
<a href="javascript:void(0)" onclick="friends('')">отправить ссылку другу</a>
Основная валюта
По умолчанию в качестве основной валюты используется доллар США (USD).
Чтобы изменить валюту на напр. российский рубль (RUR) требуется
1. Внести изменения в языковой файл (USD заменить на RUR, а RUR на USD).
2. В настройках валют панели администратора указать соотв. курсы.
Для изменения основной валюты на существующей базе клиентов, вероятно, понадобится и ручное
изменение оплаченных сумм, балансов аккаунтов и др.
Графики дежурств
Время генерация графика дежурств напрямую зависит от количества сотрудников, записей в базе дежурств и
мощности сервера. При включении данной функции рекомендуется увеличить время выполнения скрипта.
Логи Skype/ICQ
Поиск дат в загруженном логе производится при наличии этих дат в круглых (для icq) и квадратных (для skype)
скобках, а также при наличии в строке только лишь даты (для Skyperious, Например: Thursday, 02. July 2015).
Для ПО Skyperious лог (файл) должен содержать текст “Exported with Skyperious”. В данном случае в базу будут
занесены данные с 9-ой строки лога (файла). При экспорте логов через ПО Skyperious в настройках укажите:
ExportChatTemplate: Skype %(people)s
ExportDbTemplate: Export from %(people)s
Пути к файлам
Панель для Клиентов и Партнеров
: /order/index.php
Регистрация на хостинг
: /order/reg.php?mod=hosting
Регистрация на реселлинг
: /order/reg.php?mod=reselling
Регистрация на сервер
: /order/reg.php?mod=dedicated
Регистрация на домен-аккаунт
: /order/reg.php?mod=domenreg
Регистрация партнера
: /order/reg.php?mod=partner
Передача данных на страницу регистрации.
domen - имя домена
term - срок в месяцах
plan - ID тарифного плана
Пример
передачи
посредством
reg.php?mod=hosting&domen=dom.com&term=1&plan=2
GET
(возможен
и
POST):
Для регистрации в качестве юридического лица необходимо в конец ссылок, приведенных выше, добавить
"&ur".
Калькулятор стоимости хостинга
: /order/calc.php?mod=hosting
Калькулятор стоимости реселлинга : /order/calc.php?mod=reselling
Калькулятор стоимости dedicated
: /order/calc.php?mod=dedicated
Калькулятор стоимости VPS
: /order/calc.php?mod=vps
Модуль WhoIs
: /order/domen.php
Таблицы тарифов
: /order/price.php
Конструктор тарифов
: /order/custom.php
Каталог сайтов клиентов
: /order/host.php?mod=top
База знаний F.A.Q.
: /order/faq.php
Новостной модуль
: /order/news.php
Статус сети
: /order/news.php?mod=network
Просмотр билета в столе помощи
: /order/helpdesk.php
Страница обратной связи
: /order/contacts.php
Заявки на регистрацию в каталогах
: /order/catalog.php (ручная регистрация на 1PS.ru)
Панель Сотрудников (сапортов)
: /order/staff.php
Панель управления Администратора : /order/admin/index.php
CRON
: /order/admin/cron.php
IMAP
: /order/admin/imap.php
API
: /order/admin/api.php
LoadUsage
: /order/admin/usage.php
// Только в PRO Версии
WM Merchant
: /order/webmoney.php
Yandex Merchant #1
: /order/ya.php
Yandex Merchant #2
: /order/yandex.php
RBK Money
: /order/rbk.php
RoboxChange
: /order/robo.php
Z-Payment
: /order/zpayment.php
E-Gold
: /order/egold.php
MMail
: /order/mmail.php
Кодировки различных языков
Кодировка текстов (веб и писем) указывается в панели администратора (по умолчанию windows-1251).
Кодировка, которая “перекрывает” значение по умолчанию задается в /admin/lang/LANGUAGE.php. Она
распространяется на панель клиента и на многие письма (их шаблоны), отправка которых провоцируется
клиентом.
Язык russian удалять нельзя, т.к. он используется для различных системных функций как в панели
администратора, так и для страниц установки и обновления программы.
Для отключения языка english – удалите файл english.php из директории /admin/lang/
Языковые переменные для GET/POST-запросов на страницы calc.php, reg.php и др.:
&lang=english - срабатывает, если у пользователя не выставлены языковые cookies (выставляются при
изменении информации в "мой аккаунт" и т.п.).
&lang2=english - жесткое указание языка (вне зависимости от cookies).
Изменение серверного часовой пояса
Даты в биллинге выводятся и сохраняются в часовом поясе сервера хостинга, на котором находится скрипт.
При невозможности корректировки часвого пояса в настройках сервера (напр. хостинг на сервере
зарубежного провайдера) добавьте предпоследней в config.php следующую строчку:
аdate_default_timezone_set('Europe/Moscow');
Список других временных зон: http://www.php.net/manual/en/timezones.europe.php
Расшифровка системных ошибок
#1 -- Ошибка проверки лицензии скрипта;
#2 -- -//-;
#3 -- -//-;
#4 -- -//-;
#5 -- -//-;
#6 -- IP адрес сервера не внесен в список реселлеров advanta.org;
#7 -- Лицензия аннулирована или истек ее срок действия;
Отличия версии PRO
1. Автоматический прием платежей через мерчанты с мгновенным выполнением действия* (активация
аккаунта, продление срока действия, регистрация/продление домена, изменение тарифного плана и т.п.).
* На сервере должна быть установлена панель cPanel , DirectAdmin, ISPmanager или Plesk.
2. Выставление счетов на оплату для юридических лиц и создание квитанций для физических лиц.
3. Автоматическая регистрация, продление, изменение DNS доменов.
API (Applictaion Programming Interface)
Расположение: /admin/api.php
Поддержка: GET, POST включение в скрипт (include, require).
Методы GET, POST
Т.к. файл api.php находится в запаролированной директории admin, то для доступа к нему в запросе должны
присутствовать авторизационные данные доступа в папку.
Ответ от системы:
Success или текст ошибки выводится в браузер. Если ответ не содержит “Success”, значит ошибка.
Включение в скрипт (include, require)
Если Ваш скрипт находится на одном аккаунте с биллингом, то можно использовать include, require. Перед
ними предварительно обязательно
include(config.php); // конфигурация
include(license.php); // лицензионные данные
Переменные в этом случае должны передаваться как $_REQUEST[“переменная”]
А само включение осуществляться как
ob_start();
include ("admin/api.php");
$save_txt = ob_get_contents(); // сохраняем ответ системы
ob_end_clean();
Ответ от системы:
$error_api=”no”; // выполнилось без ошибок
$error_api=”yes”; // выполнилось с ошибками
$save_txt=”Success”; // или текст ошибки - текстовый ответ
При критических ошибках скрипт завершает выполнение по exit;
Обязательные параметры
userid= номер аккаунта
userlogin= логин аккаунта
go= действие
amount= оплаченная клиентом сумма в основной валюте
apihash= пароль доступа к API, указывается в настройках скрипта в админ-панели
Поля для go=activate, account, domenreg, domenprol, tarif, addon, card и invoice
merchant_name= имя мерчанта. Обязательное. Должно содержать “_Merchant”,
”_Bank” или
быть“Administrator”, например, MyPersonal_Merchant, Local_Bank и т.д. Имя используется для построения
статистик в биллинге.
merchant_comment= комментарий в базу. Необязательное.
rucourse= курс валюты в базу. Необязательное.
nocost=yes – не проверять сумму к оплате (amount в этом случае можно указывать). Необязательное.
nobaseadd=yes – не добавлять платеж в базу payments (если это уже сделал Ваш скрипт). Необязательное.
Поля для go=suspend, unsuspend
thestatus= статус (ACTIVE, LOCKED-BP, LOCKED-CP, LOCKED-ALL или UN-RULES). Обязательное.
reason= комментарий. Необязательное.
thecondition= условие разблокировки для go=unsuspend. Необязательное. Возможные значения:
money – продление срока действия аккаунта
button – самостоятельно, нажатием на кнопку
invoice – после оплаты любого счета (invoice)
пустое или не указанное значение – разблокировка невозможна
Действия
Активация аккаунта
go=activate
Продление срока действия аккаунта
go=account
month= срок в месяцах
Регистрация домена
go=domenreg
domenid= номер домена
Продление срока регистрации домена
go=domenprol
domenid= номер домена
term= количество лет
Изменение тарифного плана
go=tarif
tarifid= номер тарифного плана из листинга тарифов
Оплата дополнительной услуги
go=addon
itemid= номер дополнительной услуги из листинга заказанных дополнительных услуг
Пополнение баланса карты экспресс-оплаты
go=card
cardcost= сумма
cardid= номер карты
cardlogin= логин карты
Клиентом оплачен счет
go=invoice
invoiceid= номер чета
Блокировка аккаунта
go=suspend
Разблокировка аккаунта
go=unsuspend
Пример запроса
HTML-код формы для продления аккаунта 1000 (логин demo) на 1 месяц по тарифу с ежемесячной стоимостью
в 0.99 USD (или другой основной валюты):
<form name="update" method="POST" action="http://127.0.0.1/order/admin/api.php">
userid: <input type="text" class="myinputtext" name="userid" size="5" value="1000"><br>
userlogin: <input type="text" class="myinputtext" name="userlogin" size="10" value="demo"><br>
go: <input type="text" class="myinputtext" name="go" size="10" value="account"><br>
month: <input type="text" class="myinputtext" name="month" size="10" value="1"><br>
amount: <input type="text" class="myinputtext" name="amount" size="10" value="0.99"><br>
merchant_name:
<input
value="Demo_Merchant"><br>
type="text"
class="myinputtext"
name="merchant_name"
size="20"
apihash: <input type="text" class="myinputtext" name="apihash" size="10" value="12345"><br>
<input type="submit" class="mybutton" value="go">
</form>
Добавление мерчантов
Добавление мерчантов производится на одноименной странице в админ-панели.
На мерчант передается такая же информация, как и в действиях для API +
userid= номер аккаунта
userlogin= логин аккаунта
go= действие
Дополнительно к ней: amount=стоимость в основной валюте.
Поля “Настройки в базу #1-15” Вы можете использовать по своему усмотрению и хранить там настройки
мерчанта (подгружая их при выборке своей записи из таблицы merchants).
Добавление своих модулей в панель клиента
Админ-панель -> Настройки -> Страницы ->Панель клиента –> Подгружать /admin/modules/z_customcode.php
В файле /admin/modules/z_customcode.php может быть произвольный код страниц, написанных Вами.
В начале и конце создаваемой страницы д.б. код
require("$_SERVER[DOCUMENT_ROOT]/$mysitedir"."admin/template/$language/panel_head.inc");
и
require("$_SERVER[DOCUMENT_ROOT]/$mysitedir"."admin/template/$language/panel_foot.inc");
соответственно.
Ссылки на свой страницы нужно добавить в меню /admin/template/LANG/hosting.inc или др.
Общая информация по регистраторам доменов и панелям управления сайтом
При включенной автоактивации аккаунтов и/или регистрации доменов настоятельно рекомендуется
приобрести выделенный сервер или VPS, предназначенный исключительно под биллинг.
Использование скрипта на сервере, на котором располагаются сайты клиентов, дает хакерам возможность с
соседнего аккаунта заполучить пароли из конфиг-файлов и влезть в базу клиентов.
Во избежание ошибок при автоматических действиях на сервере не рекомендуется, чтобы пароли содержали
специальные символы (биллинг их “режет”).
Тарифные планы в панели управления сервером не должны содержать русских и специальных символов,
называйте их на английском языке.
Первоначально BPanel создавалась для работы исключительно с панелью управления сервером cPanel
(WHM), интеграция с другими панелями является дополнительным функционалом BPanel.
Информация по DirectAdmin (D.A.)
Конструктор тарифных планов – поддерживается как автоактивация, так и переход между тарифами.
При вводе в биллинг данных по хостинг-серверу указывать:
Порт Запроса – 2222
Автоматическое изменение тарифного плана хостинга на пакет реселлинга – невозможно. Необходимо
вручную создать новый реселлерский аккаунт и выслать клиенту данные доступа в него, после чего
переместить имеющийся хостинг-аккаунт клиента под нового реселлера.
Информация по ISPmanager
Поскольку в запросе к API ISPmanager присутствует не только название тарифа, но и его параметры, автор
BPanel не утруждал себя написанием кода для автоматической генерации ссылок для создания тарифов на
сервере после их добавления в биллинг из админ-панели.
Конструктор тарифных планов – поддерживается как автоактивация, так и переход между тарифами.
Изменение главного домена аккаунта клиента на сервере посредством биллинга – не поддерживается.
При вводе в биллинг данных по хостинг-серверу указывать:
Тип Запроса – https
Порт Запроса – 443
Путь запроса – /manager/ispmgr
Порт в письмо Клиента – 443/manager/ispmgr
При добавлении биллинговых тарифных планов в полях лимитов CPU, Memory и MySQL необходимо указать
аналогичные значения (ограничение на CPU в секундах, ограничение на память в мегабайтах и количество
процессов в штуках соответственно), что и в шаблонах в ISPmanagerPro, собственно как и другие параметры
тарифов.
Субдомены = Почтовые домены
Паркованные Домены = Доменные имена (DNS)
Дополнительные Домены = WWW домены (сайты)
При ошибке отправки почты (can’t send a letter) проверьте в панели ISPmanager правильность указания e-mail
в www-домене, на котором установлен биллинг. E-Mail должен быть существующим.
Информация по Plesk
Конструктор тарифных планов – недоступен.
Изменение главного домена аккаунта клиента на сервере посредством биллинга – не поддерживается.
При вводе в биллинг данных по хостинг-серверу указывать:
Тип Запроса – http
Порт Запроса – 8880
Порт в письмо Клиента – 8880
Информация по OpenVZ
Конструктор тарифных планов – недоступен.
При вводе в биллинг данных по хостинг-серверу указывать:
Тип Запроса – http
Порт Запроса – 3000
Порт в письмо Клиента – 3000
Операционные системы – добавлять в дополнительные услуги, заполняя поле “Буквенно-числовое значение
для автоматической активации” значениями вида “centos-5-x86_64” (как указано в OpenVZ в
orig_os_template); тарифные планы: “Название в панели упр. сервером” в соответствии с orig_server_template.
Поля значений дискового пространства, памяти и параметров CPU заполнять обязательно.
IP адреса для серверов указать как FREE в Настройки –> IP адреса серверов.
Если аккаунт создается или удаляется с запросом к API OpenVZ (т.е. автоматически), то необходимая запись об
IP адресе вносится или удаляется также автоматически.
В письмо об активации в качестве данных доступа к серверу добавляются четыре строчки: IP, логин, пароль и
URL панели управления.
В данных по активированному аккаунту в полях “Служебное #1” и “Служебное #2” указываются служебный
(на сервере) UserID и служебный (на сервере) VirtualServerID.
Использованные модули
В ходе разработки скрипта были использованы следующие модули сторонних производителей:
Отправка сообщений в ICQ: WebICQ Lite (http://wip.asminog.com/workshop/php2icq.html)
Проверка
статуса
ICQ-клиента
перед
отправкой
сообщения:
(http://www.phpclasses.org/package/1776-PHP-Retrieve-the-online-status-of-an-ICQ-user.html)
icq_status_class
Предотвращение регистраций и отправок писем ботами: captcha (http://pear.php.net/package/Text_CAPTCHA)
Меню в админ-панели: Cascading Popup Menus (http://www.twinhelix.com/dhtml/popupmenu/)
Вставка смайликов в комментарии: javascript c http://archives.maillist.ru/13159/429435.html
Punycode -(рас)кодировка русских доменов: Net_IDNA (http://pear.php.net/package/Net_IDNA)
Поддержка
актуальности
названий
http://www.iso.org/iso/updates_on_iso_3166
и
буквенного
Поддержка
актуальности
телефонных
http://ru.wikipedia.org/wiki/Список_телефонных_кодов_стран
обозначения
кодов
стран:
стран:
Подсветка строк таблицы http://www.tigir.com/highlight_table_rows.htm
Обрезка аватаров http://recens.ru/php/resize_and_crop.html
Работа скрипта на нескольких доменах
Для этого необходимо иметь лицензию на каждый из планируемых к использованию доменов
Вариант 1. Установите копии скриптов с соответствующими license.php на разные аккаунты на сервере, но в
config.php пропишите доступ к одной и той же базе.
Вариант 2. Добавьте после предпоследней строки license.php следующий код:
if (stristr(getenv("HTTP_HOST")," DOMEN”)) {
$license_domen="";
$license_type=" ";
$license_serial="";
}
Где “DOMEN” – дополнительный домен, а переменные $license-* - из license.php для этого домена.
Проверка лицензии
1. Внутренняя, программная (license.php);
2. Внешняя, запросом на order.bpanel.ru (order2.bpanel.ru).
Для внешней проверки доступно 2 сервера на разных континентах. Не работает один – запрос идет на
запасной.
Продление срока действия лицензии: http://order.bpanel.ru
Техническая Поддержка
Возникли вопросы?
Смело задавайте их на нашем форуме: http://forum.bpanel.ru/index.php?showforum=13
P.S.
В этом руководстве описана лишь небольшая часть функций программы.
Не бойтесь пробовать и экспериментировать :)