Page History

Типы страниц

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

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

<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>

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

<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>

3. Страница приветствия (перенаправление), получение доступа в сеть

<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 1.3 и 1.4 находятся на сервере WNAM по адресу /var//lib/tomcat8/webapps/ROOT/WEB-INF/cp в соответствующих каталогах. В версиях системы WNAM 1.5 и выше файлы не извлекаемы, но их можно получить, отправив запрос в техническую поддержку (support@netams.com). Если текст страницы в интерфейсе "Конструктор страниц" был изменен и необходимо вернуться к оригинальному виду страницы, то существует возможность восстановить страницу в исходный вид прямо из конструктора страниц.

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

Штатные страницы всех типов

содержат блок текста, в котором присутствует логотип, название, popup-блок и ссылка на сайт системы управления беспроводным доступом WNAM. По условиям лицензионного соглашения пользователя 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

Основной интерфейс использует следующие шаблоны страниц:

• .

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

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

Image Added

По умолчанию доступны языки: русский, английский, а также все языки, которые перечислены в параметре 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/. Соответствующие классы задаются как для кнопки (то, что отображается абоненту после выбора), так и для выпадающего списка отдельно, т.е. можно отдельно произвести настройку и кнопки и списка

Страницы типа 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/

Разработаны следующие образцы:

Обратите внимание, что вместе с вышеуказанными шаблонами поставляются изображения, которые также необходимо загружать в перечень страниц при создании рекламных блоков.

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

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

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

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

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

Настройка учета количества показов/переходов также производиться в "Конструкторе страниц" в  режиме экспертного редактирования. Для организации учета количества показов/переходов применяется конструкция следующего Для этого применяется конструкция вида:

<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); // безусловный вызов при загрузке страницы - учет показа