Joomla! Documentation - User contributions [en]

Adding custom fields to core components using a plugin/ru

2017-09-27T06:45:03Z

Leo240:

<noinclude><languages /></noinclude>
Вы когда-нибудь желали, чтобы в компоненте com_content ядра [системы Joomla] присутствовало дополнительное поле для [ввода] номера телефона или Вам когда-нибудь было нужно дополнительное поле для материалов компонента com_content? Joomla предоставляет простой и удобный путь для интегрирования таких новых полей в компоненты ядра. Простой плагин содержимого и переопределение макета Вашего шаблона - это все что требуется для достижения [такого интегрирования].

Эта статья показывает как добавить дополнительное поле в компоненте ядра на примере добавления дополнительного адреса электронной почты в контакты внутри компонента com_contact. Если Вам нужно добавить произвольные поля в материалы [компонента] com_content, просто измените в ниже следующем коде все упоминания "contact" на "content". Также учтите, что компонент com_content использует свойство "attribs", а не "params" для значений полей, так же, как и для переопределения.

==Создание произвольного поля==
Для ознакомления с тем, как создать и установить какой-либо не рассмотренный здесь плагин, рекомендуется сначала прочитать [[S:MyLanguage/Creating a Plugin for Joomla|Создание плагина для Joomla]].

Для того, чтобы добавить какое-либо поле в какой-либо системный компонент, Вам нужно создать плагин содержимого, который подхватывает событие onContentPrepareForm и вставляет свои собственные поля в нужный [класс] JForm. Нижеследующий код предназначен только для Joomla 3.1 и следующих за ней версий.

<source lang="php">
<?php
// no direct access
defined ('_JEXEC') or die;
class plgContentExample extends JPlugin
{
/**
* Load the language file on instantiation.
* Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since <your version>
*/
protected $autoloadLanguage = true;

/**
* Prepare form and add my field.
*
* @param JForm $form The form to be altered.
* @param mixed $data The associated data for the form.
*
* @return boolean
*
* @since <your version>
*/
function onContentPrepareForm($form, $data)
{
$app = JFactory::getApplication();
$option = $app->input->get('option');

switch($option)
{
case 'com_contact' :
if ($app->isAdmin())
{
JForm::addFormPath(__DIR__ . '/forms');
$form->loadFile('contact', false);
}

return true;
}

return true;
}
}
?>
</source>

===Включение редактирования произвольных полей с лицевой части [веб-сайта]===

<div class="mw-translate-fuzzy">
Включить редактирование Ваших новых произвольных полей довольно легко. Для того, чтобы довавить данное поле в конкретную форму редактирования содержимого с лицевой части [веб-сайта], просто сдублируйте следующий отрывок кода:
</div>

<source>
case 'com_contact':
if ($app->isSite())
{
JForm::addFormPath(__DIR__ . '/forms');
$form->loadFile('contact', false);
}
return true;
</source>

<div class="mw-translate-fuzzy">
Сдублируйте его непосредственно снизу от уже существующего отрывка этого кода и измените 'isAdmin' на 'isSite'.
</div>

<div class="mw-translate-fuzzy">
Как только Вы это выполнили, создайте в файле edit.php переопределение шаблона для веб-формы содержимого. Если Вы создаете набор произвольных полей для [компонента] com_content, то Вам необходимо скопировать components/com_contact/views/form/tmpl/edit.php в /templates/your-template-name/html/com_contact/form/edit.php.
</div>

Внутри Вашего переопределения макета добавьте в вер-форму новые поля [туда], где по-Вашему они должны быть показаны (например, под заголовком [или] под описанием), удостоверяясь в том, что названия полей соответствуют XML файлу Вашего плагина (следующим Вы создадите его).

<source lang="php">
<?php // Checking if this is an existing item or not ?>
<?php if ($this->item->id) : ?>
<?php // If it is an existing item, get the attribs part of the existing record ?>
<?php $attribs = json_decode($this->item->attribs); ?>
<?php // Set the value of the custom field to what is already saved. ?>
<?php // Duplicate for the number of fields you need, changing the field_name as needed. ?>
<?php echo $this->form->setValue('field_name', 'attribs', $attribs->field_name); ?>
<?php endif; ?>
<?php // This line needs added to the file right where you want to display it. So, if you want it to show right after the description field, find the description field and place this right after it. Duplicate for the number of fields you need, changing the field_name as needed. ?>
<?php // Now we display the field. If we are editing an existing item, the previously saved data will be populated already ?>
<?php echo $this->form->renderField('field_name', 'attribs'); ?>
</source>

Как только это выполнено, Ваши [новые] поля теперь появятся и будут сохранены через лицевую [веб-страницу] редактирования [содержимого].

<div class="mw-translate-fuzzy">
Дополнительные поля загружаются из файла /forms/contact.xml, [находящегося] в директории плагина. Важно чтобы эти поля находились в элементе поля с названием свойства, установленным на "params". Если Вы не установите это название свойства, то [Ваши новые ] поля появятся в административной [панели] сайта, но их значения не будут сохраняться.
</div>

В этом случае мы добавляем поле для ярлыка для описания на публичном веб-сайте поля адреса электронной почты и второе поле - для значения [самого] адреса электронной почты,

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fields name="params">
<fieldset name="params" label="PLG_CONTENT_EXAMPLE_FIELDSET_LABEL">
<field
name="contact_emaillabel2"
type="text"
label="PLG_CONTENT_EXAMPLE_CONTACT_EMAILLABEL2"
/>
<field
name="contact_email2"
type="text"
label="PLG_CONTENT_EXAMPLE_CONTACT_EMAIL2"
filter="email"
/>
</fieldset>
</fields>
</form>
</source>

В заключении, нам необходим языковый файл, чтобы эти параметры были представлены в административной панели эстетично и чтобы их можно было переводить на другие языки. Это файл должен иметь название по образцу <tt>en-GB.plg_content_example.ini</tt>.

<source>
PLG_CONTENT_EXAMPLE_FIELDSET_LABEL="Additional Information"
PLG_CONTENT_EXAMPLE_CONTACT_EMAIL2="Additional email address"
PLG_CONTENT_EXAMPLE_CONTACT_EMAILLABEL2="Additional email label"
</source>

Вот и все, [что необходимо выполнить] для создания [дополнительного] поля в [компоненте] com_content. Если Вы установите этот плагин, то в веб-форме редактирования контакта Вы получите дополнительную вкладку с названием ''Additional Information'', включающую эти дополнительные поля. Если Вы введете данные в эти новые поля описания и адреса электронной почты контакта, то Вы увидите, что [компонент] com_contact будет сохранять и извлекать эти данные.

Этот же самый плагин может быть использован для добавления полей в другие компоненты: просто добавьте соответствующий код в функцию onContentPrepareForm и создайте соответствующие XML файлы веб-формы.

==Показ произвольного поля==
Для показа произвольного поля Вам необходимо создать в Вашем шаблоне переопределение макета для соответствующего компонента. Для более подробного ознакомления с созданием шаблонов смотрите вики [[S:MyLanguage/Creating a basic Joomla! template|Создание начального шаблона для Joomla!]]. Для более подробного ознакомления с переопределением макетов смотрите [[S:MyLanguage/Understanding Output Overrides|Понимание переопределения вывода данных]].

Скопируйте файл <tt><Joomla>/components/com_contact/views/contact/tmpl/default.php</tt> в <tt><template>/html/com_contact/contact/default.php</tt>, при необходимости создав эту папку. Мы собираемся изменить этот файл для включения дополнительной информации. Компонент com_contact автоматически загрузит эти дополнительные поля для нас и загрузит их в переменную под названием $this->params. Все, что нам нажно сделать, так это проверить, установленны ли эти данные и, если это так, то показать их.

Для показа этого поля, найдите в [файле]<tt><template>/html/com_contact/contact/default.php</tt> место, которое соответствует [месту] в котором Вы желаете показать эти дополнительные поля, и добавьте следующий код:

