Небольшая PHP библиотека для Joomla 4, Joomla 5, Joomla 6 и Amo CRM. Нужна только разработчикам расширений Joomla. А так же как зависимость для расширений, которые её используют.
Версия 1.3.1 Совместимость проверена: Joomla 6.0.1 от 25.11.2025 документация GitHub
Видео по установке и настройке
на RuTube
на VK Видео
Состав пакета
В составе пакета:
- WT Amo CRM Library - Библиотека интеграции Joomla и AmoCRM
- Система - WT Amo CRM Library - плагин хранения настроек для подключения к AmoCRM
- Пользователь - WT AmoCRM user synс - Плагин для синхронизации данных контактов AmoCRM и пользователей Joomla
- Консоль - WT import AmoCRM contacts - Плагин для CLI Joomla (команды консоли сервера) для добавления команд в CLI Joomla
Подключение библиотеки в своё расширение для Joomlause Webtolk\Amocrm\Amocrm;
$amocrm = new Amocrm();
$accountData = $amocrm->account()->getAccountInfo();
// Joomla uses a Symfony vardumper
dump($accountData);
Список сущностей AmoCRM для работы из Joomla
PHP-классы поддерживаемых сущностей находятся в папке src/Entities.
- \Webtolk\Amocrm\Entities\Account $amocrm->account() - получение информации об аккаунте
- \Webtolk\Amocrm\Entities\Contacts $amocrm->contacts() - работа с сущностью контактов AmoCRM
- \Webtolk\Amocrm\Entities\Customfields $amocrm->customfields() - работа с кастомными полями сущностей AmoCRM
- \Webtolk\Amocrm\Entities\Leads $amocrm->leads() - работа с сущностью сделок AmoCRM
- \Webtolk\Amocrm\Entities\Notes $amocrm->notes() - работа с примечаниями к сущностям AmoCRM
- \Webtolk\Amocrm\Entities\Tags $amocrm->tags() - работа с сущностью тегов AmoCRM
- \Webtolk\Amocrm\Entities\Users $amocrm->users() - работа с сущностью пользователей AmoCRM
- \Webtolk\Amocrm\Entities\Webhooks $amocrm->webhooks() - работа с вебхуками AmoCRM
Синхронизация пользователей Joomla и AmoCRM. Двухсторонняя интеграция.Плагин Пользователь - WT AmoCRM user synс в поставке библиотеки позволяет как создавать новые контакты в AmoCRM при создании / регистрации пользователей в Joomla, так и создавать пользователей Joomla при создании контактов AmoCRM. Возможно обновлять информацию в одной системе при изменении данных в другой. Настройки сопоставления полей Joomla и AmoCRM. Данные также можно хранить в свойстве params объекта пользователя ($user->params). Сопоставление полей настраивается в параметрах плагина.
CLI плагин импорта пользователей Joomla из контактов AmoCRM.В AmoCRM есть экспорт данных в CSV. Однако, возможно из-за большого количества разного рода интеграций, данные не всегда корректно экспортируются. Дабы избежать проблем с нарушением структуры данных было принято решение сделать более медленный импорт данных напрямую по REST API. Команды для выполнения в консоли сервера можно увидеть в параметрах плагина группы console.
Обработка входящих вебхуков AmoCRM в Joomla.В системном плагине добавлена единая точка входа для вебхуков со стороны AmoCRM. В дальнейшем информация из вебхука передаётся плагинам групп system, user и amocrm, срабатывающим на событие onAmocrmIncomingWebhook. Вы можете создать собственный плагин, который будет слушать это событие и обрабатывать данные или выполнять некие действия на стороне Joomla при событиях в AmoCRM.
Коллекция полей Joomla Form с данными из AmoCRM для разработчиков.Для использования в расширениях Joomla создана коллекция полей Joomla Form. Эти поля используются в плагинах самой библиотеки, однако разработчики могут использовать готовые поля и в сторонних расширениях. Классы полей находятся в папке src/Fields библиотеки. Для корректной работы поля необходимо в XML-манифесте вашего расширения (плагин, модуль, компонент) указать атрибут addfieldprefix с неймспейсом библиотеки.
Скриншоты#Changeloghttps://web-tolk.ru/dev/biblioteki/wt-amo-crm-library.htmlhttps://github.com/sergeytolkachyov/WT-Amo-CRM-library-for-Joomla-4P.S.К слову сказать, разработчики Amo CRM предоставляют PHP SDK для интеграций. Но для работы в Joomla пришлось бы устанавливать дополнительные библиотеки-зависимости. В связи с чем было принято решение написать отдельную несложную библиотеку, использующую нативные для Joomla методы подключения.
P.P.S. Эту библиотеку использует для работы плагин
WT AmoCRM - RadicalForm.P.P.P.S. Разработка документации в процессе. К методам библиотеки в коде (PHPDoc) даны подробные комментарии и образцы структуры данных.
19.11.2025, 09:49:12