Витрина

Материал из ISPWiki
Перейти к: навигация, поиск

Введение

Витрина - это механизм отображения услуг из BILLmanager на сайте провайдера. Начиная с версии 5.47 BILLmanager предоставляет расширенный механизм настройки витрины.

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

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

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

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

Настройка витрины осуществляется а разделе Глобальные настройки во вкладке Настройка витрины.

Доступные настройки:

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

Витрина

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

Vitrina2.png

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

Vitrina3.png

Сайт витрины

Если выбрана настройка Сайт витрины, то по адресу BILLmanager будет открыт автоматически генерируемый сайт.

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

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

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

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

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

/usr/local/mgr5/sbin/mgrctl -m billmgr showroom

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

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

Vitrina-site.png

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

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

<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 - Хост биллинга. Может принимать значение в виде строки с хостом, например 'https://my.ispsystem.com'

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

Важно!

Так же необходимо настройка allow_origin для ihttpd, для работы витрины на домене отличном, от домена биллинга. Для этого в файл конфигурации ihttpd необходимо добавить

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

Например:

listen {
	ip 172.32.12.23
	allow_origin http://showroom.com
	redirect
}

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

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

Свойство Значение по-умолчанию Описание
basket false Отображать корзину с заказами. Может принимать значения {blockId: BLOCK_TAGRET_ID}, где BLOCK_TAGRET_ID - имя id html элемента, в котором отображать корзину; false - не отображать корзину.
usermenu false Отображать меню пользователя. Может принимать значения {blockId: BLOCK_TAGRET_ID}, где BLOCK_TAGRET_ID - имя id html элемента, в котором отображать меню; false - не отображать меню.
title false Отображать заголовок формы. Может принимать значения true - отображать заголовок, false - не отображать
wizard_step false Отображать шаги заказа. Может принимать значения true - отображать шаги, false - не отображать
custom_css false Подключить 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>

Смотрите также: Интеграция с сайтом.