<source lang="php">
<?php if ($this->params->get('contact_emaillabel2', false)) : ?>
<div>
<span class="contact-additionalemail"><?php echo $this->params->get('contact_emaillabel2'); ?>:&emsp;<a href="mailto:<?php echo $this->params->get('contact_email2'); ?>"><?php echo $this->params->get('contact_email2'); ?></a><br/></span>
</div>
<?php endif; ?>
</source>

Если Вы добавите этот код и установите свой шаблон, то теперь на лицевой части Вашего веб-сайте у Вас будут показаны эти дополнительные поля.

<noinclude>
[[Category:Plugin Development/ru|Разработка плагинов]]
[[Category:Template Development/ru|Разработка шаблонов]]
[[Category:Tutorials/ru|Наставления]]
</noinclude>

Translations:Adding custom fields to core components using a plugin/2/ru

2017-09-27T06:45:02Z

Leo240:

Эта статья показывает как добавить дополнительное поле в компоненте ядра на примере добавления дополнительного адреса электронной почты в контакты внутри компонента com_contact. Если Вам нужно добавить произвольные поля в материалы [компонента] com_content, просто измените в ниже следующем коде все упоминания "contact" на "content". Также учтите, что компонент com_content использует свойство "attribs", а не "params" для значений полей, так же, как и для переопределения.

Adding custom fields to core components using a plugin/ru

2017-09-27T04:44:14Z

Leo240:

<noinclude><languages /></noinclude>
Вы когда-нибудь желали, чтобы в компоненте com_content ядра [системы Joomla] присутствовало дополнительное поле для [ввода] номера телефона или Вам когда-нибудь было нужно дополнительное поле для материалов компонента com_content? Joomla предоставляет простой и удобный путь для интегрирования таких новых полей в компоненты ядра. Простой плагин содержимого и переопределение макета Вашего шаблона - это все что требуется для достижения [такого интегрирования].

<div class="mw-translate-fuzzy">
На примере добавления дополнительного адреса эл.почты в контакты компонента com_content, эта статья показывает как добавить какое-либо дополнительное поле в какой-либо компонент ядра. Если Вам нужно добавить произвольные поля в материалы [компонента] com_content, просто измените в ниже следующем коде все упоминания "contact" на "content".
</div>

==Создание произвольного поля==
Для ознакомления с тем, как создать и установить какой-либо не рассмотренный здесь плагин, рекомендуется сначала прочитать [[S:MyLanguage/Creating a Plugin for Joomla|Создание плагина для Joomla]].

Для того, чтобы добавить какое-либо поле в какой-либо системный компонент, Вам нужно создать плагин содержимого, который подхватывает событие onContentPrepareForm и вставляет свои собственные поля в нужный [класс] JForm. Нижеследующий код предназначен только для Joomla 3.1 и следующих за ней версий.

<source lang="php">
<?php
// no direct access
defined ('_JEXEC') or die;
class plgContentExample extends JPlugin
{
/**
* Load the language file on instantiation.
* Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since <your version>
*/
protected $autoloadLanguage = true;

/**
* Prepare form and add my field.
*
* @param JForm $form The form to be altered.
* @param mixed $data The associated data for the form.
*
* @return boolean
*
* @since <your version>
*/
function onContentPrepareForm($form, $data)
{
$app = JFactory::getApplication();
$option = $app->input->get('option');

switch($option)
{
case 'com_contact' :
if ($app->isAdmin())
{
JForm::addFormPath(__DIR__ . '/forms');
$form->loadFile('contact', false);
}

return true;
}

return true;
}
}
?>
</source>

===Включение редактирования произвольных полей с лицевой части [веб-сайта]===

<div class="mw-translate-fuzzy">
Включить редактирование Ваших новых произвольных полей довольно легко. Для того, чтобы довавить данное поле в конкретную форму редактирования содержимого с лицевой части [веб-сайта], просто сдублируйте следующий отрывок кода:
</div>

<source>
case 'com_contact':
if ($app->isSite())
{
JForm::addFormPath(__DIR__ . '/forms');
$form->loadFile('contact', false);
}
return true;
</source>

<div class="mw-translate-fuzzy">
Сдублируйте его непосредственно снизу от уже существующего отрывка этого кода и измените 'isAdmin' на 'isSite'.
</div>

<div class="mw-translate-fuzzy">
Как только Вы это выполнили, создайте в файле edit.php переопределение шаблона для веб-формы содержимого. Если Вы создаете набор произвольных полей для [компонента] com_content, то Вам необходимо скопировать components/com_contact/views/form/tmpl/edit.php в /templates/your-template-name/html/com_contact/form/edit.php.
</div>

Внутри Вашего переопределения макета добавьте в вер-форму новые поля [туда], где по-Вашему они должны быть показаны (например, под заголовком [или] под описанием), удостоверяясь в том, что названия полей соответствуют XML файлу Вашего плагина (следующим Вы создадите его).

<source lang="php">
<?php // Checking if this is an existing item or not ?>
<?php if ($this->item->id) : ?>
<?php // If it is an existing item, get the attribs part of the existing record ?>
<?php $attribs = json_decode($this->item->attribs); ?>
<?php // Set the value of the custom field to what is already saved. ?>
<?php // Duplicate for the number of fields you need, changing the field_name as needed. ?>
<?php echo $this->form->setValue('field_name', 'attribs', $attribs->field_name); ?>
<?php endif; ?>
<?php // This line needs added to the file right where you want to display it. So, if you want it to show right after the description field, find the description field and place this right after it. Duplicate for the number of fields you need, changing the field_name as needed. ?>
<?php // Now we display the field. If we are editing an existing item, the previously saved data will be populated already ?>
<?php echo $this->form->renderField('field_name', 'attribs'); ?>
</source>

Как только это выполнено, Ваши [новые] поля теперь появятся и будут сохранены через лицевую [веб-страницу] редактирования [содержимого].

<div class="mw-translate-fuzzy">
Дополнительные поля загружаются из файла /forms/contact.xml, [находящегося] в директории плагина. Важно чтобы эти поля находились в элементе поля с названием свойства, установленным на "params". Если Вы не установите это название свойства, то [Ваши новые ] поля появятся в административной [панели] сайта, но их значения не будут сохраняться.
</div>

В этом случае мы добавляем поле для ярлыка для описания на публичном веб-сайте поля адреса электронной почты и второе поле - для значения [самого] адреса электронной почты,

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<form>
<fields name="params">
<fieldset name="params" label="PLG_CONTENT_EXAMPLE_FIELDSET_LABEL">
<field
name="contact_emaillabel2"
type="text"
label="PLG_CONTENT_EXAMPLE_CONTACT_EMAILLABEL2"
/>
<field
name="contact_email2"
type="text"
label="PLG_CONTENT_EXAMPLE_CONTACT_EMAIL2"
filter="email"
/>
</fieldset>
</fields>
</form>
</source>

В заключении, нам необходим языковый файл, чтобы эти параметры были представлены в административной панели эстетично и чтобы их можно было переводить на другие языки. Это файл должен иметь название по образцу <tt>en-GB.plg_content_example.ini</tt>.

<source>
PLG_CONTENT_EXAMPLE_FIELDSET_LABEL="Additional Information"
PLG_CONTENT_EXAMPLE_CONTACT_EMAIL2="Additional email address"
PLG_CONTENT_EXAMPLE_CONTACT_EMAILLABEL2="Additional email label"
</source>

Вот и все, [что необходимо выполнить] для создания [дополнительного] поля в [компоненте] com_content. Если Вы установите этот плагин, то в веб-форме редактирования контакта Вы получите дополнительную вкладку с названием ''Additional Information'', включающую эти дополнительные поля. Если Вы введете данные в эти новые поля описания и адреса электронной почты контакта, то Вы увидите, что [компонент] com_contact будет сохранять и извлекать эти данные.

Этот же самый плагин может быть использован для добавления полей в другие компоненты: просто добавьте соответствующий код в функцию onContentPrepareForm и создайте соответствующие XML файлы веб-формы.

