Versions Compared

Key

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

...

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

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

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

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

Страницы, отображаемые абонентам, выдаются веб-сервером tomcat, работающем на сервере WNAM (аналогично административному интерфейсу). Все страницы абонентов имеют корневую ссылку (путь) /cp/ или /adv/.
В обычном режиме работы страницы абонентов настраиваются из административного интерфейса WNAM в разделе Загружаемые страницы портала (версия WNAM 1.1-1.2) или из конструктора страниц (версии WNAM 1.3 и выше).
При необходимости, администратор на заданной площадке может включить режим работы с рекламой, в таком случае вместо обычных страниц авторизации и перенаправления (приветствия) будут отображаться рекламные блоки, соответствующие активным и совпавшим по параметрам рекламным кампаниям.
Страницы любого типа представляют собой блоки 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)Формат страниц, отображаемых абонентам, зависит от версии WNAM.