Розробка кастомного плагіна Joomla
Уявіть: ваш клієнт просить додати синхронізацію статей з CRM при публікації. Або потрібно інтегрувати зовнішній OAuth-провайдер для входу користувачів. Базовими засобами Joomla таке не зробити — потрібен кастомний плагін. Досвід показує, що готові розширення не покривають специфічні інтеграції, а кастомний плагін вирішує задачу в 3 рази швидше, ніж адаптація готового компонента. Ми розробляємо плагіни під будь-які події: від обробки контенту до автентифікації. Реалізували 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 |
| Підтримка | Гарантія 12 місяців, допомога при оновленні Joomla |
Додатково можемо налаштувати CI/CD, додати кешування, реалізувати фонові завдання.
Терміни та вартість
Розробка плагіна для однієї групи подій — від 2 до 5 днів. Приклади:
- Синхронізація із зовнішнім API (авторизація, пакетна відправка) — 3 дні.
- Плагін автентифікації через SSO (OAuth, LDAP) — 5 днів.
- Простий обробник контенту (фільтрація, модифікація) — 2 дні.
Точну оцінку дамо після аналізу вашого завдання. Вартість розраховується індивідуально.
Типові помилки при розробці плагінів Joomla
- Використання застарілих класів (JFactory, JDatabase замість DI).
- Неправильна обробка кешування — плагін виконується при кожному запиті, сповільнюючи сайт.
- Відсутність обробки винятків — критична помилка валить увесь сайт.
- Жорстка прив'язка до однієї версії Joomla без урахування сумісності.
Ми враховуємо ці ризики на етапі проектування.
Чому обирають нас?
- Багаторічний досвід розробки під Joomla.
- 30+ реалізованих плагінів для різних версій.
- Сертифіковані розробники Joomla.
- Гарантія на код — 12 місяців.
- Повний супровід: від ідеї до продакшену.
Отримайте консультацію щодо вашого проєкту. Оцінимо завдання та запропонуємо оптимальне рішення в найкоротші терміни.