artem
28.03.2018
5594

Доработка FreePBX. Создание новых вкладок меню

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

Все о доработке FreePBX

Пример постановки задачи

Необходимо создать отдельную ссылку в меню, для статистики CDR Viewer. Более подробно ознакомиться с данной утилитой (Asterisk CDR Viewer) можно из данной статьи. Рассмотрим три способа создания ссылки в меню.

Генерация нового модуля

Это первый способ создания ссылки в меню. Подробнее о том, как создавать новый модуль описывается в статье: Создание нового модуля в FreePBX (ссылка на пока не выложенную статью). Плюсы использования данного метода:
Наличие верхней панели меню FreePBX после перехода в модуль;
Доступность методов других классов FreePBX;
Наличие модуля во вкладке Admin -> Module Admin, возможность его установки и удаления;
Возможность ограничения доступа к модулю, с помощью вкладки Admin -> Administrators;
Также, при использовании модуля, можно убрать его из списков меню. Делается это путём редактирования файла /etc/asterisk/freepbx_menu.conf.
К примеру, если нам нужно убрать из списка отображение модуля CDR Reports, достаточно в файл freepbx_menu.conf дописать:

[cdr]
remove=Yes

Чтобы узнать имя модуля, необходимо открыть его во FreePBX. При этом в адресной строке браузера будет конструкция, вида: …?display=имя_модуля.

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

В нашем примере ссылка будет на файл index.php, расположенный в директории CDR Viewer.

Каталог с программой расположим в директории admin (путь по умолчанию: /var/www/html/admin).

Теперь рассмотрим создание новой ссылки в меню.

Ссылка в основной панели

Открываем для редактирования файл …/admin/views/menu.php

Здесь, как понятно из названия, генерируется основное меню FreePBX. Находим код:

Найти можно по ключевой фразе: navbar-c.

<div class=»collapse navbar-collapse» id=»fpbx-menu-collapse»>
<ul class=»nav navbar-nav navbar-left»>
<?php include_once(__DIR__ . ‘/menu_items.php’); ?>

В файле menu_items.php генерируется контент для основных пунктов меню, таких как Admin, Applications, Connectivity, Dashboard, Reports, Settings, UCP.
Допишем, после последней строки следующий код:

<li><a href=»CDR Viewer/index.php» data-original-title title>CDR Viewer</a></li>

В поле href указываем путь к файлу, на который будет организована ссылка.

Так как разработка производится во FreePBX, то корневой директорией является admin.

Сохраняем, после обновления страницы должна появится новая ссылка с названием CDR Viewer.

Ссылка в основной панели

Ссылка в выпадающем меню

Открываем для редактирования файл …/admin/views/menu_items.php.

Находим следующие строки кода:

uksort($items,’_item_sort’);

$mods[$t] .= implode($items) . ‘</ul>’;
Перед ними вставляем следующий код:
if ($t == «Reports»)

{

$items[‘CDR Viewer’] = ‘<li><a href=»CDR Viewer/index.php» class= » «>CDR Viewer</a></li>’;

}
В данном коде будет произведена вставка пункта CDR Viewer в выпадающий список вкладки Reports. Для вставки в выпадающий список другой вкладки просто меняется значение “Reports” на другое.
Важно вставить код между символом } и uksort, чтобы не зацепить выполнение цикла foreach.

Теперь, если обновить страницу, получим следующий результат:

Ссылка в выпадающем меню
Подписаться
Уведомить о
guest
2 комментариев
Старые
Новые Популярные
Межтекстовые Отзывы
Посмотреть все комментарии
Dmitriy Q
Dmitriy Q
08.12.2020 12:34

А как например убрать лишние языки из языковой панели?

Eduard I. Titkov
Eduard I. Titkov
10.12.2020 17:06
Ответить на  Dmitriy Q

Можно выставить, да вообще отключить.
Show Language setting в FreePBX Advanced Settings

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

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

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


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

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 сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.