Mad grant в 13:07, 5 июня 2013

2013-06-05T13:07:40Z

Mad grant в 13:07, 5 июня 2013

2013-06-05T13:07:24Z

VITL': Новая страница: «В данной статье мы приведем пример административного шаблона, для модуля, который опериру…»

2011-07-27T20:36:01Z

Новая страница: «В данной статье мы приведем пример административного шаблона, для модуля, который опериру…»

Новая страница

В данной статье мы приведем пример административного шаблона, для модуля, который оперирует объектами, не страницами. К объектам относятся пользователи, баннеры, скидки и т.п. Практически для каждого модуля должен быть определен шаблон '''list.view.xsl''', который отвечает за отображение данных в виде списка в административной части. В случае, если системное название вашего кастомного модуля '''cache''', то в папку '''\styles\skins\mac\data\modules\cache\''' необходимо добавить файл '''list.view.xsl''', примерно следующего содержания:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xsl:stylesheet SYSTEM "ulang://cache" [
<!ENTITY sys-module 'cache'>
]>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

<xsl:template match="data[@type = 'list' and @action = 'view']">
<div class="imgButtonWrapper">
<xsl:choose>
<xsl:when test="$method = 'udata_lists'">
<a id="addAddress" href="{$lang-prefix}/admin/&sys-module;/add_udata/">&label-add-udata;</a>
</xsl:when>
<xsl:when test="$method = 'upage_lists'">
<a id="addAddress" href="{$lang-prefix}/admin/&sys-module;/add_upage/">&label-add-upage;</a>
</xsl:when>
<xsl:otherwise />
</xsl:choose>
</div>

<xsl:call-template name="ui-smc-table">
<xsl:with-param name="control-params" select="$method" />
<xsl:with-param name="content-type">objects</xsl:with-param>
<xsl:with-param name="enable-objects-activity">1</xsl:with-param>
<xsl:with-param name="domains-show">1</xsl:with-param>
<xsl:with-param name="search-show">0</xsl:with-param>
<xsl:with-param name="disable-csv-buttons">1</xsl:with-param>
</xsl:call-template>

</xsl:template>

</xsl:stylesheet>
</source>

Строки:
<source lang="xml">
<!DOCTYPE xsl:stylesheet SYSTEM "ulang://cache" [
<!ENTITY sys-module 'cache'>
]>
</source>

отвечают за подключение дополнительных XSLT сущностей. Данный вызов '''ulang://cache''', в котором использует протокол '''upage''', сформирует список сущностей из файла '''\classes\modules\cache\i18n.php''', если не был найден фал с текущим языковым префиксом: i18n.ru.php, i18n.en.php, i18n.fr.php и т.п..
Просмотреть весь список полученных сущностей модуля cache можно вызовом:
<pre>
http://ваш_домен/ulang/cache
</pre>

Данные условия узла data:
<source lang="xml">
<xsl:template match="data[@type = 'list' and @action = 'view']">
...
<xsl:template>
</source>

выбраны из-за того, что в php-методе, который осуществляет выборку из базы данных нужных объектов, прописано:
<source lang="php">
$this->setDataType("list");
$this->setActionType("view");
</source>

в данном примере используется метод '''udata_lists''', файла '''\classes\modules\cache\__admin.php''', сам пример метода:
<source lang="php">
public function udata_lists() {
$this->setDataType("list");
$this->setActionType("view");
if($this->ifNotXmlMode()) return $this->doData();

$limit = 20;
$curr_page = getRequest('p');
$offset = $limit * $curr_page;

$sel = new selector('objects');
$sel->types('object-type')->name('cache', 'udata');
$sel->order('name')->asc();
$sel->limit($offset, $limit);
selectorHelper::detectFilters($sel);

$domains = getRequest('domain_id');
if(is_array($domains) && sizeof($domains)) {
$domainsCollection = domainsCollection::getInstance();
if(sizeof($domainsCollection->getList()) > 1) {
$sel->where('domain_id')->equals($domains[0]);
}
}

$this->setDataRange($limit, $offset);
$data = $this->prepareData($sel->result, "objects");
$this->setData($data, $sel->length);
return $this->doData();
}
</source>