==Показ произвольного поля==
Для показа произвольного поля Вам необходимо создать в Вашем шаблоне переопределение макета для соответствующего компонента. Для более подробного ознакомления с созданием шаблонов смотрите вики [[S:MyLanguage/Creating a basic Joomla! template|Создание начального шаблона для Joomla!]]. Для более подробного ознакомления с переопределением макетов смотрите [[S:MyLanguage/Understanding Output Overrides|Понимание переопределения вывода данных]].

Скопируйте файл <tt><Joomla>/components/com_contact/views/contact/tmpl/default.php</tt> в <tt><template>/html/com_contact/contact/default.php</tt>, при необходимости создав эту папку. Мы собираемся изменить этот файл для включения дополнительной информации. Компонент com_contact автоматически загрузит эти дополнительные поля для нас и загрузит их в переменную под названием $this->params. Все, что нам нажно сделать, так это проверить, установленны ли эти данные и, если это так, то показать их.

Для показа этого поля, найдите в [файле]<tt><template>/html/com_contact/contact/default.php</tt> место, которое соответствует [месту] в котором Вы желаете показать эти дополнительные поля, и добавьте следующий код:

<source lang="php">
<?php if ($this->params->get('contact_emaillabel2', false)) : ?>
<div>
<span class="contact-additionalemail"><?php echo $this->params->get('contact_emaillabel2'); ?>:&emsp;<a href="mailto:<?php echo $this->params->get('contact_email2'); ?>"><?php echo $this->params->get('contact_email2'); ?></a><br/></span>
</div>
<?php endif; ?>
</source>

Если Вы добавите этот код и установите свой шаблон, то теперь на лицевой части Вашего веб-сайте у Вас будут показаны эти дополнительные поля.

<noinclude>
[[Category:Plugin Development/ru|Разработка плагинов]]
[[Category:Template Development/ru|Разработка шаблонов]]
[[Category:Tutorials/ru|Наставления]]
</noinclude>

Translations:Adding custom fields to core components using a plugin/15/ru

2017-09-27T04:44:14Z

Leo240:

===Включение редактирования произвольных полей с лицевой части [веб-сайта]===

J3.x:Creating a Plugin for Joomla/ru

2017-09-27T04:35:46Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похож на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

'''Совет:''' если вы добавляете атрибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

* <code>$this->params</code>: набор [[S:MyLanguage/Parameter|параметров]] для данного плагина, заданный администратором
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
'''Совет''' Для использования <code>$this->db</code> и <code>$this->app</code>, <code>JPlugin</code> проверяет, существуют ли свойства, и не закрытые ли они. Если предполагается использование объектов по умолчанию, создайте неинстанцированные свойства в классе плагина (к примеру <code>protected $db; protected $app;</code> в той же области видимости, что и <code>protected $autoloadLanguage = true;</code>). Свойства не будут существовать до тех пор, пока не будут созданы явно.

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/10/ru

2017-09-27T04:35:45Z

Leo240:

* <code>$this->params</code>: набор [[S:MyLanguage/Parameter|параметров]] для данного плагина, заданный администратором
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
'''Совет''' Для использования <code>$this->db</code> и <code>$this->app</code>, <code>JPlugin</code> проверяет, существуют ли свойства, и не закрытые ли они. Если предполагается использование объектов по умолчанию, создайте неинстанцированные свойства в классе плагина (к примеру <code>protected $db; protected $app;</code> в той же области видимости, что и <code>protected $autoloadLanguage = true;</code>). Свойства не будут существовать до тех пор, пока не будут созданы явно.

J3.x:Creating a Plugin for Joomla/ru

2017-09-27T04:24:56Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похож на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

'''Совет:''' если вы добавляете атрибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

* <code>$this->params</code>: набор [[S:MyLanguage/Parameter|параметров]] для данного плагина, заданный администратором
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
'''Совет''' Для использования <code>$this->db</code> и <code>$this->app</code>, <code>JPlugin</code> проверяет, существуют ли свойства, и не закрытые ли они. Если предполагается использование объектов по умолчанию, создайте неинстанцированные свойства в классе плагина (к примеру <code>protected $db; protected $app;</code> в той же области, что и <code>protected $autoloadLanguage = true;</code>). Свойства не будут существовать до тех пор, пока не будут созданы явно.

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/5/ru

2017-09-27T04:24:55Z

Leo240:

Как можно заметить, он похож на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

J3.x:Creating a Plugin for Joomla/ru

2017-09-26T12:54:33Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похожа на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

'''Совет:''' если вы добавляете атрибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

* <code>$this->params</code>: набор [[S:MyLanguage/Parameter|параметров]] для данного плагина, заданный администратором
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
'''Совет''' Для использования <code>$this->db</code> и <code>$this->app</code>, <code>JPlugin</code> проверяет, существуют ли свойства, и не закрытые ли они. Если предполагается использование объектов по умолчанию, создайте неинстанцированные свойства в классе плагина (к примеру <code>protected $db; protected $app;</code> в той же области, что и <code>protected $autoloadLanguage = true;</code>). Свойства не будут существовать до тех пор, пока не будут созданы явно.

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/10/ru

2017-09-26T12:54:32Z

Leo240:

* <code>$this->params</code>: набор [[S:MyLanguage/Parameter|параметров]] для данного плагина, заданный администратором
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
'''Совет''' Для использования <code>$this->db</code> и <code>$this->app</code>, <code>JPlugin</code> проверяет, существуют ли свойства, и не закрытые ли они. Если предполагается использование объектов по умолчанию, создайте неинстанцированные свойства в классе плагина (к примеру <code>protected $db; protected $app;</code> в той же области, что и <code>protected $autoloadLanguage = true;</code>). Свойства не будут существовать до тех пор, пока не будут созданы явно.

J3.x:Creating a Plugin for Joomla/ru

2017-09-26T11:42:26Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похожа на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

'''Совет:''' если вы добавляете атрибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

<div class="mw-translate-fuzzy">
* <code>$this->params</code>: the [[S:MyLanguage/Parameter|parameters]] set for this plugin by the administrator
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
</div>

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/8/ru

2017-09-26T11:42:26Z

Leo240:

'''Совет:''' если вы добавляете атрибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

J3.x:Creating a Plugin for Joomla/ru

2017-09-26T11:41:29Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похожа на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

'''Совет:''' если вы добавляете атбибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

<div class="mw-translate-fuzzy">
* <code>$this->params</code>: the [[S:MyLanguage/Parameter|parameters]] set for this plugin by the administrator
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
</div>

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/8/ru

2017-09-26T11:41:29Z

Leo240:

'''Совет:''' если вы добавляете атбибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

J3.x:Creating a Plugin for Joomla/ru

2017-09-26T11:41:06Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похожа на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

''''Совет:'''' если вы добавляете атбибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

<div class="mw-translate-fuzzy">
* <code>$this->params</code>: the [[S:MyLanguage/Parameter|parameters]] set for this plugin by the administrator
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
</div>

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/8/ru

2017-09-26T11:41:05Z

Leo240:

''''Совет:'''' если вы добавляете атбибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

Portal:Developers/ru

2017-09-26T11:35:19Z

Leo240:

<noinclude><languages /></noinclude>
{{Top portal heading|color=white-bkgd|icon=code|icon-color=#5091cd|size=5x|text-color=#333|title=
Joomla! Developers Portal}}
__TOC__
{{Portal:Developers/Intro/ru}}
{{section portal heading|icon=book|title=Приступая к работе!}}{{Portal:Developers/Resources/ru}}

