Створення модуля для Joomla під ключ — від маніфесту до кешування

Створення модуля для Joomla під ключ

Ми розробляємо кастомні модулі Joomla з нуля. Нещодавно зіткнулися з завданням: вивести на головній сторінці інтернет-магазину блок "хіти продажів" з фільтрацією за категорією та кешуванням. Готові рішення не підходили — тягнули зайві стилі, плодили N+1 запити. Написали свій модуль за два дні. Розповімо, як це робимо.

Кастомний модуль Joomla — це не просто віджет. Це повністю контрольований елемент на своїй позиції шаблону. Він може відображати дані з будь-яких таблиць, зовнішніх API або обчислювати значення на льоту. Приклади: останні новини, форма зворотного зв'язку, статистика відвідувань, курси валют, рекомендації товарів. Головне — він не гальмує сайт і не конфліктує з іншими розширеннями. Як заявляють розробники Joomla в керівництві з розробки модулів Joomla, кастомні модулі є основою гнучкої архітектури.

У цій статті розберемо на реальному прикладі: модуль виведення виділених товарів каталогу. Покажемо структуру, маніфест, helper з кешуванням, dispatcher та шаблон. А головне — як уникнути типових помилок: дублювання запитів, відсутність кешування, несумісність з Joomla 5.

Чому кастомний модуль Joomla кращий за готовий компонент?

Готові модулі з маркетплейсу часто перевантажені опціями, які не потрібні вашому проекту. Вони можуть конфліктувати з іншими розширеннями, вимагати додаткових бібліотек і сповільнювати сторінку. Кастомний модуль містить рівно той код, який потрібен під задачу. Ви контролюєте кожен SQL-запит, кожен шаблон і кожне налаштування. У підсумку — мінімальний час завантаження (LCP < 2.5 с) і відсутність зайвих HTTP-запитів. Наприклад, в одному проекті ми заощадили замовнику на хостингу за рахунок оптимізації запитів і кешування.

Коли потрібен кастомний модуль Joomla?

Кастомний модуль виправданий, коли стандартних рішень недостатньо: потрібна інтеграція зі стороннім API, виведення даних з нестандартних таблиць, складна логіка фільтрації або кешування, яке не підтримується готовими модулями. Також він незамінний, якщо важлива максимальна продуктивність і мінімальний розмір коду. Вартість розробки розраховується індивідуально, але вкладення швидко окупаються за рахунок економії ресурсів сервера та часу на підтримку.

Як реалізувати кешування в модулі Joomla?

Кешування — це ключовий момент для продуктивності. У нашому helper ми використовуємо вбудований Cache API Joomla: обгортаємо запит до БД у кеш із часом життя 15 хвилин. Це знижує навантаження на сервер і прискорює завантаження сторінки для користувача.

Устрій модуля Joomla

Стандартний кастомний модуль включає такі файли:

• mod_product_highlights.php — точка входу
• mod_product_highlights.xml — маніфест
• src/Dispatcher/Dispatcher.php — диспетчер
• src/Helper/ProductHighlightsHelper.php — хелпер
• tmpl/default.php — шаблон
• language/ru-RU/... — мовні файли

Маніфест

<?xml version="1.0" encoding="utf-8"?>
<extension type="module" client="site" version="4.0">
  <name>mod_product_highlights</name>
  <author>Your Company</author>
  <version>1.0.0</version>
  <description>Виділені товари каталогу</description>
  <namespace path="src">MyCompany\Module\ProductHighlights</namespace>
  <files>
    <filename module="mod_product_highlights">mod_product_highlights.php</filename>
    <folder>src</folder>
    <folder>tmpl</folder>
  </files>
  <config>
    <fields name="params">
      <fieldset name="basic">
        <field name="count" type="number" label="Кількість товарів" default="4" min="1" max="12" />
        <field name="category_id" type="sql" label="Категорія" query="SELECT id AS value, title AS text FROM #__catalog_categories WHERE published = 1" default="" />
        <field name="show_price" type="radio" label="Показати ціну" default="1">
          <option value="1">Так</option>
          <option value="0">Ні</option>
        </field>
      </fieldset>
    </fields>
  </config>
