Обзор модуля Config Edit во FreePBX 13

В данной статье проведём обзор возможностей модуля Config Edit во FreePBX 13 версии. Также рассмотрим его установку. Также в конце статьи рассмотрим мини-патч, позволяющий данному модулю редактировать системные файлы.

Основная информация

Модуль Config Edit предназначен для удобного и быстрого редактирования кастомных конфигурационных файлов Asterisk прямо из web-интерфейса FreePBX. Располагается он на вкладке Admin -> Config Edit.

Установка модуля

Установка модуля производится на вкладке Admin -> Module Admin.

Config Edit относится к Extended-модулям. Соответственно, чтобы он появился в списке, необходимо выбрать Extended-репозиторий и нажать на кнопку Check Online.

В представленном списке, в разделе Admin находим модуль Config Edit. Нажимаем на него, чтобы открылось меню установки модуля. Выбираем «Download and Install», после чего в правом верхнем углу экрана запускаем установку, нажатием на кнопку «Process».

Появится предупреждающее окно о том, что модуль Config Edit (и возможно другие модули, которые были выбраны) сейчас будет установлен. Для продолжения нажимаем Confirm. Появится окно, отражающее ход установки. Если процесс завершится корректно, то увидим следующую надпись: «configedit installed successfully».

По нажатию кнопки «Return» произойдёт возврат на страницу Module Administration. После чего необходимо применить настройки модуля, нажатием Apply Config в правом верхнем углу экрана. Модуль Config Edit успешно установлен.

Подробности о том, как устанавливать и удалять модули можно найти в статье: Управление модулями FreePBX .

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

Использование модуля

Для начала использования модуля необходимо перейти на вкладку Admin -> Config Edit. Первое, что увидим, перейдя на страницу модуля — список кастомных и системных конфигурационных файлов в левой части страницы.

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

К сожалению, файлы, переписывающие конфигурацию FreePBX (override файлы) также относятся к системным, в этом приложении, поэтому не могут быть отредактированы.

Для того чтобы создать новый файл, необходимо нажать на соответствующую кнопку «Add New File» и ввести свободное имя файла. При этом файл может создаться только в списке Asterisk Custom Configuration Files.

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

Мини-патч модуля

При разборе Config Edit показалось, что функционал редактирования только кастомных файлов является недостаточным. Поэтому было решено немного пропатчить данный модуль, а именно: разрешить редактирование всех файлов (включая _additional и _override).

Для этого внесём небольшие изменения в исходный код модуля.

Открываем для редактирования файл /var/www/html/admin/modules/configedit/assets/js/configedit.js. Именно в этом файле производится запрет на редактирование других конфигурационных файлов.

В нём находим функцию function loadFile(id, file, path, type) , отвечающую за подгрузку файлов конфигураций. В данной функции находим раздел, отвечающий за проверку возможности редактирования файла: if(data.writable). Для достижения необходимого результата закомментируем данную строку if и весь раздел else (который находится чуть ниже по коду), оставив только часть, заключённую в if. То есть код if примет следующий вид:

//if(data.writable) {
$("#message").addClass("hidden").text("");
$("#save").prop("disabled", false);
$("#delete").prop("disabled", false);
cmeditor.setOption("readOnly",false);
/*} else {
 $("#message").removeClass("alert-success hidden").addClass("alert-danger").text(_("File is not writable"));
 $("#save").prop("disabled", true);
$("#delete").prop("disabled", true);
cmeditor.setOption("readOnly",true);
}*/

Тем самым закомментировали условие, которое делало возможность редактирования недоступным. Сохраняем файл и проверяем полученный результат. Для этого перезагружаем страницу модуля Config Edit и выбираем файл, к примеру, extensions_override_freepbx.conf (заметим, что ранее данный файл был недоступен для редактирования, так как относился к системным конфигам). Теперь можно отредактировать и сохранить его не выходя из FreePBX.

На этом установка, обзор и настройка модуля Config Edit завершены.