Денис Пестрецов
18.10.2019
9712

Добавление управляющих кнопок в FreePBX

В предыдущей статье мы рассматривали создание своего модуля в FreePBX 13, а также научились создавать свои вкладки в меню. В данной статье рассмотрим возможность добавления новых управляющих кнопок, наряду с уже существующими, такими как Submit, Reset, Duplicate, Delete. Также рассмотрим создание обработчиков для этих кнопок. Управляющие кнопки Перед тем, как описывать добавление различных управляющих кнопок, […]

Управляющие кнопки в FreePBX

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

В данной статье рассмотрим возможность добавления новых управляющих кнопок, наряду с уже существующими, такими как Submit, Reset, Duplicate, Delete. Также рассмотрим создание обработчиков для этих кнопок.

Сразу отмечу, что данная доработка рассматривается на примере FreePBX 13 версии. В других версиях возможны изменения способа добавления.

Управляющие кнопки

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

В качестве примера, добавлять и рассматривать кнопки будем в модуле Announcements.
Стандартные управляющие кнопки
Стандартные управляющие кнопки

В данном случае, управляющих кнопок на странице – 3: Submit, Reset, Delete (рис. 1).

Отображение управляющих кнопок обычно описано в файле класса модуля, в каталоге admin/modules/имя_модуля/имя_модуля.class.php. Модуль Announcement не является исключением, и его управляющие кнопки описаны в файле admin/modules/ announcement/Announcement.class.php.

Для большинства модулей, описание производится в стандартной функции getActionBar($request), и выглядит следующим образом:

case 'announcement':
$buttons = array(
		'delete' => array(
			'name' => 'delete',
			'id' => 'delete',
			'value' => _('Delete')
		),
		'reset' => array(
			'name' => 'reset',
			'id' => 'reset',
			'value' => _('Reset'),
		),
		'submit' => array(
			'name' => 'submit',
			'id' => 'submit',
			'value' => _('Submit')
		),
	);

Если необходимо скрыть какую-либо кнопку для отображения, то в её описание необходимо добавить ‘class’ => ‘hidden’. К примеру, если хотим скрыть кнопку Reset в модуле Announcement, то код данной кнопки будет следующим:

'reset' => array(
'name' => 'reset',
	'id' => 'reset',
	'value' => _('Reset'),
	'class' => 'hidden',
),

Перезагрузив страницу, получим:

Скрытие управляющей кнопки
Скрытие управляющей кнопки

Создание кнопки

Для отображения новой управляющей кнопки необходимо добавить её к массиву buttons, расположенному в функции getActionBar (описана выше). В качестве примера, добавим тестовую кнопку с именем TBut. Для этого добавим следующий код:

'TBut' => array(
	'name' => 'TBut',
	'id' => 'TBut',
	'value' => _('TBut')
)

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

Результат добавления кнопки
Результат добавления кнопки

Итак, кнопка добавлена, но пока что не выполняет никаких функций. Добавим обработчик для этой кнопки.

Отметим, что обработчик можно создать двумя способами. При этом в первом случае он будет рассчитан на то, что данная кнопка будет использована только в отдельно взятом модуле. Второй же случай предполагает использование описанной кнопки во многих модулях (к примеру, как кнопки Duplicate или Reset).

Локально используемая кнопка

В данном случае предполагается, что кнопка будет использоваться локально только в одном модуле (первый случай). Для создания обработчика такой кнопки открываем файл admin/modules/имя_модуля/assets/js/имя_модуля.js. Такой путь будет у большинства модулей FreePBX 13 версии. В нашем примере путь будет следующим: admin/modules/announcement/assets/js/ announcement.js.

В качестве обработчика добавим следующий код:

$("#TBut").click(function(e){
alert('Нажата кнопка TBut');
});

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

Также можно локально изменять обработчик стандартных кнопок (таких как Submit, Reset и т.п.).

Для того чтобы отменить стандартную обработку управляющей кнопки, необходимо воспользоваться следующими командами:
e.preventDefault();
e.stopPropagation();

К примеру, если нам необходимо переписать обработчик кнопки Submit модуля Announcement, то в файл admin/modules/announcement/assets/js/ announcement.js добавляем следующий код:

$("#submit").click(function(e){
	e.preventDefault();
	e.stopPropagation();
	// Здесь пишем свой обработчик кнопки Submit
});

Глобально используемая кнопка

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

Стандартный обработчик всех управляющих кнопок описывается в файле admin/assets/js/pbxlib.js.

Сразу предупрежу, что в данном файле, как и во многих библиотеках, практически отсутствует табуляция. Поэтому для нахождения нужного места советую воспользоваться поиском. Интересующий нас код начинается с switch(buttonName). В данной конструкции можно как создать обработчик для своей созданной кнопки, так и изменить, для уже существующей.

Для создания обработчика кнопки TBut добавим следующий код:

case "TBut":
alert('Нажата кнопка TBut');
break;

Русификация

Также можно изменить язык отображения подписи кнопки. Для этого необходимо внести данную подпись в файл admin/modules/имя_модуля/i18n/ru_RU/LC_MESSAGES/имя_модуля.po. В моём случае это будет файл: admin/modules/announcement/i18n/ru_RU/LC_MESSAGES/ announcement.po.

Подробнее о процессе русификации модулей можно прочесть в статье: Работа с русификацией FreePBX. Исправление отображения Queues (https://voxlink.ru/kb/freepbx/freepbx-ispravlenie-otobrazheniya-queues/).

Возможно, Вам также будут интересны следующие статьи:

Подписаться
Уведомление о
guest
0 Комментарий
Inline Feedbacks
View all comments

Остались вопросы?

Я - Виталий Шелест, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование

ближайшие курсы

ближайшие Вебинары

ONLINE

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

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

Надежен в эксплуатации.

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

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

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

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.