Общее представление страниц
Страницы любого типа представляют собой блоки 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).