==Существуют четыре типа разработки расширений==
<br />
{{section portal heading|icon=code|title=Компоненты}}
{{Portal:Component_Development/Reading_list/ru}}{{tip|Смотрите [[S:MyLanguage/Portal:Component_Development|страницу портала разработки компонентов ]].|title=Для дополнительных материалов и информации:}}
<br />
{{section portal heading|icon=plug|title=Плагины}}{{Portal:Plugin_Development/Reading_list/ru}}{{tip|Смотрите [[S:MyLanguage/Portal:Plugin_Development|страницу портала разработки плагинов]].|title=Для дополнительных материалов и информации:}}
<br />
{{section portal heading|icon=cubes|title=Модули}}{{Portal:Module_Development/Reading_list/ru}}{{tip|Смотрите "[[S:MyLanguage/Portal:Module_Development|страницу по модулям портала разработки]]".|title=Для дополнительных материалов и информации:}}
<br />
{{section portal heading|icon=desktop|title=Шаблоны}}{{Portal:Template_Development/Reading_list/ru}}{{tip|Смотрите "[[S:MyLanguage/Portal:Component_Development|страницу по шаблонам на портале разработки]]".|title=Для дополнительных материалов и информации:}}
{{-}}

==Другие темы по разработке==
<div class="large-4 column">
{{section portal heading|icon=database|title=База данных}}{{Portal:Developers/Database/ru}}
</div>
<div class="large-4 column">
{{section portal heading|icon=language|title=Локализация}}{{Portal:Developers/Localisation/ru}}
</div>
<div class="large-4 column">
{{section portal heading|icon=users|title=Темы по ACL (списку контроля доступа)}}{{Portal:Developers/Access Control/ru}}
</div>
{{-}}
<div class="large-6 column">
{{section portal heading|icon=edit|title=Формы}}{{Portal:Developers/Forms/ru}}
</div>
<div class="large-6 column">
{{section portal heading|icon=lock|title=Безопасность}}{{Portal:Developers/Security/ru}}{{tip|Смотрите [[S:MyLanguage/Security|cтраницу портала по безопасности]].|title=Для дополнительных материалов и информации:}}
</div>
{{-}}
{{section portal heading|icon=user-plus|title=Внесение своего вклада в документацию}}
{{Portal:Developers/Developer_Documentation/ru}}

__NOTOC__
<noinclude>
[[Category:Development/ru|Разработка]]
[[Category:JED/ru|JED]]
[[Category:Joomla! user profiles/ru|Профили пользователей системы Joomla!]]
</noinclude>

Translations:Portal:Developers/25/ru

2017-09-26T11:35:18Z

Leo240:

==Существуют четыре типа разработки расширений==

Portal:Developers/Developer Documentation/ru

2017-09-23T07:12:03Z

Leo240: Created page with "Если Вы обнаружите другие статьи, которые по Вашему мнению будут полезны разработчикам, пожалу..."

<noinclude><languages /></noinclude>
Разработка документации разработчиков Joomla контролируется непосредственно [[S:MyLanguage/Documentation Working Group|Рабочей группой по документации]]. На данный момент существует один дочерний проект отражающий интересы разработчиков:
* [[S:MyLanguage/JDOC:Developer_Tutorials_Project|Проект справочных руководств для разработчиков]]

Когда Вы создаете новую страницу, убедитесь,что Вы помещаете приведенный ниже маркер в нижней части страницы, чтобы она попала в список категорий:

<pre><nowiki>[[Category:Development]]</nowiki></pre>

Если Вы обнаружите другие статьи, которые по Вашему мнению будут полезны разработчикам, пожалуйста добавьте этот маркер к тем страницам

<noinclude>
[[Category:Landing subpages]]
</noinclude>

Translations:Portal:Developers/Developer Documentation/4/ru

2017-09-23T07:12:03Z

Если Вы обнаружите другие статьи, которые по Вашему мнению будут полезны разработчикам, пожалуйста добавьте этот маркер к тем страницам

Portal:Developers/Developer Documentation/ru

2017-09-23T07:10:24Z

Leo240: Created page with "Когда Вы создаете новую страницу, убедитесь,что Вы помещаете приведенный ниже маркер в нижней ч..."

<noinclude><languages /></noinclude>
Разработка документации разработчиков Joomla контролируется непосредственно [[S:MyLanguage/Documentation Working Group|Рабочей группой по документации]]. На данный момент существует один дочерний проект отражающий интересы разработчиков:
* [[S:MyLanguage/JDOC:Developer_Tutorials_Project|Проект справочных руководств для разработчиков]]

Когда Вы создаете новую страницу, убедитесь,что Вы помещаете приведенный ниже маркер в нижней части страницы, чтобы она попала в список категорий:

<pre><nowiki>[[Category:Development]]</nowiki></pre>

If you locate other articles you think are relevant to developers, please add this marker to those pages.

<noinclude>
[[Category:Landing subpages]]
</noinclude>

Translations:Portal:Developers/Developer Documentation/3/ru

2017-09-23T07:10:24Z

Когда Вы создаете новую страницу, убедитесь,что Вы помещаете приведенный ниже маркер в нижней части страницы, чтобы она попала в список категорий:

Portal:Developers/Developer Documentation/ru

2017-09-23T07:08:39Z

Leo240: Created page with "* Проект справочных руководств для разработчиков"

<noinclude><languages /></noinclude>
Разработка документации разработчиков Joomla контролируется непосредственно [[S:MyLanguage/Documentation Working Group|Рабочей группой по документации]]. На данный момент существует один дочерний проект отражающий интересы разработчиков:
* [[S:MyLanguage/JDOC:Developer_Tutorials_Project|Проект справочных руководств для разработчиков]]

When creating a new page, ensure you place the following marker at the bottom of the page so it is included in the category list:

<pre><nowiki>[[Category:Development]]</nowiki></pre>

If you locate other articles you think are relevant to developers, please add this marker to those pages.

<noinclude>
[[Category:Landing subpages]]
</noinclude>

Translations:Portal:Developers/Developer Documentation/2/ru

2017-09-23T07:08:39Z

Leo240: Created page with "* Проект справочных руководств для разработчиков"

* [[S:MyLanguage/JDOC:Developer_Tutorials_Project|Проект справочных руководств для разработчиков]]

Portal:Developers/Developer Documentation/ru

2017-09-23T07:07:35Z

Leo240: Created page with "Разработка документации разработчиков Joomla контролируется непосредственно S:MyLanguage/Documentation Workin..."

<noinclude><languages /></noinclude>
Разработка документации разработчиков Joomla контролируется непосредственно [[S:MyLanguage/Documentation Working Group|Рабочей группой по документации]]. На данный момент существует один дочерний проект отражающий интересы разработчиков:
* [[S:MyLanguage/JDOC:Developer_Tutorials_Project|Developer Tutorials Project]]

When creating a new page, ensure you place the following marker at the bottom of the page so it is included in the category list:

<pre><nowiki>[[Category:Development]]</nowiki></pre>

If you locate other articles you think are relevant to developers, please add this marker to those pages.

<noinclude>
[[Category:Landing subpages]]
</noinclude>

Translations:Portal:Developers/Developer Documentation/1/ru

2017-09-23T07:07:35Z

Разработка документации разработчиков Joomla контролируется непосредственно [[S:MyLanguage/Documentation Working Group|Рабочей группой по документации]]. На данный момент существует один дочерний проект отражающий интересы разработчиков:

Category:JED/ru

2017-09-23T06:59:42Z

Leo240: Created page with "* Каталог: http://extensions.joomla.org * Условия использования: http://extensions.joomla.org/about-jed/terms-of-service * ЧАВО каталога..."

