Розробка кастомного плагіна Joomla

Розробка користувацького плагіну Joomla

Плагіни Joomla реагують на системні події. Перехватлюють моменти життєвого циклу: до/після збереження статті, при аутентифікації, при пошуку, при відправці форми. Це найправильніший спосіб розширити поведінку системи без модифікації ядра.

Групи плагінів

Структура плагіну

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>

DI Provider

// services/provider.php
use Joomla\CMS\Extension\PluginInterface;
use Joomla\DI\Container;
use MyCompany\Plugin\Content\SyncCrm\Extension\SyncCrmPlugin;

return new class implements \Joomla\DI\ServiceProviderInterface {
    public function register(Container $container): void {
        $container->set(PluginInterface::class, function (Container $container) {
            $dispatcher = $container->get(\Joomla\Event\DispatcherInterface::class);
            $plugin = new SyncCrmPlugin($dispatcher, []);
            $plugin->setApplication($container->get(\Joomla\CMS\Application\CMSApplicationInterface::class));
            return $plugin;
        });
    }
};

Основний клас плагіну

// 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);
        }
    }
}

Плагін аутентифікації (зовнішний SSO)

public static function getSubscribedEvents(): array {
    return ['onUserAuthenticate' => 'authenticate'];
}

public function authenticate(Event $event): void {
    $credentials = $event->getArgument('credentials');
    $options     = $event->getArgument('options');
    $response    = $event->getArgument('response');

    // Перевіряємо через зовнішній OAuth-сервер
    $token = $this->verifyWithOAuthServer($credentials['username'], $credentials['password']);

    if ($token) {
        $response->status = \Joomla\CMS\Authentication\Authentication::STATUS_SUCCESS;
        $response->email  = $token['email'];
        $response->fullname = $token['name'];
        $response->type   = 'OAuth';
    } else {
        $response->status  = \Joomla\CMS\Authentication\Authentication::STATUS_FAILURE;
        $response->error_message = 'Неверні облікові дані';
    }
}

Терміни

Розробка плагіну для однієї групи подій (content, user або system) з налаштовуємими параметрами — 1–3 дні.