Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

  • интерфейс администратора (включая

...

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

...

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

...

  • агента (привязан к назначенным ему площадкам оказания услуги);

  • интерфейс абонента

...

  • беспроводной сети Wi-Fi.

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

...

  • обработку веб-сессии, поступившей с портала (

...

  • хот-спота) сервера доступа или беспроводного контроллера;
  • отображение страницы СМС-идентификации (по звонку, через

...

  • портал "Госуслуг", через ваучер, через Яндекс ID и т.п.);

...

  • отображение страницы приветствия и согласия с условиями предоставления доступа (переход (перенаправление)

...

  • на авторизацию через социальную сеть,

...

  • опрос, платный доступ и т.п.);
  • отображение страницы с сообщением об ошибке в случае её возникновения.

...

Страницы, отображаемые абонентам, выдаются веб-сервером 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);

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

...

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


Warning
Формат страниц, отображаемых абонентам, зависит от версии системы WNAM. Модификация страниц/шаблонов страниц предусматривает уверенное знание следующих инструментов: HTML, JavaScript, CSS, JQuery, Bootstrap.