Изменение CallerID разных пользователей в настройках модуля UCP FreePBX

В рамках данной статьи рассмотрим общие принципы доработки, позволяющей изменять свой CallerID (отображаемое имя при звонке) в модуле UCP FreePBX. Также рассмотрим создание режима администратора, позволяющего изменять не только свой CallerID, но также CallerID других пользователей.

Кому может быть полезно

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

Использование функционала

В данном разделе рассмотрим основные возможности доработки, а также изменения в веб-интерфейсе.

Для того, чтобы воспользоваться доработанным функционалом необходимо авторизоваться в UCP и открыть панель пользовательских настроек (User Settings). Переход на данную панель находится в левом нижнем углу экрана, а иконка её выглядит следующим образом:

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

Необходимо перейти на вкладку User Details.

Далее рассмотрим два различных функционала: пользователя (доступно изменение только своего имени) и администратора (доступно изменение имён всех внутренних номеров АТС).

Функционал пользователя

Для изменения собственного имени необходимо отредактировать поле Display Name. Чтобы изменения применились в системе необходимо нажать на клавишу ‘Enter’.

Функционал администратора

Кроме изменения собственного имени, администратору системы доступно также изменение имени любого другого внутреннего номера системы. При этом вкладка User Details для администратора имеет вид:

Как видим, добавилось новое поле Extension, в котором есть возможность выбора внутреннего номера, имя которого собираемся изменить.

Способ изменения имени такой же, как и у пользователей: в поле Display Name вводим новое имя и подтверждаем изменение нажатием клавиши ‘Enter’.

Назначение роли администратора

Для того, чтобы назначить пользователю роль администратора необходимо в FreePBX перейти по следующему пути: Admin -> User Management. В появившемся списке выбираем пользователя, которому собираемся выдать соответствующие права и открываем его для редактирования настроек.

В появившемся окне переходим на вкладку UCP:

В отрывшейся вкладке находим настройку Administrator и выставляем её в Yes.

Чтобы подтвердить выбор необходимо нажать кнопку Submit на этой же странице.

Рассмотрим доработку на примере изменения пользователем своего имени.

Описание доработки

Первым делом необходимо добавить обработчик, реагирующий на изменение поля displayname в настройках UCP. Для этого открываем файл /var/www/html/admin/modules/ucp/htdocs/modules/Settings/assets/js/global.js, находим в нём функцию displaySimpleWidgetSettings и в неё вставляем следующий код:

$("#displayname").change(function() {
	$.post("ajax.php?module=Settings&command=settings", {
    	key: "extrename",
    	displayname: $("#displayname").val()
	}
});

В результате выполнения данного кода отправится AJAX-запрос на ajax.php?module=Settings&command=settings с ключом extrename.

Теперь необходимо написать обработчик этого AJAX-запроса. Делается это в файле /var/www/html/admin/modules/ucp/htdocs/modules/Settings/Settings.class.php. Находим функцию ajaxHandler. В ней находим switch($_POST['key']). Здесь опишем обработчик extrename:

case 'extrename':
	$displayname = htmlentities(strip_tags($_REQUEST['displayname']));
	$ext_num = $user['default_extension'];
	$this->UCP->FreePBX->Core->updateUsername($ext_num, $displayname);
	$this->UCP->FreePBX->Userman->updateUserExtraData ($user['id'], array('displayname' => $displayname));
 
	$ret = array(
    	"status" => true
	);
break;

Также в этом же switch переписываем обработчик case 'displayname' на следующий:

case 'displayname':
	$ret = array(
	    "status" => true
	);
break;

Теперь осталось только реализовать функцию updateUsername в модуле Core, которая будет обновлять имя пользователя. Для этого открываем файл /var/www/html/admin/modules/core/Core.class.php. В него добавляем следующий код:

/**
 * Update username by extension number
 * @param {int} $ext The user extension
 * @param {String} $new_name The new name of extension
 */
public function updateUsername($ext, $new_name)
{
	global $astman;
 
	$sql = "UPDATE users SET name = ? WHERE extension = ?";
	$sth = $this->database->prepare($sql);
	$sth->execute(array($new_name,$ext));
 
	if($astman->connected())
	    $astman->database_put("AMPUSER",$ext."/cidname",$new_name);
	else
	    error_log("Astman not Connected!");
}

Теперь каждый пользователь, у которого есть доступ к UCP может изменить свой CallerID.

На это статья-обзор по изменению CallerID разных пользователей в настройках модуля UCP FreePBX завершена.