Хочешь добавить на сайт Joomla что-то своё — например, калькулятор, форму, блок с данными — но не хочешь лезть в ядро и портить шаблон? Тогда тебе нужен модуль.

В этой статье я покажу, как создать простой модуль-калькулятор, который можно включать, выключать и настраивать через админку Joomla — без единой правки в ядре сайта.

Что такое модуль в Joomla?

Модуль — это небольшой блок контента, который можно разместить в любой позиции сайта (например, в сайдбаре, шапке или подвале). Его можно включать/выключать, настраивать и показывать только на нужных страницах.

Примеры модулей: меню, логотип, погода, формы, баннеры — и, конечно, калькулятор.

Шаг 1: Создаём папку модуля

В папке /modules/ создай новую папку с именем:

/modules/mod_calculator/

Шаг 2: Создаём манифест модуля (mod_calculator.xml)

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

<?xml version="1.0" encoding="utf-8"?>
<extension type="module" version="4.0" client="site" method="upgrade">
    <name>MOD_CALCULATOR</name>
    <author>Ты</author>
    <version>1.0.0</version>
    <description>Простой калькулятор</description>
    <files>
        <filename module="mod_calculator">mod_calculator.php</filename>
        <folder>tmpl</folder>
    </files>
    <config>
        <fields name="params">
            <fieldset name="basic">
                <field
                    name="header"
                    type="text"
                    label="Заголовок"
                    description="Заголовок модуля"
                    default="Калькулятор"
                />
                <field
                    name="show_result"
                    type="list"
                    label="Показывать результат"
                    default="1"
                >
                    <option value="1">Да</option>
                    <option value="0">Нет</option>
                </field>
            </fieldset>
        </fields>
    </config>
</extension>

Шаг 3: Основной файл модуля (mod_calculator.php)

Создай файл mod_calculator.php. Он просто подключает шаблон.

<?php
defined('_JEXEC') or die;

require JModuleHelper::getLayoutPath('mod_calculator', 'default');</code></pre>

    <h2>Шаг 4: Шаблон модуля (tmpl/default.php)</h2>

    <p>Создай папку <code>tmpl</code> и внутри — файл <code>default.php</code>. Это и будет тело модуля.</p>

    <pre><code><?php
defined('_JEXEC') or die;

// Получаем параметры
$header = $params->get('header', 'Калькулятор');
$showResult = $params->get('show_result', 1);

// Обработка формы
$result = null;
if ($_SERVER['REQUEST_METHOD'] === 'POST' &amp;&amp; $showResult) {
    $a = (float)($_POST['num1'] ?? 0);
    $b = (float)($_POST['num2'] ?? 0);
    $op = $_POST['op'] ?? 'add';

    switch ($op) {
        case 'add': $result = $a + $b; break;
        case 'sub': $result = $a - $b; break;
        case 'mul': $result = $a * $b; break;
        case 'div': $result = $b != 0 ? $a / $b : 'Ошибка: деление на 0'; break;
        default: $result = 'Ошибка';
    }
}
?>

<!-- Вывод модуля -->
<div class="mod-calculator">
    <?php if ($header) : ?>
        <h3><?php echo htmlspecialchars($header); ?></h3>
    <?php endif; ?>

    <form method="post">
        <input type="number" name="num1" placeholder="Число 1" required>
        <input type="number" name="num2" placeholder="Число 2" required>
        <select name="op">
            <option value="add">+</option>
            <option value="sub">-</option>
            <option value="mul">*</option>
            <option value="div">/</option>
        </select>
        <button type="submit">=</button>
    </form>

    <?php if ($result !== null &amp;&amp; $showResult): ?>
        <p><strong>Результат:</strong> <?php echo htmlspecialchars($result); ?></p>
    <?php endif; ?>

Шаг 5: Установка модуля

1. Запакуй папку mod_calculator в ZIP-архив.
2. В админке Joomla: Расширения → Менеджер расширений → Установка — загрузи архив.
3. Перейди в Модули, найди «Калькулятор».
4. Настрой: выбери позицию, включи, укажи, на каких страницах показывать.
5. Сохрани — и калькулятор уже работает!

Почему это круто?

• ✅ Не лезем в шаблон и ядро.
• ✅ Можно включать/выключать через админку.
• ✅ Можно настраивать параметры (заголовок, показ результата).
• ✅ Легко переиспользовать на других сайтах.

Что дальше?

Теперь ты можешь делать любые модули: формы обратной связи, блоки с погодой, таймеры, счётчики — всё, что угодно. Главное — выносить логику в отдельный модуль, а не встраивать в шаблон.

Удачи в разработке на Joomla!

Посетителей сегодня: 0

© Digital Specialist | Не являемся сотрудниками Google, Яндекса и NASA

Кто я | HSH | Контакты и регион