Версия WNAM 1.3 и выше

Параметр

Описание и значение

$(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)

Ссылки на страницы авторизации через социальные сети, включая ключи доступа и ссылки возвратного перенаправления

Типы страниц

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

Ниже приведены некоторые варианты форм:

СМС авторизация

<form id="smsPhase1" class="form-signin" data-toggle="validator" role="form" name="sms" action="/cp/sms" method="post">

     <input type="hidden" name="phone" value="$(phone)" id="hiddenPhone"/>

</form>

Вход через ваучер

<form id="voucherPhase" class="form-signin" data-toggle="validator" role="form" name="voucher" action="/cp/voucher" method="post">

    <input id="code" type="text" name="code" class="form-control" placeholder="${template_codeplaceholder_text}"

    size="$(voucher-length)" data-error="${template_codeerror_text}: $(voucher-format)" required>

</form>

<form id="redirectForm" class="form-signin" data-toggle="validator" role="form" name="redirect" action="/cp/login" method="post">

    <input type="hidden" name="dst" id=dstRef value="$(dst)"/>

</form>

Вы можете менять оформление страницы, но должны оставить формы с их параметрами, а также механизм переключения фаз в странице (если они есть) в неизменном виде.

Дистрибутивные шаблоны страниц находятся на вашем сервере WNAM по адресу /var/lib/tomcat8/webapps/ROOT/WEB-INF/cp/ в соответствующих подпапках.

Если вы изменили текст страницы в интерфейсе Конструктора страниц, и хотите вернуться к оригинальному виду страницы, существует возможность восстановить страницу в исходный вид прямо из конструктора.

Отображение логотипа WNAM

Штатные страницы всех типов внизу содержат блок текста, в котором присутствует логотип, название, popup-блок и ссылка на сайт системы управления беспроводным доступом WNAM. По условиям лицензионного соглашения пользователя WNAM вы не имеете права модифицировать и удалять этот блок, если только у вас не была приобретена соответствующая лицензия (брендирование). В случае нарушения данного запрета может последовать юридическое преследование лицензиата, вплоть до отзыва лицензии.

Возможности по вводу номера телефона абонента

Возможности по вводу номера телефона абонента

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

var mobileNumber = $('#mobile-number');
 mobileNumber.intlTelInput({
 autoFormat: !is_firefox_android,
 nationalMode: false,
 onlyCountries: ['ru', 'by', 'kz'],
 preferredCountries: ['ru'],
 utilsScript: '/lib/libphonenumber/build/utils.js'
 });

Вы можете:

• Указать перечень допустимых стран (флажков) в окне ввода номера, изменив набор колов стран в параметре onlyCountries

• Разрешить выбор любой страны (флага) убрав всю строку с параметром onlyCountries

• Установить флаг (страну) по умолчанию в параметре preferredCountries

Мультиязычный интерфейс абонентских страниц

Конструктор страниц в упрощенном режиме позволяет создавать страницы одновременно на нескольких языках. Возможность мультиязычности включается ползунком в разделе  "Интернационализация":

По умолчанию будут доступны языки: русский, английский, а также все языки, которые перечислены в параметре languages файла /etc/wam.properties, например:

#additional languages
languages=kz

Двузначные коды языков необходимо перечислять через запятую.

Включение режима интернационализации требует сохранения страницы. После этого вы должны:

• Последовательно выбрать текущее представления конструкотра (язык)

• В выбранном языке отредактировать значения надписей, если предложенные по умолчанию вам не нравятся

• Если надписи нет (она не переведена, так как в дистрибутиве WNAM отсутствует перевод на выбранный язык), вам предстоит самостоятельно сделать перевод.

Внимание! Переключение языка в режиме превью (в правом окне) НЕ работает, вы должны пользоваться переключением в разделе "текущее представление конструктора".

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

<!-- Language Switcher -->
 <div id="lang-switcher" class="text-right form-signin">
    <div style="${template_i18n_disabled}">
       <div class="btn-group dropdown">
          <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" style="height: inherit;">
             <span class="lang-sm lang-lbl" lang="${not empty lang and (lang eq 'en' or lang eq 'kz') ? lang : 'ru'}"></span>
             <span class="caret"></span>
          </button>
       <ul class="dropdown-menu" role="menu">
          <li style="${empty lang or lang eq 'ru' ? 'display:none' : ''}">
             <a href="javascript:void(0)" onclick="changeLang('ru');"><span class="lang-sm lang-lbl" lang="ru"></span></a>
          </li>
          <li style="${lang eq 'en' ? 'display:none' : ''}">
             <a href="javascript:void(0)" onclick="changeLang('en');"><span class="lang-sm lang-lbl" lang="en"></span></a>
          </li>
          <li style="${lang eq 'kz' ? 'display:none' : ''}">
             <a href="javascript:void(0)" onclick="changeLang('kz');"><span class="lang-sm lang-lbl" lang="kz"></span></a>
          </li>
       </ul>
    </div>
   </div>
 </div>

Переключатель представляет собой dropdown (выпадающий список) и имеет средства кастомизации, в частности можно определить как будут выводится доступные языки.
Возможные варианты:

class="lang-sm lang-lbl"
Выводит флаг + название

class="lang-sm"
Выводит только флаг

class="lang-lbl"
Выводит только название

Подробнее о кастомизации в документации разработчика компоненты bootstrap-languages: http://usrz.github.io/bootstrap-languages/

Соответствующие классы задаются как для кнопки (то, что видно после селекта) так и для выпадающего списка отдельно, т.е. можно отдельно кастомизировать и кнопку и список.

Страницы, используемые в расширенном механизме работы с рекламой

Механизм работы с рекламой использует те же самые страницы, которые используются и в работе авторизации/перенаправления, однако в них должны быть добавлены (штатные страницы указанные блоки содержат):

• учет показов, переходов (абонент заинтересовался рекламой), переходов (абонент НЕ заинтересовался рекламой) 

• параметры страницы - идентификаторы рекламной кампании

 В дополнение к динамически заменяемым в страницах параметрам, перечисленным выше, используются дополнительные, рекламные:

Для учета показов/переходов применяется конструкция вида:

<button type="submit" class="btn btn-primary" name="loginb" onclick="doSubmit('$(dst)', 1);">

...

function doSubmit(url, advtype) { // параметры: URL - ссылка для перехода; advtype=1 - заинтересован, advtype=2 - не заинтересован 
 if (url.substring(0, 2) != "$(") {
    $("#dstRef").val(url);
 }
 getAdv(advtype);
 document.redirect.submit();
 return false;
}

function getAdv(advtype) {
 var c = "$(companyId)";
 if (c.substring(0, 2) != "$(") {
    var url = "/cp/display?companyId=$(companyId)&blockId=$(blockId)&advtype=" + advtype;
    $.get(url);
    }
 }
 getAdv(0); // безусловный вызов при загрузке страницы - учет показа