Рекомендуем

Скидки до 30% на все темы и подписки... Никаких уловок или обмана Подписка на GavickPro включает в себя полный доступ к шаблонам для Joomla и WordPress, без каких-либо...

Далее...

Elegant Icon Font - 310 великолепных иконок... ElegantThemes создали поистине самый красивый, элегантный и полный набор иконок. Набор предлагается в виде веб шрифта,...

Далее...

JA Fubix адаптивный шаблон для Joomla... JA Fubix - апрельский шаблон от JoomlArt. Отлично подходящий для сайтов с тематикой спортивных новостей использующих...

Далее...

T3 Framework от JoomlArt О фреймворке Фреймворк T3 заслужено считается одним из самых популярных шаблонных фреймворков для Joomla. Все шаблоны...

Далее...

3 популярных фреймворка для... Очень большую роль в популярности Joomla сыграла система шаблонов, позволяющая в считанные секунды преобразить...

Далее...

  • Prev
  • Next

Разработка модулей в Joomla 2.5: Часть 1. Разработка базового модуля

3

Категории: Разработка модулей для Joomla

Давай те создадим наш первый модуль «Hello World». Все имена файлов и пути к ним указываются относительно каталога, в котором разрабатывается модуль. Для создания нашего первого модуля потребуется создание всего двух файлов. Файл самого модуля и XML файл описания модуля. Наш первый модуль не будет особенным, все, что он будет делать это выводить текст: «Hello World» в позицию, в которой он опубликован.

Давай начнем, запустите свой любимый редактор и создайте файл mod_helloworld.php:

Hello World!

Также создадим и XML файл описания модуля mod_helloworld.xml:

<?xml version="1.0" encoding="utf-8"?>
<extension type="module" version="2.5.0" method="upgrade">

	<name>Hello World!</name>
	<!-- Следующие элементы не обязательны и могут содержать все, что вы считаете нужным -->
	<creationDate>05.05.2012</creationDate>
	<author>Dev Joomla</author>
	<authorEmail>info@dev-joomla.ru</authorEmail>
	<authorUrl>http://www.dev-joomla.ru</authorUrl>
	<copyright>Copyright Info</copyright>
	<license>License Info</license>
	<!-- Версия модуля – эта строка сохраняется в таблице расширений -->
	<version>0.0.1</version>
	<!-- Описание модуля также не обязательно и если оно не указано, то берется из тэга  name -->
	<description>Это описание модуля Hello World...</description>
	<!-- Обратите внимание на тэг  files: в нем содержится информация, о том какие файлу нужно копировать в каталог модуля -->
	<files>
		<filename module="mod_helloworld">mod_helloworld.php</filename>
		<filename>mod_helloworld.xml</filename>
	</files>
</extension>

XML файл описания модуля получился достаточно большим. Но это только по тому, что наш модуль практически ничего не делает. Наиболее важное, на что нужно обратить внимание это строка 18 в ней в атрибуте module="mod_helloworld" мы указываем, какой файл будет считаться точкой входа модуля. Другими словами, с какого файла начинается выполнение модуля. Вообще это может быть файл с любым названием, но по соглашению принятого в Joomla имя файла должно начинаться с приставки mod_, мы так и поступили. И выполнение нашего модуля начнется с файла mod_helloworld.php.

XML файл описания модуля mod_helloworld.xml необходим для установки модуля и для того, чтобы Joomla дала вам возможность использовать этот модуль. В нем содержится все необходимые для работы Joomla описания модуля. Мы рассмотрели только минимальный набор тэгов, но в дальнейшем мы это наверстаем.

Для тестирования нашего модуля его необходимо установить. В Joomla существует два способа это сделать. Наиболее распространенный – установка из файла пакета (архив в формате zip в котором содержаться все необходимые файлы). Второй способ с помощью «поиска». Оба метода мы рассмотрим ниже, но рекомендую использовать установки с помощью файла пакета. Этот метод более «жестко» относиться к устанавливаемы файлам и ошибкам в них, особенно к XML файлу описания. Это дает нам возможность увидеть ошибки еще в процессе установки.

Если вы уже сталкивались с установкой расширений в Joomla, то вы наверняка заметили, что все расширения устанавливаются с помощью zip архива в котором содержатся вся необходимая информация для установки и удаления расширения.

Начиная с Joomla 1.6 появился новый способ установки с помощью поиска, суть его заключается в том, что вы сами размещаете файлы расширения в нужных местах (для нашего модуля это будет каталог modules/mod_helloworld относительно каталога? в который установлена Joomla), и в менеджере расширений производите поиск таких расширений, после чего можете его установить. Применять этот метод имеет смысл, если по каким-то причинам не получается установить расширение с помощью пакета. Обычно это случается при каких либо ограничениях хостинга (ограничение на размер загружаемого файла, на время выполнения) или при наличие конфликта в правах (в целях повышения безопасности можно запретить запись в определенные каталоги, в том числе и в те куда Joomla будет устанавливать расширение).

Все, что нам осталось сделать – это создать ZIP архив содержащий созданные нами файлы и установить полученный файл через «Менеджер расширений» и протестировать наш первый модуль.

Для тестирования нашего модуля необходимо проделать несколько шагов:

  1. Перейти в «Менеджер модулей»
  2. Создать новый модуль и выбрать тип модуля «Hello world»
  3. Заполнить поле «Заголовок»
  4. Выбрать позицию, в которой модуль будет опубликован
  5. Убедиться что в поле «Состояние» выбрано «Опубликовано»
  6. И сохранить настройки модуля
  7. Насладиться работой своего первого модуля

Скачать исходные тексты mod_helloworld-part01.zip

Предыдущая запись:

Следующая запись:


Комментариев 3 комментария

[…] Часть 1 – Разработка базового модуля […]

Большое спасибо автору! Я пользовался постоянно Flexi или mod_php Для того что-бы интегрировать код, думал что написать собственный модуль это сложно)) А теперь просто счастлив)))

Ошибка в окне с кодом
Обратите внимание на тэг files: в нем содержится информация, о том какие файлЫ нужно копировать в каталог модуля

Добавить комментарий

Professional Responsive Joomla Templates