Создание модуля часть 1

Будем начинать с создания приметивного модуля. Создадаим простой модуль, который будет выводить надпись "Администратор". Этот модуль может использоваться как фундамент, что бы на его основе создавать более сложные модули.

Для начала создадим папку, в которой будет находиться модуль. Как принято имя папки должно начинаться с приставки mod_ и дальше должно идти название модуля, т.е. в нашем случае папка будет называться mod_admin. В созданной папке создадим файл mod_admin.php содержащий следующее:

<?php
// no direct access
defined('_JEXEC') or die('Restricted access');
echo JText::_( 'AdMiNiStRaToR' );

Как видно код состоит всего из 2-х строчек:

defined('_JEXEC') or die('Restricted access');

Используется во всех расширениях Joomla. Это своего рода защита от прямого обращения к скрипту.

echo JText::_( 'AdMiNiStRaToR' );

В этой строчке непосредственно выводится приветствие с помощью команды echo. Обратите внимание, что здесь используется встроенный класс JText. JText - этот класс получает доступ к сервису по переводу для любых языковых пакетов, установленных на Joomla. Грубо говоря он переводит английские слова в текущую локализацию Joomla. Если заданный текст не найден в текущей локализации, то отобразится просто начальный текст (AdMiNiStRaToR). Стоит так же отметить что этот метод не учитывает регистр (я специально поставил разные регистры) и не переводит пунктуацию.

Затем создадим файл XML, который будет указывать Joomla как и куда устанавливать модуль. Название этого файла такое же как было описано выше, только расширение будет *.xml. Итак создаем и сохраняем в нашей папке файл mod_admin.xml, содержащий следуещее:

<?xml version="1.0" encoding="utf-8"?>
<install type="module" version="1.5.0">
	<name>Админ</name>
	<!-- The following elements are optional and free of formatting conttraints -->
	<creationDate>Март 2009</creationDate>
	<author>Николай S.</author>
	<authorEmail>kolyamba831@inbox.ru</authorEmail>
	<authorUrl>http://www.joomlafree.ru</authorUrl>
	<copyright>All rights reserved</copyright>
	<license>GNU/GPL</license>
	<version>1.0.0</version>
	<description>Простой модуль - выводит слово "Администратор" </description>
	<files>
		<filename module="mod_admin">mod_admin.php</filename>
	</files>
</install>

Рассмотрим его подробнее:

• Начльный тэг <install> инструктирует Joomla что устанвливается модуль, совместимый с версиями 1.5 и выше;
• <name> - определяет название модуля;
• <author> - имя автора;
• <creationDate> - дата создания;
• <copyright> - сведения о копирайте;
• <license> - лицензия;
• <authorEmail> - e-mail автора;
• <authorUrl> - сайт автора;
• <version> - версия модуля;
• <description> - описание модуля;
• <filename> - определяет файлы (элементы), которые использует модуль. В данном случае 1 файл;

Это все что потребуется для создания простейшего модуля. Все что остается зделать это запокавать папку mod_hello в архив ZIP и установить этот модуль через Менеджер Расширений (Extension Manager) Расширения -> Установить/Удалить. Так же не забыть опубликовать этот модуль в нужной позиции.

• 1
• 2
• 3
• 4
• 5