You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

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

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

В составе WNAM поставляется множество страниц различных типов (авторизация, приветствие, опросы и т.п.), каждая из которых содержит:

  • Набор предустановленных полей шаблонизатора (если используется "упрощенный" режим)
  • Набор полей для динамической подстановки.

Поясним на примере.

Шаблон страницы СМС авторизации самого распространенного типа, "Отправка СМС абоненту (по умолчанию)", содержит HTML-конструкции вида:

<!-- Logo -->
<p align="center"><img src="${template_logo_img}" class="img-responsive"/></p>
<!-- Main Text -->
<h2 class="form-signin-heading">${template_maintext_text}</h2>
<!-- Main Comment -->
<p class="comment">${template_maincomment_text1}</p>
<!-- Hidden Inputs -->
<input type="hidden" name="phone" value="$(phone)" id="hiddenPhone"/>

В момент, когда страница из шаблона отображается абоненту, происходит следующее:

  1. Из базы данных берется сам шаблон, а также все настроенные значения для свойств ${template_logo_img}, ${template_maintext_text}, ${template_maincomment_text1} и т.п. Например, вы можете настроить ссылку на изображение-логотип, заголовок страницы, текст страницы в конструкторе упрощенного режима. Если какое-то из полей вами не настроено, будет взято значение по умолчанию. Все конструкции вида ${...} будут подвергнуты замене, в результате чего сформируется полноценный блок HTML-кода. Этот блок кода в данный момент будет одинаков для всех абонентов. Описание всех конструкций вида ${...} доступно в виде подсказок в упрощенном режиме конструктора.
  2. Дополнительно, в зависмости от текущей фазы процесса авторизации, и от текущих введенных параметров, будет произведена динамическая подстановка значений во все конструкции типа $(...), например вместо $(phone) будет подставлен телефонный номер, указанный конкретным абонентом.
  3. Полученная страница отправляется в браузер абонента.

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



Веб-интерфейс системы WNAM состоит из следующих разделов:

  • интерфейс администратора (включая общие роли наблюдателя и оператора)
  • интерфейс владельца площадки (вид привязан к назначенным площадкам оказания услуги)
  • интерфейс рекламодателя и рекламного агента
  • интерфейс абонента

Интерфейсы первых трех типов служат для управления системой - настройки праметров, получения отчетной и справочной информации

Интерфейс четвертого типа (абонентов) служит для взаимодействия с пользователем, подключившимся к сети Wi-Fi, и служит для:

  • перехвата веб-сессии, поступившей с портала (хотспота) сервера доступа или беспроводного контроллера
  • отображение страницы СМС идентификации (по звонку, через госуслуги, через ваучер)
  • отображения страницы приветствия и согласия с условиями (перенаправление), переход на авторизацию через социальную сеть, или на опрос
Страницы, отображаемые абонентам, выдаются веб-сервером tomcat, работающем на сервере WNAM (аналогично административному интерфейсу). Все страницы имеют корневую ссылку (путь) /cp/ или /adv/.
В обычном режиме работы страницы абонентов настраиваются из административного интерфейса WNAM в разделе Загружаемые страницы портала
При необходимости, администратор на заданной площадке может включить режим работы с рекламой, в таком случае вместо обычных страниц авторизации и перенаправления будут отображаться рекламные блоки, соответствующие активным и совпавшим по параметрам рекламным кампаниям.
Страницы любого типа представляют собой блоки HTML-кода, хранящиеся в базе данных mongodb системы WNAM, а не в виде файлов на файловой системе. Текст страниц можно отредактировать в произвольном редакторе и загрузить в систему, а также непосредственно из инструментов работы со страницами. Там же можно загружать дополнительные файлы (CSS, JS, изображения).
Все типы страниц перед отправкой абоненту проходят динамическую обработку, которая заключается в замене заданных конструкций в теле страницы текущими значениями. К таким конструкциям относятся параметры:

 

ПараметрОписание и значение
$(phone)Номер телефона абонента. Если пока не известен (на первом этапе СМС авторизации, то пустая строка)
$(mac)МАС-адрес устройства абонента
$(dst)Ссылка, на которую требуется перенаправить абонента
$(dst-orig)Оригинальная ссылка, к которой обратился абонент
$(form)Имя шаблона страницы (формы)
$(error)Сообщение об ошибке, если имеется
$(size)Длина ожидаемого СМС кода (4 или 6)
$(size-format)Формат ожидаемого СМС кода (1234 или 123456)
$(soc_esia)Ссылка на портал авторизации Госуслуг (ЕСИА)
$(voucher-format)Формат номера ваучера
$(voucher-length)Длина номера ваучера
$(minibrowser)Признак (true/false), что страница открыта в мини-браузере устройства
$(smscode)Код СМС авторизации (для шаблонов методов отправки кода абонентом)