</extension>

Helper з кешуванням

// src/Helper/ProductHighlightsHelper.php
namespace MyCompany\Module\ProductHighlights\Site\Helper;

use Joomla\CMS\Factory;

class ProductHighlightsHelper
{
    public static function getProducts(object $params): array
    {
        $cache = Factory::getCache('mod_product_highlights', 'callback');
        $cache->setCaching(true);
        $cache->setLifeTime(15); // хвилин
        $cacheId = md5('product_highlights_' . json_encode($params));
        return $cache->get([static::class, '_fetchProducts'], [$params], $cacheId) ?: [];
    }

    public static function _fetchProducts(object $params): array
    {
        $db = Factory::getDbo();
        $count = (int) $params->get('count', 4);
        $catId = (int) $params->get('category_id', 0);
        $query = $db->getQuery(true)
            ->select(['id', 'title', 'price', 'image', 'alias'])
            ->from($db->quoteName('#__catalog_products'))
            ->where($db->quoteName('published') . ' = 1')
            ->where($db->quoteName('featured') . ' = 1');
        if ($catId) {
            $query->where($db->quoteName('category_id') . ' = ' . $catId);
        }
        $query->order('ordering ASC')->setLimit($count);
        $db->setQuery($query);
        return $db->loadObjectList() ?: [];
    }
}

Dispatcher

// src/Dispatcher/Dispatcher.php
namespace MyCompany\Module\ProductHighlights\Site\Dispatcher;

use Joomla\CMS\Dispatcher\AbstractModuleDispatcher;
use MyCompany\Module\ProductHighlights\Site\Helper\ProductHighlightsHelper;

class Dispatcher extends AbstractModuleDispatcher
{
    protected function getLayoutData(): array
    {
        $data = parent::getLayoutData();
        $products = ProductHighlightsHelper::getProducts($data['params']);
        $data['products'] = $products;
        $data['showPrice'] = (bool) $data['params']->get('show_price', true);
        return $data;
    }
}

Шаблон

// tmpl/default.php
defined('_JEXEC') or die;
use Joomla\CMS\Router\Route;
?>
<div class="mod-product-highlights">
    <?php foreach ($products as $product) : ?>
        <div class="product-card">
            <?php if ($product->image) : ?>
                <img src="<?php echo $product->image; ?>" alt="<?php echo htmlspecialchars($product->title); ?>" loading="lazy">
            <?php endif; ?>
            <h4 class="product-card__title">
                <a href="<?php echo Route::_('index.php?option=com_catalog&view=product&alias=' . $product->alias); ?>">
                    <?php echo htmlspecialchars($product->title); ?>
                </a>
            </h4>
            <?php if ($showPrice && $product->price) : ?>
                <p class="product-card__price"><?php echo number_format($product->price, 0, '.', ' '); ?> грн</p>
            <?php endif; ?>
        </div>
    <?php endforeach; ?>
</div>

Ми приділяємо увагу alt-атрибутам: для зображення товару в модулі задаємо alt, що відповідає назві товару. Це покращує доступність і SEO.

Процес роботи

Порівняння кастомного модуля та готового плагіна

Що входить у роботу

1. Готовий модуль з маніфестом, helper, dispatcher, шаблоном і мовними файлами.
2. Налаштування кешування для зниження навантаження на БД.
3. Документація зі встановлення та налаштування.
4. Консультація щодо розміщення в потрібній позиції шаблону.
5. Підтримка протягом 30 днів після здачі.

Терміни та вартість

Розробка кастомного модуля займає від 3 до 5 днів залежно від складності. Вартість розраховується індивідуально. Ми гарантуємо сумісність з Joomla 4 і 5, а також відсутність помилок у коді.

Ми накопичили багаторічний досвід в оптимізації запитів, кешуванні та створенні зручних інтерфейсів для адміністраторів. Отримайте попередній розрахунок за 1 день — надішліть задачу. Замовте розробку модуля Joomla та отримайте готовий код з гарантією.

Зв'яжіться з нами для обговорення вашого завдання — ми допоможемо реалізувати функціонал, який ідеально впишеться у ваш проект.