Создание нового модуля в FreePBX
В этой статье речь пойдёт о создании нового модуля в FreePBX, средствами freepbxgenerator.phar.
Создание модуля
Первым шагом при создании нового модуля станет скачивание специальной программы freepbxgenerator.phar. Используем для этого команду wget:
wget https://git.freepbx.org/projects/FL/repos/freepbx-module-generator/raw/dist/freepbxgenerator.phar?at=refs%2Fheads%2Fmaster -O freepbxgenerator.phar
Phar — это утилита для создания исполняемых архивов в PHP, аналог JAR в Java.
Phar входит в php по умолчанию, начиная с версии 5.3, так что никаких дополнительных инсталляций не требуется.
После того, как файл загрузился, необходимо выдать ему права на исполнение:
chmod +x freepbxgenerator.phar
После чего запускаем файл:
./ freepbxgenerator.phar
После небольшого интерактивного диалога, новый модуль будет создан. Рассмотрим элементы данного диалога.
Первый вопрос о том, к какому типу будет отнесён создаваемый модуль. Предлагается 3 варианта ответа:
[0] FreePBX — является полноценным модулем FreePBX;
[1] UCP 14+ — модуль для UCP FreePBX версии 14 и выше;
[2] Both — является примером UCP приложения. Может не нести никакой пользы.
После каждого вопроса в скобках указано значение по умолчанию.
Для применения значения по умолчанию достаточно просто нажать клавишу Enter.
Как видно из скриншота, значением по умолчанию является both, выбрал создание обычного модуля FreePBX (0).
Кратко рассмотрим следующие вопросы.
Вводим имя модуля (без пробелов) (в моём случае FreePBXnewModule). Далее указываем директорию, в которой будет храниться модуль. Здесь лучше всё оставить по умолчанию, поэтому нажимаем Enter, переходим к следующему вопросу. Версия модуля — можно также оставить по умолчанию. В описании можно указать, для чего предназначен модуль (будет отображено в описании, на вкладке Admin -> Module Admin). Далее выбираем тип лицензии для нашего модуля. Доступны GPLv2, GPLv3, AGPLv3 или MIT. Можно воспользоваться выбором по умолчанию, то есть AGPLv3. Заключительным этапом будет выбор места расположения нашего модуля, то есть той вкладки, в которой он будет потом находиться.
В заключительной части создания модуля будут представлены на проверку все введённые данные. Если всё верно, вводим «yes». После чего модуль добавится и FreePBX перезагрузится.
И мы видим, что модуль действительно добавился туда, куда нам хотелось, то есть во вкладку Applications.
Если его открыть, получим приветственную надпись о том, что модуль работает. Это, своего рода, «заглушка», вместо которой, впоследствии, будем вставлять свой исходный код.
Теперь перейдём во вкладку Admin -> Module Admin. Как можно заметить, новый модуль здесь также доступен со стандартными функциями выключения, отмены установки и удаления.
А так выглядит дерево созданных каталогов нашего модуля:
Можно видеть, что создался новый класс с именем нашего модуля. С него и следует начинать разработку. В нём уже располагаются стандартные методы любого модульного класса FreePBX, такие как install, uninstall, backup,restore, doConfigPageInit, getActionBar(для вывода кнопок управления (Submit,Reset,Delete)), showPage, методы ajax и getRightNav — правая выпадающая панель навигации.
При удалении модуля (в случае, если в Module Admin нажимаем Remove), модуль полностью удаляется с жёсткого диска.
На этом рассмотрение технологии создания нового модуля во FreePBX можно считать завершённым.
Остались вопросы?
Я - Кондрашин Игорь, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.
категории
- DECT
- Linux
- Вспомогательный софт при работе с Asterisk
- Интеграция с CRM и другими системами
- Интеграция с другими АТС
- Использование Elastix
- Использование FreePBX
- Книга
- Мониторинг и траблшутинг
- Настройка Asterisk
- Настройка IP-телефонов
- Настройка VoIP-оборудования
- Новости и Статьи
- Подключение операторов связи
- Разработка под Asterisk
- Установка Asterisk
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 сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.