Sv: /* Настройка */

2019-02-19T18:54:00Z

Настройка

Нова сторінка

Модуль дает возможность давать доступ в интернет случайным клиентам, подсоединившимся к вашим wifi точкам. Авторизация осуществляется посредством посылки кода авторизации на телефон.

==Как это работает==

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

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

==Настройка==

* Создайте группу hotspot. В этой группе будут автоматически создаваться учетные записи клиентов hotspot. Поле «Персональный темплейт для личного кабинета клиентов этой группы» установите в значение «hotspot_cabinet» - этим вы сможете создать совершенно иной вид кабинета для hotspot-абонентов, не такой как для ваших обычных пользователей.
* Создайте услугу типа «Безлимитные тарифы» с названием «Hotspot demo» или «Hotspot первое подключение» - это будет тариф, который будет автоматически выдаваться всем новым пользователям, т.е. тем, телефоны которых еще ни разу не были зарегистрированы в биллинге. Если необходимо, чтобы несколько первых минут новый клиент мог пользоваться интернетом бесплатно - установите стоимость услуги в ноль, а срок действия, скажем, 10 минут. Параметр «автопродление» - нет. В параметре «группы, которые могут устанавливать услугу» не ставьте никаких галок.
* Создайте ip pool на несколько сотен ip:
** тип: статический
** теги: hotspot
* На wifi-роутере отключите nat и переведите в режим бриджа, чтобы ip выдавал не роутер, а сервер NoDeny.
* На сервере NoDeny настройте dhcp так, чтобы выдавал ip в пуле hotspot. В будущем ваш админ должен настроить dhcp-конфиг так, чтобы он видел, что запрос пришел от wifi-точки. Либо же игнорировать это, если обычный dchp не используется в вашей сети.
* В админке в настройках hotspot укажите id группы hotspot и id тарифа «Hotspot demo»

<br>

При первом запуске инсталляции (install.pl -x) автоматически в разделе «Документы» будет создана папка Hotspot, в которой будут html-шаблоны. Вы можете их менять как угодно - дизайн и файлы никак не связаны с NoDeny. Вы можете стилизировать под свой сайт или вообще создать уникальный дизайн чисто под hotspot.

Обратите внимание на такие моменты:

* все шаблоны и сама папка Hotspot должна иметь тег system.
* тег template указывает на имя шаблона для модуля hotspot. Имя документа в дереве с папками и файлами не имеет значения - вы его можете именовать как угодно, а вот имя в теге template должно быть:
** hotspot_base - базовая структура документа. По сути в этом файле весь дизайн и основные элементы.
** hotspot_login - базовая структура окна логина.
** hotspot - окно ввода номера телефона.
** hotspot_sms - окно ввода кода из смс, пришедшей на телефон.
** hotspot_error - окно отображения ошибки.
** hotspot_cabinet - базовая структура окна, когда клиент уже авторизован.

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

В разделе «Настройки» → «Кабинет клиента» в поле «Список плагинов» добавьте следующее:

<pre>
grp:14
fondy
srv_select
srv_add
</pre>

Где 14 - id группы hotspot. Данным фрагментом мы для абонентов группы hotspot разрешили пополнять счет через систему fondy, выбирать и подключать тариф интернет. [[Настройка меню кабинета абонента|Объяснение]] того, что мы сделали. Обратите внимание, что в начале «Списка плагинов» могут идти плагины, которые доступны для всех групп, например:

<pre>
плагин1
плагин2
....
grp:14
fondy
srv_select
srv_add
</pre>

Этот вариант нам не подходит т.к плагин1 и плагин2 будет доступен группе hotspot. Измените так (допустим в группе id=1 обычные абоненты):
<pre>
grp:1
плагин1
плагин2
....
grp:14
fondy
srv_select
srv_add
</pre>

Ранее мы создали услугу, которая подключается по умолчанию при первой авторизации. Ее выбрать клиент не сможет т.к не стоит галка доступности услуги группе hotspot. Создайте платную услугу с тегом hotspot.

==Краткая информация по шаблонам==

В шаблонах, инсталируемых по умолчанию, предусмотрено наследование, а если быть точнее - расширение. Это означает, что общие фрагменты вынесены в отдельные шаблоны и итоговый шаблон - это комбинация нескольких. Например, когда биллинг выводит окно ввода телефона, он запускает шаблон hotspot, данные из которого вставляются в шаблон hotspot_login, данные из которого вставляются в шаблон hotspot_base. Кроме того в шаблон hotspot_base подгружается шаблон hotspot_css, содержащий стили документа.

<pre>
hotspot → hotspot_login → hotspot_base
↑
hotspot_css
</pre>
Вы не обязаны сохранять текущую структуру, просто она удобна. Например, в hotspot_login можно выводить вводную информацию по самой услуге wifi и не показывать ее когда пользователь уже зарегистрировался и ему уже можно выводить информацию о том как пополнить интернет, например. В этом случае цепочка такая:
<pre>
hotspot_cabinet → hotspot_base
↑
hotspot_css
</pre>

Также, обратите внимание на то, что у некоторых шаблонов есть альтернативные имена, указанные в теге template1. Обычно они содержат тоже самое имя как и в теге template, но с префиксом «user/». Это связано с тем, что NoDeny может использовать разные пути к шаблонам в зависимости от того, авторизован ли клиент, авторизован как админ или юзер. Когда авторизовался не админ, а клиент, в путь к шаблонам добавляется «user/». Поэтому файл с css имеет теги:

<pre>
system
template=hotspot_css
template1=user/hotspot_css
</pre>

template=hotspot_css используется в момент логина (ввод телефона или кода из смс), template1=user/hotspot_css для просмотра баланса, оплаты и т.д. Вы можете сделать разные css для этих ситуаций, если хотите. Тогда template1, естественно, использовать не нужно.

==Тестирование==
* Тестовым компьютером подключитесь к вашему wifi
* Убедитесь, что выданный ip есть в биллинге в пуле ip и у него стоит тег hotspot
* Откройте в браузере, например, http://beer.com
* Данный запрос должен перехватиться модулем заглушки и должен произойти редирект на http://ваш_сайт/cgi-bin/cap.pl
* Должна отобразиться страница с предложением ввода номера телефона. Если нет - проверяйте шаблоны в разделе «Документы». Вы можете убрать тег system у папки Hotspot и запустить install.pl - будет создана еще одна папка Hotspot с корректной структурой.
* Введите некорректный номер телефона чтобы проверить дизайн окна с ошибкой
* Укажите корректный номер телефона
* Введите иной код, чем тот, который пришел в смс
* Должно предложить либо переслать на новый телефон либо попробовать ввести еще раз
* Попробуйте ввести несколько раз, после чего система должна предложить только вариант с новой отсылкой смс
* Ведите корректный код из смс

При этом:
* В группе hotspot должна быть создана учетка с логином, равным номеру телефона
* У нее должна быть подключена услуга hotspot

Hotspot - Історія редагувань

Sv: /* Настройка */