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

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

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

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

В данном случае, управляющих кнопок на странице – 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/).

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

• Дебаг FreePBX 13;
• Использование PHP Console во FreePBX 13.