<noinclude><languages /></noinclude>
Расширение - это пакет программного обеспечения, который каким-либо образом дополняет Вашу установку Joomla!. Небольшой набор расширений входит в установку Joomla! по умолчанию, но гораздо больше [расширений] имеется в [http://extensions.joomla.org официальном каталоге расширений "Joomla! Extensions Directory"].

* Каталог: http://extensions.joomla.org
* Условия использования: http://extensions.joomla.org/about-jed/terms-of-service
* ЧАВО каталога расширений Joomla!: [[S:MyLanguage/Joomla! Extension Directory FAQs|Joomla! Extension Directory FAQs]]
* Документация JED: http://extensions.joomla.org/support/knowledgebase
* Форум: [[jforum:262|Extensions.Joomla.org Forum]]
* Список уязвимых расширений: http://vel.joomla.org/

<noinclude>
[[Category:Top Level]]
</noinclude>

Translations:Category:JED/5/ru

2017-09-23T06:59:42Z

* Каталог: http://extensions.joomla.org
* Условия использования: http://extensions.joomla.org/about-jed/terms-of-service
* ЧАВО каталога расширений Joomla!: [[S:MyLanguage/Joomla! Extension Directory FAQs|Joomla! Extension Directory FAQs]]
* Документация JED: http://extensions.joomla.org/support/knowledgebase
* Форум: [[jforum:262|Extensions.Joomla.org Forum]]
* Список уязвимых расширений: http://vel.joomla.org/

Category:JED/ru

2017-09-23T06:55:15Z

Leo240: Created page with "Расширение - это пакет программного обеспечения, который каким-либо образом дополняет Вашу уст..."

<noinclude><languages /></noinclude>
Расширение - это пакет программного обеспечения, который каким-либо образом дополняет Вашу установку Joomla!. Небольшой набор расширений входит в установку Joomla! по умолчанию, но гораздо больше [расширений] имеется в [http://extensions.joomla.org официальном каталоге расширений "Joomla! Extensions Directory"].

* Directory: http://extensions.joomla.org
* Terms of Service: http://extensions.joomla.org/about-jed/terms-of-service
* Joomla! Extension Directory FAQs: [[S:MyLanguage/Joomla! Extension Directory FAQs|Joomla! Extension Directory FAQs]]
* JED documentation: http://extensions.joomla.org/support/knowledgebase
* Forum: [[jforum:262|Extensions.Joomla.org Forum]]
* Vulnerable Extensions List: http://vel.joomla.org/

<noinclude>
[[Category:Top Level]]
</noinclude>

Translations:Category:JED/4/ru

2017-09-23T06:55:15Z

Расширение - это пакет программного обеспечения, который каким-либо образом дополняет Вашу установку Joomla!. Небольшой набор расширений входит в установку Joomla! по умолчанию, но гораздо больше [расширений] имеется в [http://extensions.joomla.org официальном каталоге расширений "Joomla! Extensions Directory"].

J3.x:Creating a Plugin for Joomla/ru

2017-09-19T04:16:01Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похожа на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

Совет: если вы добавляете атбибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

<div class="mw-translate-fuzzy">
* <code>$this->params</code>: the [[S:MyLanguage/Parameter|parameters]] set for this plugin by the administrator
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
</div>

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/12/ru

2017-09-19T04:16:01Z

Leo240:

=== Использование плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать в своем коде. Но делать это необязательно, ядро Joomla! имеет набор встроенных событий, которые вы можете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

J3.x:Creating a Plugin for Joomla/ru

2017-09-19T03:43:47Z

Leo240:

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.x|comment=серия}}</noinclude>
Система плагинов в Joomla! 1.5 была очень мощной и гибкой. Плагины можно использовать не только для обработки событий, вызванных ядром приложения и его расширениями, но и для того, чтобы сделать сторонние дополнения более мощными и расширяемыми. Изменения в Joomla! 2.5/3.x в отличие от 1.5 в основном касаются имен событий.

В этом руководстве описаны основы разработки своего плагина. Большинство плагинов состоит из одного файла с кодом, но для правильной установки он должен быть упакован в установочный файл, который будет обработан установщиком Joomla!.

=== Создание установочного файла ===
Как и любые расширения для Joomla, плагины легко устанавливаются в виде .zip файлов (.tar.gz тоже поддерживается), но архив должен содержать правильно составленный XML файл. Вот пример XML файла для плагина поиска по категориям.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="search">
<name>plg_search_categories</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>Copyright (C) 2005 - 2013 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>3.1.0</version>
<description>PLG_SEARCH_CATEGORIES_XML_DESCRIPTION</description>
<files>
<filename plugin="categories">categories.php</filename>
<filename>index.html</filename>
</files>
<languages>
<language tag="en-GB">en-GB.plg_search_categories.ini</language>
<language tag="en-GB">en-GB.plg_search_categories.sys.ini</language>
</languages>
<config>
<fields name="params">

<fieldset name="basic">
<field name="search_limit" type="text"
default="50"
description="JFIELD_PLG_SEARCH_SEARCHLIMIT_DESC"
label="JFIELD_PLG_SEARCH_SEARCHLIMIT_LABEL"
size="5"
/>

<field name="search_content" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ALL_DESC"
label="JFIELD_PLG_SEARCH_ALL_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>

<field name="search_archived" type="radio"
default="0"
description="JFIELD_PLG_SEARCH_ARCHIVED_DESC"
label="JFIELD_PLG_SEARCH_ARCHIVED_LABEL"
>
<option value="0">JOFF</option>
<option value="1">JON</option>
</field>
</fieldset>

</fields>
</config>
</extension>
</source>

Как можно заметить, он похожа на другие инсталляционные XML файлы для Joomla!. Нужно только обратить внимание на запись <code>group="xxx"</code> в разделе <code><extension></code>, а также на дополнительную информацию в разделе <code><filename></code> . Эта информация сообщает Joomla!, в какую папку копировать файл и в какую группу будет добавлен плагин.

Если вы создаете плагин, который реагирует на существующие события ядра, атрибут <code>group="xxx"</code> должен быть изменен в соответствии с именем уже существующей папки для события, которое вы хотите использовать. Например, <code>group="authentication"</code> or <code>group="user"</code>. Смотрите [[S:MyLanguage/Plugin/Events|Plugin/Events]] полный список существующих категорий событий. При создании нового плагина важно, чтобы его название было уникальным, и чтобы он не конфликтовал с уже существующими плагинами, которые могут реагировать на то же событие, какое используете вы.

Если вы создаете плагин реагировать на неосновные системные события вашего выбора для <code>группы="ХХХ"</code> тег должен отличаться от любого из существующих базовых категорий.

Совет: если вы добавляете атбибут <code>method="upgrade" </code> к тэгу <code>extension</code>, то плагин можно будет устанавливать без удаления предыдущей версии. Все существующие файлы будут перезаписаны, но оставшиеся файлы удалены не будут..

=== Создание плагинов ===
Объектно-ориентированный подход к написанию плагинов включает в себя создание подклассов от [http://api.joomla.org/Joomla-Platform/Plugin/JPlugin.html JPlugin], базового класса, реализующего основные свойства плагинов. Для ваших методов доступны следующие свойства:

<div class="mw-translate-fuzzy">
* <code>$this->params</code>: the [[S:MyLanguage/Parameter|parameters]] set for this plugin by the administrator
* <code>$this->_name</code>: имя плагина
* <code>$this->_type</code>: группа (тип) плагина
* <code>$this->db</code>: объект базы данных (since {{JVer|3.1}})
* <code>$this->app</code>: объект приложения (since {{JVer|3.1}})
</div>

В следующем примере <code><PluginGroup></code> представляет группу (тип) плагина, а <code><PluginName></code> его название. Обратите внимание, что имена класса и функции в PHP не чувствительны к регистру.

<source lang="php">
<?php
// no direct access
defined( '_JEXEC' ) or die;

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Load the language file on instantiation. Note this is only available in Joomla 3.1 and higher.
* If you want to support 3.0 series you must override the constructor
*
* @var boolean
* @since 3.1
*/
protected $autoloadLanguage = true;

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
/*
* Plugin code goes here.
* You can access database and application objects and parameters via $this->db,
* $this->app and $this->params respectively
*/
return true;
}
}
?>
</source>

=== Использования плагинов в коде ===
Теперь, когда вы создали свой плагин, то вам наверняка захочется его вызвать. Но необязательно, ядро Joomla! имеет набор встроенных событий, которые вы пожете использовать для запуска плагина. Тогда нижеописанное делать не нужно:

Чтобы запустить событие, используйте следующий код:

