Разработка кастомного плагина Joomla
Представьте: ваш клиент просит добавить синхронизацию статей с CRM при публикации. Или нужно интегрировать внешний OAuth-провайдер для входа пользователей. Базовыми средствами Joomla такое не сделать — нужен кастомный плагин. Опыт показывает, что готовые расширения не покрывают специфические интеграции, а кастомный плагин решает задачу в 3 раза быстрее, чем адаптация готового компонента. Мы разрабатываем плагины под любые события: от обработки контента до аутентификации. За 7 лет реализовали 30+ плагинов для Joomla 3, 4 и 5, используя современные API и Joomla! Documentation: Plugin Development.
Какие проблемы решаем
Стандартные расширения Joomla ограничены. Например, при сохранении статьи нельзя автоматически отправить данные во внешнюю систему. Или при входе пользователя — проверить его через корпоративный LDAP. Плагины перехватывают события жизненного цикла CMS и выполняют свою логику без правки ядра.
Мы сталкивались с типичными сложностями:
- N+1 запросы при синхронизации большого объёма контента. Решение: агрегируем данные в один запрос, используем пакетную обработку.
- Конфликты с кэшированием Joomla. Плагин, вызывающий внешний API при каждом показе страницы, может замедлить сайт. Решение: кэшируем ответы в Redis или выносим тяжёлые операции в фоновые задачи (Joomla Task Scheduler).
- Ошибки при обновлении Joomla. Устаревшие API вызывают 500-е ошибки. Решение: поддерживаем только Joomla 4 и 5, используем современные события и DI.
Как мы это делаем?
Стек: PHP 8.1+, MySQL 8, Redis (опционально). Для аутентификации — OpenID Connect, OAuth 2.0. Для интеграций — REST, SOAP, GraphQL.
Подход: применяем SubscriberInterface и DI-контейнер Joomla. Код покрываем модульными тестами (PHPUnit). Результат — стабильный плагин, готовый к продакшену.
Схема работы
Проектирование архитектуры, написание кода, тестирование на Joomla 4 и 5, деплой. Подробнее в этапах ниже.Кейс: недавно реализовали плагин для сети аптек на Joomla 5. Он синхронизирует цены и остатки с 1С через REST API. Обработка 2000 товаров за 10 минут, 0 ошибок за месяц работы.
Структура плагина
Плагины Joomla реагируют на системные события. Перехватывают моменты жизненного цикла: до/после сохранения статьи, при аутентификации, при поиске, при отправке формы. Это самый правильный способ расширить поведение системы без модификации ядра.
Группы плагинов
| Группа | Событие | Применение |
|---|---|---|
| content | onContentBeforeSave, onContentAfterSave | Обработка контента |
| user | onUserLogin, onUserAfterSave | Аутентификация, синхронизация |
| system | onAfterRoute, onBeforeRender | Глобальные перехваты |
| authentication | onUserAuthenticate | Внешние провайдеры входа |
| finder | onFinderIndexItem | Поисковый индекс Smart Search |
| task | onExecuteTask | Планировщик задач (Joomla 4+) |
Структура плагина
plg_content_synccrm/
├── plg_content_synccrm.php # Точка входа (для legacy)
├── plg_content_synccrm.xml # Манифест
├── services/
│ └── provider.php # DI Provider
└── src/
└── Extension/
└── SyncCrmPlugin.php # Основной класс
Манифест
<?xml version="1.0" encoding="utf-8"?>
<extension version="4.0" type="plugin" group="content">
<name>plg_content_synccrm</name>
<author>Your Company</author>
<version>1.0.0</version>
<description>Синхронизация контента с CRM при публикации</description>
<namespace path="src">MyCompany\Plugin\Content\SyncCrm</namespace>
<files>
<filename plugin="plg_content_synccrm">plg_content_synccrm.php</filename>
<folder>services</folder>
<folder>src</folder>
</files>
<config>
<fields name="params">
<fieldset name="basic">
<field name="crm_api_url" type="text" label="URL CRM API" />
<field name="crm_api_key" type="password" label="API Key CRM" />
<field name="sync_types" type="checkboxes" label="Синхронизировать типы">
<option value="article">Статьи</option>
<option value="product">Товары</option>
</field>
</fieldset>
</fields>
</config>
</extension>
Как создать плагин Joomla под задачу?
Шаги разработки:
- Определяем группу событий (content, user, system или другую).
- Создаём манифест, DI-провайдер и основной класс с подпиской на события.
- Реализуем логику обработки события — отправка в CRM, проверка токенов, вызов внешнего API.
- Настраиваем параметры плагина через XML-форму (URL, ключи, флаги).
- Тестируем на Joomla 4 и 5, покрываем unit-тестами.
Пример кода основного класса:
// src/Extension/SyncCrmPlugin.php
namespace MyCompany\Plugin\Content\SyncCrm\Extension;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Event\Event;
use Joomla\Event\SubscriberInterface;
class SyncCrmPlugin extends CMSPlugin implements SubscriberInterface {
public static function getSubscribedEvents(): array {
return [
'onContentAfterSave' => 'syncToCrm',
];
}
public function syncToCrm(Event $event): void {
[$context, $article, $isNew] = array_values($event->getArguments());
if ($context !== 'com_content.article') return;
if ((int) $article->state !== 1) return;
$syncTypes = $this->params->get('sync_types', []);
if (!in_array('article', (array) $syncTypes)) return;
try {
$this->sendToCrm([
'type' => 'article',
'external_id'=> $article->id,
'title' => $article->title,
'url' => \Joomla\CMS\Router\Route::link('site', 'index.php?option=com_content&view=article&id=' . $article->id),
'published' => (bool) $article->state,
'updated_at' => $article->modified,
]);
} catch (\Exception $e) {
$this->getApplication()->getLogger()->error('CRM sync failed: ' . $e->getMessage());
}
}
private function sendToCrm(array $data): void {
$apiUrl = rtrim($this->params->get('crm_api_url'), '/') . '/articles';
$apiKey = $this->params->get('crm_api_key');
$http = \Joomla\CMS\Factory::getContainer()
->get(\Joomla\Http\HttpFactory::class)
->getHttp();
$response = $http->post($apiUrl, json_encode($data), [
'Content-Type' => 'application/json',
'Authorization' => 'Bearer ' . $apiKey,
]);
if ($response->code >= 400) {
throw new \RuntimeException('CRM API error: ' . $response->code);
}
}
}
Что входит в работу?
| Этап | Результат |
|---|---|
| Анализ | Описание события, требования к интеграции |
| Проектирование | Архитектура, конфигурация, обработка ошибок |
| Реализация | Код плагина, манифест, параметры настройки |
| Тестирование | Модульные тесты, интеграция с Joomla |
| Документация | Инструкция по установке, настройке и API |
| Поддержка | Гарантия 1 год, помощь при обновлении Joomla |
Дополнительно можем настроить CI/CD, добавить кэширование, реализовать фоновые задачи.
Сроки и стоимость
Разработка плагина для одной группы событий — от 2 до 5 дней. Примеры:
- Синхронизация с внешним API (авторизация, пакетная отправка) — 3 дня.
- Плагин аутентификации через SSO (OAuth, LDAP) — 5 дней.
- Простой обработчик контента (фильтрация, модификация) — 2 дня.
Точную оценку дадим после анализа вашей задачи. Стоимость рассчитывается индивидуально.
Типичные ошибки при разработке плагинов Joomla
- Использование устаревших классов (JFactory, JDatabase вместо DI).
- Неправильная обработка кэширования — плагин выполняется при каждом запросе, замедляя сайт.
- Отсутствие обработки исключений — критическая ошибка валит весь сайт.
- Жёсткая привязка к одной версии Joomla без учёта совместимости.
Мы учитываем эти риски на этапе проектирования.
Почему выбирают нас?
- 7+ лет опыта разработки под Joomla.
- 30+ реализованных плагинов для разных версий.
- Сертифицированные разработчики Joomla.
- Гарантия на код — 12 месяцев.
- Полное сопровождение: от идеи до продакшена.
Получите консультацию по вашему проекту. Оценим задачу и предложим оптимальное решение в кратчайшие сроки.