Документация BILLmanager

Витрина

Витрина — механизм отображения услуг из BILLmanager на сайте провайдера. 

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

Более того, для начинающих провайдеров, у которых ещё нет собственного сайта, доступна возможность использовать автоматически генерируемый сайт. BILLmanager имеет стандартный шаблон сайта, где есть стандартные разделы и функции (разделы — О компании, Услуги и т.д.; функции — регистрация, переход в личный кабинет и т.д.). Информация об услугах на сайте будет сформирована на основе того, какие тарифные планы настроены в BILLmanager, информация о компании также автоматически формируется по данным биллинга. То есть на сайте всегда будет актуальная информация об услугах и компании.

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

Обратите внимание!

 Для корректной работы витрины опция BILLmanager 6 по умолчанию должна быть отключена в Провайдер Провайдеры Изменить.

Настройка витрины


Для настройки витрины перейдите в Провайдер → Глобальные настройки → блок Настройка витрины. Доступные настройки:

  • Отключить витрину — витрина будет полностью отключена; 
  • Форма авторизации — витрина включена. Можно использовать интеграцию в сайт или дать на неё прямую ссылку; 
  • Открыть панель — по адресу BILLmanager вместо формы авторизации будет отображаться витрина;
  • Сайт витрины — по адресу BILLmanager будет отображаться автоматически сгенерированный сайт.

В Провайдер → Глобальные настройки → блок Основное доступна опция Удалять гостевые профили клиентов. Включите её, чтобы BILLmanager удалял гостевые аккаунты При отсутствии активности более указанного количества дней. 

Витрина


Витрина позволит неавторизованному пользователю увидеть полный список предоставляемых провайдером услуг:

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

Обратите внимание!

 Цены на витрине для неавторизованного пользователя отображаются без учёта НДС, если провайдер использует модуль НДС для компаний имеющих VAT-номер Европейского Союза и его страна по умолчанию находится в VAT-зоне. Подробнее см. в статье НДС для стран Европейского Союза

Сайт витрины


Если выбрана настройка Сайт витрины, то по адресу BILLmanager будет открыт автоматически генерируемый сайт. Сайт создается или обновляется при редактировании таких сущностей как Компания, Провайдер, Тарифный план, Настройки бренда.

Исходные данные для генерации сайта располагаются в каталоге /usr/local/mgr5/skins/showroom/<ID провайдера>. Их можно настроить на любой вкус. 

Сгенерированный сайт располагается в каталоге /usr/local/mgr5/skins/showroom/1/, где 1 — Id провайдера. Сайт доступен по адресу самого BILLmanager.

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

За генерацию сайта отвечает функция showroom. Функция обновляет сайты для всех провайдеров сразу. Вызвать её вручную можно с помощью команды:

Вызов 'showroom'
/usr/local/mgr5/sbin/mgrctl -m billmgr showroom

Чтобы сбросить все изменения в каталоге с шаблоном сайта, нужно удалить каталог /usr/local/mgr5/skins/showroom/<ID провайдера>, тогда сайт будет создаваться на основе стандартных шаблонов из каталога /usr/local/mgr5/etc/showroom.sample/.

Обратите внимание!

Сайт витрины создаётся только на русском языке.

Интеграция в существующий сайт


Для добавления витрины на сайт используйте приведённый скрипт. Разместите его на нужной странице, в месте, где требуется отображать витрину. 

Скрипт отображения витрины
<script src="BILLMGR_HOST/manimg/orion/billmgrStore.init.js"></script>
 
<script type="text/javascript">
  billmgrStore.init({
    host: BILLMGR_HOST,
    startform: STARTFORM
  });
</script>
<noscript>Вам нужно включить JavaScript!</noscript>
 Пояснения к скрипту

BILLMGR_HOST — хост биллинговой системы. Может принимать значение в виде строки с URL сервера, например "https://my.ispsystem.com".

STARTFORM — параметры формы с витриной. Может принимать значение в виде строки с параметрами формы, например: "func=showroom.redirect&redirect_to=service.order.itemtype". Не может принимать значение "func=register.logon" т.е не нужно указывать функцию регистрации.

Настройка allow_origin

Обратите внимание!

 Для работы витрины на домене, отличном от домена биллинговой системы, необходима настройка allow_origin для ihttpd.

Для настройки allow_origin, в файл конфигурации ihttpd /usr/local/mgr5/etc/ihttpd.conf необходимо добавить:

allow_origin для ihttpd
allow_origin <доменное имя сайта>

Например:

allow_origin для ihttpd
listen {
	ip 172.32.12.23
	allow_origin http://showroom.com
	redirect
}

Где "http://showroom.com" — адрес сайта, на котором размещена витрина.

Настройки параметров

СвойствоЗначение по-умолчаниюОписание
basketfalseОтображать корзину с заказами. Может принимать значения {blockId: BLOCK_TAGRET_ID}, где BLOCK_TAGRET_ID — имя id html элемента, в котором отображать корзину; false — не отображать корзину.
usermenufalseОтображать меню пользователя. Может принимать значения {blockId: BLOCK_TAGRET_ID}, где BLOCK_TAGRET_ID — имя id html элемента, в котором отображать меню; false — не отображать меню.
titlefalseОтображать заголовок формы. Может принимать значения true — отображать заголовок, false — не отображать
wizard_stepfalseОтображать шаги заказа. Может принимать значения true — отображать шаги, false — не отображать
custom_cssfalseПодключить css файл. Может принимать значения в виде строки с путем до css файла, например — 'https://my.ispsystem.com/manimg/orion/default/custom.css'

Пример

Пример интеграции
<!DOCTYPE html>
<html>
  <head>
    <title>My Store</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
  </head>
  <body>
    <ul>
      <li id="basket"></li>
      <li id="usermenu"></li>
    </ul>
    <h1>Welcome to my store!</h1>
    <div>
      <script src="https://my.ispsystem.com/manimg/orion/billmgrStore.init.js"></script>
      <script type="text/javascript">
        billmgrStore.init({
          host: 'https://my.ispsystem.com',
          startform: 'func=showroom.redirect&redirect_to=service.order.itemtype',
          basket: { blockId: 'basket' },
          usermenu: { blockId:  'usermenu' },
          title: true,
          wizard_step: true,
          custom_css: 'https://my.ispsystem.com/manimg/orion/default/custom.css'
        });
      </script>
      <noscript>Вам нужно включить JavaScript!</noscript>
    </div>
  </body>
</html>