<source lang="php">
$dispatcher = JDispatcher::getInstance();
$results = $dispatcher->trigger( '<EventName>', <ParameterArray> );
</source>

Важно отметить, что параметры должны передаваться в массиве. Функция же в плагине будет получить параметры как отдельные значения. Возвращаемое значение будет состоять из массив возвращаемых значений из разных плагинов (поэтому он также может содержать многоуровневые массивы). Возвращаться будет массив значений из разных плагинов (этот массив может быть многоуровневым).

Если вы создаете плагин для нового события, а не для встроенного события ядра. то не забудьте активировать плагин после установки. Перед ссылкой на ваш новый плагин должна стоять команда <code>JPluginHelper::importPlugin()</code>.

<noinclude>
[[Category:Tutorials]]
[[Category:Plugin Development]]
</noinclude>

Translations:J3.x:Creating a Plugin for Joomla/Page display title/ru

2017-09-19T03:43:46Z

Leo240:

Создание плагина для Joomla

J3.x:Creating a simple module/Adding Form Fields/ru

2017-03-14T10:30:13Z

Leo240: Created page with "== Добавление полей формы к модулю =="

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Поля формы дают много возможностей по настройке в Joomla и для модулей являются единственным способом, позволяющим пользователю настроить их для нужд своего сайта.

