Umicms - Вклад участника [ru]

Массовое удаление заказов из административной панели

2016-08-29T13:18:04Z

Alexei:

'''Актуально для версии 2.14'''

Если в административной панели, в модуле "Интернет-магазин", скопилось большое количество заказов, то удалять их вручную по-одному будет довольно утомительно. Чтобы облегчить задачу, можно сделать выборку с помощью Selector, получить все заказы, у которых, к примеру, последний раз изменялся статус заказа больше года назад, и удалить эти заказы. Ниже приведен код, который это делает:

<source lang="php">
public function deleteAllOrders () {
$orders = new selector('objects');
$orders->types('object-type')->name('emarket', 'order');
$time = 1461888000; // 29.4.2016
$orders->where('status_change_date')->eqless($time);
$umiObjects = umiObjectsCollection::getInstance();

foreach ($orders as $order) {
$id = $order->getId();
$umiObjects->delObject($id);
echo "удален заказ $id<br>";
}
}
</source>

Разместите данный код в файле classes/modules/custom.php после строки //TODO: Write your own macroses here.

В переменную
<source lang="php">
$time = 1328021732;
</source>

мы передаем дату, с которой будем сравнивать дату изменения статуса заказа (т.е. если дата последнего изменения статуса заказа старше чем эта - заказ будет удален). В данный момент это 31 января 2012 года, вы можете установить сюда свое значение, воспользовавшись Unixtime конвертером. Данный конвертер можно найти в свободном доступе в интернете - например, здесь http://www.cy-pr.com/tools/time/

[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:Написание кастомных макросов]]

Добавление информации о заказе в письмо-уведомление(tpl)

2016-08-19T12:00:48Z

Alexei:

'''Актуально для версии 2.9'''

Необходимо добавить в письмо, которое приходит клиенту и администратору сайта информацию о заказе.

Задача решается на примере шаблона demoold (классический интернет магазин, версия 2.8.6).

Решение. Для реализации поставленной задачи нужно отредактировать шаблон, по которому формируется письмо-уведомление о заказе:
/tpls/emarket/mail/default.tpl

в данный шаблон после всех трех блоков $FORMS

добавляем макрос:

