Страницы любого типа представляют собой блоки HTML-кода, хранящиеся в базе данных mongodb системы WNAM, а не в виде файлов на файловой системе. Текст страниц можно отредактировать в произвольном редакторе и загрузить в систему, а также непосредственно из инструмента работы со страницами (в режиме редактирование HTML). Там же можно загружать дополнительные файлы (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);Страницы, подготовленные для механизма рекламных кампаний, могут работать и в качестве обычных страниц авторизации и перенаправления (в таком случае учет показов и переходов не срабатывает).