== Добавление полей формы к модулю ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[S:MyLanguage/SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$hello = modHelloWorldHelper::getHello( $language );
</source>

Now lets edit our database query in the helper file to reflect our parameter choice.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. $db->Quote($params));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Using_the_Database|Prev: Using the Database|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Auto_Update|Next: Adding Auto Update|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials]]
[[Category:Tutorials in a Series]]
[[Category:Module Development]]
[[Category:Beginner Development]]
[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.0]]
[[Category:Joomla! 3.1]]
[[Category:Joomla! 3.2]]
[[Category:Joomla! 3.3]]
[[Category:Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Adding Form Fields/3/ru

2017-03-14T10:30:13Z

Leo240: Created page with "== Добавление полей формы к модулю =="

== Добавление полей формы к модулю ==

J3.x:Creating a simple module/Adding Form Fields/ru

2017-03-14T10:29:34Z

Leo240: Created page with "Поля формы дают много возможностей по настройке в Joomla и для модулей являются единственным спос..."

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Поля формы дают много возможностей по настройке в Joomla и для модулей являются единственным способом, позволяющим пользователю настроить их для нужд своего сайта.

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[S:MyLanguage/SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$hello = modHelloWorldHelper::getHello( $language );
</source>

Now lets edit our database query in the helper file to reflect our parameter choice.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. $db->Quote($params));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Using_the_Database|Prev: Using the Database|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Auto_Update|Next: Adding Auto Update|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials]]
[[Category:Tutorials in a Series]]
[[Category:Module Development]]
[[Category:Beginner Development]]
[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.0]]
[[Category:Joomla! 3.1]]
[[Category:Joomla! 3.2]]
[[Category:Joomla! 3.3]]
[[Category:Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Adding Form Fields/2/ru

2017-03-14T10:29:33Z

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

J3.x:Creating a simple module/Adding Form Fields/ru

2017-03-14T10:23:44Z

Leo240: Created page with "ru"

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Form fields give a great deal of customisation in Joomla and for modules are the sole way of allowing the user to tweak the module to the needs of their site.

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[S:MyLanguage/SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$hello = modHelloWorldHelper::getHello( $language );
</source>

Now lets edit our database query in the helper file to reflect our parameter choice.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. $db->Quote($params));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Using_the_Database|Prev: Using the Database|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Auto_Update|Next: Adding Auto Update|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials]]
[[Category:Tutorials in a Series]]
[[Category:Module Development]]
[[Category:Beginner Development]]
[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.0]]
[[Category:Joomla! 3.1]]
[[Category:Joomla! 3.2]]
[[Category:Joomla! 3.3]]
[[Category:Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Adding Form Fields/1/ru

2017-03-14T10:23:44Z

Leo240: Created page with "ru"

J3.x:Creating a simple module/Adding Form Fields/ru

2017-03-14T10:23:07Z

Leo240: Created page with "Добавление полей формы"

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/en}}
Form fields give a great deal of customisation in Joomla and for modules are the sole way of allowing the user to tweak the module to the needs of their site.

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[S:MyLanguage/SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$hello = modHelloWorldHelper::getHello( $language );
</source>

Now lets edit our database query in the helper file to reflect our parameter choice.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. $db->Quote($params));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Using_the_Database|Prev: Using the Database|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Auto_Update|Next: Adding Auto Update|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials]]
[[Category:Tutorials in a Series]]
[[Category:Module Development]]
[[Category:Beginner Development]]
[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.0]]
[[Category:Joomla! 3.1]]
[[Category:Joomla! 3.2]]
[[Category:Joomla! 3.3]]
[[Category:Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Adding Form Fields/Page display title/ru

2017-03-14T10:23:07Z

Leo240: Created page with "Добавление полей формы"

Добавление полей формы

J3.x:Creating a simple module/Using the Database/ru

2017-03-14T10:20:18Z

Leo240:

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Многие модули в Joomla требуют использования базы данных. В этом учебнике предполагается, что вы уже понимаете основы использования класса JDatabase. В противном случае, обратитесь к документации на [[S:MyLanguage/Accessing_the_database_using_JDatabase/3.1|доступ к базе данных, с использованием JDatabase]], прежде чем продолжить этот урок.

== Создание таблицы при установке ==
Чтобы создать XML-таблицу при установке мы собираемся добавить следующие строки в <tt>''mod_helloworld.xml''</tt>:

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/install.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/install.sqlazure.utf8.sql</file>
</sql>
</install>

<uninstall>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/uninstall.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/uninstall.sqlazure.utf8.sql</file>
</sql>
</uninstall>

<update>
<schemas>
<schemapath type="mysql">sql/mysql/updates</schemapath>
<schemapath type="sqlazure">sql/sqlazure/updates</schemapath>
</schemas>
</update>
</source>

В этом коде есть 3 секции:
*Тег "install" добавляет таблицу базы данных.
*Тег "uninstall" удаляет таблицу базы данных, если модуль удаляется. Обратите внимание, что не все модули захотят использовать эту функцию (и это не обязательно).
*Тег "update" будет обновлять базы данных, если база данных должна быть изменена при обновлении модуля.

Далее следует указать тег "folder" в разделе "files", чтобы гарантировать, что SQL-файлы скопированы с установочного zip-архива:

<source lang="xml">
<folder>sql</folder>
</source>

Обратите внимание, что у нас есть схемы и для MySQL и для Microsoft SQL - опять же вы можете выбрать, будете ли вы адаптировать свой модуль для одной из этих систем или же для обеих .

В этом примере мы просто покажем пример файлов для базы данных MySQL. Создание файлов для Microsoft SQL Server будет оставлено в качестве упражнения для самостоятельной тренировки читателя.

В нашем файле <tt>install.mysql.utf8.sql</tt> мы создадим таблицу и поместим некоторые приветствия в нее.

<source lang="sql">
CREATE TABLE IF NOT EXISTS `#__helloworld` (
`id` int(10) NOT NULL AUTO_INCREMENT,
`hello` text NOT NULL,
`lang` varchar(25) NOT NULL,

PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hello World', 'en-GB');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hola Mundo', 'es-ES');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Bonjour tout le monde', 'fr-FR');
</source>

В файле uninstall мы просто удалим таблицу.

<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`
</source>

Finally we'll just leave a placeholder in the updates file. There is an SQL file for each component version. Each file name must match the version string in the manifest file for that version. Joomla uses this string to determine which SQL files(s) to execute, and in what order they will be executed.

''Важное Замечание:'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика - иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

<source lang="sql">
# Placeholder file for database changes for version 1.0.0
</source>

== Создание запроса в файле хелпера ==
При установке нашего модуля мы должны заметить, что теперь у нас есть таблица helloworld в нашей базе данных с нашими приветствиями в ней. Теперь мы должны извлечь это из базы данных для отображения пользователю. Сейчас мы будем вносить изменения в функцию "getHello", которую мы разместили в файле хелпера в последней части.

Пока что мы будем не будем рассматривать использование полей формы для выбора приветствия и просто получим английскую версию.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('lang = ' . $db->Quote('en-GB'));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Заключение ==
Используя модули с подключениями к базе данных для Joomla! это довольно простой и понятный процесс. С помощью методов, описанных в этом руководстве, очень многие модули могут быть разработаны без особых хлопот, с обновлениями простыми для управления.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Developing_a_Basic_Module|Назад: Разработка базового модуля|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Form_Fields|Далее: Добавление полей формы|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials/ru|Урок]]
[[Category:Tutorials in a Series/ru|Уроки в этой серии]]
[[Category:Module Development/ru|Разработка модуля]]
[[Category:Beginner Development/ru|Разработка для начинающих]]
[[Category:Joomla! 3.x/ru|Joomla! 3.x]]
[[Category:Joomla! 3.0/ru|Joomla! 3.0]]
[[Category:Joomla! 3.1/ru|Joomla! 3.1]]
[[Category:Joomla! 3.2/ru|Joomla! 3.2]]
[[Category:Joomla! 3.3/ru|Joomla! 3.3]]
[[Category:Joomla! 3.4/ru|Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Using the Database/13/ru

2017-03-14T10:20:17Z

Leo240:

''Важное Замечание:'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика - иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

J3.x:Creating a simple module/Using the Database/ru

2017-03-14T10:18:15Z

Leo240:

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Многие модули в Joomla требуют использования базы данных. В этом учебнике предполагается, что вы уже понимаете основы использования класса JDatabase. В противном случае, обратитесь к документации на [[S:MyLanguage/Accessing_the_database_using_JDatabase/3.1|доступ к базе данных, с использованием JDatabase]], прежде чем продолжить этот урок.

== Создание таблицы при установке ==
Чтобы создать XML-таблицу при установке мы собираемся добавить следующие строки в <tt>''mod_helloworld.xml''</tt>:

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/install.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/install.sqlazure.utf8.sql</file>
</sql>
</install>

<uninstall>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/uninstall.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/uninstall.sqlazure.utf8.sql</file>
</sql>
</uninstall>

<update>
<schemas>
<schemapath type="mysql">sql/mysql/updates</schemapath>
<schemapath type="sqlazure">sql/sqlazure/updates</schemapath>
</schemas>
</update>
</source>

В этом коде есть 3 секции:
*Тег "install" добавляет таблицу базы данных.
*Тег "uninstall" удаляет таблицу базы данных, если модуль удаляется. Обратите внимание, что не все модули захотят использовать эту функцию (и это не обязательно).
*Тег "update" будет обновлять базы данных, если база данных должна быть изменена при обновлении модуля.

Далее следует указать тег "folder" в разделе "files", чтобы гарантировать, что SQL-файлы скопированы с установочного zip-архива:

<source lang="xml">
<folder>sql</folder>
</source>

Обратите внимание, что у нас есть схемы и для MySQL и для Microsoft SQL - опять же вы можете выбрать, будете ли вы адаптировать свой модуль для одной из этих систем или же для обеих .

В этом примере мы просто покажем пример файлов для базы данных MySQL. Создание файлов для Microsoft SQL Server будет оставлено в качестве упражнения для самостоятельной тренировки читателя.

В нашем файле <tt>install.mysql.utf8.sql</tt> мы создадим таблицу и поместим некоторые приветствия в нее.

<source lang="sql">
CREATE TABLE IF NOT EXISTS `#__helloworld` (
`id` int(10) NOT NULL AUTO_INCREMENT,
`hello` text NOT NULL,
`lang` varchar(25) NOT NULL,

PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hello World', 'en-GB');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hola Mundo', 'es-ES');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Bonjour tout le monde', 'fr-FR');
</source>

В файле uninstall мы просто удалим таблицу.

<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`
</source>

Finally we'll just leave a placeholder in the updates file. There is an SQL file for each component version. Each file name must match the version string in the manifest file for that version. Joomla uses this string to determine which SQL files(s) to execute, and in what order they will be executed.

''Важное Замечание:'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если нет файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика, чтобы иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

<source lang="sql">
# Placeholder file for database changes for version 1.0.0
</source>

== Создание запроса в файле хелпера ==
При установке нашего модуля мы должны заметить, что теперь у нас есть таблица helloworld в нашей базе данных с нашими приветствиями в ней. Теперь мы должны извлечь это из базы данных для отображения пользователю. Сейчас мы будем вносить изменения в функцию "getHello", которую мы разместили в файле хелпера в последней части.

Пока что мы будем не будем рассматривать использование полей формы для выбора приветствия и просто получим английскую версию.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('lang = ' . $db->Quote('en-GB'));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Заключение ==
Используя модули с подключениями к базе данных для Joomla! это довольно простой и понятный процесс. С помощью методов, описанных в этом руководстве, очень многие модули могут быть разработаны без особых хлопот, с обновлениями простыми для управления.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Developing_a_Basic_Module|Назад: Разработка базового модуля|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Form_Fields|Далее: Добавление полей формы|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials/ru|Урок]]
[[Category:Tutorials in a Series/ru|Уроки в этой серии]]
[[Category:Module Development/ru|Разработка модуля]]
[[Category:Beginner Development/ru|Разработка для начинающих]]
[[Category:Joomla! 3.x/ru|Joomla! 3.x]]
[[Category:Joomla! 3.0/ru|Joomla! 3.0]]
[[Category:Joomla! 3.1/ru|Joomla! 3.1]]
[[Category:Joomla! 3.2/ru|Joomla! 3.2]]
[[Category:Joomla! 3.3/ru|Joomla! 3.3]]
[[Category:Joomla! 3.4/ru|Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Using the Database/13/ru

2017-03-14T10:18:14Z

Leo240:

''Важное Замечание:'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если нет файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика, чтобы иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

J3.x:Creating a simple module/Using the Database/ru

2017-03-14T10:16:03Z

Leo240:

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Многие модули в Joomla требуют использования базы данных. В этом учебнике предполагается, что вы уже понимаете основы использования класса JDatabase. В противном случае, обратитесь к документации на [[S:MyLanguage/Accessing_the_database_using_JDatabase/3.1|доступ к базе данных, с использованием JDatabase]], прежде чем продолжить этот урок.

== Создание таблицы при установке ==
Чтобы создать XML-таблицу при установке мы собираемся добавить следующие строки в <tt>''mod_helloworld.xml''</tt>:

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/install.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/install.sqlazure.utf8.sql</file>
</sql>
</install>

<uninstall>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/uninstall.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/uninstall.sqlazure.utf8.sql</file>
</sql>
</uninstall>

<update>
<schemas>
<schemapath type="mysql">sql/mysql/updates</schemapath>
<schemapath type="sqlazure">sql/sqlazure/updates</schemapath>
</schemas>
</update>
</source>

В этом коде есть 3 секции:
*Тег "install" добавляет таблицу базы данных.
*Тег "uninstall" удаляет таблицу базы данных, если модуль удаляется. Обратите внимание, что не все модули захотят использовать эту функцию (и это не обязательно).
*Тег "update" будет обновлять базы данных, если база данных должна быть изменена при обновлении модуля.

Далее следует указать тег "folder" в разделе "files", чтобы гарантировать, что SQL-файлы скопированы с установочного zip-архива:

<source lang="xml">
<folder>sql</folder>
</source>

Обратите внимание, что у нас есть схемы и для MySQL и для Microsoft SQL - опять же вы можете выбрать, будете ли вы адаптировать свой модуль для одной из этих систем или же для обеих .

В этом примере мы просто покажем пример файлов для базы данных MySQL. Создание файлов для Microsoft SQL Server будет оставлено в качестве упражнения для самостоятельной тренировки читателя.

В нашем файле <tt>install.mysql.utf8.sql</tt> мы создадим таблицу и поместим некоторые приветствия в нее.

<source lang="sql">
CREATE TABLE IF NOT EXISTS `#__helloworld` (
`id` int(10) NOT NULL AUTO_INCREMENT,
`hello` text NOT NULL,
`lang` varchar(25) NOT NULL,

PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hello World', 'en-GB');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hola Mundo', 'es-ES');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Bonjour tout le monde', 'fr-FR');
</source>

