Створення модуля для 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 та отримайте готовий код з гарантією.

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