$(soc_fb), $(soc_ok)

$(soc_vk), $(soc_in)

Ссылки на страницы авторизации через социальные сети, включая ключи доступа и ссылки возвратного перенаправления

 



Страницы основного интерфейса абонента

Основной интерфейс использует следующие шаблоны страниц:

Название страницыНазначение и пояснения
smsОсновная страница авторизации через СМС (отправка СМС абоненту)
sms_recvСтраница авторизации через СМС (ожидаем СМС от абонента). Вторая фаза обновляет страницу каждые 5 секунд, проверка дошла ли СМС.
call_recvАвторизация через запрос звонка от абонента
voucherАвторизация через ваучер
soc_net_redirПеренаправление на вход через социальную сеть
quizПеренаправление на опрос
quiz_finishСтраница, демонстрируемая после успешного прохождения опроса
overlimitСтраница, демонстрируемая при превышении какого-либо ограничения
bs_finalСтраница последней стадии входа в сеть через контроллер Bluesocket
redirectСтраница с перенаправлением (авторизация прошла успешно, войти в Интернет)
redirect_videoСтраница с показом видеоролика при входе в сеть (перенаправление)

Страницы типа sms. sms_recv, call_recv имеют две фазы:

  • ввод телефонного номера
  • ввод кода из СМС, запрос совершения звонка либо отправки СМС с последующей проверкой

Каждая из фаз имеет соответствующую секцию в HTML-коде страницы, выбор той, которую показывать или скрывать, определяется наличием подставленного номера телефона вместо конструкции $(phone).

Дистрибутивные шаблоны страниц доступны по ссылке http://www.netams.com/files/wnam/portalpages/, также находятся на вашем сервере WNAM по адресу /var/lib/tomcat8/webapps/ROOT/WEB-INF/cp/

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

Страницы, используемые в расширенном механизме работы с рекламой

Механизм работы с рекламой использует:

  • одну обязательную страницу advertisement_image.html, которая применяется при отображении рекламных блоков, состоящих исключительно из загруженного изображения. Если вы планируете использовать такую рекламу, вы должны загрузить шаблон такой страницы в общем административном разделе "загружаемые страницы портала". 
  • произвольные страницы, отображаемые вместо штатных страниц авторизации и перенаправления, в зависимости от настроек рекламных кампаний

Дистрибутивные страницы шаблонов, которые вы можете использовать в своей работе, вы можете загрузить здесь: http://www.netams.com/files/wnam/advpages/

Разработаны следующие образцы:

Название страницыНазначение и пояснения
advertisement_example.htmlСтраница с рекламой, функционально равная странице redirect
advertisement_example_sms.htmlСтраница СМС-авторизации, функционально равная странице sms
advertisement_example_sms_recv.htmlСтраница СМС-авторизации, функционально равная странице sms_recv
advertisement_example_video.htmlСтраница с видеороликом, функционально равная странице redirect
advertisement_image.htmlСтраница с рекламой, функционально равная странице redirect, и предусматривает демонстрацию изображения на весь экран устройства, возможно с возможностью отслеживания поворота

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

В дополнение к динамически заменяемым в страницах рекламы параметрам, перечисленным выше, используются:

ПараметрОписание и значение
$(banner)Ссылка на изображение, показываемое на весь экран в странице advertisement_image.html
$(companyId)Идентификатор рекламной кампании
$(blockId)Идентификатор рекламного блока
$(pageId)Идентификатор страницы (файла) рекламного блока

Единственным существенным отличием страниц рекламы от стандартных страниц портала является наличие конструкции, позволяющей учитывать показы и клики (переходы) по рекламе.

Для этого применяется конструкция вида:

<button type="submit" class="btn btn-primary" onclick="getAdv(true);">

...

function getAdv(clicked) {
var c = "$(companyId)";
if (c.substring(0,2) == "$(") return;
var c = "";
if (clicked == true) { c = "&clicked=yes"; }
var url = "/adv/advblockpages/display?companyId=$(companyId)"+c;
$.get(url);
}
getAdv(false);

Страницы, подготовленные для механизма рекламных кампаний, могут работать и в качестве обычных страниц авторизации и перенаправления (в таком случае учет показов и переходов не срабатывает).

В любом случае действие на стадии авторизации вызывает запрос ссылки /cp/sms по методу POST, а перенаправления (после опроса, рекламы и т.п.) инициирует вход в сеть через устройство доступа по ссылке /сp/login (также метод POST)

 

  • No labels