Модуль Joomla «Hello World!»

Попробуем создать простейший модуль Joomla. Для этого создадим в папке модулей, директорию mod_testmodule (testmodule - это имя нашего расширения). Внутри новой папки создадим два файла mod_testmodule.php и mod_testmodule.xml

В mod_testmodule.xml поместим следующий код

<?xml version="1.0" encoding="utf-8"?>
<install type="module" version="1.5.0">
    <name>testmodule</name>
    <author>me</author>
    <version>1.0</version>
    <description>TEST example by joomla-book.ru</description>
    <files>
        <filename module="mod_testmodule">mod_testmodule.php</filename>
    </files>
</install>

На самом деле в этом файле может храниться очень много полезной и не очень информации, дополнительные настройки, локализации и прочее. Но в качестве простого примера, мы упростим xml почти до минимума. Здесь наc интересуют имя модуля, и список необходимых файлов (перечисляются внутри ).

А php-файл должен в свою очередь содержать следующий текст

<?php
    print "Hello world!";
?>

Теперь модуль готов к использованию. В панели управления Расширения - Менеджер модулей - Новый найдите свой модуль, он будет называться testmodule, и установите в желаемою позицию. Все бы хорошо, но возникает серьезная проблема, наш модуль может быть запущен без Joomla по прямой ссылке

Чтобы этой неприятности не происходило, модифицируем наш исполняемый php файл.

<?php
    defined('_JEXEC') or die('Restricted access');
    echo JText::_('Hello World!');
?>

Первая строка проверяет глобальную константу, её объявление гарантирует нам что модуль запущен самой Joomla а не по прямой ссылке. JText - попытается найти перевод на текущий язык (у вас скорее всего на русский) среди файлов локализаций, в крайнем случае вернет то что было передано в него.

Схема расположения элементов модуля Joomla

Схема создана Михаилом

• Как показать модуль только не зарегистрированным пользователям?
• Модуль - что это?
• Шаблонизация модулей
• Использование параметров в модуле
• Модуль меню