24 февраля 2012 г.

Создание компонента для Joomla! v. 2.5 ч.1

Здравствуйте, уважаемые читатели. Итак, продолжаем перевод документации и написание компонента для Joomla! версии 2.5.



Введение:


Это руководство является частью руководства "Создание компонента для Joomla! v. 2.5"

Первый базовый компонент:


Давайте создадим компонент "Hello World!"

Публичная часть

При помощи удобного или привычного для Вас редактора кода, создайте файл ваш-сайт/components/com_helloworld/helloworld.php содержащий строку "Hello World!"
Вы можете протестировать работу компонента набрав в Вашем браузере ссылку index.php?option=com_helloworld (не забудьте впереди дописать адрес Вашей установленной Joomla! 2.5)

Административная часть
При помощи удобного или привычного для Вас редактора кода, создайте файл ваш-сайт/administrator/components/com_helloworld/helloworld.php содержащий строку "Hello World!"
Так же, Вы можете протестировать работу компонента набрав в Вашем браузере ссылку administrator/index.php?option=com_helloworld

Упаковка установочного архива
Если Вы уже использовали Joomla! перед прочтением этого руководства, Вы знаете, что расширения устанавливаются при помощи архивного файла, содержащего все необходимые для инсталляции и деинсталляции файлы.
При помощи фашего файлового менеджера создайте папку (вне папки с установленной Joomla!) содержащую следующие файлы:

admin/sql/updates/mysql/0.0.1.sql пустой файл, позволяющий инициализировать версию схемы компонента com_helloworld
admin/sql/updates/mysql/0.0.1.sql
          
Создайте архив Вашей папки и инсталируйте Ваш компонент, используя установщик Joomla!. Вы можете протестировать базовый компонент введя index.php?option=com_helloworld или administrator/index.php?option=com_helloworld в адресной строке Вашего браузера. Вы также, можете убедиться что компонент Hello World! виден в административном меню Joomla! в разделе меню Компоненты.

helloworld.xml содержит (Если в этом файле Вы используете кириллицу, не забудьте сохранить файл в кодировке UTF8 без BOM)



<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="2.5.0" method="upgrade">
 
	<name>Hello World!</name>
	<!-- The following elements are optional and free of formatting constraints -->
	<creationDate>November 2009</creationDate>
	<author>John Doe</author>
	<authorEmail>john.doe@example.org</authorEmail>
	<authorUrl>http://www.example.org</authorUrl>
	<copyright>Copyright Info</copyright>
	<license>License Info</license>
	<!--  The version string is recorded in the components table -->
	<version>0.0.1</version>
	<!-- The description is optional and defaults to the name -->
	<description>Description of the Hello World component ...</description>
 
	<update> <!-- Runs on update; New in 2.5 -->
		<schemas>
			<schemapath type="mysql">sql/updates/mysql</schemapath>
		</schemas>
	</update>
 
	<!-- Site Main File Copy Section -->
	<!-- Note the folder attribute: This attribute describes the folder
		to copy FROM in the package to install therefore files copied
		in this section are copied from /site/ in the package -->
	<files folder="site">
		<filename>index.html</filename>
		<filename>helloworld.php</filename>
	</files>
 
	<administration>
		<!-- Administration Menu Section -->
		<menu>Hello World!</menu>
		<!-- Administration Main File Copy Section -->
		<!-- Note the folder attribute: This attribute describes the folder
			to copy FROM in the package to install therefore files copied
			in this section are copied from /admin/ in the package -->
		<files folder="admin">
			<!-- Admin Main File Copy Section -->
			<filename>index.html</filename>
			<filename>helloworld.php</filename>
			<!-- SQL files section -->
			<folder>sql</folder>
		</files>
	</administration>
 
</extension>
site/helloworld.php содержит:


Hello World
admin/helloworld.php содержит



Hello World administration
index.html необходимо положить во все папки. Его содержание ниже


<html><body bgcolor="#FFFFFF"></body></html>

Комментариев нет:

Отправить комментарий