Изменение значения по умолчанию Custom Context при создании нового экстеншена в FreePBX

В данной статье рассмотрим, как изменить дефолтное значение поля Custom Context, чтобы автоматически при создании нового внутреннего номера туда подставлялось не ALLOW ALL (Default), а выбранное нами.

Постановка задачи.

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

Рассмотрим постановку задачи на примере создания нового внутреннего номера технологии CHAN_SIP. Создание производим на вкладке Applications -> Extensions -> Add Extension -> Add New Chan_SIP Extension. Подробнее о работе с внутренними номерами можно прочесть в статье: https://voxlink.ru/kb/freepbx/freepbx-extensions/

На вкладке Other можно найти поле Custom Context. Значение по умолчанию для данного поля – ALLOW ALL (Default).

Теперь рассмотрим ситуацию, когда в компании по умолчанию используется контекст не Default, а какой-либо другой. Соответственно, при каждом создании нового внутреннего номера придётся переключаться на вкладку Other и вручную менять контекст, что несколько неудобно.

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

Правки кода

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

Изменение в web-интерфейсе

Первым делом рассмотрим, как изменить значение, которое отображается в web-интерфейсе при заведении нового номера. Для этого открываем для редактирования файл …/admin/modules/customcontexts/views/extensions_hook.php.

Первые две строки в данном файле оставляем неизменными:

global $currentcomponent;
$device_info = core_devices_get($_REQUEST['extdisplay']);

Перед третьей строкой-условием получаем значение tech_hardware:

$tech_hard = isset($_REQUEST['tech_hardware']) ? $_REQUEST['tech_hardware'] : '';

Данный параметр передаётся каждый раз, когда мы создаём новый внутренний номер, при этом выбирая технологию (SIP, IAX2, Custom и т.д.).

Далее следует условие, которое было третьей строкой:

if (empty($device_info)) {

Далее вставляем свою часть кода:

if ($tech_hard != '')
{
	switch ($tech_hard) {
		case 'sip_generic':
			$cc = 'local';
		break;
		case 'iax2_generic':
		case 'custom_custom':
		case 'dahdi_generic':
		case 'virtual':
			$cc = 'from-internal';
		break;
		default:
			$cc = 'from-internal';
	}
}

В данном примере, при генерации Chan_SIP внутреннего номера  умолчанию будет выбираться в поле Custom Context значение local. При создании всех остальных внутренних номеров, значение в поле Custom Context так и останется from-internal (то есть ALLOW ALL).

Для того чтобы изменить значение по умолчанию для какой-то из технологий, необходимо прописать интересующее значение в одном из case, описанных выше: iax2_generic – для IAX, custom_custom – для custom и т.д.

if (empty($device_info)):
else
{
    $cc = 'from-internal';
}

Весь остальной код оставляем «как есть».

Теперь выполним небольшую проверку того, что наш код работает верно. Для этого пробуем создать новый внутренний Chan_SIP номер и переходим на кладку Other. Значение в поле Custom Context должно стать тем, которое прописали в скрипте (в моём случае — local).

При этом если попытаться создать номер любой другой технологии, то значение поля Custom Context должно остаться прежним.

Теперь перейдём к реализации функциональной части подстановки значения. Для этого открываем каталог …/admin/modules/core/functions.inc/drivers. В данном каталоге видим несколько файлов, каждый из которых отвечает за свою технологию. Для изменения в технологии Chan_SIP будем редактировать файл Sip.class.php. Находим в данном файле функцию getDeviceDisplay, а в ней инициализацию $tmparr[‘context’]. По умолчанию строка выглядит следующим образом:

$tmparr['context'] = array('prompttext' => _('Context'), 'value' => 'from-internal', 'tt' => $tt, 'level' => 1);

Изменяем в ней значение value на необходимо, получим:

$tmparr['context'] = array('prompttext' => _('Context'), 'value' => 'local', 'tt' => $tt, 'level' => 1);

Сохраняем и можем проверять. Теперь, если создать внутренний номер Chan_SIP, то не нужно открывать вкладку Other для редактирования – она будет автоматически заполнена новым значением по умолчанию.

Для проверки корректности работы функционала можно создать любой внутренний номер изменённой технологии, ничего не изменяя и не перевыбирая в поле Custom Context. После чего отрыть его в режиме редактирования и обратить внимание на вкладку Custom Context. Если всё выполнено верно, то значение, указанное в данном поле, будет тем самым выбранным значением по умолчанию (в данном  примере там автоматически должно подставиться local).

Остальные технологии

В данном разделе кратко рассмотрим, что нужно менять в других файлах директории …/admin/modules/core/functions.inc/drivers для получения желаемого результата.

Dahdi

Также в функции getDeviceDisplay находим $tmparr[‘context’] и заменяем значение value на нужное.

IAX2

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

Как видим, нет ничего сложного в том, чтобы изменить дефолтное значение поля Custom Context. На этом статья по изменению значения по умолчанию Custom Context при создании нового экстеншена в FreePBX завершена.