Вернемся к шаблону xsl:template. Блок:

<source lang="xml">
<div class="imgButtonWrapper">
...
<div>
</source>

отвечает за отображение кнопок, которые активирует переход на страницу добавления объекта. Переменная '''method''' определена в основном шаблоне '''\styles\skins\mac\main.xsl''':
<source lang="xml">
<xsl:variable name="method" select="/result/@method"/>
</source>

'''&label-add-udata;''' и '''&label-add-upage;''' - сущности сформированные из файла '''\classes\modules\cache\i18n.php''', они были подключены запросом "'''ulang://cache'''"

Именованный вызов шаблона:
<source lang="xml">
<xsl:call-template name="ui-smc-table">
...
</xsl:call-template>
</source>

отвечает за формирование списка данных. Сам шаблон обработчик с '''name="ui-smc-table"''' находится в файле '''\styles\skins\mac\interface\ui\controls.xsl'''

В шаблон '''ui-smc-table''' мы передаем различные параметры, рассмотрим каждый из них.

'''control-params''' – название текущего метода, которое будет передано в метод '''getDatasetConfiguration()''', файл '''\classes\modules\cache\admin.php''', будет выполнен подобный ajax запрос:
<pre>
http://ваш_домен/admin/cache/udata_lists.xml?domain_id[]=1&lang_id[]=1
</pre>

для подгрузки необходимых данных в xml-формате.
О методе getDatasetConfiguration более подробно рассказано в данной статье [[Назначение метода getDatasetConfiguration в модуле системы]]

В итоге, параметр '''control-params''' достаточно важный, поэтому необходимо понимать его назначение при создании дополнительного модуля.

'''content-type''' – данный параметр со значением = '''objects''', указывает на то, что данные необходимо визуально отобразить по правилам Объектов. Если данный параметр не передать, система будет считать что вы работает со страницами (pages) и выведет контролы для отображения родительских и дочерних страниц.

'''enable-objects-activity''' – данный параметр включает отображение в контролах управления такую функцию как значок смены активности объекта. Сам метод для смены активности также должен присутствовать в модуле, как и поле '''is_active''' в объекте у которого меняется активность.

'''domains-show''' – этот параметр включает отображение выпадающего списка с доменами, в случае если их больше одного. По умолчанию, этот выпадающий список отображается только для Страниц.

'''search-show''' – указав значение для этого параметра =0, мы отключили форму поиска данных в модуле. По умолчанию форма поиска отображается.

'''disable-csv-buttons''' – данный параметр скрывает функции экспорта и импорта данных в формате CSV, которые располагаются под списком объектов.

← Предыдущая		Версия 13:07, 5 июня 2013
Строка 141:		Строка 141:

	'''disable-csv-buttons''' – данный параметр скрывает функции экспорта и импорта данных в формате CSV, которые располагаются под списком объектов.		'''disable-csv-buttons''' – данный параметр скрывает функции экспорта и импорта данных в формате CSV, которые располагаются под списком объектов.
−	[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]	+	[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория: API]]

← Предыдущая		Версия 13:07, 5 июня 2013
Строка 141:		Строка 141:

	'''disable-csv-buttons''' – данный параметр скрывает функции экспорта и импорта данных в формате CSV, которые располагаются под списком объектов.		'''disable-csv-buttons''' – данный параметр скрывает функции экспорта и импорта данных в формате CSV, которые располагаются под списком объектов.
		+	[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Пример административного шаблона для объектов - История изменений

Mad grant в 13:07, 5 июня 2013

Mad grant в 13:07, 5 июня 2013

VITL': Новая страница: «В данной статье мы приведем пример административного шаблона, для модуля, который опериру…»