|
Создайте каталог mod_mymodule. В него мы поместим оба файла нашего модуля. Первым делом нужно разработать XML-файл. В большинстве случаев он будет стандартным — вам нужно будет только изменять имя модуля и имя PHP-файла. В листинге 9.1 приведен типичный XML-файл модуля.
Листинг 9.1. Файл mod_mymodule.xml
<?xml version="1.0" encoding="utf-8"?>
<install version="1.5.0">
<name>My Module</name>
<author>Denis Kolisnichenko</author>
<copyright>(C) 2008 Denis Kolisnichenko</copyright>
<creationDate>Oct 2008</creationDate>
<authorEmail>
Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript
Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript </authorEmail>
<authorUrl>www.dkws.org.ua</authorUrl>
<description>My first module</description> <version>l.0.0</version> <files>
<filename module="mod_mymodule">mod_mymodule .php</filename> </files> <params>
<param type="text" default="Denis" label="Your Name" description="Your name" /> </params> </install>
Проанализируем содержимое XML-файла. Первая строка обязательна для всех XML-файлов. Вы можете разве что указать другую кодировку. Вторая строка говорит о том, что наше расширение — модуль (type="module") и для его установки нужна версия Joomla 1.5.0 или выше:
<install version="1.5.0">
Далее следует стандартная информация о модуле:
- название — name;
- разработчик — author;
- дата создания — creationDate;
- информация об авторских правах — copyright;
- "координаты" автора — authorEmail, authorUrl;
- описание модуля — description;
- версия — version.
Блок files описывает файлы модуля, у нас всего один файл:
<files>
<filename module="mod_mymodule">mod_mymodule.php</filename> </files>
В блоке params описываются параметры модуля, которые можно будет изменить с помощью интерфейса администратора. Каждый параметр описывается с помощью тега param. Вам нужно указать следующие атрибуты этого тега:
- name — имя параметра в сценарии;
- type — тип параметра (текст в данном случае);
- default — значение по умолчанию;
- label — подпись параметра в интерфейсе администратора;
- description — описание параметра (можно не указывать).
Секцию <install> нужно обязательно закрыть:
</install>
|
