Кастомные модули Joomla 4/5 под ключ — от манифеста до кэширования

Создание модуля для 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 и получите готовый код с гарантией.

Свяжитесь с нами для обсуждения вашей задачи — мы поможем реализовать функционал, который идеально впишется в ваш проект.