В файле uninstall мы просто удалим таблицу.

<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`
</source>

Finally we'll just leave a placeholder in the updates file. There is an SQL file for each component version. Each file name must match the version string in the manifest file for that version. Joomla uses this string to determine which SQL files(s) to execute, and in what order they will be executed.

''Important Note:|Важное Замечание'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если нет файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика, чтобы иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

<source lang="sql">
# Placeholder file for database changes for version 1.0.0
</source>

== Создание запроса в файле хелпера ==
При установке нашего модуля мы должны заметить, что теперь у нас есть таблица helloworld в нашей базе данных с нашими приветствиями в ней. Теперь мы должны извлечь это из базы данных для отображения пользователю. Сейчас мы будем вносить изменения в функцию "getHello", которую мы разместили в файле хелпера в последней части.

Пока что мы будем не будем рассматривать использование полей формы для выбора приветствия и просто получим английскую версию.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('lang = ' . $db->Quote('en-GB'));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Заключение ==
Используя модули с подключениями к базе данных для Joomla! это довольно простой и понятный процесс. С помощью методов, описанных в этом руководстве, очень многие модули могут быть разработаны без особых хлопот, с обновлениями простыми для управления.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Developing_a_Basic_Module|Назад: Разработка базового модуля|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Form_Fields|Далее: Добавление полей формы|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials/ru|Урок]]
[[Category:Tutorials in a Series/ru|Уроки в этой серии]]
[[Category:Module Development/ru|Разработка модуля]]
[[Category:Beginner Development/ru|Разработка для начинающих]]
[[Category:Joomla! 3.x/ru|Joomla! 3.x]]
[[Category:Joomla! 3.0/ru|Joomla! 3.0]]
[[Category:Joomla! 3.1/ru|Joomla! 3.1]]
[[Category:Joomla! 3.2/ru|Joomla! 3.2]]
[[Category:Joomla! 3.3/ru|Joomla! 3.3]]
[[Category:Joomla! 3.4/ru|Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Using the Database/13/ru

2017-03-14T10:16:02Z

Leo240:

''Important Note:|Важное Замечание'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если нет файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика, чтобы иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

J3.x:Creating a simple module/Using the Database/ru

2017-03-14T10:03:16Z

Leo240:

<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
Многие модули в Joomla требуют использования базы данных. В этом учебнике предполагается, что вы уже понимаете основы использования класса JDatabase. В противном случае, обратитесь к документации на [[S:MyLanguage/Accessing_the_database_using_JDatabase/3.1|доступ к базе данных, с использованием JDatabase]], прежде чем продолжить этот урок.

== Создание таблицы при установке ==
Чтобы создать XML-таблицу при установке мы собираемся добавить следующие строки в <tt>''mod_helloworld.xml''</tt>:

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/install.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/install.sqlazure.utf8.sql</file>
</sql>
</install>

<uninstall>
<sql>
<file driver="mysql" charset="utf8">sql/mysql/uninstall.mysql.utf8.sql</file>
<file driver="sqlazure" charset="utf8">sql/sqlazure/uninstall.sqlazure.utf8.sql</file>
</sql>
</uninstall>

<update>
<schemas>
<schemapath type="mysql">sql/mysql/updates</schemapath>
<schemapath type="sqlazure">sql/sqlazure/updates</schemapath>
</schemas>
</update>
</source>

В этом коде есть 3 секции:
*Тег "install" добавляет таблицу базы данных.
*Тег "uninstall" удаляет таблицу базы данных, если модуль удаляется. Обратите внимание, что не все модули захотят использовать эту функцию (и это не обязательно).
*Тег "update" будет обновлять базы данных, если база данных должна быть изменена при обновлении модуля.

Далее следует указать тег "folder" в разделе "files", чтобы гарантировать, что SQL-файлы скопированы с установочного zip-архива:

<source lang="xml">
<folder>sql</folder>
</source>

Обратите внимание, что у нас есть схемы и для MySQL и для Microsoft SQL - опять же вы можете выбрать, будете ли вы адаптировать свой модуль для одной из этих систем или же для обеих .

В этом примере мы просто покажем пример файлов для базы данных MySQL. Создание файлов для Microsoft SQL Server будет оставлено в качестве упражнения для самостоятельной тренировки читателя.

В нашем файле <tt>install.mysql.utf8.sql</tt> мы создадим таблицу и поместим некоторые приветствия в нее.

<source lang="sql">
CREATE TABLE IF NOT EXISTS `#__helloworld` (
`id` int(10) NOT NULL AUTO_INCREMENT,
`hello` text NOT NULL,
`lang` varchar(25) NOT NULL,

PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hello World', 'en-GB');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hola Mundo', 'es-ES');
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Bonjour tout le monde', 'fr-FR');
</source>

В файле uninstall мы просто удалим таблицу.

<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`
</source>

Finally we'll just leave a placeholder in the updates file. There is an SQL file for each component version. Each file name must match the version string in the manifest file for that version. Joomla uses this string to determine which SQL files(s) to execute, and in what order they will be executed.

''Important Note:'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если нет файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика, чтобы иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.

<source lang="sql">
# Placeholder file for database changes for version 1.0.0
</source>

== Создание запроса в файле хелпера ==
При установке нашего модуля мы должны заметить, что теперь у нас есть таблица helloworld в нашей базе данных с нашими приветствиями в ней. Теперь мы должны извлечь это из базы данных для отображения пользователю. Сейчас мы будем вносить изменения в функцию "getHello", которую мы разместили в файле хелпера в последней части.

Пока что мы будем не будем рассматривать использование полей формы для выбора приветствия и просто получим английскую версию.

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('lang = ' . $db->Quote('en-GB'));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello
return $result;
</source>

== Заключение ==
Используя модули с подключениями к базе данных для Joomla! это довольно простой и понятный процесс. С помощью методов, описанных в этом руководстве, очень многие модули могут быть разработаны без особых хлопот, с обновлениями простыми для управления.

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Developing_a_Basic_Module|Назад: Разработка базового модуля|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Creating_a_simple_module/Adding_Form_Fields|Далее: Добавление полей формы|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Tutorials/ru|Урок]]
[[Category:Tutorials in a Series/ru|Уроки в этой серии]]
[[Category:Module Development/ru|Разработка модуля]]
[[Category:Beginner Development/ru|Разработка для начинающих]]
[[Category:Joomla! 3.x/ru|Joomla! 3.x]]
[[Category:Joomla! 3.0/ru|Joomla! 3.0]]
[[Category:Joomla! 3.1/ru|Joomla! 3.1]]
[[Category:Joomla! 3.2/ru|Joomla! 3.2]]
[[Category:Joomla! 3.3/ru|Joomla! 3.3]]
[[Category:Joomla! 3.4/ru|Joomla! 3.4]]
</noinclude>

Translations:J3.x:Creating a simple module/Using the Database/13/ru

2017-03-14T10:03:16Z

Leo240:

''Important Note:'' эти файлы также используются, чтобы установить номер версии в таблице #__schemas. Этот номер версии должен присутствовать в текущей версии компонента для того, чтобы новые файлы SQL были запущены во время обновления. Например, если у вас версия 1.0 и вы обновляетесь до версии 1.1, файл 1.1.sql не будет выполнен, если нет файла 1.0.sql нет в релизе 1.0. По этой причине, это хорошая практика, чтобы иметь файл обновления SQL для каждой версии, даже если нет изменений SQL в этой версии.