%emarket order(%order_id%,'mail')%[http://dev.docs.umi-cms.ru/spravochnik_makrosov_umicms/internetmagazin/emarket_order/]

Который возвращает информацию о заказе по шаблону mail.tpl, который должен лежать

в
<ul>
<li>/tpls/emarket/customer/</li>
<li>/tpls/ematket/</li>
</ul>
Теперь осталось сверстать данный шаблон, за основу можно взять шаблон /tpls/emarket/default.tpl.

Если же Вам нужно будет добавить в шаблон дополнительные поля, которых нет на первом шаге оформления заказа(например адрес), Вам будет необходимо использовать макрос:

%data getPropertyGroupOfObject(%delivery_address%,'common')%[http://dev.docs.umi-cms.ru/spravochnik_makrosov_umicms/shablony_dannyh/data_getpropertygroupofobject/]

Обратите внимание, что изначально система пытается брать информацию из шаблона в папке /xslt/mail/emarket/default.xsl . Чтобы начал подгружаться Ваш tpl-шаблон, необходимо сначала закомментировать указанный файл default.xsl .

[[Категория:Верстка в TPL]][[Категория:Модуль Интернет магазин]]

Phpinfo

2016-06-01T10:54:46Z

Alexei:

'''Phpinfo''' - это php-скрипт, имеющий следующее содержание

<source lang="php">
<?php phpinfo(); ?>
</source>

Результатом работы этого скрипта является подробная информация о конфигурации PHP, установленном на сервере. Достаточно создать файл с названием '''phpinfo.php''', и разместить данный файл в корневой папке системы. Внутри файла следует поместить указанное выше содержание, и после этого вызвать файл, набрав в адресной строке браузера '''адрес_вашего_сайта/phpinfo.php''' .

В phpinfo должен присутствовать блок '''mysql'''

В переменной '''session.save_path''' должен быть прописан путь до каталога, в котором будут хранится сессии.

Для решения проблем с закачкой фалов могут помочь следующие переменные:
* '''max_execution_time''' - максимальное время выполнение скрипта в секундах
* '''memory_limit''' - количество памяти, выделяемой под скрипты, в Mb
* '''upload_max_filesize''' - Максимальный размер файла для загрузки.

Для решения проблем с [[Лицензионный ключ|лицензионным ключом]] типа [[Old Free]] пригодится переменная SERVER_ADDR - содержимое именно этой переменной записывается в поле IP Сервера обновлений

[[Категория:Вопросы установки настройки и переноса]]

Оформление заказа в один шаг – tpl шаблонизатор

2016-04-22T11:00:19Z

Alexei:

'''Актуально для 2.11'''

В данной статье будет описан принцип создания формы оформления заказа за один шаг, т.е. все необходимые данные, регистрационные данные покупателя, способ доставки, способ оплаты и т.д. представлены на одной страницы. Для использования информации в данной статье версия вашей системы должна быть не ниже 2.8.4.3, иначе код не будет нормально функционировать при наличии в модуле Интернет-магазин способа доставки Курьером, и способа оплаты "Курьером при получении".

Нам понадобятся дополнительные php-методы для реализации данной задачи, которые необходимо добавить внутри абстрактного класса файла '''classes/modules/emarket/__custom.php''', сами методы следующие:

<source lang="php">
public function deliveryAddressesListCustom($template = 'onestep') {
$order = $this->getBasketOrder(false);
list($tpl_block, $tpl_item) = def_module::loadTemplates(
"emarket/delivery/{$template}.tpl",
"delivery_address_block",
"delivery_address_item"
);

$customer = customer::get();
$addresses = $customer->delivery_addresses;
$items_arr = array();
$currentDeliveryId = $order->getValue('delivery_address');

$collection = umiObjectsCollection::getInstance();

if (is_array($addresses)) foreach($addresses as $address) {
$addressObject = $collection->getObject($address);

$item_arr = array(
'attribute:id' => $address,
'attribute:name' => $addressObject->name
);

if ($address == $currentDeliveryId) $item_arr['attribute:active'] = 'active';

$items_arr[] = def_module::parseTemplate($tpl_item, $item_arr, false, $address);
}

$types = umiObjectTypesCollection::getInstance();
$typeId = $types->getBaseType("emarket", "delivery_address");

if ($tpl_block) {
return def_module::parseTemplate($tpl_block, array('items' => $items_arr, 'type_id' => $typeId));
}
}

public function deliveryListCustom($template = 'onestep') {
$order = $this->getBasketOrder(false);
list($tpl_block, $tpl_item_free, $tpl_item_priced) = def_module::loadTemplates(
"emarket/delivery/{$template}.tpl",
'delivery_block',
'delivery_item_free',
'delivery_item_priced'
);

if (!isset($_SESSION['emarket'])) $_SESSION['emarket'] = array();
if (!isset($_SESSION['emarket']['delivery'])) $_SESSION['emarket']['delivery'] = array();

$deliveryIds = delivery::getList();
$items_arr = array();
$currentDeliveryId = $order->getValue('delivery_id');

foreach($deliveryIds as $delivery) {
$delivery = delivery::get($delivery);
if ($delivery->validate($order) == false) {
continue;
}

$deliveryObject = $delivery->getObject();
$deliveryPrice = $delivery->getDeliveryPrice($order);
$_SESSION['emarket']['delivery'][$delivery->id] = (float)$deliveryPrice;

$item_arr = array(
'attribute:id' => $deliveryObject->id,
'attribute:name' => $deliveryObject->name,
'attribute:price' => $deliveryPrice.'',
'xlink:href' => $deliveryObject->xlink
);

if ($delivery->id == $currentDeliveryId) $item_arr['attribute:active'] = 'active';

$tpl_item = $deliveryPrice ? $tpl_item_priced : $tpl_item_free;
$items_arr[] = def_module::parseTemplate($tpl_item, $item_arr, false, $deliveryObject->id);
}

if ($tpl_block) {
return def_module::parseTemplate($tpl_block, array('items' => $items_arr));
} else {
return array('items' => array('nodes:item' => $items_arr));
}

}

public function paymentsListCustom($template = 'onestep') {
$order = $this->getBasketOrder(false);
list($tpl_block, $tpl_item) = def_module::loadTemplates("emarket/payment/{$template}.tpl", 'payment_block', 'payment_item');

$payments = payment::getList();
$items = array();
$currentPaymentId = $order->getValue('payment_id');

foreach($payments as $paymentId) {
$payment = payment::get($paymentId, $order);
if($payment->validate($order) == false) {
continue;
}
$paymentObject = $payment->getObject();
$paymentTypeId = $paymentObject->getValue('payment_type_id');
$paymentTypeName = umiObjectsCollection::getInstance()->getObject($paymentTypeId)->getValue('class_name');

if($paymentTypeName == 'social') {
continue;
}

$item = array(
'attribute:id' => $paymentObject->id,
'attribute:name' => $paymentObject->name,
'attribute:type-name' => $paymentTypeName,
'xlink:href' => $paymentObject->xlink
);

if($paymentId == $currentPaymentId) {
$item['attribute:active'] = 'active';
}

$items[] = def_module::parseTemplate($tpl_item, $item, false, $paymentObject->id);
}

if($tpl_block && !def_module::isXSLTResultMode()) {
return def_module::parseTemplate($tpl_block, array('items' => $items));
} else {
return array('items' => array('nodes:item' => $items));
}
}

public function personalInfoCustom($template = 'onestep') {
if (!permissionsCollection::getInstance()->isAuth()){
$customerId = customer::get()->id;
$cmsController = cmsController::getInstance();
$data = $cmsController->getModule('data');

return $data->getEditForm($customerId, $template);
} else return '';
}

public function saveInfoCustom(){
$order = $this->getBasketOrder(false);

//сохранение регистрационных данных
$cmsController = cmsController::getInstance();
$data = $cmsController->getModule('data');
$data->saveEditedObject(customer::get()->id, false, true);

//сохранение адреса доставки
$addressId = getRequest('delivery-address');
if ($addressId == 'new') {
$collection = umiObjectsCollection::getInstance();
$types = umiObjectTypesCollection::getInstance();
$typeId = $types->getBaseType("emarket", "delivery_address");
$customer = customer::get();
$addressId = $collection->addObject("Address for customer #".$customer->id, $typeId);
$dataModule = $cmsController->getModule("data");
if ($dataModule) {
if (!$dataModule->saveEditedObject($addressId, true, true)) {
$dataModule->saveEditedObjectWithIgnorePermissions($addressId, true, true); // начиная с версии 2.9.5
}
}
$customer->delivery_addresses = array_merge( $customer->delivery_addresses, array($addressId) );
}
$order->delivery_address = $addressId;

//сохранение способа доставки
$deliveryId = getRequest('delivery-id');
if ($deliveryId){
$delivery = delivery::get($deliveryId);
$deliveryPrice = (float) $delivery->getDeliveryPrice($order);
$order->setValue('delivery_id', $deliveryId);
$order->setValue('delivery_price', $deliveryPrice);
}

//сохранение способа оплаты и редирект на итоговую страницу
$order->setValue('payment_id', getRequest('payment-id'));

$order->refresh();

$paymentId = getRequest('payment-id');
if (!$paymentId) {
$this->errorNewMessage(getLabel('error-emarket-choose-payment'));
$this->errorPanic();
}
$payment = payment::get($paymentId, $order);

if ($payment instanceof payment) {
$paymentName = $payment->getCodeName();
$url = "{$this->pre_lang}/".cmsController::getInstance()->getUrlPrefix()."emarket/purchase/payment/{$paymentName}/";
} else {
$url = "{$this->pre_lang}/".cmsController::getInstance()->getUrlPrefix()."emarket/cart/";
}
$this->redirect($url);
}
</source>

также в папку '''classes/modules/emarket/''' необходимо добавить файл '''permissions.custom.php''' следующего содержания:

<source lang="php">
<?php
$permissions = array('purchasing' => array('deliveryListCustom', 'deliveryAddressesListCustom', 'paymentsListCustom', 'personalInfoCustom', 'saveInfoCustom'));
?>
</source>

Необходимо создать шаблон '''tpls/emarket/delivery/onestep.tpl''':

<source lang="php">
<?php
$FORMS = Array();

$FORMS['delivery_block'] = <<<END
<h3 class="dost">Выберите подходящий вам способ доставки:</h3>
<ul>
%items%
</ul>
END;

$FORMS['delivery_item_free'] = <<<END
<li><input type="radio" name="delivery-id" value="%id%" checked="checked" /> %name% - бесплатно</li>
END;

$FORMS['delivery_item_priced'] = <<<END
<li><input type="radio" name="delivery-id" value="%id%" /> %name% - %price%</li>
END;

$FORMS['delivery_address_block'] = <<<END
<div class="adrest">
<h3 class="dost">Выберите подходящий вам адрес доставки:</h3>
<ul>
%items%
<li>
<input type="radio" name="delivery-address" value="new" /> <b>Новый адрес доставки:</b>
<table cellspacing="1" cellpadding="1" width="100%" border="0">
%data getCreateForm(Здесь нужно подставить ид типа данных "Адрес доставки", 'onestep')%
</table>
</li>
</ul>
</div>
END;

$FORMS['delivery_address_item'] = <<<END
<li><input type="radio" name="delivery-address" value="%id%" />%index%, %city%, %street%, д. %house%, кв. %flat%</li>
END;

?>
</source>

В макросе '''data getCreateForm()''', первый параметр - это id типа данных "Адрес доставки" в модуле "Шаблоны данных", первая вкладка, раздел "Справочники", этот id вы должны для вашей системы определить самостоятельно и подставить в макрос data getCreateForm().

Шаблон '''tpls/emarket/payment/onestep.tpl''':

<source lang="php">
<?php
$FORMS = Array();

$FORMS['payment_block'] = <<<END
Выберите подходящий вам способ оплаты:
<ul>
%items%
</ul>
END;

$FORMS['payment_item'] = <<<END
<li><input type="radio" name="payment-id" value="%id%" /> %name%</li>
END;

?>
</source>

Шаблон '''tpls/data/reflection/onestep.tpl''':

<source lang="php">
<?php

$FORMS = Array();

$FORMS['reflection_block'] = <<<END
%groups%
END;

$FORMS['reflection_group'] = <<<END
<tr>
<td colspan="2">
<br/><br /><b>%title%</b><br /><br />
</td>
</tr>
%fields%
END;

$FORMS['reflection_field_string'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>

<td>
<input type="text" name="%input_name%" value="%value%" class="textinputs" />
</td>
</tr>
END;

$FORMS['reflection_field_text'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>
<td>
<textarea name="%input_name%" class="textinputs">%value%</textarea>
</td>
</tr>
END;

$FORMS['reflection_field_int'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>

<td>
<input type="text" name="%input_name%" value="%value%" class="textinputs" />
</td>
</tr>
END;

$FORMS['reflection_field_relation'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>

<td>
<select name="%input_name%" style="width: 205px" class="textinputs">
<option />
%options%
</select>
</td>
</tr>

END;

$FORMS['reflection_field_relation_option'] = <<<END
<option value="%id%">%name%</option>
END;

$FORMS['reflection_field_relation_option_a'] = <<<END
<option value="%id%" selected="selected">%name%</option>
END;

?>
</source>

В шаблоне '''tpls/emarket/default.tpl''', в блоке '''order_block''', форма должна быть примерно следующая:

<source lang="php">
<form action="%pre_lang%/emarket/saveInfoCustom/">
%emarket deliveryListCustom('onestep')%
%emarket deliveryAddressesListCustom('onestep')%
<table cellspacing="1" cellpadding="1" width="100%" border="0">
</table>
<br/>
%emarket paymentsListCustom('onestep')%
<br/>
<table cellspacing="1" cellpadding="1" width="100%" border="0">
%emarket personalInfoCustom('onestep')%
</table>
<br/>
<input type="submit" value="Оформить заказ" />
</form>
</source>

[[Категория:Написание кастомных макросов]][[Категория:Верстка в TPL]]
[[Категория:Модуль Интернет магазин]]

Аудит безопасности системы

2016-04-07T12:16:31Z

Alexei:

[[Категория:Модуль Конфигурация]]
'''Актуально для версии 2.9.5'''

В закладке "Безопасность" модуля "Конфигурация" есть инструмент проверки безопасности системы. Данный раздел проверяет насколько защищенная система и позволяет отслеживать доступ обычных пользователей к наиболее важным средствам работы с системой и сайтом в целом.

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

1. '''Протокол UFS закрыт''' - данный пункт проверяет на наличие в файле ''config.ini'' разрешения использовать через адресную строку протокол '''UFS'''. Данное разрешение прописывается строкой ''ufs.http.allow = '' в секции ''[streams]''. Для удачного прохождения теста необходимо что бы ее значение было равно "0".

2. '''Протокол UObject закрыт''' - данный пункт проверяет на наличие в файле ''config.ini'' разрешения использовать через адресную строку протокол '''UObject'''. Данное разрешение прописывается строкой ''"uobject.http.allow = "'' в секции ''[streams]''. Для удачного прохождения теста необходимо что бы ее значение было равно ''"0"''.

3. '''Подключение к БД не под root-ом''' - здесь проверяется какой логин используется для подключение к базе данных MySQL, стандартно у каждой базы данных есть главный пользователь который может полностью ей управлять, его логин ''root'', но так как для работы сайта достаточно одной базы данных то создается отдельный пользователь со своими логином и паролем который может управлять только одной базой данных на сервере. Проверка делается по файлу ''config.ini'', где в секции ''[connections]'' указываются данные для подключения к базе данных. Для успешного прохождения теста необходимо, что бы значение поля ''"login="'' было отличным от значения ''root''.

4. '''Пароль для БД не пустой''' - как можно понять из названия тут проверяется та же секция ''[connections]'' файла ''config.ini'', где поле ''"password="'' обязательно должно иметь какое либо значение кроме ''""'', то есть что бы был указан обязательно пароль для подключения к базе данных MySQL.

5. '''Доступ к файлу конфигурации закрыт''' - в данном пункте проверяется доступность файла ''config.ini'' через адресную строку браузера. То есть если файл ''config.ini'' можно открыть введя в адресной строке браузера ''http://domain.ru/config.ini'', значит тест будет провален. Для успешного прохождения данного теста в файле ''".htaccess"'' предусмотренно правило ''"RewriteRule ^config\.ini$ / [L,R]"'', если этого правила нет или оно "закомментировано" (то есть перед строкой стоит символ "#"), то необходимо либо добавить эту строку перед строкой ''"RewriteRule ^install\.ini$ / [L,R]"'', либо раскомментировать (то есть удалить символ "#" перед строкой).

6. '''Доступ к системным папкам закрыт''' - в данном тесте система проверяет запрос к папке ''/classes'' через адресную строку браузера. Что бы тест прошел удачно необходимо в ответ присылать системе либо 403 ошибку сервера, либо ничего не должно приходить вообще. Стандартно это делается добавлением файла ''".htaccess"'' в папку ''/classes''. В самом файле находиться одна строка ''Deny from all'' которая закрывает всем доступ к этой папке через браузер.

7. '''Выполнение php скриптов в /files/''' - данный тест проверяет выполняются ли ''".php"'' скрипты из папки ''/files/''. Стандартно исполнение скриптов в папке ''/files/'' закрывается. Для того что бы тест проходил удачно необходимо наличие в папке ''/files/'' файла ''.htaccess'' где должна быть прописана строка ''php_flag engine off'' которая запрещает работу php-скриптов в папке и вложенных папках рекурсивно. Если же пройти данный тест не удается, хотя необходимый файл ''.htaccess'' есть - тогда нужно добавить в ''.htaccess'' следующий код:
<pre>
RemoveHandler .php
RemoveType .php
AddType application/x-httpd-php-source .php
Options -ExecCGI -Indexes </pre>

8. '''Доступ к файлу php_for_del_connector.php''' - данным тестом проверяется доступность системного файла ''php_for_del_connector.php'' в папке ''/styles/common/other/elfinder/php/''. Тест проходит удачно при наличии в данной папке файла ''.htaccess'' в котором присутствует строка ''Deny from all''.

Аудит безопасности системы

2016-04-07T12:15:20Z

Alexei:

[[Категория:Модуль Конфигурация]]
'''Актуально для версии 2.9.5'''

В закладке "Безопасность" модуля "Конфигурация" есть инструмент проверки безопасности системы. Данный раздел проверяет насколько защищенная система и позволяет отслеживать доступ обычных пользователей к наиболее важным средствам работы с системой и сайтом в целом.

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

1. '''Протокол UFS закрыт''' - данный пункт проверяет на наличие в файле ''config.ini'' разрешения использовать через адресную строку протокол '''UFS'''. Данное разрешение прописывается строкой ''ufs.http.allow = '' в секции ''[streams]''. Для удачного прохождения теста необходимо что бы ее значение было равно "0".

2. '''Протокол UObject закрыт''' - данный пункт проверяет на наличие в файле ''config.ini'' разрешения использовать через адресную строку протокол '''UObject'''. Данное разрешение прописывается строкой ''"uobject.http.allow = "'' в секции ''[streams]''. Для удачного прохождения теста необходимо что бы ее значение было равно ''"0"''.

3. '''Подключение к БД не под root-ом''' - здесь проверяется какой логин используется для подключение к базе данных MySQL, стандартно у каждой базы данных есть главный пользователь который может полностью ей управлять, его логин ''root'', но так как для работы сайта достаточно одной базы данных то создается отдельный пользователь со своими логином и паролем который может управлять только одной базой данных на сервере. Проверка делается по файлу ''config.ini'', где в секции ''[connections]'' указываются данные для подключения к базе данных. Для успешного прохождения теста необходимо, что бы значение поля ''"login="'' было отличным от значения ''root''.

4. '''Пароль для БД не пустой''' - как можно понять из названия тут проверяется та же секция ''[connections]'' файла ''config.ini'', где поле ''"password="'' обязательно должно иметь какое либо значение кроме ''""'', то есть что бы был указан обязательно пароль для подключения к базе данных MySQL.

5. '''Доступ к файлу конфигурации закрыт''' - в данном пункте проверяется доступность файла ''config.ini'' через адресную строку браузера. То есть если файл ''config.ini'' можно открыть введя в адресной строке браузера ''http://domain.ru/config.ini'', значит тест будет провален. Для успешного прохождения данного теста в файле ''".htaccess"'' предусмотренно правило ''"RewriteRule ^config\.ini$ / [L,R]"'', если этого правила нет или оно "закомментировано" (то есть перед строкой стоит символ "#"), то необходимо либо добавить эту строку перед строкой ''"RewriteRule ^install\.ini$ / [L,R]"'', либо раскомментировать (то есть удалить символ "#" перед строкой).

6. '''Доступ к системным папкам закрыт''' - в данном тесте система проверяет запрос к папке ''/classes'' через адресную строку браузера. Что бы тест прошел удачно необходимо в ответ присылать системе либо 403 ошибку сервера, либо ничего не должно приходить вообще. Стандартно это делается добавлением файла ''".htaccess"'' в папку ''/classes''. В самом файле находиться одна строка ''Deny from all'' которая закрывает всем доступ к этой папке через браузер.

7. '''Выполнение php скриптов в /files/''' - данный тест проверяет выполняются ли <tt>".php"</tt> скрипты из папки <tt>/files/</tt>. Стандартно исполнение скриптов в папке <tt>/files/</tt> закрывается. Для того что бы тест проходил удачно необходимо наличие в папке <tt>/files/</tt> файла <tt>.htaccess</tt> где должна быть прописана строка <tt>php_flag engine off</tt> которая запрещает работу php-скриптов в папке и вложенных папках рекурсивно. Если же пройти данный тест не удается, хотя необходимый файл <tt>.htaccess</tt> есть - тогда нужно добавить в <tt>.htaccess</tt> следующий код:
<pre>
RemoveHandler .php
RemoveType .php
AddType application/x-httpd-php-source .php
Options -ExecCGI -Indexes </pre>

8. '''Доступ к файлу php_for_del_connector.php''' - данным тестом проверяется доступность системного файла ''php_for_del_connector.php'' в папке ''/styles/common/other/elfinder/php/''. Тест проходит удачно при наличии в данной папке файла ''.htaccess'' в котором присутствует строка ''Deny from all''.

Мультисайтовость

2016-03-29T11:33:29Z

Alexei:

Система UMI.CMS поддерживает мультидоменность. Что это значит? Это значит, что под управлением одной системы UMI.CMS может работать сразу несколько сайтов на разных доменах*, что особенно удобно при организации бизнес порталов, много язычных сайтов, расположенных в разных доменных зонах, или больших интернет магазинов. Кроме того, Вы получаете единый центр управления всеми сайтами, а гибкая система настройки прав пользователей, позволяет назначить каждому порталу своих, независимых, контент менеджеров. Не менее важным преимуществом является возможность использования, на этапах разработки и сопровождения, общего программного кода (шаблонов дизайна и шаблонов макросов) и материалов, централизованное обновление и разработка дополнительного кастомного функционала.
Как организовать мультидоменность на UMI.CMS? Очень просто!
# Для начала, необходимо зарегистрировать новый домен.
# В '''панели управления доменом''' прописываете Name Server (NS) хостинга. Обратите внимание, что должен быть прописан NS того хостинга, на котором уже установлена и работает система UMI.CMS**
# В '''панели управления хостингом''' прописываете, чтобы сервер, при запросе нового домена, "смотрел" в ту же папку, где уже стоит и работает UMI.CMS. Другими словами - делаете новый домен зеркалом уже работающего(т.е. новый домен делаете алиасом уже работающего).
# Заходите в административную панель системы UMI.CMS и, в модуле "Конфигурация", на вкладке "Домены", прописываете новый домен***. Можно прописывать как с “www” так и без “www”. Нажмите «Сохранить».****
<br/><br/>
С этого момента, система будет считать, что на ней установлено и работает уже два домена. В этом можно убедиться, если перейти в модуль «Структура». Под корневым деревом основного домена, появилось новое дерево структуры, с названием домена, который Вы только что создали. Система сама будет решать, какой контент необходимо возвращать.
<br/><br/>
Вернитесь в модуль «Конфигурация» вкладка «Домены». Рядом с записью нового домена, после того, как Вы сохраняли изменения, в пункте 4, появилась иконка редактирования. Нажмите на неё. Откроется раздел, в котором Вы можете дописать зеркала, для только что созданного домена. К примеру, если Вы решили дописать на предыдущей странице домен без «www» то здесь можно указать с “www”. Это необходимо, чтобы Ваша страница открывалась на запрос в адресной строке браузера как вида ''www.my-site.com'' так и ''my-site.com''. Так же, Вы можете указать здесь другие домены, которые являются зеркалом только что добавленного Вами домена.
<br/><br/>

<em><nowiki>*</nowiki> При условии соблюдения лицензионного соглашения, скачать и ознакомитьс с которым Вы можете здесь http://www.umi-cms.ru/buy/licence_agreement/ <br/>
<nowiki>**</nowiki>Заметим, что, на момент написания этой статьи, редакции Free, Start и Shop не поддерживают возможность мультидоменности.<br/>
<nowiki>***</nowiki> Если Вам необходимо сменить привязку Вашего лицензионного ключа с одного домена, зарегестрированного в системе UMI.CMS, на другой, то Вам необходимо ознакомиться со следующей статьёй http://wiki.umisoft.ru/Переактивация<br/>
<nowiki>****</nowiki> Более подробное описание модуля «Конфигурация», и вкладки «Домены» в том числе, Вы можете найти здесь http://help.umi-cms.ru/<br/></em>

<br/><br/>
<b>Обратите внимание!!!</b> Все домены должны располагаться на одном хостинге аккаунте и одном IP. (http://www.umi-cms.ru/buy/licence_agreement/).

При подключении кириллических доменов, необходимо использовать информацию в данной статье: [[Подключение кириллических доменов рф]]
[[Категория:Вопросы установки настройки и переноса]]

Редирект

2016-03-17T07:59:09Z

Alexei:

'''Актуально для версии 2.9'''

Для создания перенаправления пользователя существует множество способов, некоторые из них легко применить и в UMI.CMS. Ниже приведем некоторые примеры:<br />
Самый основной способ создания перенаправления, это добавление записи в Базу данных в таблицу cms3_redirects.<br />
В таблице вам следует заполнить три поля:<br />
1. source - относительный адрес откуда производить перенаправление.<br />
2. target - соответственно куда.<br />
3. status - с каким статусом. Если вы не знаете какой вам нужен, используйте 301.<br />
Так же можно воспользоваться статьей [[Redirect_в_системе,_перенос_сайта_на_umi.cms,_ч.1]] и написать себе скрипт для удобства.<br />

Помимо этого в системе есть предназначенный для той же цели макрос %content redirect('http://www.umi-cms.ru')%. Его можно использовать в шаблонах или непосредственно в контенте определенной страницы.<br />

В добавок к стандартным для UMI.CMS способам, есть стандартные HTML средства. Следующий meta тег, позволяет произвести необходимое перенаправление, но использоваться он может только в секции HEAD, HMTL документа. Атрибут CONTENT позволяет перенаправить на указанную после URL= страницу, а первое значение обозначает задержку в секундах.<br />
<source lang="html4strict">
<META HTTP-EQUIV="REFRESH" CONTENT="5; URL=http://ya.ru" />
</source>

На этом изобилие способов ещё не кончается. Так же мы можем использовать JavaScript или файл дополнительной настройки сервера .htaccess.<br />
В первом, скрипт для перенаправления может быть записан как минимум четырьмя способами:<br />
<source lang="javascript">
#1:
<script type="text/javascript">
location="http://www.newdomain.com";
</script>
#2:
<script type="text/javascript">
document.location.href="http://www.newdomain.com";
</script>
#3:
<script type="text/javascript">
window.location.reload("http://www.newdomain.com");
</script>
#4:
<script type="text/javascript">
document.location.replace("http://www.newdomain.com");
</script>
</source>

Во втором случае бесконечное множество вариантов. Самые простые из них:<br/>
<source lang="apache">
#1: RewriteRule / shop [R=301]
#2: Redirect 301 ^index.html$ /
#3: RedirectPermanent ^shop$ ^catalog$
</source>
Разделителем здесь является пробел, принцип старый: первое значение - откуда, второе - куда.

Если нужно добавить перенаправление, чтобы убирался слэш на конце адреса страницы, то для решения задачи нужно вставить такой код в файл /.htaccess в корне сайта после строчки "RewriteEngine On":
<source lang="apache">
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/admin/.*
RewriteRule ^(.*)/$ /$1 [L,R=301]
</source>
и выключить опцию url-suffix.add в файле config.ini.
Все страницы, кроме админки, будут перенаправлятся на адрес без слэша. Админка с перенаправлением не будет работать.

[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Вебформы на ajax tpl

2016-02-17T11:33:07Z

Alexei:

'''Актуально для версии 2.9'''

Сейчас мы в несколько довольно несложных действий заставим нашу вебформу, добавленную с помощью модуля обратная связь работать без перезагрузки страницы.
В этом нам поможет jquery плагин Form.
Для начала открываем шаблон, где размещается шапка необходимой нам страницы и между тэгами head, в самом низу добавляем строчки
<source lang="php">

<script src="http://malsup.github.com/jquery.form.js" type="text/javascript"></script>

</source>
Внимание строчка обязательно должна быть ниже макросов
<source lang="php">
%system includeQuickEditJs()%
%system includeEditInPlaceJs()%
</source>
Всё, с шапкой закончили, так как сам jquery у нас уже подключен, макросами
<source lang="php">
%system includeQuickEditJs()%
%system includeEditInPlaceJs()%
</source>
Теперь переходим к шаблону вебформ.
Открываем его.(если вы ничего не меняли, то он находиться по адресу /tpls/data/reflection/webforms.tpl)
и имеющийся код
<source lang="php">
<form enctype="multipart/form-data" method="post" action="%pre_lang%/webforms/send/">
<input type="hidden" name="system_form_id" value="%form_id%" />
<input type="hidden" name="system_template" value="%template%" />
<input type="hidden" value="%pre_lang%/webforms/posted/" name="ref_onsuccess">
%address_select%
%groups%
</form>
</source>
заменяем на вот такой
<source lang="php">
<form id="umi_the_best" enctype="multipart/form-data" method="post" action="%pre_lang%/webforms/send/">
<input type="hidden" name="system_form_id" value="%form_id%" />
<input type="hidden" name="system_template" value="%template%" />
<input type="hidden" value="%pre_lang%/webforms/posted/" name="ref_onsuccess">
%address_select%
%groups%
</form>

<script type="text/javascript">
$(document).ready(function(){
$("#umi_the_best").ajaxForm(function() {
alert("Спасибо за ваш отзыв!");
jQuery("#umi_the_best").trigger("reset");
});
});
</script>
</source>
Всё, теперь форма у нас работает без перезагрузки страницы.

Внимание, работа данного метода проверена на версии 2.8.5.3, если ваша версия ниже, работа этого метода не гарантирована.

Инструкцию для xslt шаблонизатора вы можете найти по адресу [http://wiki.umisoft.ru/Вебформы_на_ajax_xslt Вебформы на ajax xslt ]

[[Категория:Верстка в TPL]][[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Вебформы на ajax xslt

2016-02-17T11:30:13Z

Alexei:

'''Актуально для версии 2.9'''

Сейчас мы в несколько довольно несложных действий заставим нашу вебформу, добавленную с помощью модуля обратная связь работать без перезагрузки страницы.
В этом нам поможет jquery плагин Form.
Для начала открываем шаблон, где размещается шапка необходимой нам страницы и между тэгами head, в самом низу добавляем строчки
<source lang="php">

<script src="http://malsup.github.com/jquery.form.js" type="text/javascript"></script>

</source>
Внимание строчка обязательно должна быть ниже макроса
<source lang="php">
<xsl:value-of select="document('udata://system/includeQuickEditJs')/udata" disable-output-escaping="yes" />
</source>
Всё, с шапкой закончили, так как сам jquery у нас уже подключен, макросом
<source lang="php">
<xsl:value-of select="document('udata://system/includeQuickEditJs')/udata" disable-output-escaping="yes" />
</source>
Теперь переходим к шаблону вебформ.
Открываем его.(если у вас шаблон demodizzy, то он находиться по адресу /xsltTpls/modules/webforms/add.xsl)
и фрагмент кода
<source lang="xml">
<xsl:template match="udata[@module = 'webforms'][@method = 'add']">
<form method="post" action="{$lang-prefix}/webforms/send/" onsubmit="site.forms.data.save(this); return site.forms.data.check(this);" enctype="multipart/form-data">
<xsl:apply-templates select="items" mode="address" />
<xsl:apply-templates select="groups/group" mode="webforms" />
<input type="hidden" name="system_form_id" value="{/udata/@form_id}" />
<input type="hidden" name="ref_onsuccess" value="{$lang-prefix}/webforms/posted/{/udata/@form_id}/" />
<div class="form_element">
<xsl:apply-templates select="document('udata://system/captcha/')/udata" />
</div>
<div class="form_element">
<input type="submit" class="button" value="Отправить" />
</div>
</form>
</xsl:template>
</source>
заменяем на вот такой
<source lang="xml">
<xsl:template match="udata[@module = 'webforms'][@method = 'add']">
<form id="umi_the_best" method="post" action="{$lang-prefix}/webforms/send/" onsubmit="site.forms.data.save(this); return site.forms.data.check(this);" enctype="multipart/form-data">
<xsl:apply-templates select="items" mode="address" />
<xsl:apply-templates select="groups/group" mode="webforms" />
<input type="hidden" name="system_form_id" value="{/udata/@form_id}" />
<input type="hidden" name="ref_onsuccess" value="{$lang-prefix}/webforms/posted/{/udata/@form_id}/" />
<div class="form_element">
<xsl:apply-templates select="document('udata://system/captcha/')/udata" />
</div>
<div class="form_element">
<input type="submit" class="button" value="Отправить" />
</div>
</form>

<script type="text/javascript">
$(document).ready(function(){
$("#umi_the_best").ajaxForm(function() {
alert("Спасибо за ваш отзыв!");
jQuery("#umi_the_best").trigger("reset");
});
});
</script>
</xsl:template>
</source>
Всё, теперь форма у нас работает без перезагрузки страницы.

Внимание, работа данного метода проверена на версии 2.8.5.3, если ваша версия ниже, работа этого метода не гарантирована.

Инструкцию для tpl шаблонизатора вы можете найти по адресу [http://wiki.umisoft.ru/Вебформы_на_ajax_tpl Вебформы на ajax tpl]

[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория: Верстка в XSLT]]

Подключаем кастомный WYSIWYG-редактор для административной панели

2016-02-15T09:56:22Z

Alexei:

[[category:Вопросы и уроки разработки сайтов на UMI.CMS]]

<p>'''Задача:'''</p>
<p>
Подключить любой отличный от tinyMCE WYSIWYG-редактор для административной панели.
</p>
<p>'''Решение:'''</p>
<p>
Чтобы можно было изменить WYSIWYG-редактор по умолчанию, необходимо подредактировать скин используемый для административной панели и подключить его с помощью файла настроек "config.ini". В данный момент используется скин "mac". Папка со скином находится по адресу: "/styles/skins/mac". Делаем вторую копию папки "mac" и присваиваем ей название, например - "mac-with-redactor", поскольку для примера был выбрал WYSIWYG-редактор "Redactor".
</p>
<p>
Скачиваем Redactor по адресу: [http://redactorjs.com/download/ http://redactorjs.com/download]. Распаковываем скачанный архив в папку "/js/redactor".
</p>
<p>
Первым делом редактируем файл "/styles/skins/mac-with-redactor/design/js/scripts.js". Удаляем код инициализации TinyMCE для WYSIWYG-полей. Необходимо найти на ~424 строчке текст:
</p>
<source lang="javascript">
// WYSIWYG
jQuery("textarea.wysiwyg").each(function (i, n) {
tinyMCE.execCommand('mceAddControl', false, jQuery(n).attr('id'));
});
</source>
<p>
и закоментировать или удалить его.
</p>
Открываем файл "/styles/skins/mac-with-redactor/interface/ui/controls.xsl" и добавляем шаблон для инициализации Redactor:
<source lang="xml">
<xsl:template name="redactor">
<link rel="stylesheet" href="/js/redactor/css/redactor.css" />
<script type="text/javascript" src="/js/redactor/redactor.min.js"></script>
<script type="text/javascript">
$(document).ready(function() {
$('textarea.wysiwyg').redactor();
});
</script>
</xsl:template>
</source>
<p>
Далее редактируем файл "/styles/skins/mac-with-redactor/interface/layout.xsl". Необходимо заменить все пути вида "/styles/skins/mac/..." на "/styles/skins/mac-with-redactor/..." и добавить вызов шаблона, прописав "'''<xsl:call-template name='redactor' />'''".
</p>
<p>
Теперь осталось только прописать настройки скина в файле "config.ini", который находится в корне сайта. Открываем "config.ini", ищем секцию "system" и изменяем значение параметра "default-skin" на "mac-with-redactor". Также необходимо прописать наш скин в массив "skins". Для этого также в секцию "system" добавляем строку: "skins[] = 'mac-with-redactor'".
</p>
<br />
<table align="center">
<tr>
<td style="border: 1px solid black; padding: 5px;">
[[Файл:redactor.png]]
</td>
</tr>
<tr>
<td style="font-color: darkblue; font-weight: bold; text-align: center;">
Админ-панель с подключённым Redactor.
</td>
</tr>
</table>
<br />
<table align="center" width="100%">
<tr>
<td style="border: 1px dotted black; padding: 20px;">
'''Важно'''.
<br />
<p>
Обращаем Ваше внимание, что обновление системы не затрагивает пользовательский скин. Поэтому его обновление нужно будет производить вручную.
</p>
</td>
</tr>
</table>

Http basic Authorization

2016-02-12T15:51:55Z

Alexei:

'''Актуально для версии 2.9.5'''

== Задача ==

Закрыть страницу /admin дополнительной http авторизацией.

== Решение ==

Для решения задачи в .htaccess добавьте строку:

<source lang="apache">
RewriteCond %{REQUEST_URI} ^(/admin)$
RewriteRule ^(.) /security/check.php [L,R]
</source>

Потом создайте в корневой директории папку "security" и положите в нее:

1) файл .htpasswd, о том как его получить и заполнить данными можно прочитать, например, вот [http://ru.wikipedia.org/wiki/Htpasswd здесь].

2) файл .htaccess следующего содержания:

<source lang="apache">
AuthType Basic
AuthName "private area"
AuthUserFile /home/domains/c-cmac/htdocs/security/.htpasswd
require valid-user
</source>

*в AuthName укажите желаемое сообщение в форме авторизации.
*в AuthUserFile укажите абсолютный путь до файла .htpasswd, см. 1).

3) php файл check.php следующего содержания:

<source lang="php">
<?php
include '../standalone.php';

$buffer = new HTTPOutputBuffer;
$buffer->redirect("/admin/news/lists/", '301 Moved Permanently', 301);
?>
</source>

Тогда, при запросе имя_вашего_сайта/admin, браузер затребует ввести авторизационные данные, если они будут введены верно, то произойдет редирект на стандартную форму авторизации в административную панель UMI.CMS.

[[Файл:Basic_http_auth.png]]

Если Вы не хотите, еще раз вводить те же данные, то можете внести правки в файл check.php:

<source lang="php">
include '../standalone.php';

$login = $_SERVER['PHP_AUTH_USER'];
$pass = $_SERVER['PHP_AUTH_PW'];

$buffer = new HTTPOutputBuffer;
$buffer->redirect("/admin/news/lists/?u-login=$login&u-password=$pass", '301 Moved Permanently', 301);
</source>

*Из-за особенностей архитектуры UMI.CMS второй версии полноценно закрыть всю административную панель этим способом не получится, но можно хотя бы закрыть самый очевидный адрес /admin.

----

Иногда из-за особенностей хостинга данный способ может не сработать, тогда можно дополнительно закрыть административную панель паролем, заменив код в файле check.php на следующий:

<source lang="php">
<?php
include '../standalone.php';

$login = 'admin';
$pass = '4297f44b13955235245b2497399d7a93'; // md5 123123

if (!isset($_COOKIE['test_umi'])){
if (!isset($_SERVER['PHP_AUTH_USER']) || !isset($_SERVER['PHP_AUTH_PW'])) {
// Имя пользователя и/или пароль не были введены, поэтому отправляются заголовки аутентификации
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic Realm="test-umi"');
exit('Вам необходимо ввести правильные имя пользователя и пароль, '.
'иначе вы не получите доступ к этой странице');
}

// Получение введенных пользователем данных для аутентификации
$user_userlogin = trim($_SERVER['PHP_AUTH_USER']);
$user_password = md5(trim($_SERVER['PHP_AUTH_PW']));

if ($login == $user_userlogin && $pass == $user_password ) {
// Процедура входа прошла нормально, дальше что-то делаем.
$sessionId = md5(time());
setcookie('test_umi', $sessionId, time() + (60 * 60 * 24 * 30));
$_COOKIE['test_umi'] = $sessionId;
} else {
// Имя пользователя и/или пароль введены неверно, поэтому отправляются заголовки аутентификации
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic Realm="test-umi"');
exit('Вам необходимо ввести правильные имя пользователя и пароль, '.
'иначе вы не получите доступ к этой странице');
}
}
header("Location: http://domain.ru/admin/news/lists");
?>
</source>

где 'admin' - это нужный пароль, '4297f44b13955235245b2497399d7a93' - пароль зашифрованный в md5, 'domain.ru' - адрес Вашего сайта.

[[category:.htaccess]]

Http basic Authorization

2016-02-12T15:51:31Z

Alexei:

Http basic Authorization

2016-02-12T15:49:52Z

Alexei:

'''Актуально для версии 2.9.5'''

== Задача ==

Закрыть страницу /admin дополнительной http авторизацией.

== Решение ==

Для решения задачи в .htaccess добавьте строку:

<source lang="apache">
RewriteCond %{REQUEST_URI} ^(/admin)$
RewriteRule ^(.) /security/check.php [L,R]
</source>

Потом создайте в корневой директории папку "security" и положите в нее:

1) файл .htpasswd, о том как его получить и заполнить данными можно прочитать, например, вот [http://ru.wikipedia.org/wiki/Htpasswd здесь].

2) файл .htaccess следующего содержания:

<source lang="apache">
AuthType Basic
AuthName "private area"
AuthUserFile /home/domains/c-cmac/htdocs/security/.htpasswd
require valid-user
</source>

*в AuthName укажите желаемое сообщение в форме авторизации.
*в AuthUserFile укажите абсолютный путь до файла .htpasswd, см. 1).

3) php файл check.php следующего содержания:

<source lang="php">
<?php
include '../standalone.php';

$buffer = new HTTPOutputBuffer;
$buffer->redirect("/admin/news/lists/", '301 Moved Permanently', 301);
?>
</source>

Тогда, при запросе имя_вашего_сайта/admin, браузер затребует ввести авторизационные данные, если они будут введены верно, то произойдет редирект на стандартную форму авторизации в административную панель UMI.CMS.

[[Файл:Basic_http_auth.png]]

Если Вы не хотите, еще раз вводить те же данные, то можете внести правки в файл check.php:

<source lang="php">
include '../standalone.php';

$login = $_SERVER['PHP_AUTH_USER'];
$pass = $_SERVER['PHP_AUTH_PW'];

$buffer = new HTTPOutputBuffer;
$buffer->redirect("/admin/news/lists/?u-login=$login&u-password=$pass", '301 Moved Permanently', 301);
</source>

*Из-за особенностей архитектуры UMI.CMS второй версии полноценно закрыть всю административную панель этим способом не получится, но можно хотя бы закрыть самый очевидный адрес /admin.

----

Иногда из-за особенностей хостинга данный способ может не сработать, тогда можно дополнительно закрыть административную панель паролем, заменив код в файле check.php на следующий:

<source lang="php">
<?php
include '../standalone.php';

$login = 'admin';
$pass = '4297f44b13955235245b2497399d7a93'; // md5 123123

if (!isset($_COOKIE['test_umi'])){
if (!isset($_SERVER['PHP_AUTH_USER']) || !isset($_SERVER['PHP_AUTH_PW'])) {
// Имя пользователя и/или пароль не были введены, поэтому отправляются заголовки аутентификации
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic Realm="test-umi"');
exit('Вам необходимо ввести правильные имя пользователя и пароль, '.
'иначе вы не получите доступ к этой странице');
}

// Получение введенных пользователем данных для аутентификации
$user_userlogin = trim($_SERVER['PHP_AUTH_USER']);
$user_password = md5(trim($_SERVER['PHP_AUTH_PW']));

if ($login == $user_userlogin && $pass == $user_password ) {
// Процедура входа прошла нормально, дальше что-то делаем.
$sessionId = md5(time());
setcookie('test_umi', $sessionId, time() + (60 * 60 * 24 * 30));
$_COOKIE['test_umi'] = $sessionId;
} else {
// Имя пользователя и/или пароль введены неверно, поэтому отправляются заголовки аутентификации
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic Realm="test-umi"');
exit('Вам необходимо ввести правильные имя пользователя и пароль, '.
'иначе вы не получите доступ к этой странице');
}
}
header("Location: http://shpatler.ru/admin/news/lists");
?>
</source>

где 'admin' - это нужный пароль, '4297f44b13955235245b2497399d7a93' - пароль зашифрованный в md5, 'domain.ru' - адрес Вашего сайта.

[[category:.htaccess]]

Как сделать активными только импортируемые товары

2016-02-08T13:46:31Z

Alexei:

[[category:Модуль Обмен данными]][[Категория:Написание кастомных макросов]]
'''Актуально для версии 2.11'''

'''Задача''': Сделать активными только импортируемые товары, все остальные товары в каталоге должны стать неактивными.<br/><br/>
'''Реализация''': В директорию \classes\modules\exchange\ нужно добавить файл custom_events.php со следующим содержанием:

<source lang="php">
<?php
new umiEventListener("exchangeOnAddElement", "exchange", "onExchangeDisactivateElements");
new umiEventListener("exchangeOnUpdateElement", "exchange", "onExchangeDisactivateElements");
new umiEventListener("exchangeOnImportFinish", "exchange", "onImportFinishUnsetFlag");
new umiEventListener("exchangeOnAutoFinish", "exchange", "onImportFinishUnsetFlag");
?>
</source>

В этой же директории в файл __custom.php нужно добавить следующий код:

<source lang="php">
<?php
abstract class __custom_exchange {
public function onExchangeDisactivateElements(iUmiEventPoint $e) {
if ($e->getMode() === 'after') {
return;
}

$element = $e->getRef('element');

if ($element->getMethod() == 'category') {
return;
}

// начало импорта, деактивируем все товары
if (!file_exists("onExchangeDisactivateElementsFlag")) {
$pages = new selector('pages');
$pages->types('hierarchy-type')->name('catalog', 'object');

foreach ($pages as $p) {
$p->setIsActive(false);
}

file_put_contents("onExchangeDisactivateElementsFlag", "done");
}

$element->setIsActive(true);
}

public function onImportFinishUnsetFlag(iUmiEventPoint $e) {
unlink("onExchangeDisactivateElementsFlag");
}
}
?>
</source>

Мы добавили обработчик событий добавления и обновления элемента механизмом импорта, в котором все объекты каталога становятся неактивными, а импортируемые элементы - активными. Несколько замечаний:

* В процессе импорта в корне сайта будет создан файл onExchangeDisactivateElementsFlag. Это значит, что у umi.cms должны быть права на запись этой директории. После завершения импорта файл удалится. Если импорт по каким-то причинам прервется, то нужно будет вручную удалить файл.
* В нашей реализации селектор находит ВСЕ объекты каталога и делает их неактивными. Если у Вас очень много товаров на сайте, этот метод может быть неприемлемым из-за большого потребления оперативной памяти/ресурсов сервера. Если в процессе импорта Вы увидите сообщение "Ошибка разбора данных", это может означать, что сервер не успел деактивировать все объекты. В таком случае Вам нужно будет доработать скрипт, чтобы деактивация происходила поэтапно или каким-либо другим способом.Если Вам потребуется помощь в доработке скрипта, рекомендуем обратиться к нашим [http://www.umi-cms.ru/buy_now/find_webdevs/ партнерам:]

Как сделать активными только импортируемые товары

2016-02-08T13:15:32Z

Alexei:

Массовое удаление комментариев

2016-02-08T08:54:20Z

Alexei:

'''Актуально для версии 2.9.6'''

Можем возникнуть ситуация, когда на сайте не была включена captcha, и было оставлено большое количество спам-комментариев. Удалять их по-одному из административной панели будет очень долго, вместо этого для удаления мы будем использовать следующий код:

<source lang="php">
public function deleteComments() {

$amount = 100;
$pages = new selector('objects');
$pages->types('object-type')->id(66);
$pages->limit(0, $amount);
$ObjectsCollection = umiObjectsCollection::getInstance();

foreach($pages as $page)
$ObjectsCollection->delObject($page->getId());
}
</source>

Разместите данный код в файле classes/modules/custom.php после строки //TODO: Write your own macroses here. В строке
<source lang="php">
$pages->types('object-type')->id(66);
</source>
мы задаем id типа данных "Комментарии", если у Вас id типа данных "Комментарии" другой - тогда подставьте соответствующее значение.

В переменную
<source lang="php">
$amount = 100;
</source>

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

Для запуска макроса нужно в адресной строке браузера написать
<b>domain.ru/udata/custom/deleteComments</b>,
где <b>domain.ru</b> - это адрес вашего сайта

[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:Написание кастомных макросов]]

Вывод новостей по сюжету

2016-02-02T08:21:35Z

Alexei:

[[category:Написание кастомных макросов]][[Категория:API]][[Категория:Модуль_Новости]]
'''Актуально для версии 2.11'''

== Задача ==

Стандартно в UMI.CMS у типа данных "Новость" есть поле "Сюжеты", также есть одноименный тип данных.
У любой новости можно выбрать некоторое количество сюжетов:

[[Файл:Subject1.png]]

Есть макрос %news related_links()%, который выводит список последних новостей, связанных по сюжету с указанной новостью.
А если мы просто захотим вывести все новости, у которых указан определенный сюжеты или сюжеты, то такого макрос в системе нет.
Можно конечно указать у новости тег и вывести все страницы с указанным тегом, но это не самое красивое и удобное решение,
особенно, если используете теги для других нужд.

== Решение ==

В этой статье будет приведен макрос, решающий нашу задачу, но сначала нужно будет внести некоторые изменения в тип данных
"Сюжет публикации", добавим в этот тип данных следующую группу полей и поле, обязательно с теми же идентификаторами:

[[Файл:Subject2.png]]

Для использования, приведённого ниже, макроса, нам нужно будет заполнить созданное поле у элементов справочника "Сюжет публикации",
обязательно латинскими буквами, например так:

[[Файл:Subject3.png]]

А потом можно будет выбрать эти значения у новостей:

[[Файл:Subject4.png]]

== Описание макроса ==

%news subjectsList()% — выводит новости, относящиеся к выбранн(ому)ым сюже(ту)там.

'''Параметры: news subjectsList($id, [$template = 'default', $mode = 'and', $per_page = 0, $ignore_paging = false])'''

'''$id'''
Принимает идентификатор сюжета, поле, которое мы создали ранее. Можно указать несколько идентификатором через знак ";".
'''$template '''
Принимает имя шаблона, по которому выводится результат макроса, если его не указать, то он принимает значение 'default' В XSLT-шаблонизаторе игнорируется.
'''$mode'''
Принимаем два значения 'and' и 'or', когда выбрано 'and', макрос возвращает новости, среди сюжетов которых присутствуют указанные в параметре $id сюжеты,
когда выбрано 'or', макрос возвращаем новости, у которых сюжеты полностью совпадают с указанными в параметре $id сюжетами. Если параметр не указать, то
будет по-умолчанию равен 'and'.
'''$per_page '''
Принимает число, которое обозначает максимальное количество новостей. Если этот параметр не указывать, будет взято значение, указанное в настройках модуля «Новости».
'''$ignore_paging '''
Принимаем булево значение («1» или «0»), указывающее макросу игнорировать значение текущей страницы списка вывода (параметр http-запроса p). То есть, если указать «1»,
макрос будет всегда выводить только первую страницу списка новостей.

Для применения этого макроса скопируйте содержимое листинга макроса в файл /classes/modules/news/__custom.php, и не забудьте указать имя метода в permissions.custom.php, то
есть создать такой файл в директории /classes/modules/news/ со следующим содержимым:

<source lang="php">
<?php
$permissions = array(
'view' => array(
'subjectsList'
)
);
?>
</source>

== Листинг макроса ==

<source lang="php">
public function subjectsList($id = '', $template = '', $mode = '', $per_page = 0, $ignore_paging = false){
if(!$id){
throw new publicException('<b>В макросе news subjectsList() необходимо указать первый параметр $id</b>');
}

$id = preg_replace('/\s/', '', $id);
$parsId = array();
$parsId = explode(';',$id);
unset($id);

if(!$template){
$template = 'default';
}

if(!$mode){
$mode = 'and';
}

if(!$per_page){
(int) $per_page = $this->per_page;
}

if(!is_numeric($per_page)){
throw new publicException('<b>В макрос news subjectsList() передано некорректно значение номера страницы</b>');
}

list($template_block, $template_block_empty, $template_line) = def_module::loadTemplates("news/".$template, "items_block", "items_block_empty", "item_block");

$currPageNum = getRequest('p');

$resultSubjects = array();
$subjectsQuery = new selector('objects');
$subjectsQuery->types('object-type')->name('news', 'subject');
$subjectsQuery->where('subject-id')->equals($parsId);
$resultSubjects = $subjectsQuery->result();
unset($subjectsQuery, $parsId);

(int) $countSubject = count($resultSubjects);

if($countSubject === 0){
throw new publicException('<b>Сюжеты с переданными id не найдены</b>');
}

$resultItems = array();
$itemsQuery = new selector('pages');
$itemsQuery->types('object-type')->name('news', 'item');
$itemsQuery->option('or-mode')->field('subjects');
$itemsQuery->where('subjects')->equals($resultSubjects);

switch ($mode){
case 'or':
$allItems = array();
$allItems = $itemsQuery->result();

if(count($allItems) === 0){
return $template_block_empty;
}

foreach($allItems as $oneItem){
$items = array();
$items[] = $oneItem->getValue('subjects');

foreach($items as $item){
$test = array();
$test = array_diff($resultSubjects, $item);

if (count($test) === 0){

if($countSubject > 1){
$resultItems[] = $oneItem;

}elseif(count($item) === 1){
$resultItems[] = $oneItem;
}
}
}
}
unset($itemsQuery, $allItems, $oneItem, $items, $item, $test, $resultSubjects, $countSubject);

usort($resultItems, function($a, $b){

$a_publishTime = $a->getValue('publish_time');
$b_publishTime = $b->getValue('publish_time');

if ($a_publishTime == $b_publishTime) {
return 0;
}
return ($a_publishTime > $b_publishTime) ? -1 : 1;
});

if(intval($ignore_paging) === 0){
$offset = 0;
$offset = intval($currPageNum) * intval($per_page);

$resultItems = array_slice($resultItems, $offset, $per_page);
unset($offset);
}
$total = 0;
$total = count($resultItems);

break;

case 'and':
unset($resultSubjects, $countSubject);

$itemsQuery->order('publish_time')->desc();

if(intval($ignore_paging) === 0){
$offset = 0;
$offset = intval($currPageNum) * intval($per_page);
$itemsQuery->limit($offset , intval($per_page));
}
$total = 0;
$total = $itemsQuery->length();
$resultItems = $itemsQuery->result();
unset($itemsQuery, $offset);

break;

default:
throw new publicException('<b>В макросе news subjectsList() необходимо указать корректное значение параметра $mode (or или and)</b>');
}
if($total === 0){
return $template_block_empty;
}else{
$lines = Array();
$block_arr = Array();

foreach ($resultItems as $resultItem){
$line_arr = array();

$itemId = $resultItem->id;
$line_arr['attribute:id'] = $itemId;
$line_arr['attribute:link'] = $resultItem->link;
$line_arr['xlink:href'] = "upage://" . $itemId;
$line_arr['void:header'] = $lines_arr['name'] = $resultItem->getName();
$line_arr['node:name'] = $resultItem->getName();

if($publish_time = $resultItem->getValue('publish_time')){
$line_arr['attribute:publish_time'] = $publish_time->getFormattedDate("U");
}
unset($resultItems, $resultItem);

$lines[] = def_module::parseTemplate($template_line, $line_arr, $itemId);
unset($line_arr);

$this->pushEditable("news", "item", $itemId);
unset($itemId);
}
$block_arr['subnodes:items'] = $block_arr['void:lines'] = $lines;
unset($lines);

$block_arr['total'] = $total;
$block_arr['per_page'] = $per_page;
unset($total, $per_page);

return def_module::parseTemplate($template_block, $block_arr);
}
}
</source>

== Применение в xslt ==

'''Пример вызова'''

<source lang="xml">
udata/news/subjectsList/(eco;pol)//or/3/1/
</source>

'''XML-ответ UData'''

<source lang="xml">
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="news" method="subjectsList" generation-time="0.075129">
<items>
<item id="191" link="/novosti3/novost7/" xlink:href="upage://191" publish_time="1382102520">Новость7</item>
<item id="190" link="/novosti3/novost6/" xlink:href="upage://190" publish_time="1382102520">Новость6</item>
<item id="189" link="/novosti3/novost5/" xlink:href="upage://189" publish_time="1382102520">Новость5</item>
<item id="187" link="/novosti2/novost4/" xlink:href="upage://187" publish_time="1382001240">Новость4</item>
<item id="185" link="/novosti2/novost2/" xlink:href="upage://185" publish_time="1381913100">Новость2</item>
<item id="184" link="/novosti2/novost1/" xlink:href="upage://184" publish_time="1381826640">Новость1</item>
<item id="186" link="/news1/novost3/" xlink:href="upage://186" publish_time="1381742040">Новость3</item>
<item id="78" link="/news1/speshite_akciya/" xlink:href="upage://78" publish_time="1261279500">Новость9</item>
<item id="79" link="/news1/ne_speshite_ona_zakonchilas/" xlink:href="upage://79" publish_time="1259020800">Новость8</item>
</items>
<total>9</total>
<per_page>3</per_page>
</udata>
</source>

'''Элементы и атрибуты'''

'''<items>'''

Ветвь, содержащая элементы item — новости.
'''<item>'''

Элемент, описывающий отдельную новость. Значение элемента — название страницы новости.
'''@id'''

Идентификатор страницы новости.
'''@link'''

Ссылка на страницу полного текста новости.
'''@xlink:href'''

Ссылка UPage на страницу полного текста новости.
'''@publish_time'''

Время публикации новости в UNIX TIMESTAMP.
'''<total>'''

Общее количество полученных новостей.
'''<per_page>'''

Количество новостей, отображаемых на странице.

== Применение в tpl ==

'''Пример вызова макроса'''

<source lang="php">
%news subjectsList('eco;pol', 'subjects', 'or', '10', '1')%
</source>

Чтобы вызов сработал, нужно создать файл /tpls/news/subjects.tpl с таким содержимым:

<source lang="php">
<?php
$FORMS = Array();

$FORMS['item_block'] = <<<END
<li>
<p>Новость<p>
</li>
END;

$FORMS['items_block'] = <<<END
<ul>%items%</ul>
END;

$FORMS['items_block_empty'] = <<<END
<p>Нет таких новостей.</p>
END;
?>
</source>

'''Используемые шаблоны'''

Макрос оперирует шаблонами, находящимися в каталоге /tpls/news/. Вывод макроса осуществляется по шаблону, указанному в параметре template.
Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию — default.tpl.

'''Используемые блоки шаблона'''

'''items_block'''

Выводит обрамляющий блок для вывода результатов работы макроса, куда будут подставляться результирующие элементы. Отдельные новости будут отрисованы по блоку item.

'''%items%'''

Выводит список страниц, отрисованных с помощью блока item_block.

'''item_block'''

Отвечает за вывод отдельной новости, полученной в результате работы макроса.

'''%id%'''

Выводит id новости.
'''%link%'''

Выводит uri новости.
'''%value%'''

Выводит название новости.
'''%publish_time%'''

Выводит время публикации новости в UNIX TIMESTAMP.
'''%total%'''

Общее количество полученных новостей.
'''%per_page%'''

Выводит количество новостей, отображаемых на странице.

'''items_block_empty'''

Используется вместо блока items_block в том случае, если новостей, которые необходимо вывести нет.

Вывод новостей по сюжету

2016-02-02T08:20:10Z

Alexei: Правки Alexei (обсуждение) откачены к версии Mad grant

[[category:Написание кастомных макросов]][[Категория:API]][[Категория:Модуль_Новости]]
'''Актуально для версии 2.9.1'''

== Задача ==

Стандартно в UMI.CMS у типа данных "Новость" есть поле "Сюжеты", также есть одноименный тип данных.
У любой новости можно выбрать некоторое количество сюжетов:

[[Файл:Subject1.png]]

Есть макрос %news related_links()%, который выводит список последних новостей, связанных по сюжету с указанной новостью.
А если мы просто захотим вывести все новости, у которых указан определенный сюжеты или сюжеты, то такого макрос в системе нет.
Можно конечно указать у новости тег и вывести все страницы с указанным тегом, но это не самое красивое и удобное решение,
особенно, если используете теги для других нужд.

== Решение ==

В этой статье будет приведен макрос, решающий нашу задачу, но сначала нужно будет внести некоторые изменения в тип данных
"Сюжет публикации", добавим в этот тип данных следующую группу полей и поле, обязательно с теми же идентификаторами:

[[Файл:Subject2.png]]

Для использования, приведённого ниже, макроса, нам нужно будет заполнить созданное поле у элементов справочника "Сюжет публикации",
обязательно латинскими буквами, например так:

[[Файл:Subject3.png]]

А потом можно будет выбрать эти значения у новостей:

[[Файл:Subject4.png]]

== Описание макроса ==

%news subjectsList()% — выводит новости, относящиеся к выбранн(ому)ым сюже(ту)там.

'''Параметры: news subjectsList($id, [$template = 'default', $mode = 'and', $per_page = 0, $ignore_paging = false])'''

'''$id'''
Принимает идентификатор сюжета, поле, которое мы создали ранее. Можно указать несколько идентификатором через знак ";".
'''$template '''
Принимает имя шаблона, по которому выводится результат макроса, если его не указать, то он принимает значение 'default' В XSLT-шаблонизаторе игнорируется.
'''$mode'''
Принимаем два значения 'and' и 'or', когда выбрано 'and', макрос возвращает новости, среди сюжетов которых присутствуют указанные в параметре $id сюжеты,
когда выбрано 'or', макрос возвращаем новости, у которых сюжеты полностью совпадают с указанными в параметре $id сюжетами. Если параметр не указать, то
будет по-умолчанию равен 'and'.
'''$per_page '''
Принимает число, которое обозначает максимальное количество новостей. Если этот параметр не указывать, будет взято значение, указанное в настройках модуля «Новости».
'''$ignore_paging '''
Принимаем булево значение («1» или «0»), указывающее макросу игнорировать значение текущей страницы списка вывода (параметр http-запроса p). То есть, если указать «1»,
макрос будет всегда выводить только первую страницу списка новостей.

Для применения этого макроса скопируйте содержимое листинга макроса в файл /classes/modules/news/__custom.php, и не забудьте указать имя метода в permissions.custom.php, то
есть создать такой файл в директории /classes/modules/news/ со следующим содержимым:

<source lang="php">
<?php
$permissions = array(
'view' => array(
'subjectsList'
)
);
?>
</source>

== Листинг макроса ==

<source lang="php">
public function subjectsList($id = '', $template = '', $mode = '', $per_page = 0, $ignore_paging = false){
if(!$id){
throw new publicException('<b>В макросе news subjectsList() необходимо указать первый параметр $id</b>');
}

$id = preg_replace('/\s/', '', $id);
$parsId = array();
$parsId = explode(';',$id);
unset($id);

if(!$template){
$template = 'default';
}

if(!$mode){
$mode = 'and';
}

if(!$per_page){
(int) $per_page = $this->per_page;
}

if(!is_numeric($per_page)){
throw new publicException('<b>В макрос news subjectsList() передано некорректно значение номера страницы</b>');
}

list($template_block, $template_block_empty, $template_line) = def_module::loadTemplates("news/".$template, "items_block", "items_block_empty", "item_block");

$currPageNum = getRequest('p');

$resultSubjects = array();
$subjectsQuery = new selector('objects');
$subjectsQuery->types('object-type')->name('news', 'subject');
$subjectsQuery->where('subject-id')->equals($parsId);
$resultSubjects = $subjectsQuery->result();
unset($subjectsQuery, $parsId);

(int) $countSubject = count($resultSubjects);

if($countSubject === 0){
throw new publicException('<b>Сюжеты с переданными id не найдены</b>');
}

$resultItems = array();
$itemsQuery = new selector('pages');
$itemsQuery->types('object-type')->name('news', 'item');
$itemsQuery->option('or-mode')->field('subjects');
$itemsQuery->where('subjects')->equals($resultSubjects);

switch ($mode){
case 'or':
$allItems = array();
$allItems = $itemsQuery->result();

if(count($allItems) === 0){
return $template_block_empty;
}

foreach($allItems as $oneItem){
$items = array();
$items[] = $oneItem->getValue('subjects');

foreach($items as $item){
$test = array();
$test = array_diff($resultSubjects, $item);

if (count($test) === 0){

if($countSubject > 1){
$resultItems[] = $oneItem;

}elseif(count($item) === 1){
$resultItems[] = $oneItem;
}
}
}
}
unset($itemsQuery, $allItems, $oneItem, $items, $item, $test, $resultSubjects, $countSubject);

usort($resultItems, function($a, $b){

$a_publishTime = $a->getValue('publish_time');
$b_publishTime = $b->getValue('publish_time');

if ($a_publishTime == $b_publishTime) {
return 0;
}
return ($a_publishTime > $b_publishTime) ? -1 : 1;
});

if(intval($ignore_paging) === 0){
$offset = 0;
$offset = intval($currPageNum) * intval($per_page);

$resultItems = array_slice($resultItems, $offset, $per_page);
unset($offset);
}
$total = 0;
$total = count($resultItems);

break;

case 'and':
unset($resultSubjects, $countSubject);

$itemsQuery->order('publish_time')->desc();

if(intval($ignore_paging) === 0){
$offset = 0;
$offset = intval($currPageNum) * intval($per_page);
$itemsQuery->limit($offset , intval($per_page));
}
$total = 0;
$total = $itemsQuery->length();
$resultItems = $itemsQuery->result();
unset($itemsQuery, $offset);

break;

default:
throw new publicException('<b>В макросе news subjectsList() необходимо указать корректное значение параметра $mode (or или and)</b>');
}
if($total === 0){
return $template_block_empty;
}else{
$lines = Array();
$block_arr = Array();

foreach ($resultItems as $resultItem){
$line_arr = array();

$itemId = $resultItem->id;
$line_arr['attribute:id'] = $itemId;
$line_arr['attribute:link'] = $resultItem->link;
$line_arr['xlink:href'] = "upage://" . $itemId;
$line_arr['void:header'] = $lines_arr['name'] = $resultItem->getName();
$line_arr['node:name'] = $resultItem->getName();

if($publish_time = $resultItem->getValue('publish_time')){
$line_arr['attribute:publish_time'] = $publish_time->getFormattedDate("U");
}
unset($resultItems, $resultItem);

$lines[] = def_module::parseTemplate($template_line, $line_arr, $itemId);
unset($line_arr);

$this->pushEditable("news", "item", $itemId);
unset($itemId);
}
$block_arr['subnodes:items'] = $block_arr['void:lines'] = $lines;
unset($lines);

$block_arr['total'] = $total;
$block_arr['per_page'] = $per_page;
unset($total, $per_page);

return def_module::parseTemplate($template_block, $block_arr);
}
}
</source>

== Применение в xslt ==

'''Пример вызова'''

<source lang="xml">
udata/news/subjectsList/(eco;pol)//or/3/1/
</source>

'''XML-ответ UData'''

<source lang="xml">
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="news" method="subjectsList" generation-time="0.075129">
<items>
<item id="191" link="/novosti3/novost7/" xlink:href="upage://191" publish_time="1382102520">Новость7</item>
<item id="190" link="/novosti3/novost6/" xlink:href="upage://190" publish_time="1382102520">Новость6</item>
<item id="189" link="/novosti3/novost5/" xlink:href="upage://189" publish_time="1382102520">Новость5</item>
<item id="187" link="/novosti2/novost4/" xlink:href="upage://187" publish_time="1382001240">Новость4</item>
<item id="185" link="/novosti2/novost2/" xlink:href="upage://185" publish_time="1381913100">Новость2</item>
<item id="184" link="/novosti2/novost1/" xlink:href="upage://184" publish_time="1381826640">Новость1</item>
<item id="186" link="/news1/novost3/" xlink:href="upage://186" publish_time="1381742040">Новость3</item>
<item id="78" link="/news1/speshite_akciya/" xlink:href="upage://78" publish_time="1261279500">Новость9</item>
<item id="79" link="/news1/ne_speshite_ona_zakonchilas/" xlink:href="upage://79" publish_time="1259020800">Новость8</item>
</items>
<total>9</total>
<per_page>3</per_page>
</udata>
</source>

'''Элементы и атрибуты'''

'''<items>'''

Ветвь, содержащая элементы item — новости.
'''<item>'''

Элемент, описывающий отдельную новость. Значение элемента — название страницы новости.
'''@id'''

Идентификатор страницы новости.
'''@link'''

Ссылка на страницу полного текста новости.
'''@xlink:href'''

Ссылка UPage на страницу полного текста новости.
'''@publish_time'''

Время публикации новости в UNIX TIMESTAMP.
'''<total>'''

Общее количество полученных новостей.
'''<per_page>'''

Количество новостей, отображаемых на странице.

== Применение в tpl ==

'''Пример вызова макроса'''

<source lang="php">
%news subjectsList('eco;pol', 'default', 'or', '10', '1')%
</source>

'''Используемые шаблоны'''

Макрос оперирует шаблонами, находящимися в каталоге /tpls/news/. Вывод макроса осуществляется по шаблону, указанному в параметре template.
Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию — default.tpl.

'''Используемые блоки шаблона'''

'''items_block'''

Выводит обрамляющий блок для вывода результатов работы макроса, куда будут подставляться результирующие элементы. Отдельные новости будут отрисованы по блоку item.

'''%items%'''

Выводит список страниц, отрисованных с помощью блока item_block.

'''item_block'''

Отвечает за вывод отдельной новости, полученной в результате работы макроса.

'''%id%'''

Выводит id новости.
'''%link%'''

Выводит uri новости.
'''%value%'''

Выводит название новости.
'''%publish_time%'''

Выводит время публикации новости в UNIX TIMESTAMP.
'''%total%'''

Общее количество полученных новостей.
'''%per_page%'''

Выводит количество новостей, отображаемых на странице.

'''items_block_empty'''

Используется вместо блока items_block в том случае, если новостей, которые необходимо вывести нет.

Вывод новостей по сюжету

2016-02-02T08:17:55Z

Alexei:

В этой статье будет приведен макрос, решающий нашу задачу, но сначала нужно будет внести некоторые изменения в тип данных
"Сюжет публикации", добавим в этот тип данных следующую группу полей и поле, обязательно с теми же идентификаторами:

[[Файл:Subject2.png]]

Для использования, приведённого ниже, макроса, нам нужно будет заполнить созданное поле у элементов справочника "Сюжет публикации",
обязательно латинскими буквами, например так:

[[Файл:Subject3.png]]

А потом можно будет выбрать эти значения у новостей:

[[Файл:Subject4.png]]

== Описание макроса ==

%news subjectsList()% — выводит новости, относящиеся к выбранн(ому)ым сюже(ту)там.

'''Параметры: news subjectsList($id, [$template = 'default', $mode = 'and', $per_page = 0, $ignore_paging = false])'''

'''$id'''
Принимает идентификатор сюжета, поле, которое мы создали ранее. Можно указать несколько идентификатором через знак ";".
'''$template '''
Принимает имя шаблона, по которому выводится результат макроса, если его не указать, то он принимает значение 'default' В XSLT-шаблонизаторе игнорируется.
'''$mode'''
Принимаем два значения 'and' и 'or', когда выбрано 'and', макрос возвращает новости, среди сюжетов которых присутствуют указанные в параметре $id сюжеты,
когда выбрано 'or', макрос возвращаем новости, у которых сюжеты полностью совпадают с указанными в параметре $id сюжетами. Если параметр не указать, то
будет по-умолчанию равен 'and'.
'''$per_page '''
Принимает число, которое обозначает максимальное количество новостей. Если этот параметр не указывать, будет взято значение, указанное в настройках модуля «Новости».
'''$ignore_paging '''
Принимаем булево значение («1» или «0»), указывающее макросу игнорировать значение текущей страницы списка вывода (параметр http-запроса p). То есть, если указать «1»,
макрос будет всегда выводить только первую страницу списка новостей.

Для применения этого макроса скопируйте содержимое листинга макроса в файл /classes/modules/news/__custom.php, и не забудьте указать имя метода в permissions.custom.php, то
есть создать такой файл в директории /classes/modules/news/ со следующим содержимым:

<source lang="php">
<?php
$permissions = array(
'view' => array(
'subjectsList'
)
);
?>
</source>

== Листинг макроса ==

<source lang="php">
public function subjectsList($id = '', $template = '', $mode = '', $per_page = 0, $ignore_paging = false){
if(!$id){
throw new publicException('<b>В макросе news subjectsList() необходимо указать первый параметр $id</b>');
}

$id = preg_replace('/\s/', '', $id);
$parsId = array();
$parsId = explode(';',$id);
unset($id);

if(!$template){
$template = 'default';
}

if(!$mode){
$mode = 'and';
}

if(!$per_page){
(int) $per_page = $this->per_page;
}

if(!is_numeric($per_page)){
throw new publicException('<b>В макрос news subjectsList() передано некорректно значение номера страницы</b>');
}

list($template_block, $template_block_empty, $template_line) = def_module::loadTemplates("news/".$template, "items_block", "items_block_empty", "item_block");

$currPageNum = getRequest('p');

$resultSubjects = array();
$subjectsQuery = new selector('objects');
$subjectsQuery->types('object-type')->name('news', 'subject');
$subjectsQuery->where('subject-id')->equals($parsId);
$resultSubjects = $subjectsQuery->result();
unset($subjectsQuery, $parsId);

(int) $countSubject = count($resultSubjects);

if($countSubject === 0){
throw new publicException('<b>Сюжеты с переданными id не найдены</b>');
}

$resultItems = array();
$itemsQuery = new selector('pages');
$itemsQuery->types('object-type')->name('news', 'item');
$itemsQuery->option('or-mode')->field('subjects');
$itemsQuery->where('subjects')->equals($resultSubjects);

switch ($mode){
case 'or':
$allItems = array();
$allItems = $itemsQuery->result();

if(count($allItems) === 0){
return $template_block_empty;
}

foreach($allItems as $oneItem){
$items = array();
$items[] = $oneItem->getValue('subjects');

foreach($items as $item){
$test = array();
$test = array_diff($resultSubjects, $item);

if (count($test) === 0){

if($countSubject > 1){
$resultItems[] = $oneItem;

}elseif(count($item) === 1){
$resultItems[] = $oneItem;
}
}
}
}
unset($itemsQuery, $allItems, $oneItem, $items, $item, $test, $resultSubjects, $countSubject);

usort($resultItems, function($a, $b){

$a_publishTime = $a->getValue('publish_time');
$b_publishTime = $b->getValue('publish_time');

if ($a_publishTime == $b_publishTime) {
return 0;
}
return ($a_publishTime > $b_publishTime) ? -1 : 1;
});

if(intval($ignore_paging) === 0){
$offset = 0;
$offset = intval($currPageNum) * intval($per_page);

$resultItems = array_slice($resultItems, $offset, $per_page);
unset($offset);
}
$total = 0;
$total = count($resultItems);

break;

case 'and':
unset($resultSubjects, $countSubject);

$itemsQuery->order('publish_time')->desc();

if(intval($ignore_paging) === 0){
$offset = 0;
$offset = intval($currPageNum) * intval($per_page);
$itemsQuery->limit($offset , intval($per_page));
}
$total = 0;
$total = $itemsQuery->length();
$resultItems = $itemsQuery->result();
unset($itemsQuery, $offset);

break;

default:
throw new publicException('<b>В макросе news subjectsList() необходимо указать корректное значение параметра $mode (or или and)</b>');
}
if($total === 0){
return $template_block_empty;
}else{
$lines = Array();
$block_arr = Array();

foreach ($resultItems as $resultItem){
$line_arr = array();

$itemId = $resultItem->id;
$line_arr['attribute:id'] = $itemId;
$line_arr['attribute:link'] = $resultItem->link;
$line_arr['xlink:href'] = "upage://" . $itemId;
$line_arr['void:header'] = $lines_arr['name'] = $resultItem->getName();
$line_arr['node:name'] = $resultItem->getName();

if($publish_time = $resultItem->getValue('publish_time')){
$line_arr['attribute:publish_time'] = $publish_time->getFormattedDate("U");
}
unset($resultItems, $resultItem);

$lines[] = def_module::parseTemplate($template_line, $line_arr, $itemId);
unset($line_arr);

$this->pushEditable("news", "item", $itemId);
unset($itemId);
}
$block_arr['subnodes:items'] = $block_arr['void:lines'] = $lines;
unset($lines);

$block_arr['total'] = $total;
$block_arr['per_page'] = $per_page;
unset($total, $per_page);

return def_module::parseTemplate($template_block, $block_arr);
}
}
</source>

== Применение в xslt ==

'''Пример вызова'''

<source lang="xml">
udata/news/subjectsList/(eco;pol)//or/3/1/
</source>

'''XML-ответ UData'''

<source lang="xml">
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="news" method="subjectsList" generation-time="0.075129">
<items>
<item id="191" link="/novosti3/novost7/" xlink:href="upage://191" publish_time="1382102520">Новость7</item>
<item id="190" link="/novosti3/novost6/" xlink:href="upage://190" publish_time="1382102520">Новость6</item>
<item id="189" link="/novosti3/novost5/" xlink:href="upage://189" publish_time="1382102520">Новость5</item>
<item id="187" link="/novosti2/novost4/" xlink:href="upage://187" publish_time="1382001240">Новость4</item>
<item id="185" link="/novosti2/novost2/" xlink:href="upage://185" publish_time="1381913100">Новость2</item>
<item id="184" link="/novosti2/novost1/" xlink:href="upage://184" publish_time="1381826640">Новость1</item>
<item id="186" link="/news1/novost3/" xlink:href="upage://186" publish_time="1381742040">Новость3</item>
<item id="78" link="/news1/speshite_akciya/" xlink:href="upage://78" publish_time="1261279500">Новость9</item>
<item id="79" link="/news1/ne_speshite_ona_zakonchilas/" xlink:href="upage://79" publish_time="1259020800">Новость8</item>
</items>
<total>9</total>
<per_page>3</per_page>
</udata>
</source>

'''Элементы и атрибуты'''

'''<items>'''

Ветвь, содержащая элементы item — новости.
'''<item>'''

Элемент, описывающий отдельную новость. Значение элемента — название страницы новости.
'''@id'''

Идентификатор страницы новости.
'''@link'''

Ссылка на страницу полного текста новости.
'''@xlink:href'''

Ссылка UPage на страницу полного текста новости.
'''@publish_time'''

Время публикации новости в UNIX TIMESTAMP.
'''<total>'''

Общее количество полученных новостей.
'''<per_page>'''

Количество новостей, отображаемых на странице.

== Применение в tpl ==

'''Пример вызова макроса'''

<source lang="php">
%news subjectsList('eco;pol', 'subjects', 'or', '10', '1')%
</source>

Чтобы вызов сработал, нужно создать файл /tpls/news/subjects.tpl с таким содержимым:

<source lang="php">
<?php
$FORMS = Array();

$FORMS['item_block'] = <<<END
<li>
<p>Новость<p>
</li>
END;

$FORMS['items_block'] = <<<END
<ul>%items%</ul>
END;

$FORMS['items_block_empty'] = <<<END
<p>Нет таких новостей.</p>
END;
?>
</source>

'''Используемые шаблоны'''

Макрос оперирует шаблонами, находящимися в каталоге /tpls/news/. Вывод макроса осуществляется по шаблону, указанному в параметре template.
Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию — default.tpl.

'''Используемые блоки шаблона'''

'''items_block'''

Выводит обрамляющий блок для вывода результатов работы макроса, куда будут подставляться результирующие элементы. Отдельные новости будут отрисованы по блоку item.

'''%items%'''

Выводит список страниц, отрисованных с помощью блока item_block.

'''item_block'''

Отвечает за вывод отдельной новости, полученной в результате работы макроса.

'''%id%'''

Выводит id новости.
'''%link%'''

Выводит uri новости.
'''%value%'''

Выводит название новости.
'''%publish_time%'''

Выводит время публикации новости в UNIX TIMESTAMP.
'''%total%'''

Общее количество полученных новостей.
'''%per_page%'''

Выводит количество новостей, отображаемых на странице.

'''items_block_empty'''

Используется вместо блока items_block в том случае, если новостей, которые необходимо вывести нет.

Автоматическая подготовка экспорта в формат YML с помощью cron

2016-02-01T12:39:12Z

Alexei:

'''Актуально для версии 2.11'''

Если на вашем сайте большое количество товаров и, соответственно, подготовка экспорта в формат YML занимает продолжительное время, то возникает необходимость запускать данную подготовку, например, ночью, чтобы днем была меньше нагрузка на сайт. Для выполнения данной задачи необходимо сделать следующее:

1) В папке classes/modules/exchange разместите файл custom_events.php , и в нем пропишите следующий код:

<source lang="php">
<?php
new umiEventListener("cron", "exchange", "prepareElementsToExportCustom");
?>
</source>

2) В файле classes/modules/exchange/__custom.php после строки //TODO: Write your macroses here добавьте следующий код:

<source lang="php">
public function prepareElementsToExportCustom() {
$objectId = '885'; // пропишите в эту переменную id выгрузки YML

$objects = umiObjectsCollection::getInstance();
$object = $objects->getObject($objectId);
$formatId = $object->format;
$format = $objects->getObject($formatId);
$suffix = $format->sid;
if($suffix != 'YML') {
return;
}

if(!file_exists(CURRENT_WORKING_DIR . "/sys-temp/yml/" . $objectId . 'el')) {
throw new publicException('<a href="' . getLabel("label-errors-no-information") . '" target="blank">' . getLabel("label-errors-no-information") .'</a>');
}

$elements = unserialize(file_get_contents(CURRENT_WORKING_DIR . "/sys-temp/yml/" . $objectId . 'el'));
$hierarchy = umiHierarchy::getInstance();

foreach ($elements as $elementId) {
$element = $hierarchy->getElement($elementId);

if ($element instanceof umiHierarchyElement) {
try {
$element->updateYML();
} catch (Exception $e) {
echo $e->getMessage() . " #{$elementId}";
return;
}
}
}
}
</source>

Все, теперь осталось только настроить автоматический запуск cron на какое-то время, это вы самостоятельно устанавливаете на хостинге, информацию о cron в нашей документации вы можете посмотреть здесь: http://dev.docs.umi-cms.ru/nastrojka_sistemy/cron/ .

Обратите внимание: в скрипте загружаются все товары сразу, поэтому на обработку большого каталога может уйти много оперативной памяти и времени.

[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:Модуль Обмен данными]][[Категория:Написание кастомных макросов]]

Обратная связь: Сохранение значений полей при возникновении ошибок отправки

2016-01-27T07:53:22Z

Alexei:

'''''Проблема: при отправке сообщения из формы обратной связи с некорректно заполненными полями после сообщения об ошибке значения полей исчезают.'''''

Чтобы введенные ранее значения полей оставались после перезагрузки страницы, предлагаем следующее решение для макроса '''%webforms add()%'''

Правим шаблон по которому у вас выводится форма. 

 Необходимо добавить в тег '''<form>''' параметры '''id="webform"''' и '''onsubmit="saveFormData(this); return true;"'''.
Ниже тега '''</form>''' добавим следующий скрипт:

<pre>
<script type="text/javascript">
restoreFormData(document.getElementById('webform'));
</script>
</pre>

Если в шаблон ранее не вносилось поправок, блок будет выглядеть следующим образом:

<source lang="html4strict">
$FORMS['form_block'] = <<<END
<form enctype="multipart/form-data" method="post" action="/webforms/send/" id="webform" onsubmit="saveFormData(this); return true;">
<input type="hidden" name="system_form_id" value="%form_id%" />
<input type="hidden" name="system_template" value="%template%" />
%address_select%
%groups%
</form>
<script type="text/javascript">
restoreFormData(document.getElementById('webform'));
</script>
END;
</source>

Теперь при возникновении ошибок при отправке сообщения значения полей будут сохраняться.

Добавленные функции находятся в файле '''js/guest.js''', по-этому, что бы функционал работал, в шаблоне страницы этот скрипт должен вызываться. Вызов этого скрипта осуществляет макрос '''%system includeQuickEditJs()%'''. Имейте в виду, что по умолчанию файл '''js/guest.js''' подключается только для пользователя-гостя. Если Вы хотите, чтобы функции были доступны для всех типов пользователей, можно создать новый файл с функциями '''saveFormData''' и '''restoreFormData''' и подключать его вручную.

[[Категория:Модуль Обратная связь]]

XSLT шаблоны для всех типов баннеров

2016-01-20T10:39:30Z

Alexei:

[[Категория: Верстка в XSLT]][[Категория: Модуль Баннеры]]
'''Актуально для версии 2.9.6'''<br/><br/>
'''Задача:''' Добавить шаблоны вывода баннеров всех типов: с картинкой, флэшкой и HTML.<br/><br/>
'''Реализация:'''

В директории с XSLT-шаблонами (папка '''./xsltTpls''' или '''./templates/имя_шаблона/xslt''' при новом формате хранения шаблонов) создадим новый файл banners.xsl и добавим в него следующее содержимое:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:date="http://exslt.org/dates-and-times"
xmlns:udt="http://umi-cms.ru/2007/UData/templates"
xmlns:umi="http://www.umi-cms.ru/TR/umi"
xmlns:xlink="http://www.w3.org/1999/xlink"
exclude-result-prefixes="xsl date udt xlink">

<xsl:template match="udata[@module = 'banners'][@method = 'fastInsert']" />

<xsl:template match="udata[@module = 'banners'][@method = 'fastInsert'][banner]">
<div class="gray_block">
<xsl:apply-templates select="banner" />
</div>
</xsl:template>

<xsl:template match="udata[@module = 'banners'][@method = 'fastInsert']">
<xsl:apply-templates select="banner" />
</xsl:template>

<xsl:template match="banner" />

<xsl:template match="banner[@type = 'image']">
<xsl:choose>
<xsl:when test="href">
<a href="/banners/go_to/{/udata/@id}/">
<xsl:if test="@target">
<xsl:attribute name="target">
<xsl:value-of select="@target" />
</xsl:attribute>
</xsl:if>
<img src="{source}" width="{@width}" height="{@height}" alt="{alt}" border="0" />
</a>
</xsl:when>
<xsl:otherwise>
<img src="{source}" width="{@width}" height="{@height}" alt="{alt}" border="0" />
</xsl:otherwise>
</xsl:choose>
</xsl:template>

<xsl:template match="banner[@type = 'swf']">
<object width="{@width}" height="{@height}" align="middle"
codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,0,0"
classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000">
<param name="allowScriptAccess" value="sameDomain" />
<param name="movie" value="{source}" />
<param name="quality" value="high" />
<param name="bgcolor" value="#ffffff" />
<param name="wmode" value="opaque" />
<xsl:if test="href">
<param name="flashVars">
<xsl:attribute name="value">
<xsl:text>url=/banners/go_to/</xsl:text><xsl:value-of select="/udata/@id" /><xsl:text>/</xsl:text>
<xsl:if test="@target">
<xsl:text>&target=</xsl:text><xsl:value-of select="@target" />
</xsl:if>
</xsl:attribute>
</param>
</xsl:if>
<embed width="{@width}" height="{@height}" align="middle" wmode="opaque"
pluginspage="http://www.macromedia.com/go/getflashplayer"
type="application/x-shockwave-flash" allowscriptaccess="sameDomain"
name="banner" bgcolor="#ffffff" quality="high" src="{source}">
<xsl:if test="href">
<xsl:attribute name="flashVars">
<xsl:text>url=/banners/go_to/</xsl:text><xsl:value-of select="/udata/@id" /><xsl:text>/</xsl:text>
<xsl:if test="@target">
<xsl:text>&target=</xsl:text><xsl:value-of select="@target" />
</xsl:if>
</xsl:attribute>
</xsl:if>
</embed>
</object>
</xsl:template>

<xsl:template match="banner[@type = 'html']">
<xsl:value-of select="source" disable-output-escaping="yes" />
</xsl:template>

</xsl:stylesheet>
</source>

В основном файле шаблона (название файла можно посмотреть в настройках модуля "Структура") добавим строку подключения созданного файла banners.xsl:
<source lang="xml">
<xsl:include href="banners.xsl" />
</source>

Данные шаблоны обрабатывают результаты работы макроса '''banners fastInsert()'''. Пример вызова данного макроса приведен ниже:
<source lang="xml">
<xsl:apply-templates select="document('udata://banners/fastInsert/(идентификатор_рекламного_места)')/udata/banner"/>
</source>

Как сделать активными только импортируемые товары

2015-12-30T08:51:11Z

Alexei:

Удаление элементов или снятие активности при импорте данных из 1С

2015-12-25T11:15:40Z

Alexei:

[[category:Интеграция с 1С]]
Актуально для 2.9.6

----

В XSL-Шаблоне импорта xsl/import/commerceML2.xsl, в шаблоне "Товары/Товар", прописан следующий блок:
<source lang="xml">
<xsl:if test="Статус = 'Удален'">
<xsl:attribute name="is-deleted">1</xsl:attribute>
</xsl:if>
</source>
данные строки добавляют в узел <page> атрибут is-deleted="1" в том случае, если в системе 1С для какого либо элемента (раздел, номенклатура) была поставлена "Пометка удаления". В итоге, при обработке данных, UMI.CMS помеченный элемент переместит в "Корзину", но он по прежнему будет существовать в системе и при повторном импорте данных, помещенный элемент в корзину будет обновляться. Для полного удаления элемента его необходимо удалить из Корзины.

Некоторые версии 1С передают статус "Удален" не как отдельный элемент <Статус>Удален</Статус> в xml-дереве товара, а как атрибут у элемента <Товар Статус="Удален">. В этом случае для удаления товара при импорте из 1С, если он помечене на удаление, нужно в скопировать темплейт <xsl:template match="Товары/Товар"> из файла /xsl/import/commerceML2.xsl в файл /xsl/import/custom/commerceML2.xsl и добавить после условия
<source lang="xml">
<xsl:if test="Статус = 'Удален'">
<xsl:attribute name="is-deleted">1</xsl:attribute>
</xsl:if>
</source>

дополнительное условие
<source lang="xml">
<xsl:if test="@Статус='Удален'">
<xsl:attribute name="is-deleted">1</xsl:attribute>
</xsl:if>
</source>

В некоторых случаях, требуется не удаления элемента в корзину, а изменение его активности, т.е. установления статуса "Не активен". Для этого необходимо весь шаблон "Товары/Товар" скопировать в файл xsl/import/custom/commerceML2.xsl, в корневой узел <stylesheet>. И потом изменить строчку:
<source lang="xml">
<xsl:attribute name="is-deleted">1</xsl:attribute>
</source>
на:
<source lang="xml">
<xsl:attribute name="is-active">0</xsl:attribute>
</source>

Если Вы хотите, чтобы товары, помеченные как удаленные, не попадали в корзину, а сразу удалялись из системы, то можете применить решением из статьи [[Удаление_товаров_из_системы_при_импорте]].

Пример создания нового способа оплаты

2015-12-10T08:49:13Z

Alexei:

'''Актуально для версии 2.9'''
<br/>

'''Задача:''' создать способ оплаты с дополнительным шагом, на котором показать пользователю дополнительную информацию.<br/>
'''Решение:''' для решения поставленной задачи, создадим новый способ оплаты.<br/>

Чтобы добавить новый способ оплаты, Вам следует выполнить следующие шаги:<br/>
1. Открыть модуль '''Шаблоны данных''' и найти там "'''Способы оплаты'''". Добавить в него дочерний шаблон, назвав его например, так "''Перевод через сервис Visa QIWI Wallet''".<br/>
2. В созданном шаблоне создаем два поля:<br/>
'''Как платить? [kak_platit]''' - тип HTML-текст, видимое.<br/>
'''Номер телефона [phone]''' - тип Строка, видимое.<br/>
[[Файл:Newpay1.png]]<br>
Запоминаем id шаблона из адресной строки браузера:<br/>
'''/admin/data/type_edit/131/''' - то есть у меня id=131<br/>
[[Файл:Qiwi5.png]]<br>
3. В этом же модуле, на вкладке Справочники, находим справочник "'''Типы способов оплаты'''" и нажимаем на иконку глаза, чтобы открыть содержимое справочника.<br/>
Добавляем новое наименование.<br/>
В поле "'''Название'''" напишем тоже самое "''Перевод через сервис Visa QIWI Wallet''", в поле "'''Тип данных (id)'''" наш запомненный ранее id "''131''", в поле "'''Тип данных'''" напишем "''emarket-payment-131''", где 131 - это наш id. А вот в поле "'''Идентификатор типа оплаты'''" напишем название будущего класса, которое должно отражать предназначение класса. Указывается латинскими буквами. У меня в примере данный класс называется ''simpleQIWI'' (Обратите внимание, что название регистрозависимое. Если мы используем прописные буквы, то точно также мы должны их использовать и в дальнейшем).<br/>
[[Файл:Qiwi6.png]]<br>
4. Открываем базу данных через phpMyAdmin и выполняем запрос:<br/>
<source lang="sql">
UPDATE `blank`.`cms3_object_types` SET `guid` = 'emarket-payment-131' WHERE `cms3_object_types`.`id` =131;
</source>
В данном запросе следует изменить:<br/>
''''blank'''' - на название вашей базы данных,<br/>
''''emarket-payment-131'''' - на emarket-payment с вашим id<br/>
'''131''' - на ваш id<br/>
5. Заходим на сайт по FTP, открываем директорию:<br/>
'''\classes\modules\emarket\classes\payment\systems\'''<br/>
где копируем файл courier.php и переименовываем его в ''simpleqiwi.php'' - у Вас может быть другое название, которое Вы указали в 3 шаге.<br/>
6. Открываем файл на редактирование и изменяем:<br/>
название класса courierPayment на '''simpleQIWIPayment''' (у вас может быть другое название, указанное на 3 шаге).<br/>
7. Доработаем содержимое класса на наше усмотрение. Здесь мы вместо редиректа передаем массив с данными об ID заказа, его номере и итоговую сумму заказа, а также кладем в ячейки массива содержимое полей "Номер телефона" и "Как платить?":<br/>
<source lang="php">
<?php
class simpleQIWIPayment extends payment {

public function validate() { return true; }

public function process($template = null) {
$order = $this->order;
$order->order();
$controller = cmsController::getInstance();
$module = $controller->getModule("emarket");
$line['attribute:orderId'] = $order->getId();
$line['attribute:number'] = $order->getValue('number');
$line['attribute:total_price'] = $order->getValue('total_price');
$line['attribute:phone'] = $this->object->phone;
$line['node:value'] = $this->object->kak_platit;
$lines[] = $line;
$udata['nodes:item'] = $lines;
if($module) {
return $udata;
}
return null;
}

public function poll() {
$buffer = outputBuffer::current();
$buffer->clear();
$buffer->contentType('text/plain');
$buffer->push('Sorry, but this payment system doesn\'t support server polling.' . getRequest('param0'));
$buffer->end();
}

};
?>
</source><br/>
8. Проверьте, что файл в кодировке utf-8 (без BOM).<br/>
9. В административном интерфейсе сайта, в модуле Интернет-магазин, создайте новый способ оплаты "''Перевод через сервис Visa QIWI Wallet''", заполните поля '''Номер телефона''' и '''Как платить?'''.<br>[[Файл:Newpay2.png]]<br/>
10. Добавим новый шаг в шаблон оформления заказа на этапе выбора способа оплаты: \templates\demodizzy\xslt\modules\emarket\purchase\payment.xsl
<source lang="xml">
<xsl:template match="purchasing[@stage = 'payment'][@step = 'simpleQIWI']">
<xsl:apply-templates select="//steps" />
<div class="ramka">
<h3>Сведения которые необходимо указать при оплате:</h3>
<h4>Номер телефона: <xsl:value-of select="item/@phone" /></h4>
<h4>Сумма к оплате: <xsl:value-of select="item/@total_price" /></h4>
<h4>Комментарий: Заказ №<xsl:value-of select="item/@number" /></h4>
</div>
<br/>
<xsl:value-of select="item" disable-output-escaping="yes"/>
<div class="cart-buttons">
<a href="{$lang-prefix}/emarket/purchase/result/successful/" class="button big">
<xsl:text>Завершить</xsl:text>
</a>
</div>
</xsl:template>
</source>
11. Проверим.<br/>
[[Файл:Newpay3.png]]<br/><br/>
[[Файл:Newpay6.png]]<br/><br/>
[[Файл:Newpay5.png]]

[[Категория:Модуль Интернет магазин]][[Категория:Написание кастомных макросов]]

Оформление заказа в один шаг – tpl шаблонизатор

2015-12-08T11:05:57Z

Alexei:

'''Актуально для 2.11'''

В данной статье будет описан принцип создания формы оформления заказа за один шаг, т.е. все необходимые данные, регистрационные данные покупателя, способ доставки, способ оплаты и т.д. представлены на одной страницы. Для использования информации в данной статье версия вашей системы должна быть не ниже 2.8.4.3, иначе код не будет нормально функционировать при наличии в модуле Интернет-магазин способа доставки Курьером, и способа оплаты "Курьером при получении".

Нам понадобятся дополнительные php-методы для реализации данной задачи, которые необходимо добавить внутри абстрактного класса файла '''classes/modules/emarket/__custom.php''', сами методы следующие:

<source lang="php">
public function deliveryAddressesListCustom($template = 'onestep') {
$order = $this->getBasketOrder(false);
list($tpl_block, $tpl_item) = def_module::loadTemplates(
"emarket/delivery/{$template}.tpl",
"delivery_address_block",
"delivery_address_item"
);

$customer = customer::get();
$addresses = $customer->delivery_addresses;
$items_arr = array();
$currentDeliveryId = $order->getValue('delivery_address');

$collection = umiObjectsCollection::getInstance();

if (is_array($addresses)) foreach($addresses as $address) {
$addressObject = $collection->getObject($address);

$item_arr = array(
'attribute:id' => $address,
'attribute:name' => $addressObject->name
);

if ($address == $currentDeliveryId) $item_arr['attribute:active'] = 'active';

$items_arr[] = def_module::parseTemplate($tpl_item, $item_arr, false, $address);
}

$types = umiObjectTypesCollection::getInstance();
$typeId = $types->getBaseType("emarket", "delivery_address");

if ($tpl_block) {
return def_module::parseTemplate($tpl_block, array('items' => $items_arr, 'type_id' => $typeId));
}
}

public function deliveryListCustom($template = 'onestep') {
$order = $this->getBasketOrder(false);
list($tpl_block, $tpl_item_free, $tpl_item_priced) = def_module::loadTemplates(
"emarket/delivery/{$template}.tpl",
'delivery_block',
'delivery_item_free',
'delivery_item_priced'
);

if (!isset($_SESSION['emarket'])) $_SESSION['emarket'] = array();
if (!isset($_SESSION['emarket']['delivery'])) $_SESSION['emarket']['delivery'] = array();

$deliveryIds = delivery::getList();
$items_arr = array();
$currentDeliveryId = $order->getValue('delivery_id');

foreach($deliveryIds as $delivery) {
$delivery = delivery::get($delivery);
if ($delivery->validate($order) == false) {
continue;
}

$deliveryObject = $delivery->getObject();
$deliveryPrice = $delivery->getDeliveryPrice($order);
$_SESSION['emarket']['delivery'][$delivery->id] = (float)$deliveryPrice;

$item_arr = array(
'attribute:id' => $deliveryObject->id,
'attribute:name' => $deliveryObject->name,
'attribute:price' => $deliveryPrice.'',
'xlink:href' => $deliveryObject->xlink
);

if ($delivery->id == $currentDeliveryId) $item_arr['attribute:active'] = 'active';

$tpl_item = $deliveryPrice ? $tpl_item_priced : $tpl_item_free;
$items_arr[] = def_module::parseTemplate($tpl_item, $item_arr, false, $deliveryObject->id);
}

if ($tpl_block) {
return def_module::parseTemplate($tpl_block, array('items' => $items_arr));
} else {
return array('items' => array('nodes:item' => $items_arr));
}

}

public function paymentsListCustom($template = 'onestep') {
$order = $this->getBasketOrder(false);
list($tpl_block, $tpl_item) = def_module::loadTemplates("emarket/payment/{$template}.tpl", 'payment_block', 'payment_item');

$payments = payment::getList();
$items = array();
$currentPaymentId = $order->getValue('payment_id');

foreach($payments as $paymentId) {
$payment = payment::get($paymentId, $order);
if($payment->validate($order) == false) {
continue;
}
$paymentObject = $payment->getObject();
$paymentTypeId = $paymentObject->getValue('payment_type_id');
$paymentTypeName = umiObjectsCollection::getInstance()->getObject($paymentTypeId)->getValue('class_name');

if($paymentTypeName == 'social') {
continue;
}

$item = array(
'attribute:id' => $paymentObject->id,
'attribute:name' => $paymentObject->name,
'attribute:type-name' => $paymentTypeName,
'xlink:href' => $paymentObject->xlink
);

if($paymentId == $currentPaymentId) {
$item['attribute:active'] = 'active';
}

$items[] = def_module::parseTemplate($tpl_item, $item, false, $paymentObject->id);
}

if($tpl_block && !def_module::isXSLTResultMode()) {
return def_module::parseTemplate($tpl_block, array('items' => $items));
} else {
return array('items' => array('nodes:item' => $items));
}
}

public function personalInfoCustom($template = 'onestep') {
if (!permissionsCollection::getInstance()->isAuth()){
$customerId = customer::get()->id;
$cmsController = cmsController::getInstance();
$data = $cmsController->getModule('data');

return $data->getEditForm($customerId, $template);
} else return '';
}

public function saveInfoCustom(){
$order = $this->getBasketOrder(false);

//сохранение регистрационных данных
$cmsController = cmsController::getInstance();
$data = $cmsController->getModule('data');
$data->saveEditedObject(customer::get()->id, false, true);

//сохранение адреса доставки
$addressId = getRequest('delivery-address');
if ($addressId == 'new') {
$collection = umiObjectsCollection::getInstance();
$types = umiObjectTypesCollection::getInstance();
$typeId = $types->getBaseType("emarket", "delivery_address");
$customer = customer::get();
$addressId = $collection->addObject("Address for customer #".$customer->id, $typeId);
$dataModule = $cmsController->getModule("data");
if ($dataModule) {
if (!$dataModule->saveEditedObject($addressId, true, true)) {
$dataModule->saveEditedObjectWithIgnorePermissions($addressId, true, true); // начиная с версии 2.9.5
}
}
$customer->delivery_addresses = array_merge( $customer->delivery_addresses, array($addressId) );
}
$order->delivery_address = $addressId;

//сохранение способа доставки
$deliveryId = getRequest('delivery-id');
if ($deliveryId){
$delivery = delivery::get($deliveryId);
$deliveryPrice = (float) $delivery->getDeliveryPrice($order);
$order->setValue('delivery_id', $deliveryId);
$order->setValue('delivery_price', $deliveryPrice);
}

//сохранение способа оплаты и редирект на итоговую страницу
$order->setValue('payment_id', getRequest('payment-id'));

$order->refresh();

$paymentId = getRequest('payment-id');
if (!$paymentId) {
$this->errorNewMessage(getLabel('error-emarket-choose-payment'));
$this->errorPanic();
}
$payment = payment::get($paymentId);

if ($payment instanceof payment) {
$paymentName = $payment->getCodeName();
$url = "{$this->pre_lang}/".cmsController::getInstance()->getUrlPrefix()."emarket/purchase/payment/{$paymentName}/";
} else {
$url = "{$this->pre_lang}/".cmsController::getInstance()->getUrlPrefix()."emarket/cart/";
}
$this->redirect($url);
}
</source>

также в папку '''classes/modules/emarket/''' необходимо добавить файл '''permissions.custom.php''' следующего содержания:

<source lang="php">
<?php
$permissions = array('purchasing' => array('deliveryListCustom', 'deliveryAddressesListCustom', 'paymentsListCustom', 'personalInfoCustom', 'saveInfoCustom'));
?>
</source>

Необходимо создать шаблон '''tpls/emarket/delivery/onestep.tpl''':

<source lang="php">
<?php
$FORMS = Array();

$FORMS['delivery_block'] = <<<END
<h3 class="dost">Выберите подходящий вам способ доставки:</h3>
<ul>
%items%
</ul>
END;

$FORMS['delivery_item_free'] = <<<END
<li><input type="radio" name="delivery-id" value="%id%" checked="checked" /> %name% - бесплатно</li>
END;

$FORMS['delivery_item_priced'] = <<<END
<li><input type="radio" name="delivery-id" value="%id%" /> %name% - %price%</li>
END;

$FORMS['delivery_address_block'] = <<<END
<div class="adrest">
<h3 class="dost">Выберите подходящий вам адрес доставки:</h3>
<ul>
%items%
<li>
<input type="radio" name="delivery-address" value="new" /> <b>Новый адрес доставки:</b>
<table cellspacing="1" cellpadding="1" width="100%" border="0">
%data getCreateForm(Здесь нужно подставить ид типа данных "Адрес доставки", 'onestep')%
</table>
</li>
</ul>
</div>
END;

$FORMS['delivery_address_item'] = <<<END
<li><input type="radio" name="delivery-address" value="%id%" />%index%, %city%, %street%, д. %house%, кв. %flat%</li>
END;

?>
</source>

В макросе '''data getCreateForm()''', первый параметр - это id типа данных "Адрес доставки" в модуле "Шаблоны данных", первая вкладка, раздел "Справочники", этот id вы должны для вашей системы определить самостоятельно и подставить в макрос data getCreateForm().

Шаблон '''tpls/emarket/payment/onestep.tpl''':

<source lang="php">
<?php
$FORMS = Array();

$FORMS['payment_block'] = <<<END
Выберите подходящий вам способ оплаты:
<ul>
%items%
</ul>
END;

$FORMS['payment_item'] = <<<END
<li><input type="radio" name="payment-id" value="%id%" /> %name%</li>
END;

?>
</source>

Шаблон '''tpls/data/reflection/onestep.tpl''':

<source lang="php">
<?php

$FORMS = Array();

$FORMS['reflection_block'] = <<<END
%groups%
END;

$FORMS['reflection_group'] = <<<END
<tr>
<td colspan="2">
<br/><br /><b>%title%</b><br /><br />
</td>
</tr>
%fields%
END;

$FORMS['reflection_field_string'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>

<td>
<input type="text" name="%input_name%" value="%value%" class="textinputs" />
</td>
</tr>
END;

$FORMS['reflection_field_text'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>
<td>
<textarea name="%input_name%" class="textinputs">%value%</textarea>
</td>
</tr>
END;

$FORMS['reflection_field_int'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>

<td>
<input type="text" name="%input_name%" value="%value%" class="textinputs" />
</td>
</tr>
END;

$FORMS['reflection_field_relation'] = <<<END
<tr>
<td>
%title%%required_asteriks%:
</td>

<td>
<select name="%input_name%" style="width: 205px" class="textinputs">
<option />
%options%
</select>
</td>
</tr>

END;

$FORMS['reflection_field_relation_option'] = <<<END
<option value="%id%">%name%</option>
END;

$FORMS['reflection_field_relation_option_a'] = <<<END
<option value="%id%" selected="selected">%name%</option>
END;

?>
</source>

В шаблоне '''tpls/emarket/default.tpl''', в блоке '''order_block''', форма должна быть примерно следующая:

<source lang="php">
<form action="%pre_lang%/emarket/saveInfoCustom/">
%emarket deliveryListCustom('onestep')%
%emarket deliveryAddressesListCustom('onestep')%
<table cellspacing="1" cellpadding="1" width="100%" border="0">
</table>
<br/>
%emarket paymentsListCustom('onestep')%
<br/>
<table cellspacing="1" cellpadding="1" width="100%" border="0">
%emarket personalInfoCustom('onestep')%
</table>
<br/>
<input type="submit" value="Оформить заказ" />
</form>
</source>

[[Категория:Написание кастомных макросов]][[Категория:Верстка в TPL]]
[[Категория:Модуль Интернет магазин]]

Макрос удаления одной единицы товара в корзине

2015-12-07T15:43:17Z

Alexei: /* Макрос удаления одной единицы товара в корзине. */

[[category:Написание кастомных макросов]][[Категория:Модуль Интернет магазин]]

==<center> Макрос удаления одной единицы товара в корзине. </center>==
'''Актуально для версии 2.9'''

При нажатии на кнопку «'''Х'''» в корзине будет производиться удаление одной единицы товара, если количество товара больше одной единицы, и удалять товар из корзины, если его количество равно единице. В директории ''/classes/modules/emarket/'' в файл''' __custom.php''' необходимо добавить следующий код:
<source lang='php'>
<?php
abstract class __emarket_custom extends __emarket_purchasing{

public function custom_basket($mode = false, $itemType = false, $itemId = false) {
$mode = $mode ? $mode : getRequest('param0');
$order = self::getBasketOrder(!in_array($mode, array('put', 'remove')));
$itemType = $itemType ? $itemType : getRequest('param1');
$itemId = (int) ($itemId ? $itemId : getRequest('param2'));
$amount = (int) getRequest('amount');
$options = getRequest('options');

$order->refresh();

if($mode == 'put') {
$orderItem = ($itemType == 'element') ? $this->getBasketItem($itemId) : $order->getItem($itemId);

if (!$orderItem) {
throw new publicException("Order item is not defined");
}

if(is_array($options)) {
if($itemType != 'element') {
throw new publicException("Put basket method required element id of optionedOrderItem");
}

// Получить все товары заказа
$orderItems = $order->getItems();

foreach($orderItems as $tOrderItem) {
$itemOptions = $tOrderItem->getOptions();

if(sizeof($itemOptions) != sizeof($options)) {
$itemOptions = null;
$tOrderItem = null;
continue;
}

if($tOrderItem->getItemElement()->id != $orderItem->getItemElement()->id) {
$itemOptions = null;
$tOrderItem = null;
continue;
}

// Сравниваем каждую переменную tOrderItem со списком опций
foreach($options as $optionName => $optionId) {
$itemOption = getArrayKey($itemOptions, $optionName);

if(getArrayKey($itemOption, 'option-id') != $optionId) {
$tOrderItem = null;
continue 2;
// Если не совпадает, создаем новый товар с указанными опциями }
}

break; //Если совпадает, выйти из цикла и перейти к изменению количества }

if(!isset($tOrderItem) || is_null($tOrderItem)) {
$tOrderItem = orderItem::create($itemId);
$order->appendItem($tOrderItem);
}

if($tOrderItem instanceof optionedOrderItem) {
foreach($options as $optionName => $optionId) {
if($optionId) {
$tOrderItem->appendOption($optionName, $optionId);
} else {
$tOrderItem->removeOption($optionName);
}
}
}

if($tOrderItem) {
$orderItem = $tOrderItem;
}
}

$amount = $amount ? $amount : ($orderItem->getAmount() + 1);
$orderItem->setAmount($amount ? $amount : 1);
$orderItem->refresh();

if($itemType == 'element') {
$order->appendItem($orderItem);
}
$order->refresh();
}

if($mode == 'remove') {
$orderItem = ($itemType == 'element') ? $this->getBasketItem($itemId, false) : orderItem::get($itemId);
if($orderItem instanceof orderItem) {
//Проверяем количество единиц товара, если 1 то удаляем товар из списка, иначе уменьшаем количество на 1
if ($orderItem->getAmount()==1){
$order->removeItem($orderItem);
$order->refresh();

}
else
$orderItem->setAmount($orderItem->getAmount()-1);{
$order->refresh();
$orderItem->refresh();
}
}
}

if ($mode == 'remove_all') {
foreach ($order->getItems() as $orderItem) {
$order->removeItem($orderItem);
}
$order->refresh();
}

$referer = getServer('HTTP_REFERER');
$noRedirect = getRequest('no-redirect');

if($redirectUri = getRequest('redirect-uri')) {
$this->redirect($redirectUri);
} else if (!defined('VIA_HTTP_SCHEME') && !$noRedirect && $referer) {
$current = $_SERVER['REQUEST_URI'];
if(substr($referer, -strlen($current)) == $current) {
if($itemType == 'element') {
$referer = umiHierarchy::getInstance()->getPathById($itemId);
} else {
$referer = "/";
}
}
$this->redirect($referer);
}

$order->refresh();
return $this->order($order->getId());
}
}
}
};
?>
</source>

Далее, необходимо дать права на использования данного макроса. Для этого нужно создать файл '''permissions.custom.php''' в директории ''/classes/modules/emarket/'' со следующим содержанием:
<source lang='php'>
<?php
$permissions = array('purchasing' => array('custom_basket'));
?>
</source>

В файле шаблона, по которому выводится корзина товаров, (в демо шаблоне '''demoold''' ''templates\demoold\tpls\emarket\default.tpl'') необходимо изменить адрес ссылки удаления товара (то есть вызвать кастомный макрос вместо системного) на:
<a href="/emarket/custom_basket/remove/item/%id%/">(X)</a>

Смена шагов оформления заказа на этапе delivery

2015-11-17T09:24:32Z

Alexei:

'''Актуально для версии 2.9.6'''

В данной статье будет описан механизм смены шагов оформления заказа на этапе delivery. Необходимо, чтобы была следуюшая последовательность:
* выбор способа доставки;
* проверка на то какой способ доставки выбран:
если выбран "Самовывоз", то перейти к следующему этапу, если "Доставка", то предложить заполнить Адрес доставки.

В файл '''classes/modules/emarket/__custom.php''', добавим четыре метода, все они написаны на основе существующих:
<source lang="php">
public function purchasecust(){
$customer = customer::get();
// Проверка на то, что покупатель Гость, и все ли обязательные поля заполнены в объекте
if(!$customer->isUser() && !$customer->isFilled()) {
$this->redirect('/emarket/purchase/');
}else{
$this->redirect('/emarket/purchase/delivery/choose/');
}
}

public function personalcust(){
$cmsController = cmsController::getInstance();
$data = $cmsController->getModule('data');
$data->saveEditedObject(customer::get()->id, false, true);
$this->redirect($this->pre_lang . '/emarket/purchase/delivery/choose/');
}

public function choosecust(){
$ini = cmsController::getInstance()->getModule("emarket");
$order = $ini->getBasketOrder(false);
$deliveryId = (int) getRequest('delivery-id');

if(!$deliveryId) {
$this->redirect($ini->pre_lang . '/emarket/purchase/delivery/choose/');
}

if(@isset($_SESSION['emarket']['delivery'][$deliveryId])) {
$deliveryPrice = (float) $_SESSION['emarket']['delivery'][$deliveryId];
} else {
$delivery = delivery::get($deliveryId);
$deliveryPrice = (float) $delivery->getDeliveryPrice($order);
}

$order->setValue('delivery_id', $deliveryId);
$order->setValue('delivery_price', $deliveryPrice);
$order->refresh();
$order->commit();
if($deliveryId == 27255){
$this->redirect($this->pre_lang . '/emarket/purchase/payment/choose/');
}else{
$this->redirect($this->pre_lang . '/emarket/purchase/delivery/address/');
}
}

public function addresscust(){
$ini = cmsController::getInstance()->getModule("emarket");
$order = $ini->getBasketOrder(false);
$addressId = getRequest('delivery-address');
if($addressId == 'new') {
$controller = cmsController::getInstance();
$collection = umiObjectsCollection::getInstance();
$types = umiObjectTypesCollection::getInstance();
$typeId = $types->getBaseType("emarket", "delivery_address");
$customer = customer::get();
$addressId = $collection->addObject("Address for customer #".$customer->id, $typeId);
$dataModule = $controller->getModule("data");
if($dataModule) {
$dataModule->saveEditedObjectWithIgnorePermissions($addressId, true, true);
}
$customer->delivery_addresses = array_merge( $customer->delivery_addresses, array($addressId) );
}
$order->delivery_address = (int) $addressId;
$order->commit();

$this->redirect($this->pre_lang . '/emarket/purchase/payment/choose/');
}
</source>

также в папке '''classes/modules/emarket/''' создадим файл '''permissions.custom.php''' следующего содержания:
<source lang="php">
<?php
$permissions = array('purchasing' => array('purchasecust', 'personalcust', 'choosecust', 'addresscust'));
?>
</source>
В методе '''choosecust()''', в строке:
<pre>
if($deliveryId == 27255){
</pre>

необходимо прописать ваш $object_id способа доставки "Самовывоз", id можно узнать в модуле Интернет-магазин, вкладка "Доставка".

Если говорить о TPL-шаблонах, то в шаблоне '''/tpls/emarket/default.tpl''', в блоке '''order_block''', необходимо прописать для формы следующий action:
<pre>
<form action="%pre_lang%/emarket/purchasecust/">
</pre>

В шаблоне '''tpls/emarket/required/default.tpl''', action:
<pre>
<form action="%pre_lang%/emarket/personalcust/" method="post">
</pre>

В шаблоне '''tpls/emarket/delivery/default.tpl''', в блоке '''delivery_block''', action:
<pre>
<form action="%pre_lang%/emarket/choosecust/" method="post">
</pre>
а в блоке '''delivery_address_block''', action:
<pre>
<form action="%pre_lang%/emarket/addresscust/" method="post">
</pre>

В XSLT-шаблонах правки аналогичные.
[[Категория:Модуль Интернет магазин]]

Кэширование через nginx

2015-11-14T16:07:45Z

Alexei:

[[category:Кеширование]]
Пользователям версии 2.8.3 (и выше) предлагается новая экспериментальная функция кэширования через nginx. Наши исследования показали ускорение работы сайта до 100 раз и более.

nginx является одним из самых популярных серверов для быстрой "отдачи" контента с высоконагруженных сайтов. Подавляющее большинство системных администраторов использует его в паре с сервером Apache - это надёжное и годами проверенное решение. nginx позволяет быстро отдавать статический контент (изображения, тексты), пропуская более "сложные" запросы до нижестоящего Apache (который уже задействует средства PHP и MySQL). Таким образом, засчёт "снятия" огромного количества запросов с Apache, достигается снижение нагрузки на сервер и следовательно - многократное повышение скорости работы сайта.

UMI.CMS с версии 2.8.3 умеет помещать страницы сайта в кэш nginx, позволяя таким образом отдавать их напрямую по вышеописанному механизму. Причём если вы что-то редактируете в "админке", кэш всех задействованных страниц сразу же перестраивается, показывая посетителям сайта обновлённую информацию. Это выгодно отличает UMI.CMS от конкурентов, которые на данный момент способны обновлять кэш только по истечению длительного периода времени.

'''Далее следует информация для разработчиков:'''

Для того, чтобы включить этот режим, требуется владение минимальными навыками системного администрирования. Если вы не администрируете свой сервер самостоятельно, обратитесь к технической поддержке вашего хостинга с целью внесения специальных настроек в конфигурационный файл nginx (см. приложенный файл).

<source lang="apache">
server {
listen 192.168.7.127:80; # (1) IP и порт, на котором висит этот сервер
server_name 192.168.7.127; # (2) К каким доменным именам применяются инструкции

location / {
error_page 412 = @dynamic;

if ($request_method = 'POST') { return 412; }

if ($is_args = '?') { return 412; }

if ($cookie_umicms_session) { return 412; }

try_files $uri/index.html @dynamic;
root /usr/local/apache2/htdocs/cache/$host; # (3) Путь до каталога закэшированных файлов
index index.php;
}

location @dynamic {
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;

proxy_pass http://192.168.7.127:81; # (4) Адрес и порт, на котором установлен бэкэнд (Apache)
}

location ~* ^/admin {
error_page 412 = @dynamic;
return 412;
}

location ~* \.php$ {
error_page 412 = @dynamic;
return 412;
}

location ~* \.(jpg|jpeg|gif|bmp|png)$ {
root /usr/local/apache2/htdocs; # (5) Путь к корневому каталогу сайта
# (рекомендуется, чтобы изображения отдавались nginx-ом)
access_log off;
}
}
</source>

'''Внимание!'''

1. Данный конфигурационный файл неактуален на новых версиях системы.

2. Здесь перечислены рекомендуемые параметры и настройки. В зависимости от особенностей вашего сервера, реальные настройки могут отличаться от указанных здесь. Действуйте по собственному разумению или обратитесь к системному администратору за советом.

3. Мы рекомендуем не копировать эти настройки непосредственно в основной конфигурационный файл, а записать их в отдельный файл и подключить (include) к nginx.

4. С версии 2.8.4.2 (22 июля 2011) система UMI.CMS, работающая на нескольких доменах, помещает кэш в подкаталоги по названиями этих доменов. Для этого вам нужно указать $host в блоке try_files: root /usr/local/apache2/htdocs/cache/$host;

Затем отредактируйте настройки в файле config.ini системы UMI.CMS, например:

<source lang="php">
[includes]
system.static-cache = указать тот же путь, что и в пункте (3) конфигурационного файла nginx

[cache]
static.enabled = "1"
static.mode = "nginx"
</source>

'''Внимание!''' Указанные здесь рекомендации относятся только к конфигурированию режима nginx. Вы можете добавлять другие настройки по своему усмотрению, при условии что вы понимаете что делаете.

Если вы администрируете сервер самостоятельно, после внесения изменений не забудьте перезапустить nginx (заставить его перечитать конфигурационные файлы).

Откройте главную страницу сайта в браузере. Затем проверьте, что в каталоге, указанном в пункте (3) конфигурационного файла nginx, создался статический html-файл главной страницы. На этом настройка закончена.

Для того, чтобы дополнительно проверить работу этого механизма кэширования, включите мониторинг HTTP-запросов и убедитесь, что повторный запрос в браузере этой же страницы возвращает ответ "304 Not Modified" от nginx. Это означает, что статический файл отдан nginx-ом. Затем отредактируйте любой контент, содержащийся на странице, откройте её в браузере снова, и убедитесь в том что страница изменилась.

'''Технические условия и ограничения:'''

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

Как правило, к этому относится блок Корзины: взависимости от действий [неавторизованного] посетителя, число товаров в блоке корзины изменяется - следовательно, данный блок кэшировать нельзя. Решение очень простое и применяется на всех высоконагруженных сайтах: измените вёрстку таким образом, чтобы динамические блоки подгружались аяксом "поверх" остального контента страницы. Механизм кэширования сделан так, что для авторизованных пользователей система UMI.CMS всегда выдаёт только динамический контент.
Также, можно настроить gzip сжатие, по следующей статье [http://wiki.umisoft.ru/Настройка_gzip_сжатия Настройка_gzip_сжатия].

Работа с корзиной без перезагрузки TPL

2015-11-12T13:33:54Z

Alexei:

'''Проверенно на версии системы 2.9 редакция 21905'''

Самый простой и удобный способ реализовать данную задачу заключается в том, что нужно использовать уже имеющиеся в UMI.CMS скрипты из тестового демосайта Demodizzy (шаблон современный). Для этого вам нужно установить локальную версию с данным шаблоном и скопировать файлы '''"__common.js"''' и '''"basket.js"''' из папки ''~/templates/demodizzy/js/'' в свою систему. За добавление товара в корзину отвечают методы '''site.basket.add''' и '''basket.putElement''' из файла: '''"basket.js"'''

После того как мы перенесли файлы на сайт с TPL шаблонизатором, необходимо отредактировать метод '''site.utils.js.init''' в файле '''"__common.js"'''. В этом методе подключается файл '''"basket.js"''' и поэтому необходимо изменить адрес этого файла в соответствии с тем куда Вы его перенесли. В нашем случае после редактирования метод будет выглядеть так:

<source lang="javascript">
site.utils.js.init([
'/js/client/basket.js',
'/templates/demoold/js/basket.js',
]);
</source>

Далее нужно подключить необходимые файлы. В шаблоне дизайна сайта вам нужно подключить файл '''"__common.js"'''

Пример:
<source lang="html4strict">
<script type="text/javascript" src="/js/jquery/jquery.js"></script>
<script type="text/javascript" src="/templates/demoold/js/__common.js"></script>
</source>

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

Данная ссылка описана в tpl шаблоне: ''~\tpls\emarket\default.tpl'' в блоке '''$FORMS['basket_add_link']'''.

Скрипт работает таким образом, что ищет необходимый элемент по ID и классу ссылки. По этому ссылка на добавление товара должна иметь следующий вид (если не модифицировать сам скрипт):
<source lang="html4strict">
$FORMS['basket_add_link'] = <<<END
<a href="#" id="add_basket_%id%" class="basket_list">Положить в корзину</a>
END;
</source>
Теперь необходимо соответствующим образом изменить шаблон корзины. Для этого нам нужно в файле ''~\tpls\emarket\basket.tpl'' добавить необходимые скрипту теги. А именно нужно присвоить значение класса class="block basket basket_info_summary" тегу <div> блока

$FORMS['order_block'].

Пример:
<source lang="html4strict">
$FORMS['order_block'] = <<<END
<div id="rubricator" class="block basket basket_info_summary">
</source>
После этого добавление в корзину будет выполнятся с помощью скрипта, и не будет больше перезагружать страницу.

[[Категория:Модуль Интернет магазин]][[Категория:Верстка в TPL]]

Подписка на рассылку без перезагрузки страницы (ajax)

2015-11-05T14:37:12Z

Alexei:

[[category:Модуль Рассылки]][[category:Вопросы и уроки разработки сайтов на UMI.CMS]]
'''Задача:''' Реализовать подписку на рассылку посетителей сайта без перезагрузки страницы с помощью ajax.<br /><br />
'''Реализация:''' В шаблон подписки на рассылку, по которому обрабатываются результаты работы макроса dispatches subscribe(), добавим JavaScript код для отправки ajax запросов:
<source lang="javascript">
<script src="/js/jquery/jquery.jgrowl_minimized.js"></script>
<link rel="/js/jquery/jquery.jgrowl.css"/>
<script>
function sbs_frm_send( form ){
var request_url = "/udata://dispatches/subscribe_do/.json";
var email = $("input[name='sbs_mail']", form);
var params = {"sbs_mail" : email.val()};
$.ajax({
type: "POST",
url: request_url,
data: params,
dataType: "json",
})
.done(function( result ) {
getResult(result);
})
.fail(function( result ) {
jQuery.jGrowl('Возникла ошибка при выполнении запроса.', {
'header': 'UMI.CMS - Ошибка',
'life': 10000
});
});

function getResult( result ){
responses = {"%subscribe_subscribe%": "Вы подписались на рассылку",
"%subscribe_incorrect_email%": "Извините, Вы указали некорректный E-mail.",
"%subscribe_unsubscribed_ok%": "Вы успешно отписались от рассылки.",
"%subscribe_unsubscribed_failed%": "Не удалось отписаться от рассылки."};
var result_node = result["result"];
if (result_node["class"] && result_node["class"] === "error"){
jQuery.jGrowl( responses[result_node["node"]], {
'header': 'UMI.CMS - ошибка',
'life': 10000
});
email.focus();
}else{
jQuery.jGrowl( responses[result_node], {
'header': 'UMI.CMS',
'life': 10000
});
}

}

}
</script>
</source>

Тег <form> подписки на рассылку должен выглядеть следующим образом:
<source lang="javascript">
<form action="/dispatches/subscribe_do/" name="sbs_frm" method="post" onsubmit="sbs_frm_send(this);return false;">
</source>

Примечание: для использования данного скрипта в tpl-шаблонизаторе, следует заменить спец символы "&amp;" на "&"

Изменение иерархии при обмене данными с 1С

2015-11-05T07:51:33Z

Alexei:

'''В статье [[Как_переместить_страницу_если_её_раздел_поменялся]] есть более простое решение'''

При импорте из CommerceML2.0 объекты располагаются в том иерархическом порядке, в котором они были в исходном файле, в дальнейшем, при обновлении данных средствами импорта их положение уже не изменяется, а обращение к объекту идёт напрямую по его идентификатору. Если требуется при обмене данными с 1С изменять иерархию в соответствии с импортируемыми данными, то необходимо добавить соответствующую обработку в шаблон импорт.<br />
Перед импортом входящая информация из commerceML2.0 трансформируется по XSLT шаблону в формат UmiDump2.0. За иерархические связи в UmiDump отвечает нода <hierarchy>. Для того чтобы при импорте структура каталога обновлялась, необходимо чтобы после трансформации в UmiDump в нём бли записи об иерархических связях. Для этого скопируем содержимое файла ~/xsl/import/commerceML2.xsl в ~/xsl/import/custom/commerceML2.xsl удалив строку <xsl:include href="custom/commerceML2.xsl" />.
После этого находим шаблон
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
</umidump>

</xsl:template>
</source>
и изменяем его, подключив два шаблона
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>

<xsl:variable name="classid" select="КоммерческаяИнформация/Классификатор/Ид" />

<hierarchy>
<xsl:apply-templates select="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy"/>
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy">
<xsl:with-param name="classid">
<xsl:copy-of select="$classid" />
</xsl:with-param>
</xsl:apply-templates>
</hierarchy>
</umidump>

</xsl:template>
</source>

теперь добавим эти шаблоны в наш кастомный файл:
<source lang=xml>
<xsl:template match="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy">
<relation id="{Ид}" parent-id="{Группы/Ид}"/>
</xsl:template>

<xsl:template match="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy">
<xsl:param name="classid" />
<xsl:apply-templates select="//Группа" >
<xsl:with-param name="classid">
<xsl:copy-of select="$classid" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>

<xsl:template match="//Группа" >
<xsl:param name="classid" />
<xsl:if test="name(../../.) = 'Классификатор'">
<relation id="{Ид}" parent-id="{$classid}"/>
</xsl:if>
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>

<xsl:template match="Группы/Группа" mode="ghierarchy">
<xsl:param name="parent" />
<relation id="{Ид}" parent-id="{$parent}"/>
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>
</source>

теперь при обмене данными с 1С иерархия будет изменятся в соответствии с иерархией из импортируемого файла.
[[Категория:Модуль Обмен данными]] [[category:Интеграция с 1С]]

Изменение иерархии при обмене данными с 1С

2015-11-05T06:29:29Z

Alexei:

'''В статье [[Как_переместить_страницу_если_её_раздел_поменялся]] есть более простое решение'''

При импорте из CommerceML2.0 объекты располагаются в том иерархическом порядке, в котором они были в исходном файле, в дальнейшем, при обновлении данных средствами импорта их положение уже не изменяется, а обращение к объекту идёт напрямую по его идентификатору. Если требуется при обмене данными с 1С изменять иерархию в соответствии с импортируемыми данными, то необходимо добавить соответствующую обработку в шаблон импорт.<br />
Перед импортом входящая информация из commerceML2.0 трансформируется по XSLT шаблону в формат UmiDump2.0. За иерархические связи в UmiDump отвечает нода <hierarchy>. Для того чтобы при импорте структура каталога обновлялась, необходимо чтобы после трансформации в UmiDump в нём бли записи об иерархических связях. Для этого скопируем содержимое файла ~/xsl/import/commerceML2.xsl в ~/xsl/import/custom/commerceML2.xsl удалив строку <xsl:include href="custom/commerceML2.xsl" />.
После этого находим шаблон
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
</umidump>

</xsl:template>
</source>
и изменяем его, подключив два шаблона
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
<hierarchy>
<xsl:apply-templates select="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy"/>
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy"/>
</hierarchy>
</umidump>

</xsl:template>
</source>

теперь добавим эти шаблоны в наш кастомный файл:
<source lang=xml>
<xsl:template match="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy">
<relation id="{Ид}" parent-id="{Группы/Ид}"/>
</xsl:template>

<xsl:template match="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy">
<xsl:param name="classid" />
<xsl:apply-templates select="//Группа" >
<xsl:with-param name="classid">
<xsl:copy-of select="$classid" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>

<xsl:template match="//Группа" >
<xsl:param name="classid" />
<xsl:if test="name(../../.) = 'Классификатор'">
<relation id="{Ид}" parent-id="{$classid}"/>
</xsl:if>
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>

<xsl:template match="Группы/Группа" mode="ghierarchy">
<xsl:param name="parent" />
<relation id="{Ид}" parent-id="{$parent}"/>
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>
</source>

теперь при обмене данными с 1С иерархия будет изменятся в соответствии с иерархией из импортируемого файла.
[[Категория:Модуль Обмен данными]] [[category:Интеграция с 1С]]

Изменение иерархии при обмене данными с 1С

2015-10-28T12:41:17Z

Alexei:

'''В статье [[Как_переместить_страницу_если_её_раздел_поменялся]] есть более простое решение'''

При импорте из CommerceML2.0 объекты располагаются в том иерархическом порядке, в котором они были в исходном файле, в дальнейшем, при обновлении данных средствами импорта их положение уже не изменяется, а обращение к объекту идёт напрямую по его идентификатору. Если требуется при обмене данными с 1С изменять иерархию в соответствии с импортируемыми данными, то необходимо добавить соответствующую обработку в шаблон импорт.<br />
Перед импортом входящая информация из commerceML2.0 трансформируется по XSLT шаблону в формат UmiDump2.0. За иерархические связи в UmiDump отвечает нода <hierarchy>. Для того чтобы при импорте структура каталога обновлялась, необходимо чтобы после трансформации в UmiDump в нём бли записи об иерархических связях. Для этого скопируем содержимое файла ~/xsl/import/commerceML2.xsl в ~/xsl/import/custom/commerceML2.xsl удалив строку <xsl:include href="custom/commerceML2.xsl" />.
После этого находим шаблон
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
</umidump>

</xsl:template>
</source>
и изменяем его, подключив два шаблона
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
<hierarchy>
<xsl:apply-templates select="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy"/>
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy"/>
</hierarchy>
</umidump>

</xsl:template>
</source>

теперь добавим эти шаблоны в наш кастомный файл:
<source lang=xml>
<xsl:template match="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy">
<relation id="{Ид}" parent-id="{Группы/Ид}"/>
</xsl:template>

<xsl:template match="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy">
<xsl:apply-templates select="//Группа"/>
</xsl:template>

<xsl:template match="//Группа" >
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>

<xsl:template match="Группы/Группа" mode="ghierarchy">
<xsl:param name="parent" />
<relation id="{Ид}" parent-id="{$parent}"/>
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>
</source>

теперь при обмене данными с 1С иерархия будет изменятся в соответствии с иерархией из импортируемого файла.
[[Категория:Модуль Обмен данными]] [[category:Интеграция с 1С]]

Мультисайтовость

2015-10-28T07:42:44Z

Alexei:

Система UMI.CMS поддерживает мультидоменность. Что это значит? Это значит, что под управлением одной системы UMI.CMS может работать сразу несколько сайтов на разных доменах*, что особенно удобно при организации бизнес порталов, много язычных сайтов, расположенных в разных доменных зонах, или больших интернет магазинов. Кроме того, Вы получаете единый центр управления всеми сайтами, а гибкая система настройки прав пользователей, позволяет назначить каждому порталу своих, независимых, контент менеджеров. Не менее важным преимуществом является возможность использования, на этапах разработки и сопровождения, общего программного кода (шаблонов дизайна и шаблонов макросов) и материалов, централизованное обновление и разработка дополнительного кастомного функционала.
Как организовать мультидоменность на UMI.CMS? Очень просто!
# Для начала, необходимо зарегистрировать новый домен.
# В '''панели управления доменом''' прописываете Name Server (NS) хостинга. Обратите внимание, что должен быть прописан NS того хостинга, на котором уже установлена и работает система UMI.CMS**
# В '''панели управления хостингом''' прописываете, чтобы сервер, при запросе нового домена, "смотрел" в ту же папку, где уже стоит и работает UMI.CMS. Другими словами - делаете новый домен зеркалом уже работающего.
# Заходите в административную панель системы UMI.CMS и, в модуле "Конфигурация", на вкладке "Домены", прописываете новый домен***. Можно прописывать как с “www” так и без “www”. Нажмите «Сохранить».****
<br/><br/>
С этого момента, система будет считать, что на ней установлено и работает уже два домена. В этом можно убедиться, если перейти в модуль «Структура». Под корневым деревом основного домена, появилось новое дерево структуры, с названием домена, который Вы только что создали. Система сама будет решать, какой контент необходимо возвращать.
<br/><br/>
Вернитесь в модуль «Конфигурация» вкладка «Домены». Рядом с записью нового домена, после того, как Вы сохраняли изменения, в пункте 4, появилась иконка редактирования. Нажмите на неё. Откроется раздел, в котором Вы можете дописать зеркала, для только что созданного домена. К примеру, если Вы решили дописать на предыдущей странице домен без «www» то здесь можно указать с “www”. Это необходимо, чтобы Ваша страница открывалась на запрос в адресной строке браузера как вида ''www.my-site.com'' так и ''my-site.com''. Так же, Вы можете указать здесь другие домены, которые являются зеркалом только что добавленного Вами домена.
<br/><br/>

<em><nowiki>*</nowiki> При условии соблюдения лицензионного соглашения, скачать и ознакомитьс с которым Вы можете здесь http://www.umi-cms.ru/buy/licence_agreement/ <br/>
<nowiki>**</nowiki>Заметим, что, на момент написания этой статьи, редакции Free, Start и Shop не поддерживают возможность мультидоменности.<br/>
<nowiki>***</nowiki> Если Вам необходимо сменить привязку Вашего лицензионного ключа с одного домена, зарегестрированного в системе UMI.CMS, на другой, то Вам необходимо ознакомиться со следующей статьёй http://wiki.umisoft.ru/Переактивация<br/>
<nowiki>****</nowiki> Более подробное описание модуля «Конфигурация», и вкладки «Домены» в том числе, Вы можете найти здесь http://help.umi-cms.ru/<br/></em>

<br/><br/>
<b>Обратите внимание!!!</b> Все домены должны располагаться на одном хостинге аккаунте и одном IP. (http://www.umi-cms.ru/buy/licence_agreement/).

При подключении кириллических доменов, необходимо использовать информацию в данной статье: [[Подключение кириллических доменов рф]]
[[Категория:Вопросы установки настройки и переноса]]

Создание собственной вкладки в системном модуле

2015-10-28T06:28:26Z

Alexei:

'''Задача:''' не затрагивая системный код кастомизировать системный модуль через добавление собственной вкладки.<p></p>

'''Решение.'''<p></p>

'''Пояснения:'''<p></p>
В классе ''def_module'' находится метод ''__implement'' в задачи которого входит собрать все необходимые для работы модуля классы вместе.
Имплементятся все классы, находящиеся в файлах с двойным подчеркиванием, среди собранных будет и класс ''__emarket_custom_admin'', находящийся в файле ''__custom_adm.php''.
Далее, при помощи php-функции ''get_class_methods'' из собранных классов получаем массив всех методов из всех классов.
Далее, в переменную ''fn'' помещается название функции ''onImplement'' и при помощи функции ''in_array'' мы ищем, имеется ли данное значение среди объявленных методов. Если такое значение есть, то система исполняет код описанный в функции ''onImplement''.
Таким образом, если мы хотим получить доступ к системным методам, нам необходимо их задействовать в классе ''__emarket_custom_admin'' и в методе ''onImplement()''.<p></p>

Теперь добавим новую вкладку в модуль Интернет-магазина.<br/>
Для этого откроем файл ''/classes/modules/emarket/__custom_adm.php'' и в классе ''__emarket_custom_admin'' напишем метод ''onImplement()'':
<source lang="php">
public function onImplement() {
$commonTabs = $this->getCommonTabs();
$commonTabs->add('mytab');
$configTabs = $this->getConfigTabs();
$configTabs->add('mytabconfig');
}
</source>

Для создания вкладки мы воспользовались системным методом ''getCommonTabs'', который описывается в классе ''def_module''.
<br>
Вкладка создана, как в самом модуле, так и в его настройках, но вкладки имеют системные имена:<br>
''header-emarket-mytab'' <br/>
''header-emarket-mytabconfig''<br>
Чтобы вкладки получили нужные нам имена, нам необходимо их описать в языковых файлах ''i18n.{язык}.php''.<br>
Создадим файл ''i18n.ru.php'' с таким содержанием:
<source lang="php">
<?php
$i18n = array(
'header-emarket-mytab' => 'Моя кастомная вкладка',
'header-emarket-mytabconfig' => 'Моя вкладка настроек',
);
?>
</source>
В результате вкладки получат нормальные имена.<p></p>

При переходе на созданную вкладку мы получим сообщение об ошибке:
Запрашиваемый ресурс не существует<p></p>

Чтобы ошибка исчезла, нам необходимо описать наши созданные вкладки в виде функций (в том же файле __custom_adm.php):
<source lang="php">
public function mytab() {
$this->setDataType("list");
$this->setActionType("view");
if($this->ifNotXmlMode()) return $this->doData();
}
</source>
Более подробно в [http://api.docs.umi-cms.ru/razrabotka_nestandartnogo_funkcionala/razrabotka_sobstvennyh_makrosov_i_modulej/ документации по созданию своего модуля]
<p></p>
Для отображением данных на вкладке, необходимо создать файл ''/styles/skins/mac/data/modules/emarket/list.view.custom.xsl'', где описать шаблон для вкладки:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xsl:stylesheet SYSTEM "ulang://common" [
]>

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

<xsl:template match="/result[@method = 'mytab']/data[@type = 'list' and @action = 'view']">
Test
</xsl:template>

</xsl:stylesheet>
</source>

Более подробно в [http://api.docs.umi-cms.ru/razrabotka_nestandartnogo_funkcionala/kodirovanie_administrativnogo_interfejsa/ документации по кодированию административного интерфейса]

'''По материалам отдела разработки'''
[[Категория:Написание кастомных макросов]][[Категория:API]]

Изменение иерархии при обмене данными с 1С

2015-10-27T12:28:13Z

Alexei:

'''В статье [[Как_переместить_страницу_если_её_раздел_поменялся]] есть более простое решение'''

При импорте из CommerceML2.0 объекты располагаются в том иерархическом порядке, в котором они были в исходном файле, в дальнейшем, при обновлении данных средствами импорта их положение уже не изменяется, а обращение к объекту идёт напрямую по его идентификатору. Если требуется при обмене данными с 1С изменять иерархию в соответствии с импортируемыми данными, то необходимо добавить соответствующую обработку в шаблон импорт.<br />
Перед импортом входящая информация из commerceML2.0 трансформируется по XSLT шаблону в формат UmiDump2.0. За иерархические связи в UmiDump отвечает нода <hierarchy>. Для того чтобы при импорте структура каталога обновлялась, необходимо чтобы после трансформации в UmiDump в нём бли записи об иерархических связях. Для этого скопируем содержимое файла ~/xsl/import/commerceML2.xsl в ~/xsl/import/custom/commerceML2.xsl удалив строку <xsl:include href="custom/commerceML2.xsl" />.
После этого находим шаблон
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
</umidump>

</xsl:template>
</source>
и изменяем его, подключив два шаблона
<source lang=xml>
<xsl:template match="/">

<umidump xmlns:xlink="http://www.w3.org/TR/xlink" version="2.0">
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор" />
<xsl:apply-templates select="КоммерческаяИнформация/Каталог" />

<xsl:apply-templates select="КоммерческаяИнформация/ПакетПредложений" />

<xsl:if test="count(КоммерческаяИнформация/Документ)">
<xsl:apply-templates select="КоммерческаяИнформация" mode="document" />
</xsl:if>
<hierarchy>
<xsl:apply-templates select="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy"/>
<xsl:apply-templates select="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy"/>
</hierarchy>
</umidump>

</xsl:template>
</source>

теперь добавим эти шаблоны в наш кастомный файл:
<source lang=xml>
<xsl:template match="КоммерческаяИнформация/Каталог/Товары/Товар" mode="hierarchy">
<relation id="{Ид}" parent-id="{Группы/Ид}"/>
</xsl:template>

<xsl:template match="КоммерческаяИнформация/Классификатор/Группы" mode="hierarchy">
<xsl:apply-templates select="//Группа"/>
</xsl:template>

<xsl:template match="//Группа" >
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>

<xsl:template match="Группы/Группа" mode="ghierarchy">
<xsl:param name="parent" />
<xsl:apply-templates select="Группы/Группа" mode="ghierarchy">
<xsl:with-param name="parent">
<xsl:copy-of select="Ид" />
</xsl:with-param>
</xsl:apply-templates>
</xsl:template>
</source>

теперь при обмене данными с 1С иерархия будет изменятся в соответствии с иерархией из импортируемого файла.
[[Категория:Модуль Обмен данными]] [[category:Интеграция с 1С]]

Добавление счетчика посещений на страницы сайта

2015-10-26T08:11:00Z

Alexei: переименовал «Добавление счётчика посещений на страницы сайта» в «Добавление счетчика посещений на страницы сайта»

[[Категория:Модуль Интернет магазин]]

Для добавления подобного функционала, нужно прежде всего создать в типе данных страница ещё одно поле, которое будет содержать в себе значение количества посещений. Добавим на страницу новую группу (чтобы проще поле было искать) например статистика (statistics), в эту группу добавим поле типа «Счётчик» и назовём его, к примеру, «количество посещений» (counter).
Теперь нам нужно написать кастомный макрос, который будет при выполнении увеличивать значение поля «Количество посещений». Идём в папку ~/classes/modules/ открываем файл custom.php и добавляем (после строки //TODO: Write your own macroses here) следующий код:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("kolichestvo_prosmotrov");
++$temp_count;
$element->setValue("kolichestvo_prosmotrov",$temp_count);
$element->commit();
return $element->getValue("kolichestvo_prosmotrov");
} </source>

После этого, в шаблоне, который будет выводить данную страницу размещаем макрос %custom counter(%pid%)% если это TPL шаблон либо <xsl:apply-templates select="document(concat('udata://custom/counter/',page/@id))" /> для XSLT шаблона. Макрос будет срабатывать при каждом открытии страницы, увеличивать значение поля «Количество просмотров» на единицу и выводить количество просмотров. /Если вывод значений поля не требуется, нужно немного изменить код макроса:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("counter");
++$temp_count;
$element->setValue("counter",$temp_count);
$element->commit();
} </source>
[[Категория:Написание кастомных макросов]]

Добавление счётчика посещений на страницы сайта

2015-10-26T08:11:00Z

#перенаправление [[Добавление счетчика посещений на страницы сайта]]

Добавление счетчика посещений на страницы сайта

2015-10-26T08:08:19Z

Alexei:

Добавление счетчика посещений на страницы сайта

2015-10-26T08:03:18Z

Alexei: Правки Alexei (обсуждение) откачены к версии Mad grant

[[Категория:Модуль Интернет магазин]]

Для добавления подобного функционала, нужно прежде всего создать в типе данных страница ещё одно поле, которое будет содержать в себе значение количества посещений. Добавим на страницу новую группу (чтобы проще поле было искать) например статистика (statistics), в эту группу добавим поле типа «Счётчик» и назовём его, к примеру, «количество посещений» (counter).
Теперь нам нужно написать кастомный макрос, который будет при выполнении увеличивать значение поля «Количество посещений». Идём в папку ~/classes/modules/ открываем файл custom.php и добавляем (после строки //TODO: Write your own macroses here) следующий код:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("kolichestvo_prosmotrov");
++$temp_count;
$element->setValue("kolichestvo_prosmotrov",$temp_count);
$element->commit();
return $element->getValue("kolichestvo_prosmotrov");
} </source>

После этого, в шаблоне, который будет выводить данную страницу размещаем макрос %custom counter(%pid%)% если это TPL шаблон либо <xsl:apply-templates select="document(concat('udata://custom/counter/',page/@id))" /> для XSLT шаблона. Макрос будет срабатывать при каждом открытии страницы, увеличивать значение поля «Количество просмотров» на единицу и выводить количество просмотров. /Если вывод значений поля не требуется, нужно немного изменить код макроса:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("counter");
++$temp_count;
$element->setValue("counter",$temp_count);
$element->commit();
return «»;//$element->getValue("counter");
} </source>
[[Категория:Написание кастомных макросов]]

Добавление счетчика посещений на страницы сайта

2015-10-26T07:59:48Z

Alexei:

[[Категория:Модуль Интернет магазин]]

Для добавления подобного функционала, нужно прежде всего создать в типе данных страница ещё одно поле, которое будет содержать в себе значение количества посещений. Добавим на страницу новую группу (чтобы проще поле было искать) например статистика (statistics), в эту группу добавим поле типа «Счётчик» и назовём его, к примеру, «количество посещений» (counter).
Теперь нам нужно написать кастомный макрос, который будет при выполнении увеличивать значение поля «Количество посещений». Идём в папку ~/classes/modules/ открываем файл custom.php и добавляем (после строки //TODO: Write your own macroses here) следующий код:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("kolichestvo_prosmotrov");
++$temp_count;
$element->setValue("kolichestvo_prosmotrov",$temp_count);
$element->commit();
return $element->getValue("kolichestvo_prosmotrov");
} </source>

После этого, в шаблоне, который будет выводить данную страницу размещаем макрос %custom counter(%pid%)% если это TPL шаблон либо <xsl:apply-templates select="document(concat('udata://custom/counter/',page/@id))" /> для XSLT шаблона. Макрос будет срабатывать при каждом открытии страницы, увеличивать значение поля «Количество просмотров» на единицу и выводить количество просмотров. /Если вывод значений поля не требуется, нужно немного изменить код макроса:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("counter");
++$temp_count;
$element->setValue("counter",$temp_count);
$element->commit();
return «»;
} </source>
[[Категория:Написание кастомных макросов]]

Добавление счетчика посещений на страницы сайта

2015-10-26T07:58:21Z

Alexei:

[[Категория:Модуль Интернет магазин]]

Для добавления подобного функционала, нужно прежде всего создать в типе данных страница ещё одно поле, которое будет содержать в себе значение количества посещений. Добавим на страницу новую группу (чтобы проще поле было искать) например статистика (statistics), в эту группу добавим поле типа «Счётчик» и назовём его, к примеру, «количество посещений» (counter).
Теперь нам нужно написать кастомный макрос, который будет при выполнении увеличивать значение поля «Количество посещений». Идём в папку ~/classes/modules/ открываем файл custom.php и добавляем (после строки //TODO: Write your own macroses here) следующий код:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue("kolichestvo_prosmotrov");
++$temp_count;
$element->setValue("kolichestvo_prosmotrov",$temp_count);
$element->commit();
return $element->getValue("kolichestvo_prosmotrov");
} </source>

После этого, в шаблоне, который будет выводить данную страницу размещаем макрос %custom counter(%pid%)% если это TPL шаблон либо <xsl:apply-templates select="document(concat('udata://custom/counter/',page/@id))" /> для XSLT шаблона. Макрос будет срабатывать при каждом открытии страницы, увеличивать значение поля «Количество просмотров» на единицу и выводить количество просмотров. /Если вывод значений поля не требуется, нужно немного изменить код макроса:
<source lang="php"> public function counter($current_page_id) {
$hierarchy = umiHierarchy::getInstance();
$element=$hierarchy->getElement($current_page_id);
$temp_count=$element->getValue('counter');
++$temp_count;
$element->setValue("counter",$temp_count);
$element->commit();
return «»;//$element->getValue("counter");
} </source>
[[Категория:Написание кастомных макросов]]

Переход с триальной версии на коммерческую версию системы UMI.CMS

2015-10-22T08:47:39Z

Alexei:

'''Актуально для версии 2.11'''<br/><br/>
'''Задача:'''
Активировать систему лицензионным ключом коммерческой редакции

'''Решение:'''
Для активации системы нам необходимо войти в модуль "Конфигурация", и на вкладке "Домены" очистить поле "Доменный ключ" и затем нажать кнопку "Сохранить". При выполнении данных действий фактический домен должен совпадать с основным доменом, который указан на вкладке "Домены" модуля "Конфигурация".

[[Файл:сброс_ключа.jpg]]

Далее, появляется окно "Неверный лицензионный ключ", в этом окне присутствует поле для ввода лицензионного ключа, соответственно вводим ключ и нажимаем на кнопку "Проверить".

[[Файл:key4.png]]

Если ключ не принимается, обращаемся к статье [http://wiki.umisoft.ru/Не_принимается_лицензионный_ключ]

При переходе с одной редакции системы на другую происходит следующее:

1. Модули, которые отсутствуют в Вашей редакции удаляются (если Вы переходите на редакцию с большим числом модулей, то для того чтобы новые модули появились в системе, необходимо обновить систему или обновить принудительно, если версия системы актуальная)

2. Ваш сайт будет работать неограниченное время (на триальном ключе только 30 дней)

Файл:Сброс ключа.jpg

2015-10-22T08:47:04Z

Alexei:

Переход с триальной версии на коммерческую версию системы UMI.CMS

2015-10-22T08:46:43Z

Alexei:

'''Актуально для версии 2.9.6'''<br/><br/>
'''Задача:'''
Активировать систему лицензионным ключом коммерческой редакции

'''Решение:'''
Для активации системы нам необходимо войти в модуль "Конфигурация", и на вкладке "Домены" очистить поле "Доменный ключ" и затем нажать кнопку "Сохранить". При выполнении данных действий фактический домен должен совпадать с основным доменом, который указан на вкладке "Домены" модуля "Конфигурация".

[[Файл:key2.png]]
[[Файл:сброс_ключа.jpg]]

Далее, появляется окно "Неверный лицензионный ключ", в этом окне присутствует поле для ввода лицензионного ключа, соответственно вводим ключ и нажимаем на кнопку "Проверить".

[[Файл:key4.png]]

Если ключ не принимается, обращаемся к статье [http://wiki.umisoft.ru/Не_принимается_лицензионный_ключ]

При переходе с одной редакции системы на другую происходит следующее:

1. Модули, которые отсутствуют в Вашей редакции удаляются (если Вы переходите на редакцию с большим числом модулей, то для того чтобы новые модули появились в системе, необходимо обновить систему или обновить принудительно, если версия системы актуальная)

2. Ваш сайт будет работать неограниченное время (на триальном ключе только 30 дней)

Демо-дизайн "Современный"

2015-09-30T12:40:18Z

Alexei:

<b>Первое знакомство</b><br>

Если Вы решили использовать демо-дизайн "Современный", то Вам предстоит познакомиться с устройством шаблонов. Эта статья должна Вам в этом немного помочь.<br>

Все шаблоны xslt-шаблонизатора находятся в папке xsltTpls. По умолчанию, входной точкой во все шаблоны является default.xsl
Этот шаблон нужен только для того, чтобы пред-определить все наиболее часто встречающиеся значения и присвоить их переменным, а также подключить основные шаблоны.<br>

Кроме шаблона default.xsl в папке xsltTpls находятся другие подпапки. В первую очередь стоит обратить внимание на папку "layouts". В ней находится только один шаблон default.xsl. Это основной шаблон, который определяет общий внешний вид страницы. Именно в нём задаётся основная разметка и "вход" в шаблоны <br>
<xsl:template match="/" mode="layout">.
Сам шаблон можно условно поделить следующие части: шапка, дно, левое меню, правое меню и контент. Все поля, кроме контента, не меняют своего содержания, т.е. отвечают за вывод одних и тех же элементов оформления (будь то вывод последних новостей или меню).
Иначе дело обстоит с контентом.<br>
В xslt-шаблонизаторе для всех страниц определён метод и модуль, т.е. способ их формирования. Можно посмотреть как выглядит страница в виде xml-документа, если после адреса страницы дописать .xml (к примеру так www.ваш_сайт.ru/любая_страница/.xml). В первой строке буде узел result и у него два атрибута module и method.<br>
Если Вы открываете страницу контента, то шаблонизатор вернёт заголовок result:<br>
module="content" method="content"
если открывать страницу с объектом каталога то заголовок result уже будет таким:<br>
module="catalog" method="object"
и т.д. Для всех типов страниц предусмотрены свои заголовки, по названию модуля и метода, которые отвечают за их выполнение. Если посмотреть в шаблон - в основном центральном блоке стоит обработчик, который ищет подходящий шаблон на основании этих заголовков:<br>
<div class="content">
<xsl:apply-templates select="result" />
</div>

Теперь вернёмся к организации шаблонов. Все шаблоны подключаются в главном файле через вызов вида:<br>
modules/имя_модуля/common.xsl
Сам файл common.xsl не содержит какой-либо полезной информации, он просто подключает все шаблоны из этой же папки. Шаблоны, для удобства, называются также как макросы, за результат отработки которых они отвечают.<br>

Отдельно нужно ответить шаблоны:<br>
common.xsl в папке xsltTpls здесь лежат те макросы, которые на языке tpl называются системными (system)<br>
папка library также содержит шаблоны, отвечающие за обработку системных макросов.<br>
sample.xsl в папке xsltTpls содержит пример самой простой страницы на xslt<br>
папка sys-tpls содержит шаблоны преобразования данных для служебных целей (печать заказов, карта google и другие)<br>

Для знакомства с xslt-шаблонизатором имеет смысл ознакомиться с учебным пособием, которое можно скачать здесь:
http://docs.umi-cms.ru/xslt-umi-devbook/
[[Категория:Верстка в XSLT|Современный]]

Демо-дизайн "Современный"

2015-09-30T12:38:37Z

Alexei:

<b>Первое знакомство</b><br>

Если Вы решили использовать демо-дизайн "Современный", то Вам предстоит познакомиться с устройством шаблонов. Эта статья должна Вам в этом немного помочь.<br>

Все шаблоны xslt-шаблонизатора находятся в папке xsltTpls. По умолчанию, входной точкой во все шаблоны является default.xsl
Этот шаблон нужен только для того, чтобы пред-определить все наиболее часто встречающиеся значения и присвоить их переменным, а также подключить основные шаблоны.<br>

Кроме шаблона default.xsl в папке xsltTpls находятся другие подпапки. В первую очередь стоит обратить внимание на папку "layouts". В ней находится только один шаблон default.xsl. Это основной шаблон, который определяет общий внешний вид страницы. Именно в нём задаётся основная разметка и "вход" в шаблоны <br>
<xsl:template match="/" mode="layout">.
Сам шаблон можно условно поделить следующие части: шапка, дно, левое меню, правое меню и контент. Все поля, кроме контента, не меняют своего содержания, т.е. отвечают за вывод одних и тех же элементов оформления (будь то вывод последних новостей или меню).
Иначе дело обстоит с контентом.<br>
В xslt-шаблонизаторе для всех страниц определён метод и модуль, т.е. способ их формирования. Можно посмотреть как выглядит страница в виде xml-документа, если после адреса страницы дописать .xml (к примеру так www.ваш_сайт.ru/любая_страница/.xml). В первой строке буде узел result и у него два атрибута module и method.<br>
Если Вы открываете страницу контента, то шаблонизатор вернёт заголовок result:<br>
module="content" method="content"
если открывать страницу с объектом каталога то заголовок result уже будет таким:<br>
module="catalog" method="object"
и т.д. Для всех типов страниц предусмотрены свои заголовки, по названию модуля и метода, которые отвечают за их выполнение. Если посмотреть в шаблон - в основном центральном блоке стоит обработчик, который ищет подходящий шаблон на основании этих заголовков:<br>
<div class="content">
<xsl:apply-templates select="result" />
</div>

Теперь вернёмся к организации шаблонов. Все шаблоны подключаются в главном файле через вызов вида:<br>
modules/имя_модуля/common.xsl
Сам файл common.xsl не содержит какой-либо полезной информации, он просто подключает все шаблоны из этой же папки. Шаблоны, для удобства, называются также как макросы, за результат отработки которых они отвечают.<br>

Отдельно нужно ответить шаблоны:<br>
common.xsl в папке xsltTpls здесь лежат те макросы, которые на языке tpl называются системными (system)<br>
папка library также содержит шаблоны, отвечающие за обработку системных макросов.<br>
sample.xsl в папке xsltTpls содержит пример самой простой страницы на xslt<br>
папка sys-tpls содержит шаблоны преобразования данных для служебных целей (печать заказов, карта google и другие)<br>

Для знакомства с xslt-шаблонизатором имеет смысл ознакомиться с учебным пособием, которое можно скачать здесь:
http://www.umi-cms.ru/support/docs/xslt-umi-devbook/
[[Категория:Верстка в XSLT|Современный]]

Демо-дизайн "Современный"

2015-09-30T12:38:02Z

Alexei:

<b>Первое знакомство</b><br>

Если Вы решили использовать демо-дизайн "Современный", то Вам предстоит познакомиться с устройством шаблонов. Эта статья должна Вам в этом немного помочь.<br>

Все шаблоны xsl-шаблонизатора находятся в папке xsltTpls. По умолчанию, входной точкой во все шаблоны является default.xsl
Этот шаблон нужен только для того, чтобы пред-определить все наиболее часто встречающиеся значения и присвоить их переменным, а также подключить основные шаблоны.<br>

Кроме шаблона default.xsl в папке xsltTpls находятся другие подпапки. В первую очередь стоит обратить внимание на папку "layouts". В ней находится только один шаблон default.xsl. Это основной шаблон, который определяет общий внешний вид страницы. Именно в нём задаётся основная разметка и "вход" в шаблоны <br>
<xsl:template match="/" mode="layout">.
Сам шаблон можно условно поделить следующие части: шапка, дно, левое меню, правое меню и контент. Все поля, кроме контента, не меняют своего содержания, т.е. отвечают за вывод одних и тех же элементов оформления (будь то вывод последних новостей или меню).
Иначе дело обстоит с контентом.<br>
В xslt-шаблонизаторе для всех страниц определён метод и модуль, т.е. способ их формирования. Можно посмотреть как выглядит страница в виде xml-документа, если после адреса страницы дописать .xml (к примеру так www.ваш_сайт.ru/любая_страница/.xml). В первой строке буде узел result и у него два атрибута module и method.<br>
Если Вы открываете страницу контента, то шаблонизатор вернёт заголовок result:<br>
module="content" method="content"
если открывать страницу с объектом каталога то заголовок result уже будет таким:<br>
module="catalog" method="object"
и т.д. Для всех типов страниц предусмотрены свои заголовки, по названию модуля и метода, которые отвечают за их выполнение. Если посмотреть в шаблон - в основном центральном блоке стоит обработчик, который ищет подходящий шаблон на основании этих заголовков:<br>
<div class="content">
<xsl:apply-templates select="result" />
</div>

Теперь вернёмся к организации шаблонов. Все шаблоны подключаются в главном файле через вызов вида:<br>
modules/имя_модуля/common.xsl
Сам файл common.xsl не содержит какой-либо полезной информации, он просто подключает все шаблоны из этой же папки. Шаблоны, для удобства, называются также как макросы, за результат отработки которых они отвечают.<br>

Отдельно нужно ответить шаблоны:<br>
common.xsl в папке xsltTpls здесь лежат те макросы, которые на языке tpl называются системными (system)<br>
папка library также содержит шаблоны, отвечающие за обработку системных макросов.<br>
sample.xsl в папке xsltTpls содержит пример самой простой страницы на xslt<br>
папка sys-tpls содержит шаблоны преобразования данных для служебных целей (печать заказов, карта google и другие)<br>

Для знакомства с xslt-шаблонизатором имеет смысл ознакомиться с учебным пособием, которое можно скачать здесь:
http://www.umi-cms.ru/support/docs/xslt-umi-devbook/
[[Категория:Верстка в XSLT|Современный]]