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

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

Компонент — основна одиниця функціональності Joomla. Управляє головною областю контенту сторінки. Має дві частини: Site (фронтенд) та Administrator (бекенд). Приклади: com_content (статті), com_users (користувачі), com_contact (контакти).

Архітектура компонента Joomla 5

Joomla 5 використовує MVC із Namespace та PSR-4:

com_catalog/
├── catalog.xml                    # Маніфест
├── administrator/
│   └── components/
│       └── com_catalog/
│           ├── src/
│           │   ├── Controller/    # Контроллери
│           │   ├── Model/         # Моделі
│           │   ├── View/          # Вьюхи
│           │   └── Table/         # Таблиці БД
│           ├── tmpl/              # Шаблони
│           └── services/
│               └── provider.php   # DI Provider
└── components/
    └── com_catalog/
        ├── src/
        │   ├── Controller/
        │   ├── Model/
        │   └── View/
        └── tmpl/

Маніфест (catalog.xml)

<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="4.0">
    <name>Каталог товарів</name>
    <namespace path="src">MyCompany\Component\Catalog</namespace>
    <version>1.0.0</version>
    <files folder="components/com_catalog">
        <filename>index.html</filename>
        <folder>src</folder>
        <folder>tmpl</folder>
    </files>
    <administration>
        <files folder="administrator/components/com_catalog">
            <filename>index.html</filename>
            <folder>src</folder>
            <folder>tmpl</folder>
            <folder>services</folder>
        </files>
        <menu img="class:catalog">Каталог</menu>
    </administration>
    <install>
        <sql>
            <file driver="mysql" charset="utf8">sql/install.mysql.sql</file>
        </sql>
    </install>
    <uninstall>
        <sql>
            <file driver="mysql" charset="utf8">sql/uninstall.mysql.sql</file>
        </sql>
    </uninstall>
</extension>

DI Service Provider

// administrator/components/com_catalog/services/provider.php
namespace MyCompany\Component\Catalog\Administrator\Service;

use Joomla\CMS\Extension\ComponentInterface;
use Joomla\CMS\Extension\Service\Provider\ComponentDispatcherFactory;
use Joomla\CMS\MVC\Factory\MVCFactory;
use Joomla\DI\Container;
use Joomla\DI\ServiceProviderInterface;

return new class implements ServiceProviderInterface {
    public function register(Container $container): void {
        $container->registerServiceProvider(new ComponentDispatcherFactory('\\MyCompany\\Component\\Catalog'));
        $container->registerServiceProvider(new MVCFactory('\\MyCompany\\Component\\Catalog'));
    }
};

Модель

// components/com_catalog/src/Model/ProductsModel.php
namespace MyCompany\Component\Catalog\Site\Model;

use Joomla\CMS\MVC\Model\ListModel;

class ProductsModel extends ListModel {
    protected function getListQuery(): \Joomla\Database\QueryInterface {
        $db = $this->getDatabase();
        $query = $db->getQuery(true);

        $query->select(['p.id', 'p.title', 'p.price', 'p.sku', 'p.category_id', 'c.title AS category_name'])
              ->from($db->quoteName('#__catalog_products', 'p'))
              ->join('LEFT', $db->quoteName('#__catalog_categories', 'c') . ' ON c.id = p.category_id')
              ->where($db->quoteName('p.published') . ' = 1');

        // Фільтр за категорією
        $categoryId = $this->getState('filter.category_id');
        if ($categoryId) {
            $query->where($db->quoteName('p.category_id') . ' = ' . (int) $categoryId);
        }

        // Пошук
        $search = $this->getState('filter.search');
        if ($search) {
            $query->where($db->quoteName('p.title') . ' LIKE ' . $db->quote('%' . $search . '%'));
        }

        $query->order($db->quoteName($this->getState('list.ordering', 'p.title')) . ' ' . $this->getState('list.direction', 'ASC'));

        return $query;
    }
}

Вьюха

// components/com_catalog/src/View/Products/HtmlView.php
namespace MyCompany\Component\Catalog\Site\View\Products;

use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
use Joomla\CMS\Factory;

class HtmlView extends BaseHtmlView {
    protected array $items = [];
    protected object $pagination;
    protected object $state;

    public function display($tpl = null): void {
        $model = $this->getModel();
        $this->items      = $model->getItems();
        $this->pagination = $model->getPagination();
        $this->state      = $model->getState();

        // Додати toolbar для адміністраторів
        if (Factory::getApplication()->isClient('administrator')) {
            $this->addToolbar();
        }

        parent::display($tpl);
    }

    protected function addToolbar(): void {
        $toolbar = \Joomla\CMS\Toolbar\ToolbarHelper::class;
        $toolbar::title('Каталог товарів', 'catalog');
        $toolbar::addNew('product.add');
        $toolbar::deleteList('', 'products.delete');
    }
}

Шаблон вьюхи

// components/com_catalog/tmpl/products/default.php
defined('_JEXEC') or die;
use Joomla\CMS\HTML\HTMLHelper;
?>
<div class="catalog-products">
    <?php foreach ($this->items as $item) : ?>
    <div class="catalog-product-card">
        <h3 class="product-title">
            <a href="<?php echo \Joomla\CMS\Router\Route::_('index.php?option=com_catalog&view=product&id=' . $item->id); ?>">
                <?php echo htmlspecialchars($item->title, ENT_QUOTES, 'UTF-8'); ?>
            </a>
        </h3>
        <p class="product-price"><?php echo number_format($item->price, 2, '.', ' '); ?> ₽</p>
        <p class="product-category"><?php echo htmlspecialchars($item->category_name); ?></p>
    </div>
    <?php endforeach; ?>

    <?php echo $this->pagination->getListFooter(); ?>
</div>

Терміни

Розробка користувацького компонента з CRUD операціями, списком та детальною сторінкою, бекенд-управлінням — 2–3 тижні.