Общее представление страниц

Страницы любого типа представляют собой блоки HTML-кода, хранящиеся в БД MongoDB системы WNAM (не в виде файлов на файловой системе). Текст страниц можно отредактировать в произвольном редакторе и загрузить в систему WNAM, а также можно использовать функцию редактирования страниц непосредственно из инструмента работы со страницами системы WNAM (в режиме редактирования HTML). В конструкторе страниц также можно загружать дополнительные файлы (CSS, JS, изображения).

Все типы страниц перед отправкой абоненту проходят динамическую обработку, которая заключается в замене заданных конструкций в теле страницы текущими значениями. К таким конструкциям относятся параметры:

ПараметрОписание и значение
$(phone)Номер телефона абонента (если номер не известен (на первом этапе СМС-авторизации), то остается пустая строка)
$(mac)МАС-адрес устройства абонента
$(dst)Ссылка, на которую требуется перенаправить абонента
$(dst-orig)Оригинальная ссылка, к которой обратился абонент
$(form)Имя шаблона страницы (формы)
$(error)Сообщение об ошибке (если имеется)
$(size)Длина ожидаемого СМС-кода (4, 5 или 6)
$(size-format)Формат ожидаемого СМС-кода (1234, 12345 или 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