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

Выборка с одновременным выполнением двух условий ИЛИ

2018-07-16T14:23:28Z

Po4emu4ka:

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

== Задача ==

Предположим у товаров по группам заданы некие поля и необходимо выбрать те товары, у которых в одной группе полей либо одно поле равно указанному значению, либо другое, при этом, одновременно должно выполняться условие, что в другой группе полей одно или второе поле равно заданному значению, т.е. получится условие вида (А или В) и (С или D). Одним запросом при помощи selector, используя два раза режим or-mode такую выборку сделать не получится, так как между двумя условиями "ИЛИ" система поставит еще одно.

== Решение ==
Реализовать такую выборку в UMI.CMS можно сделав два запроса к базе и получить "пересечение" их результатов, т.е. id товаров, а затем отобрать в результирующем запросе товары с данными id:

<source lang="php">

$pages = new selector('pages');
$pages->types('object-type')->id('идентификатор нужного типа данных');

$pages->option('or-mode')->fields('поле_первой_группы1','поле_первой_группы2');

$pages->where('поле_первой_группы1')->equals('значение');

$pages->where('поле_первой_группы2')->equals('значение');

foreach($pages as $page){

$mass[]=$page->id;

}

$pages1 = new selector('pages');
$pages1->types('object-type')->id('идентификатор нужного типа данных');

$pages1->option('or-mode')->fields('поле_второй_группы1','поле_второй_группы2');

$pages1->where('поле_второй_группы1')->equals('значение');

$pages1->where('поле_второй_группы2')->equals('значение');

foreach($pages1 as $page1){

$mass2[]=$page1->id;
}

$diff = array_intersect($mass,$mass2);

$final = new selector('pages');
$final->types('object-type')->id('идентификатор нужного типа данных');
$final->where('id')->equals($diff);

foreach($final as $object){

echo "<a href=\"{$object->link}\">{$object->name}</a>\n";
}
echo "Pages found: {$final->length}";

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

Lang.php

2018-07-16T14:22:07Z

Po4emu4ka:

В этом файле хранятся все [[языковые константы]].

Обратите внимание, что в зависимости от текущего языка, может подключаться дополнительный файл. Например, если мы находися в английской версии и префикс у этого языка "en", то при наличи файла lang.en.php в папке модуля будет использоваться именно он.

В этом файле должно быть как минимум следующее содержание:

<source lang="php">
<?php
$C_LANG = Array();
$C_LANG['module_name'] = "Мой модуль";
$LANG_EXPORT = Array();
?>
</source>

Тут есть 2 массива: $C_LANG и $LANG_EXPORT.

Массив $C_LANG устанавливает заголовки по умолчанию для методов нашего модуля. Ключ массива всегда соответствует названию метода. Обратите внимение, что ключ "module_name" в массиве $C_LANG зарезервирован - это название модуля.

Массив $LANG_EXPORT содержит языковые константы, которые может использовать модуль. Каждый ключ этого массива можно использовать как макрос, если заключить его в знаки "%".
[[category:Вопросы и уроки разработки сайтов на UMI.CMS]]

Класс currencyUpdater модуля emarket

2018-07-16T13:32:56Z

Po4emu4ka:

=Класс currencyUpdater=

== Описание ==

Класс currencyUpdater является абстрактным. Он создает объекты-обновляторы нужного класса валюты(дочерние классы).
Обновление курса осуществляется из внешнего источника - специальной xml ЦБ РФ.
Исходный код класса находится в файле classes\modules\emarket\classes\currency\currencyUpdater.php

== Методы ==

=== __construct ===

Конструктор __construct() создает объект валюты нужного класса

'''Параметры:''' 
iUmiObject $currencyObject:

'''Результат:'''не возвращает ничего, записывает объект в специальную защищенную переменную класса
 

=== update() ===

Метод update() обновляет курс объекта валюты

'''Параметры:''' 
отсутствуют
'''Результат:''' $rate курс валюты
 

=== get() ===

Метод get() получает обновлятор курса нужной валюты(класса)
'''Параметры:''' 
iUmiObject $currencyObject:

'''Результат:'''$updater обновлятор нужного класса валюты
 

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс discountModificator и его дочерние классы (модуль emarket)

2018-07-16T13:32:30Z

Po4emu4ka:

=Класс discountModificator и его дочерние классы=

== Описание ==

Класс является абстрактным - базовый класс для модификаторов цен скидок. Классами наследниками являются классы, представляющие типы модификаторов цен - процентный модификатор и абсолютный.
Исходный код класса находится в файле classes\modules\emarket\classes\discount\discountModificator.php

== Методы ==

=== create() ===

Метод create() создает объект скидки нужного типа(класса)

'''Параметры:''' 
discount $discount:
объект представляющий собой скидку
umiObject $modTypeObject:
объект представляющий тип модификатора
'''Результат:''' объект модификатор цены скидки нужного типа
 

=== get() ===

Метод get() получает объект скидки
'''Параметры:''' 
int $modObjectId:
идентификатор объекта модификатора скидки
discount $discount:
объект представляющий собой скидку
'''Результат:''' объект модификатор цены скидки нужного типа
 

=== getList() ===

Метод getList() получает список доступных можификаторов типа скидки
'''Параметры:''' 
int $discountTypeId=false:
идентификатор типа скидки
'''Результат:'''array список модификаторов
 

=== recalcPrice()===

Метод recalcPrice() пересчитывает цену с учетом модификатора.
Метод является абстрактным и определяется в дочерних классах

'''Параметры:''' 
int $price:
цена на товар, заказ
'''Результат:'''
 

== Дочерние классы ==

Стандартно у класса discountModificator имеется два дочерних класса procDiscountModificator и absoluteDiscountModificator, которые изменяют цену, соответственно, на заданный процент скидки либо
на фиксированное число. В каждом классе описан один публичный метод - recalcPrice

=== recalcPrice()===

Метод recalcPrice() пересчитывает цену с учетом модификатора.

'''Параметры:''' 
int $originalPrice:
цена на товар, заказ без учета скидки
'''Результат:''' int цена с учетом скидки

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс discountModificator модуля emarket

2018-07-16T13:32:06Z

Po4emu4ka:

=Класс discountModificator и его дочерние классы=

== Описание ==

Класс является абстрактным - базовый класс для модификаторов цен скидок. Классами наследниками являются классы, представляющие типы модификаторов цен - процентный модификатор и абсолютный.
Исходный код класса находится в файле classes\modules\emarket\classes\discount\discountModificator.php

== Методы ==

=== create() ===

Метод create() создает объект скидки нужного типа(класса)

'''Параметры:''' 
discount $discount:
объект представляющий собой скидку
umiObject $modTypeObject:
объект представляющий тип модификатора
'''Результат:''' объект модификатор цены скидки нужного типа
 

=== get() ===

Метод get() получает объект скидки
'''Параметры:''' 
int $modObjectId:
идентификатор объекта модификатора скидки
discount $discount:
объект представляющий собой скидку
'''Результат:''' объект модификатор цены скидки нужного типа
 

=== getList() ===

Метод getList() получает список доступных можификаторов типа скидки
'''Параметры:''' 
int $discountTypeId=false:
идентификатор типа скидки
'''Результат:'''array список модификаторов
 

=== recalcPrice()===

Метод recalcPrice() пересчитывает цену с учетом модификатора.
Метод является абстрактным и определяется в дочерних классах

'''Параметры:''' 
int $price:
цена на товар, заказ
'''Результат:'''
 

== Дочерние классы ==

Стандартно у класса discountModificator имеется два дочерних класса procDiscountModificator и absoluteDiscountModificator, которые изменяют цену, соответственно, на заданный процент скидки либо
на фиксированное число. В каждом классе описан один публичный метод - recalcPrice

=== recalcPrice()===

Метод recalcPrice() пересчитывает цену с учетом модификатора.

'''Параметры:''' 
int $originalPrice:
цена на товар, заказ без учета скидки
'''Результат:''' int цена с учетом скидки
[[category:Модуль Интернет магазин]]

Класс discountRule и его дочерние классы (модуль emarket)

2018-07-16T13:31:28Z

Po4emu4ka:

=Класс discountRule и его дочерние классы=

== Описание ==

Класс является абстрактным - базовый класс для правил скидок. Классами наследниками являются классы, представляющие типы правил:

*На определенные товары
*На временной промежуток
*На сумму покупок пользователя
*На группу пользователей
*На пользователей
*На связанные товары
*На сумму заказа

Исходный код класса находится в файле classes\modules\emarket\classes\discount\discountRule.php

== Методы ==

=== create() ===

Метод create() создает объект правила скидки нужного типа(класса)

'''Параметры:''' 
discount $discount:
объект представляющий собой скидку
umiObject $ruleTypeObject:
объект представляющий тип правила
'''Результат:''' объект правило скидки нужного типа
 

=== get() ===

Метод get() получает объект скидки
'''Параметры:''' 
int $modObjectId:
идентификатор объекта модификатора скидки
discount $discount:
объект представляющий собой скидку
'''Результат:''' объект правило скидки нужного типа
 

=== getList() ===

Метод getList() получает список доступных правил скидки
'''Параметры:''' 
int $discountTypeId=false:
идентификатор типа скидки
'''Результат:'''array список правил
 

== Интерфейсы ==

Здесь также описаны два интерфейса:

*orderDiscountRule, в котором описан метод validateOrder()
*itemDiscountRule, в котором описан validateItem()

== Дочерние классы ==

Стандартно у класса discountRule имеются следующие дочерние классы:

*usersDiscountRule
*userGroupsDiscountRule
*relatedItemsDiscountRule
*orderPriceDiscountRule
*itemsDiscountRule
*dateRangeDiscountRule
*allOrdersPricesDiscountRule

Каждый из дочерних классов реализует либо оба вышеуказанных интерфейса, либо один из них:

<table border=1>
<tr>
<td>
Интерфейсы/классы
</td>
<td>
usersDiscountRule
</td>
<td>
userGroupsDiscountRule
</td>
<td>
relatedItemsDiscountRule
</td>
<td>
orderPriceDiscountRule
</td>
<td>
itemsDiscountRule
</td>
<td>
dateRangeDiscountRule
</td>
<td>
allOrdersPricesDiscountRule
</td>
</tr>
<tr>
<td>
orderDiscountRule
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
</tr>
<tr>
<td>
itemDiscountRule
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
</tr>
</table>

В дочерних классах могут быть определены, соответственно - validateOrder(),validateItem(), оба или один из них.
Также, в некоторых классах имеется метод validate()

<table border=1>
<tr>
<td>
Методы/классы
</td>
<td>
usersDiscountRule
</td>
<td>
userGroupsDiscountRule
</td>
<td>
relatedItemsDiscountRule
</td>
<td>
orderPriceDiscountRule
</td>
<td>
itemsDiscountRule
</td>
<td>
dateRangeDiscountRule
</td>
<td>
allOrdersPricesDiscountRule
</td>
</tr>
<tr>
<td>
validateItem()
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
</tr>
<tr>
<td>
validateOrder()
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
</tr>
<tr>
<td>
validate()
</td>
<td align="center">
+
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
<td align="center">
-
</td>
<td align="center">
-
</td>
<td align="center">
+
</td>
<td align="center">
-
</td>
</tr>
</table>

=== validate()===

Метод validate() проверяет применимо ли данное правило к заказу или товару в каталоге.
Он используется в тех классах, в которых описаны оба метода - validateOrder() и validateItem(), и просто вызывается внутри них

'''Параметры:''' 
отсутсвтвуют
'''Результат:''' boolean true|false

=== validateOrder()===

Метод validateOrder() проверяет применимо ли данное правило к заказу.

'''Параметры:''' 
order $order:
объект представляющий заказ
'''Результат:''' boolean true|false

=== validateItem()===

Метод validateItem() проверяет применимо ли данное правило к товару в каталоге.

'''Параметры:''' 
iUmiHierarchyElement $element:
страница товара в каталоге
'''Результат:''' boolean true|false

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс discount модуля emarket

2018-07-16T13:30:33Z

Po4emu4ka:

=Класс discount=

== Описание ==

Класс является абстрактным - базовый класс для скидок. Классами наследниками являются классы, представляющие типы скидок - скидка на заказ, на товары, накопительная скидка.
Исходный код класса находится в файле classes\modules\emarket\classes\discount\discount.php

== Методы ==

=== getName() ===

Метод getName() получает название скидки

'''Параметры:''' 
отсутсвуют
'''Результат:'''String название скидки
 

=== setName() ===

Метод setName() изменяет название скидки
'''Параметры:''' 
String $name:
новое название скидки
'''Результат:''' 
 

=== getDiscountRules() ===

Метод getDiscountRules() получает список правил скидки
'''Параметры:''' 
отсутствуют
'''Результат:'''array список правил скидки (массив объектов класса discountRule)
 

=== appendDiscountRule()===

Метод appendDiscountRule() добавляет правило скидки

'''Параметры:''' 
discountRule $discountRule:
правило скидки
'''Результат:'''
 

=== getDiscountModificator()===

Метод getDiscountModificator() получает модификатор цены скидки
'''Параметры:''' 
отсутствуют
'''Результат:''' объект класса discountModificator - модификатор цены
 

=== setDiscountModificator() ===

Метод setDiscountModificator() устанавливает модификатор цены скидки
'''Параметры:''' 
discountModificator $discountModificator:
модификатор цены скидки
'''Результат:''' 
 

=== recalcPrice() ===

Метод recalcPrice() выполняет пересчет цены $price
'''Параметры:''' 
Float $price:
цена
'''Результат:''' Float пересчитанная цена с учетом скидки
 

=== get() ===

Метод get() получает экземпляр скидки по ее id
'''Параметры:''' 
Integer $discountId:
id скидки
'''Результат:'''discount объект скидки, экземпляр класса-потомка discount 
 

=== add() ===

Метод add() создает новую скидку
'''Параметры:''' 
String $discountName:
название скидки 
Integer $discountTypeId:
тип скидки
'''Результат:'''discount скидка 
 

=== getTypeId() ===

Метод getTypeId() получает id типа скидки по ее идентификатору
'''Параметры:''' 
String $discountCode:
строковой идентификатор типа скидки
'''Результат:''' Integer id типа скидки или false, если тип получить не удалось
 

=== init() ===

Метод init() инициализирует систему скидок
'''Параметры:''' 
отсутствуют
'''Результат:''' 

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс emarketTop модуля emarket

2018-07-16T13:28:40Z

Po4emu4ka:

=Класс emarketTop=

== Описание ==

Класс emarketTop позволяет вести статистику по интернет-магазину.
Исходный код класса находится в файле classes\modules\emarket\classes\stat\emarketTop.php

== Методы ==

=== addOrder() ===

Метод addOrder() добавляет в таблицу cms3_emarket_top статистику по заказу

'''Параметры:''' 
order $order:
объект заказ
'''Результат:'''
 

=== delOrder() ===

Метод delOrder() удаляет из таблицы cms3_emarket_top
статистику по заказу
'''Параметры:''' 
order $order:
объект заказ
'''Результат:''' 
 

=== getTop() ===

Метод getTop() получает топ популярных товаров
'''Параметры:''' 
array $range:
здесь необходимо передать массив, состоящий из двух элементов с ключами fromDate и toDate
int $numberItems:
количество возвращаемых популярных товаров
string $sort:
поле сортировки
'''Результат:'''array список популярных товаров
 

=== clearTableTop()===

Метод clearTableTop() удалит всю статистику
'''Параметры:''' 
отсутствуют
'''Результат:'''
 

=== allOrdersRecalculate() ===

Метод allOrdersRecalculate()
вернет количество заказов со статусом "готов", оформленных до текущей даты
'''Параметры:''' 
отсутствуют

'''Результат:'''int количество заказов
 

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс optionedOrderItem модуля emarket

2018-07-16T13:27:40Z

Po4emu4ka:

=Класс optionedOrderItem=

== Описание ==

Расширенная версия класса orderItem с учетом возможных опций.
Исходный код класса находится в файле classes\modules\emarket\classes\order\items\ooptioned.php

== Свойства класса ==

$options, хранит информацию о свойствах наименования
<source lang="php">
protected $options = Array();
</source>

== Методы ==

=== create() ===

Экземпляр класса создается с помощью конструктора __construct
'''Параметры:''' 
umiObject $object
'''Результат:'''

=== getOptions() ===

Метод getOptions() вернет список опций наименования

'''Параметры:''' 
отсутствуют

'''Результат:'''Array $options 

=== appendOption() ===

Метод appendOption() подключает опцию к товару в заказе
'''Параметры:''' 
String $propertyName:
название свойства, к которому применяется опция 
Integer $optionId:
id объекта, который соответствует значению опции 
'''Результат:'''вернет true, если применение опции прошло без ошибок 

=== removeOption() ===

Метод removeOption() удалит опцию из описания товара в заказе.
'''Параметры:''' 
String $propertyName:
название свойства, к которому привязана опция 
'''Результат:'''вернет true, если опция успешно удалена 

=== getItemPrice() ===

Метод getItemPrice() получает цену на товар с учетом опций
'''Параметры:''' 
отсутствуют
'''Результат:''' float $price

=== setOptionPrice() ===

Метод setOptionPrice() установит
"цену опции"
'''Параметры:''' 
String $propertyName:
название свойства, к которому применяется опция 
Float $price = false:
стоимость опции 
'''Результат:'''вернет true, если применение цены опции прошло без ошибок 

=== refresh() ===

Метод refresh() обновит информацию об опциях товара
'''Параметры:''' 
отсутствуют
'''Результат:''' 

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс orderItem модуля emarket

2018-07-16T13:26:54Z

Po4emu4ka:

=Класс orderItem=

== Описание ==

Класс orderItem связывает объекты каталога в магазине и непосредственно заказ (корзину товаров).
Исходный код класса находится в файле classes\modules\emarket\classes\order\orderItem.php

== Методы ==

=== create() ===

Экземпляр класса создается с помощью функции create()

'''Параметры:''' 
Integer $elementId:
id страницы-объекта каталога 
Integer|Boolean $storeId:
id склада, на котором находится товар, по умолчанию false 
'''Результат:'''orderItem товар в заказе 

=== get() ===

Метод get() экземпляр наименования в заказе с учетом текущих настроек интернет-магазина и типа товара.

'''Параметры:''' 
Integer $objectId:
id объекта 

'''Результат:'''orderItem объект наименования в заказе 

=== remove() ===

Метод remove() удалит объект, представляющий товар в заказе

'''Параметры:''' 

'''Результат:'''

=== getName() ===

Метод getName() получит название наименования

'''Параметры:''' 

'''Результат:''' String название наименования заказа

=== getAmount() ===

Метод getAmount() получит количество товара, которое добавлено к заказу

'''Параметры:''' 

'''Результат:''' Integer количество товаров в заказе

=== setAmount() ===

Метод setAmount() изменит количество товаров в заказе

'''Параметры:''' 
Integer $amount:
новое значение количества товаров в заказе 

'''Результат:'''

=== getTotalOriginalPrice() ===

Метод getTotalOriginalPrice() получит стоимость всего наименования без учета скидок

'''Параметры:''' 

'''Результат:'''Float стоимость наименования без учета скидок

=== getTotalActualPrice() ===

Метод getTotalActualPrice() получит стоимость всего наименования с учетом скидок

'''Параметры:''' 

'''Результат:'''Float стоимость наименования с учетом скидок

=== getItemPrice() ===

Метод getItemPrice() получитп стоимость одной единицы товара (без скидок)

'''Параметры:''' 

'''Результат:''' Float стоимость 1 единицы товара без скидки

=== getIsDigital() ===

Метод getIsDigital() проверит, является ли товар цифровым.

'''Параметры:''' 

'''Результат:''' Boolean true|false

=== getItemElement() ===

Метод getItemElement() получит страницу-объект каталога, которая является товаром этого наименования.

'''Параметры:''' 

'''Результат:''' iUmiHierarchyElement объект в каталоге

=== getDiscount() ===

Метод getDiscount()
получит скидку, которая действует на наименование

'''Параметры:''' 

'''Результат:'''itemDiscount скидка на наименование 

=== setDiscount() ===

Метод setDiscount() установит скидку на наименование

'''Параметры:''' 

itemDiscount $discount:
объект скидка на товар 

'''Результат:''' 

=== refresh() ===

Метод refresh() пересчитает параметры наименования и обновит свойства наименования в БД

'''Параметры:''' 

'''Результат:'''вернет true в случае, если наименование существует и было обновлено, false в противном случае 

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс order модуля emarket

2018-07-16T13:25:21Z

Po4emu4ka:

=Класс order=

== Описание ==

Данный класс предоставляет доступ к заказу интернет-магазина либо к текущей корзине.
Исходный код класса находится в файле classes\modules\emarket\classes\order\order.php

== Свойства класса ==

$items, хранит информацию о предметах в заказе или корзине
<source lang="php">
protected $items = Array();
</source>

$actualPrice хранит актуальную цену на заказ(с учетом скидки)
<source lang="php">
protected $actualPrice;
</source>

$originalPrice хранит цену заказа с учетом скидки
<source lang="php">
protected $originalPrice;
</source>

$totalAmount хранит общее количество предметов в заказе или корзине товаров
<source lang="php">
protected $totalAmount;
</source>

$discount хранит объект "скидка на заказ"
<source lang="php">
protected $discount;
</source>

$domain хранит объект "текущий домен"
<source lang="php">
protected $domain;
</source>

== Методы ==

=== create() ===

Экземпляр класса создается с помощью функции create()
'''Параметры:''' 
boolean $useDummyOrder:
по умолчанию false 
'''Результат:'''Int $orderId - id нового заказа 

=== get() ===

Метод get() получит экземпляр заказа по его id. Если id заказа false, то метод вернет текущий объект со статусом "в корзине".
Если такого объекта еще нет, то он его создаст
'''Параметры:''' 
Integer $orderId:
по умолчанию false 
'''Результат:'''iUmiObject $order - новый объект заказ 

=== getStatusByCode() ===

Метод getStatusByCode() получит id объекта статуса заказа.
'''Параметры:''' 
String $codename:
код статуса заказа 
String $statusClass = 'order_status':
группа статуса 
'''Результат:'''Integer id объекта статуса заказа 

=== getCodeByStatus() ===

Метод getCodeByStatus() получит код статуса заказа.
'''Параметры:''' 
Integer $id:

идентификатор объекта статуса заказа 

'''Результат:'''String codename код статуса заказа 

=== getItems() ===

Метод getItems() получит список наименований в заказе.

'''Параметры:''' 

'''Результат:'''Array массив, состоящий из экземпляров класса orderItem 

=== appendItem() ===

Метод appendItem() добавит наименование в заказ.
'''Параметры:''' 
orderItem $orderItem:

наименование заказа 

'''Результат:''' вернет false, если наименование с таким id уже есть в заказе

=== removeItem() ===

Метод removeItem() удалит наименование из заказа.После удаления из заказа объект orderItem будет уничтожен
'''Параметры:''' 
orderItem $orderItem:

наименование в заказе 

'''Результат:''' вернет true, если наименование было удалено, false в противном случае

=== getItem() ===

Метод getItem() получит
экземпляр наименования заказа по id
'''Параметры:''' 
Integer $itemId:

id наименования 

'''Результат:''' orderItem, если наименование получить не удалось - false

=== isEmpty() ===

Метод isEmpty() проверяет есть ли наименования в заказе

'''Параметры:''' 

'''Результат:''' bool true, если заказ пустой, иначе false

=== earse() ===

Метод earse() очистит
список товаров в заказе. При этом будут уничтожены все orderItem'ы

'''Параметры:''' 

'''Результат:'''

=== getOrderStatus() ===

Метод getOrderStatus() получит текущий статус заказа

'''Параметры:''' 

'''Результат:''' Integer id объекта статуса заказа

=== setOrderStatus() ===

Метод setOrderStatus() изменит текущий статус заказа
'''Параметры:''' 
Integer $newStatusId:

id объекта-статуса заказа 

'''Результат:''' 

=== getPaymentStatus() ===

Метод getPaymentStatus() получит текущий статус оплаты заказа

'''Параметры:''' 

'''Результат:''' Integer id объекта-статуса оплаты

=== setPaymentStatus() ===

Метод getItem() изменит текущий статус оплаты заказа
'''Параметры:''' 
Integer $statusId:

id объекта-статуса оплаты 

'''Результат:'''

=== getDeliveryStatus() ===

Метод getDeliveryStatus() Получить текущий статус доставки заказа

'''Параметры:''' 

'''Результат:''' Integerid объекта-статуса доставки

=== setDeliveryStatus() ===

Метод setDeliveryStatus() изменит текущий статус доставки заказа

'''Параметры:''' 
Integer $statusId:

id объекта-статуса доставки 

'''Результат:'''

=== getActualPrice() ===

Метод getActualPrice() Получит цену всего заказа с учетом скидки на этот заказ

'''Параметры:''' 

'''Результат:''' Float actualPrice - цена с учетом скидки на заказ 

=== getOriginalPrice() ===

Метод getOriginalPrice() Получит цену всего заказа без учета скидки на этот заказ

'''Параметры:''' 

'''Результат:''' Float originalPrice - цена без учета скидки на заказ

=== getTotalAmount() ===

Метод getTotalAmount() получит количество наименований в заказе

'''Параметры:''' 

'''Результат:''' Integer totalAmount - количество наименований в заказе

=== getDeliveryPrice() ===

Метод getDeliveryPrice() получит стоимость доставки

'''Параметры:''' 

'''Результат:''' Integer delivery_price стоимость доставки

=== refresh() ===

Метод refresh() пересчитает содержимое корзины

'''Параметры:''' 

'''Результат:'''

=== getCustomerId() ===

Метод getCustomerId() получит
id клиента. Это может быть как id пользователя, так и id объекта временного покупателя

'''Параметры:''' 

'''Результат:''' Integer id объекта-клиента

=== getDomain() ===

Метод getDomain() получит
домен, в котором производится заказ

'''Параметры:''' 

'''Результат:''' $domain

=== setDomainId() ===

Метод setDomainId() изменит домен, в котором производится заказ

'''Параметры:''' 
domain $domain:

 

'''Результат:''' 

=== getDiscount() ===

Метод getDiscount() получит
текущую скидку на этот заказ

'''Параметры:''' 

'''Результат:''' discount скидка на заказ

=== setDiscount() ===

Метод setDiscount() Назначит скидку на заказ

'''Параметры:''' 
discount $discount:

скидка на заказ, по умолчанию null 

'''Результат:''' 

=== getBonusDiscount() ===

Метод getBonusDiscount() получит размер оплаты бонусами.

'''Параметры:''' 

'''Результат:''' float размер оплаты 

=== setBonusDiscount() ===

Метод setBonusDiscount() установит оплату бонусом.

'''Параметры:''' 
Integer $id:

идентификатор объекта статуса заказа 

'''Результат:'''String codename код статуса заказа 

=== getCodeByStatus() ===

Метод getCodeByStatus() получит код статуса заказа.

'''Параметры:''' 
float $bonus:

сумма списываемых баллов 

'''Результат:'''

=== generateNumber() ===

Метод generateNumber() сгенерирует номер заказа.

'''Параметры:''' 

'''Результат:'''

=== order() ===

Метод order() сохранит заказ в базе со статусом "в обработке(waiting)", т.е. этот заказ уже не будет являтсья "текущей корзиной товаров"

'''Параметры:''' 

'''Результат:'''true в случае сохранения заказа, false в противном случае 

=== searchDiscount() ===

Метод searchDiscount() определит скидку для заказа.

'''Параметры:''' 

'''Результат:''' orderDiscount $discount - скидка заказа 

=== reserve() ===

Метод reserve() зарезервирует наименования в заказе

'''Параметры:''' 

'''Результат:'''

=== unreserve() ===

Метод unreserve() отменить резервирование наименований в заказе.

'''Параметры:''' 

'''Результат:'''

=== writeOff() ===

Метод writeOff() спишет из магазина зарезервированные наименования

'''Параметры:''' 

'''Результат:''' true, если наименования списаны, false в противном случае 

=== getAdvParamFromUrl() ===

Метод getAdvParamFromUrl() получит параметры рекламной компании.

'''Параметры:''' 
 $url:
адрес на который пришёл пользователь 

 $refer:
адрес с которого пришёл пользователь, по умолчанию null 

'''Результат:''' array $params 

=== parseUrlReferer() ===

Метод parseUrlReferer() найдет в URL ключевые слова и источник перехода

'''Параметры:''' 
 $url:
адрес с которого пришёл пользователь (referer) 

'''Результат:''' array $query 
br/
br//p

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Класс payment модуля emarket

2018-07-16T13:24:21Z

Po4emu4ka:

=Класс payment=

== Описание ==

Класс является абстрактным - базовый класс для способов оплаты. Классами наследниками являются классы, представляющие типы способов оплаты - курьеру при получении, платежная квитанция и т.д.
Исходный код класса находится в файле classes\modules\emarket\classes\payment\payment.php

== Методы ==

=== create() ===

Метод create() создает объект способа оплаты нужного типа(класса)

'''Параметры:''' 
iUmiObject $paymentTypeObject:
объект представляющий тип оплаты
'''Результат:'''объект представляющий способ оплаты
 

=== get() ===

Метод get() получает объект способа оплаты. Вызывается внутри метода create().
'''Параметры:''' 
int $objectId:
идентификатор объекта способа оплаты
order $order=null:
объект заказ
'''Результат:''' 
 

=== getList() ===

Метод getList() получает список способов оплаты
'''Параметры:''' 
отсутствуют
'''Результат:'''array список способов оплаты
 

=== getResponseOrderId()===

Метод getResponseOrderId() ищет идентификатор заказа в ответе платежной системы.

'''Параметры:''' 
discountRule $discountRule:
правило скидки
'''Результат:'''Integer идентификатор заказа либо boolean false
 

=== getCodeName()===

Метод getCodeName() получает строковый идентификатор типа оплаты
'''Параметры:''' 
отсутствуют
'''Результат:''' string строковый идентификатор типа оплаты или boolean false
 

=== getOrderId() ===

Метод getOrderId() ищет идентификатор заказа в параметре специфичном для платежной системы. Здесь метод всегда возвращает false. Данную функцию необходимо переопредилить в файле платежной системы.
'''Параметры:''' 
отсутствуют
'''Результат:''' boolean false
 

Также, в данном классе имеется три абстрактных метода:
*process()
*validate()
*poll()

Определяются, соответственно, в дочерних классах

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Счетчик посещений для всех страниц сайта

2018-07-16T13:11:43Z

Po4emu4ka:

'''Задача:''' вставить на страницу код счетчика.

'''Решение:''' мы будем рассматривать, вставку кода счетчика на примере вставки счетчика yandex-метрика.

Для реализации этой задачи, нам необходимо выполнить следующие действия:

1. В модуле "Шаблоны Данных" добавить дочерний тип для "Страниц контента";

2. В новом типе добавить поле "Метрика", тип "Простой текст";

3. Создать новую страницу в структуре "Настройки сайта" (снять галочку "Отображать в меню");

4. Изменить тип страницы на созданный в шаблонах данных (изменяется в "дополнительных настройках" страниц);

5. В поле "Метрика" вставить код нужного счетчика, например yandex-метрики и примерно код этого счетчика будет выглядеть так:
<source lang="java">

<div style="display:none;"><script type="text/javascript">
(function(w, c) {
(w[c] = w[c] || []).push(function() {
try {
w.yaCounter123456 = new Ya.Metrika({id:123456, enableAll: true});
}
catch(e) { }
});
})(window, 'yandex_metrika_callbacks');
</script></div>
<script src="//mc.yandex.ru/metrika/watch.js" type="text/javascript" defer="defer"></script>
<noscript><div><img src="//mc.yandex.ru/watch/123456" style="position:absolute; left:-9999px;" alt="" /></div></noscript>

</source>

так же можно вставить текст копирайта и сохраняем страницу;

6. Последний шаг будет различаться, в зависимости от того, какой шаблонизатор мы используем.
Для tpl-шаблонизатора вывод содержания этого поля в шаблон дизайна будет производится с помощью макроса %data getProperty()%.
Подробное описание этого макроса в документации разработчиков сайтов [[http://help-dev.umi-cms.ru/data.getProperty.html]].

В xslt-шаблонизаторе, для того, чтобы получить свойство страницы необходимо использовать протокол upage.
Если мы хотим увидеть конкретное свойство страницы, например "Метрики" - вводим в адресной строке браузера следующий запрос:
httр://silaest.ru/upage/XX.YY , где XX - это ID страницы, свойство которой необходимо вывести, YY - идентификатор поля (XX и YY следует разделить точкой). То есть, если ID созданной страницы настроек 414 (httр://silaest.ru/admin/content/edit/414/), а идентификатор поля метрик в шаблонах данных "metrika", то запрос будет выглядеть следующим образом: httр://silaest.ru/upage/414.metrika

Если мы хотим установить счетчик для всех страниц потребуется отредактировать шаблон "~/xsltTpls/layouts/default.xsl" - вывести свойство страницы "Настройки сайта" до закрывающего тега <body>, то есть:
<source lang="java">
...
<xsl:value-of select="document('upage://414.metrika')/udata/property/value" disable-output-escaping="yes" />
</body>
...
</source>

Также, обращаем свое внимание, что поле "wysiwyg" (Визуальный редактор) не предназначен для вставки кода (например yandex-метрики). Для этих целей следует использовать тип поля "Простой текст", при создании нового поля в "Шаблонах данных" (шаг 2). В противном случае часть кода будет вырезана визуальным редактором и счетчик работать не будет.

Если нам требуется добавить код других счетчиков или вставить карту - создавать дочернюю страницу не требуется, достаточно просто добавить новые поля (для уже созданного типа "Настройки сайта") в шаблонах данных.
[[category:Сторонние сервисы и программы]]

Формирование прайс листа на основе каталога XSLT

2018-07-16T13:10:03Z

Po4emu4ka:

== Задача ==

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

== Решение ==

Для решения данной задачи сформируем шаблон основанный на макросе '''catalog getCategoryList''' и '''catalog getObjectList'''. Для этого первым делом необходимо убедиться, что у всех разделов и товаров стоят галочки '''Отображать в меню''' и '''Показывать подменю'''. После этого необходимо добавить в главном шаблоне вывод прайс листа строкой:
<source lang="xml">
<xsl:if test=" $document-page-id = 98">
<xsl:apply-templates select="document('udata://catalog/getCategoryList/(notemplate)/36')" mode="price_list" />
</xsl:if>
</source>

мы дополнительно поставили проверку на id страницы для которой необходимо выводить прайс лист, его можно узнать, создав в структуре страницу контента для прайс листа и открыв ее для редактирования, в адресной строке браузера.

Далее создаем в папке ''\templates\demodizzy\xslt\modules\catalog'' файл '''price-list.xsl''' и помещаем туда следующий код:
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE xsl:stylesheet SYSTEM "ulang://i18n/constants.dtd:file">
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:umi="http://www.umi-cms.ru/TR/umi">



<xsl:template match="udata[@module='catalog' and @method = 'getCategoryList']" mode="price_list">
<table class="price_list">
<tr>
<td>
Наименование
</td>
<td>
Цена
</td>
</tr>
<xsl:apply-templates select="//items/item" mode="price_list"/>
</table>

</xsl:template>

<xsl:template match="udata[@method = 'getCategoryList']//item" mode="price_list">
<tr class="price_list_category">
<td colspan="2">
<a href="{@link}" class="price_list">

Раздел <xsl:value-of select="." />

</a>
</td>
</tr>

<xsl:apply-templates select="document(concat('udata://catalog/getCategoryList/notemplate/', @id))//items/item" mode="include_price_list" />
</xsl:template>


<xsl:template match="udata[@method = 'getCategoryList']//item" mode="include_price_list">
<tr class="price_list_subcategory">
<td colspan="2">
<a href="{@link}" class="price_list">

Подраздел <xsl:value-of select="." />

</a>
</td>
</tr>
<xsl:apply-templates select="document(concat('udata://catalog/getObjectsList/notemplate/', @id))//item" mode="price_list" />
<xsl:apply-templates select="document(concat('udata://catalog/getCategoryList/notemplate/', @id))//items/item" mode="include_catalog_price_list" />
</xsl:template>


<xsl:template match="udata[@method = 'getCategoryList']//item" mode="include_catalog_price_list">
<tr class="price_list_subsubcategory">
<td colspan="2">
<a href="{@link}" class="price_list2">

Подподраздел <xsl:value-of select="." />

</a>
</td>
</tr>
</xsl:template>

<xsl:template match="udata[@method = 'getObjectsList']//item" mode="price_list">
<xsl:param name="id" select="./@id" />
<tr class="price_list_subsubcategory">
<td>
<a href="{@link}" class="price_list2">

Товар <xsl:value-of select="." />

</a>
</td>
<td>
<xsl:value-of select="document(concat('upage://',$id))//properties/group/property[@name='price']/value" /><xsl:text> руб.</xsl:text>
</td>
</tr>
</xsl:template>



</xsl:stylesheet>
</source>

для того, что бы данный шаблон заработал необходимо подключить его в файле '''catalog/common.xsl''' добавив строчку:
<source lang="xml">
<xsl:include href="price-list.xsl" />
</source>
[[category:Верстка в XSLT]][[category:Модуль Каталог]]

Чекбоксы вместо выпадающего списка при фильтрации объектов каталога

2018-07-16T13:09:12Z

Po4emu4ka:

Задача: реализовать в фильтрации каталога представление данных из выпадающего списка в виде чекбоксов.

Данную задачу можно решить используя кастомный макрос. В кастомный макрос передается значение %name%, и используя средства API UMI.CMS [http://api.umi-cms.ru/] скрипт получает содержимое справочника для переданного поляи по полученным значения сформировать в цикле чекбоксы.

Вызов в кастомного скрипта производится в блоке '''search_block_line_relation''' (шаблона по которому производится фильтрация):

<source lang="php">
%custom filter_checkbox(%id%, %name%)% %object_name% 
</source>

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

<source lang="php">
public function filter_checkbox($items, $name) {
$field_name = $name;
$hierarchy = umiHierarchy::getInstance();
$controller = cmsController::getInstance();
$page_id = $controller->getCurrentElementId();
$h_type_id = umiHierarchyTypesCollection::getInstance()->getTypeByName('catalog', 'object')->getId();
$type_id = $hierarchy->getDominantTypeId($page_id, 10, $h_type_id);
if(!$type_id){
$type_id = umiObjectTypesCollection::getInstance()->getTypeByHierarchyTypeId($h_type_id);
}
$type = umiObjectTypesCollection::getInstance()->getType($type_id);
$field_id = $type->getFieldId($field_name);
if(!$field_id){
throw new publicException('field with name \'' . $name . '\' not found in type with id = ' . $type_id);
}
$field = umiFieldsCollection::getInstance()->getField($field_id);
$guid_id = $field->getGuideId();
$arr = umiObjectsCollection::getInstance()->getGuidedItems($guid_id);

$res = "";
$i = 0;

foreach ($arr as $key=>$value) {
$res .= "<input type=\"checkbox\" name=\"fields_filter[$name][" . $i . "]\" id=\"" . $key ."\" value=\"" . $key ."\" />" . $value . " ";
$i++;
}

return $res;
}
</source>
[[category:Написание кастомных макросов]][[category:Модуль Каталог]]

Экспорт в YML (vendor.model)

2018-07-16T13:08:00Z

Po4emu4ka:

== Задача ==
Произвести экспорт в формат ЯндексМаркет (YML) с присутствием таких полей как:
vendor (производитель), vendorCode (код товара по классификации производителя), model (модель товара), price (цена).

== Необходимые действия ==
Чтобы на страницах объекта каталога присутствовали данные поля, в «Шаблоне данных» необходимо добавить нужные поля и реализовать кастомный шаблон экспорта xsl/export/custom/YML.xsl . Системный шаблон лежит по пути /xsl/import/commerceML2.xsl. Системные файлы редактировать нельзя, поэтому для их кастомизации Вам нужно определить template, который требуется изменить. Потом полностью перенести его в файл /import/custom/commerceML2.xsl.

В xsl присутствует такой блок:
<source lang="xml">

<xsl:variable name="typePrefix">typePrefiks</xsl:variable>
<xsl:variable name="vendor">proizvoditel</xsl:variable>
<xsl:variable name="model">model</xsl:variable>
</source>

К примеру, необходимо чтобы значение proizvoditel совпадало с идентификатором поля Производитель, если у вас он прописан как vendor (в Шаблоне данных), то необходимо proizvoditel изменить на vendor. В блок vendor.model добавляем новую строку для vendorCode:
<source lang="xml">
<xsl:variable name="vendorCode">vendorcode</xsl:variable>
</source>

И далее после строк:
<source lang="xml">
<vendor><xsl:value-of select=".//property[name = $vendor]//value"/></vendor>
<model><xsl:value-of select=".//property[name = $model]//value"/></model>
</source>

Добавляем:
<source lang="xml">
<xsl:if test=".//property[name = $vendorCode]//value != ''">
<vendorCode><xsl:value-of select=".//property[name = $vendorCode]//value"/></vendorCode>
</xsl:if>
</source>

Чтобы экспортировались все поля, они должны быть заполнены.
[[category:Модуль Обмен данными]]

Виджет комментариев вконтакте на Вашем сайте

2018-07-16T13:06:27Z

Po4emu4ka:

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

'''Задача:'''

Добавить один из виджетов ВКонтакте на свой сайт. Мы будем рассматривать добавление виджета, на примере комментариев ВКонтакте. Пользователи смогут комментировать Ваши материалы без дополнительной регистрации. При желании, каждый оставленный комментарий может транслироваться на страницу комментатора во ВКонтакте со ссылкой на исходную статью. Со страницы автора и из раздела Новости о статье узнают друзья автора и смогут присоединиться к дискуссии. В этом случае комментарии второго уровня будут синхронизироваться между ВКонтакте и виджетом на Вашем сайте, так что обсуждение будет происходить одновременно на двух площадках, привлекая внимание новых участников.

'''Решение:'''
Подробно рассмотрим как реализовать данную задачу.

Шаг 1. Создаем приложение ВКонтакте (если оно уже есть можно приступить к Шагу 2)

Нажимаем на "Разработчикам" на сайте ВКонтакте на своей странице.
[[Файл:1qqq.png]]

Нажимаем подключить сайт.

[[Файл:2qqq.png]]

Заполняем необходимые поля.

[[Файл:3qqq.png]]

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

[[Файл:4qqq.png]]

Далее, в новом окне мы получаем ID приложения (apiID).

[[Файл:5qqq.png]]

Шаг 2. Подключение, непосредственно самого виджета.
Нажимаем на "Разработчикам" на сайте ВКонтакте на своей странице.
[[Файл:1qqq.png]]

Нажимаем виджеты и сторонние сайты.

[[Файл:6qqq.png]]

Получаем необходимый код, для вставки на Ваш сайт. Единственное изменение, которое необходимо внести - это apiID, ввести Ваш apiID (полученный в Шаге 1)

[[Файл:7qqq.png]]

Вставляем код
<source lang="javascript">

<script type="text/javascript" src="http://vkontakte.ru/js/api/openapi.js?9" charset="windows-1251"></script>

<script type="text/javascript">
VK.init({apiId: 1234567, onlyWidgets: true});
</script>


<div id="vk_comments"></div>
<script type="text/javascript">
VK.Widgets.Comments("vk_comments", {limit: 10, width: "596"});
</script>
</source>
Первую часть кода (до строчки "Вставьте этот тег div в то место, где должен располагаться блок комментариев") вставьте между тегами <head> и </head> в шаблоне. При использовании XSLT-шаблонизатора, по умолчанию, в файле '''/xsltTpls/layouts/default.xsl''' или '''/templates/имя_шаблона/xslt/layouts/default.xsl''' 
При использовании TPL-шаблонизатора файл в директории '''/tpls/content''' или '''/templates/имя_шаблона/tpls/content'''

Вторую часть кода - в HTML-код шаблона, страницы или блока, где должен отображаться виджет (html-код страницы или блока, редактируемого через wysiwyg-редактор можно открыть, нажав на кнопку HTML при редактировании страницы или блока).
[[category:Сторонние сервисы и программы]]

Интеграция с Класс365

2018-07-16T13:04:08Z

Po4emu4ka:

[[category:Сторонние сервисы и программы]]

== Вариант 1. В Класс365 нет товаров и в UMI.CMS нет товаров (учет в Класс365) ==

''Вы хотите начать работать в Класс365 и в интернет-магазине UMI.CMS. Работа с товарами будет производиться в Класс365.''

#Создайте свою базу в Класс365.
#*Для того, чтобы вести учет и обрабатывать заказы в Класс365, выберите в главном меню раздел «Справочники» и заполните справочники «Товары» и «Контрагенты» (можно заполнить вручную или импортировать из Excel*).
#Введите остатки по складам, либо оформите поступление товаров
#Создайте магазин на сайте http://www.umi-cms.ru/
#Настройте интеграцию с интернет магазином в Класс365
#Над главным меню нажмите на кнопку «Администрирование» и выберите пункт Интеграция с интернет-магазинами, нажмите «Добавить», в появившейся форме в строке «CMS сайта» выберите UMI.CMS и подставьте:
##''Адрес сайта'' - http://ваш_сайт/admin/exchange/auto/
##''Логин'' - имя пользователя (супервайзера) в UMI.CMS
##''Пароль'' - Ваш пароль пользователя (супервайзера) в UMI.CMS
#Проверьте подключение.
#Настройте параметры выгрузки товаров и загрузки заказов:
#*тип цен, организацию, группы товаров, статус, к какой организации привязывать заказ, учет НДС.
#Для того, что бы товары появились в UMI.CMS, нажмите кнопку «Выгрузить сейчас». На сайте появились Ваши товары.
#*Если Вы хотите проверить правильность работы системы, оформите пробный заказ в управлении UMI.CMS.
#Для того, чтобы Ваши заказы отобразились В Класс365, в форме «Интеграция с интернет-магазином» нажмите «Загрузить сейчас».
#В главном меню выберите раздел «Продажи» в открывшемся подменю нажмите на «Заказы покупателей». Там будет сформирован заказ с соответствующим набором товаров и суммой, а во вкладке «Контрагенты» создан новый контрагент с данными Вашего покупателя.

*При импорте товаров в Класс365 из файла формата Excel, в системе создается папка «импортированные».
Из нее Вы можете перенести товары в любую группу, чтобы не путаться при выгрузке товаров в интернет-магазин.

== Вариант 2. В Класс365 нет товаров, а в UMI.CMS есть товары (учет в Класс365) ==

''У Вас уже есть интернет-магазин UMI.CMS с товарами и вы только начинаете работать с Класс365. Работа с товарами будет производиться в Класс365.''

#Создайте свою базу в Класс365.
#Заполните данные об организации. В разделе главного меню «Справочники» заполните справочник «Контрагенты».
#Для того, чтобы перенести базу товаров из UMI.CMS в Класс365, на сайте нажмите правой кнопкой мыши на категорию товаров и выберите «Экспорт списка в CSV».
#Сформируйте прайс-лист в формате .xls с параметрами:
##Артикул / код на складе
##наименование краткое
##наименование полное
##ставка НДС
##единица измерения
##цена
#*Обязательными полями являются артикул или код на складе, наименование, единица измерения. Все остальные параметры загружаются на ваше усмотрение, если их нет в документе, то вы сможете их добавить непосредственно в системе.
#Импортируйте товары в систему.
##Над главным меню нажмите на кнопку «Администрирование» и выберите пункт «Импорт и экспорт».
##Нажмите кнопку «Новый импорт товаров».
##Нажмите на кнопку «Выбрать файл» и выберите заранее подготовленный файл в формате .xls
##В окне появится информация, содержащаяся в файле.
##Над каждой колонкой в выпадающем списке выберите соответствующее ей значение
##Нажмите кнопку «загрузить товары»
##Товары загружены и находятся в справочнике «Товары», группа «импортированные».
#*Так же с помощью импорта, выбрав в выпадающем списке «Цена продажа» вы сформируете продажный прайс-лист с указанными ценами в загружаемом файле.
#*Выбор колонок прайс листа:
#*[[Файл:Cms.jpg]]
#Введите остатки товаров по складам
#Над главным меню нажмите на кнопку «Администрирование» и выберите пункт «Интеграция с интернет магазинами», нажмите «Добавить». Из выпадающего списка выберете UMI.CMS и подставьте:
##''Адрес сайта'' - http://ваш_сайт/admin/exchange/auto/
##''Логин'' - имя пользователя (супервайзера) в UMI.CMS
##''Пароль'' - Ваш пароль пользователя (супервайзера) в UMI.CMS
#*Проверьте подключение.

== Вариант 3. В Класс365 нет товаров, а в UMI.CMS есть товары (учет в UMI.CMS) ==

''У Вас уже есть интернет-магазин UMI.CMS с товарами и вы только начинаете работать с Класс365. Работа с товарами будет производиться в UMI.CMS. В Класс365 будут только обрабатываться заказы из UMI.CMS.''

#Настройте интеграцию с интернет-магазином в Класс365:
#*Над главным меню нажмите на кнопку «Администрирование» и выберите пункт «Интеграция с интернет-магазинами», нажмите «Добавить», в появившейся форме в строке «CMS сайта» выберете UMI.CMS иподставьте:
##''Адрес сайта'' - http://ваш_сайт/admin/exchange/auto/
##''Логин'' - имя пользователя (супервайзера) в UMI.CMS
##''Пароль'' - Ваш пароль пользователя (супервайзера) в UMI.CMS
#*Проверьте подключение.
#Если Вы хотите проверить правильность работы системы, оформите пробный заказ в управлении UMI.CMS. Для того, чтобы Ваши заказы отобразились в Класс365, в форме «Интеграция с интернет-магазином» нажмите «Загрузить сейчас».
#В главном меню выберите раздел «Продажи», в открывшемся подменю нажмите на «Заказы покупателей». Там будет сформирован заказ с соответствующим набором товаров и суммой, а во вкладке «Контрагенты» создан новый контрагент с данными Вашего покупателя.

== Вариант 4. В Класс365 есть товары, а в UMI.CMS нет товаров (учет в Класс365) ==

''Вы уже работаете в Класс365, и хотите подключить интернет-магазин UMI.CMS. Работа с товарами будет производиться в Класс365.''

Создайте магазин на сайте http://www.umi-cms.ru/

#Настройте интеграцию с интернет магазином в Класс365:
#*Над главным меню нажмите на кнопку «Администрирование» и выберите пункт «Интеграция с интернет-магазинами», нажмите «Добавить». В появившейся форме в строке «CMS сайта» выберете UMI.CMS и подставьте.
##''Адрес сайта'' - http://ваш_сайт/admin/exchange/auto/
##''Логин'' - имя пользователя (супервайзера) в UMI.CMS
##''Пароль'' - Ваш пароль пользователя (супервайзера) в UMI.CMS
#Проверьте подключение.
#Настройте параметры выгрузки товаров и загрузки заказов:
#*тип цен, организацию, группы товаров, статус, к какой организации привязывать заказ, учет НДС.
#Для того, что бы товары появились в UMI.CMS, нажмите кнопку «Выгрузить сейчас». На сайте появятся Ваши товары.
#Если Вы хотите проверить правильность работы системы, оформите пробный заказ в управлении UMI.CMS. Для того, чтобы Ваши заказы отобразились в Класс365, в форме «Интеграция с интернет-магазином» нажмите «Загрузить сейчас».
#В главном меню выберите раздел «Продажи» в открывшемся подменю нажмите на «Заказы покупателей». Там будет сформирован заказ с соответствующим набором товаров и суммой, а во вкладке «Контрагенты» создан новый контрагент с данными Вашего покупателя.

== Вариант 5. В Класс365 есть товары и в UMI.CMS есть товары (учет в Класс365) ==

''Вы уже работаете в Класс365 и у вас есть интернет-магазин UMI.CMS с товарами. Работа с товарами будет производиться в Класс365.''

#Настройте интеграцию с UMI.CMS:
#*Над главным меню нажмите на кнопку «Администрирование» и выберите пункт «Интеграция с интернет-магазинами», нажмите «Добавить», в появившейся форме в строке «CMS сайта» выберете UMI.CMS. и подставьте:
##''Адрес сайта'' - http://ваш_сайт/admin/exchange/auto/
##''Логин'' - имя пользователя (супервайзера) в UMI.CMS
##''Пароль'' - Ваш пароль пользователя (супервайзера) в UMI.CMS
#*Проверьте подключение.
#*Выгрузите товары, имеющиеся в системе, в интернет-магазин, для этого в форме «Интеграция с интернет-магазином» настройте параметры выгрузки (Группа товаров/все товары) и нажмите «Выгрузить сейчас».
#*Товары отобразятся на сайте.
#Перенесите базу товаров из UMI.CMS в Класс365, на сайте нажмите правой кнопкой мыши на категорию товаров и выберете «Экспорт списка в CSV».
#Сформируйте прайс-лист в формате .xls с параметрами:
##Артикул / код на складе
##наименование краткое
##наименование полное
##ставка НДС
##единица измерения
##цена
#*Обязательными полями являются артикул или код на складе, наименование, единица измерения. Все остальные параметры загружаются на ваше усмотрение, если их нет в документе, то вы сможете их добавить непосредственно в системе.
#Над главным меню нажмите на кнопку «Администрирование» и выберите пункт «Импорт и экспорт». Нажмите кнопку «Новый импорт товаров».
##Нажмите на кнопку «Выбрать файл» и выберите заранее подготовленный файл в формате .xls
##В окне появится информация, содержащаяся в файле
##Над каждой колонкой в выпадающем списке выберите соответствующее ей значение
##Нажмите кнопку «Загрузить товары».
##Товары загружены и находятся в справочнике «Товары», группа «Импортированные».
#*Так же с помощью импорта, выбрав в выпадающем списке «Цена продажа» вы сформируете продажный прайс-лист с указанными ценами в загружаемом файле.
#*Выбор колонок прайс листа:
#*[[Файл:Cms.jpg]]
#Введите остатки товаров по складам
#*Теперь в системе Класс365 и в UMI.CMS отображены все товары, которые вы реализуете.

== Для более полной передачи информации о заказе из интернет-магазина в Класс365 мы доработали шаблон UMI.CMS ==
Шаг 1. Скачайте файл по ссылке. [http://class365.ru/files/ordersCommerceML.xsl Скачать файл] 
Шаг 2. Замените стандартный шаблон ordersCommerceML.xsl в папке xsl/export на скачанный шаблон.

== Ссылки ==
* [http://class365.ru/help/faq-umi-cms Помощь по интеграции с интернет-магазином на платформе UMI.CMS]

Класс delivery модуля emarket

2018-07-16T13:01:54Z

Po4emu4ka:

=Класс delivery=

== Описание ==

Класс является абстрактным. Классами наследниками являются классы, представляющие типы доставки.
Исходный код класса находится в файле classes\modules\emarket\classes\delivery\delivery.php

== Методы ==

=== create() ===

Метод create() создает объект доставки нужного типа(класса).
Сначала создается экземпляр umiObject, затем на его основании создается экземпляр нужного класса(типа доставки) с помощью метода get()
'''Параметры:''' 
umiObject $deliveryTypeObject:
объект тип доставки
'''Результат:'''$object объект доставки нужного типа

=== get() ===

Метод get() получает объект доставки нужного типа(класса)
'''Параметры:''' 
iUmiObject $objectId:
идентификатор umiObject объекта доставки
'''Результат:'''$object объект доставки нужного типа 

=== getList() ===

Метод getList() получает список объектов способов доставки
'''Параметры:''' 
boolean $selfDeliveryOnly=false:
только самовывоз 

'''Результат:'''array результат выборки объектов способов доставки

=== validate()===

Метод validate() подтверждает заказ в качестве текущего.
Метод является абстрактным и определяется в дочерних классах
'''Параметры:''' 
order $order:
объект заказ 

=== getDeliveryPrice()===

Метод getDeliveryPrice() получает цену данного способа доставки
Метод является абстрактным и определяется в дочерних классах
'''Параметры:''' 
order $order:
объект заказ 

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Кастомизация макроса content redirect()

2018-07-16T12:59:45Z

Po4emu4ka:

== Задача ==

Предположим, имеется следующая структура каталога обусловленная шаблоном:
* Основная категория, в которой выводятся подкатегории товаров
*В каждой подкатегории выводятся дочерние подкатегории, либо только одна подкатегория, в которой находится один товар.
Редирект необходимо делать с тех категорий, выводимых в основной категории, в которых содержится только одна категория с одним товаром.Соответственно, редирект нужно сделать на этот конечный товар, минуя ту единственную категорию,в которой он содержится.

Через таблицу cms_redirects такой редирект работать не будет, так как страницы с которых идет перенаправление существуют и активны.
Если прописать для этих страниц стандартный макрос %content redirect()%, то переадресация произойдет прямо с основной страницы каталога, на которой данные категории выводятся.

== Решение ==
Необходимо кастомизировать %content redirect()% так, чтобы осуществлялась проверка на источник перехода, т.е. будем проверять равенство идентификатора текущей страницы идентификатору, переданному в качестве параметра $source
Если вызывать именно такой макрос на страницах выводимых в каталоге категорий, то переадресации с первой страницы каталога происходить не будет.

Открываем файл /classes/modules/content/_custom.php и вставляем туда следующий метод:

<source lang="php">
public function customRedirect($source= "",$url = "") {
$current_page_id = cmsController::getInstance()->getCurrentElementId();
if(is_numeric($url)&&is_numeric($source)&&$source==$current_page_id) {
$url = $this->get_page_url($url);
def_module::redirect($url);
}

}
</source>
[[category:Написание кастомных макросов]]

Кастомизация макроса %content redirect()%

2018-07-16T12:57:40Z

Po4emu4ka:

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

== Задача ==

Предположим,имеется следующая структура каталога:
1. Главная категория, в которой выводятся подкатегории
2. В каждой подкатегории выводится еще несколько подкатегорий, либо одна подкатегория, в которой находится только один товар.
Редирект на конечный товар необходимо сделать с тех страниц, в которых выводится одна подкатегория с одним товаром в ней. Собственно на этот товар и необходимо сделать переадресацию.
Через таблицу cms_redirects такой редирект работать не будет, так как страницы, с которых осуществляется переадресация существуют и активны.

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

Открываем файл /classes/modules/users/_custom.php и вставляем туда следующий метод:

<source lang="php">
public function selected_groups($template = 'default'){

$groups = new selector('objects');
$groups->types('object-type')->id('36');
$groups->where('for_registration')->equals('1');

list($itemsTemplate, $itemTemplate) = def_module::loadTemplates("users/{$template}", "items", "item");
$item = array();
$items = array();
foreach($groups as $group){
$item['attribute:id'] = $group->getId();
$item['attribute:name'] = $group->getValue('nazvanie');
$items[] = def_module::parseTemplate($itemTemplate, $item);
}
$items = array('subnodes:items' => $items);
return def_module::parseTemplate($itemsTemplate, $items);
}
</source>
[[category:Написание кастомных макросов]]

Как у заказа в интернет магазине (%emarket ordersList() %) вывести статус заказа (tpl)

2018-07-16T12:56:03Z

Po4emu4ka:

'''Задача:''' 
Вывести в личном кабинете пользователя список заказов со статусом или другим значением любого другого поля. 

'''Решение:''' 

Организовать такой функционал на tpl достаточно просто. Для этого необходимо лишь немного изменить один из блоков в шаблоне макроса % emarket ordersList()%. 
'''Пример:''' 

$FORMS['orders_item'] = <<<END
< li>% name% (% id%) % data getPropertyOfObject(% id%,status_id)%</li>
END;

О работе макроса %data getPropertyOfObject()% можно почитать здесь http://help-dev.umi-cms.ru/data.getPropertyOfObject.html
Аналогичным образом можно вывести любое значение не системного поля заказа.

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

Использование модуля GeoIP в PHP-шаблонизаторе

2018-07-16T12:55:03Z

Po4emu4ka:

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

== Общая информация ==
:Модуль [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]] возвращает данные об IP-адресе посетителя, такие, как страна, область, город, широта и долгота.

:Что бы воспользоваться данным функционалом необходимо проверить его наличие. Если, после авторизации на сайте под логином супервайзера, в модулях отсутствует иконка [[Изображение: geoip.png]] - это значит что данный модуль еще не установлен на Вашей системе.

После приобретения, для его установки, необходимо зайти в модуль “Конфигурация” > “Модули” > “Список модулей, доступных для установки” и установить данный модуль.

== XML ==
:Если открыть исходный XML страницы, можно увидеть узел, добавленный модулем [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]]:

<source lang="xml">
<geo>
<country>Россия</country>
<region>Санкт-Петербург</region>
<city>Санкт-Петербург</city>
<latitude>59.93863</latitude>
<longitude>30.31413</longitude>
</geo>
</source>

== Примеры использования ==
:Приведу простые для восприятия примеры использования [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]] и PHP

=== Вывод на странице страны, города, широты и долготы ===
:Если в начале страницы шаблона есть теги <?php ?>, то нижеследующий код необходимо добавить между данными тегами.
Если данных тегов нет, от необходимо добавить их в начале страницы. В итоге должно получиться примерно следующим образом

<?php
$country = $variables['user']['geo']['country']; // Страна
$region = $variables['user']['geo']['region']; // Регион
$city = $variables['user']['geo']['city']; // Город
$latitude = $variables['user']['geo']['latitude']; // Широта
$longitude = $variables['user']['geo']['longitude']; // Долгота
?>

затем добавим в файл шаблона вывод данных [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]]:

<<nowiki />ul>
<<nowiki />li><?= $country?></li>
<<nowiki />li><?= $region?></li>
<<nowiki />li><?= $city?></li>
<<nowiki />li><?= $latitude?></li>
<<nowiki />li><?= $longitude?></li>
</ul>

=== Вывод текста в зависимости от страны ===
:Выведем сообщение, если IP не российский
Нижеуказанный код необходимо добавить на Вашу страницу в том месте, где Вы хотите отображать сообщение:

<?php if($country == "Россия"): ?>
Приветствую вас на моём сайте!
<?php else: ?>
Sorry, available only from Russia
<?php endif ?>

=== [[http://ru.wikipedia.org/wiki/Google_Maps GoogleMaps]] ===
:Так же можно отобразить точку на карте [[http://ru.wikipedia.org/wiki/Google_Maps GoogleMaps]], используя широту и долготу.

==== Статическая карта ====
Необходимо в начале файла, где мы ранее добавляли переменные, указать еще одну переменную:

$googleMaps = "https://maps.googleapis.com/maps/api/staticmap?center={$latitude},{$longitude}&markers={$latitude},{$longitude}&zoom=9&size=400x400";

Затем, добавить в место, где Вы хотите видеть вывод карты код:

<img alt="GoogleMaps" src=<?= $googleMaps?> />

:Вот как будет выглядеть карта:

[[Изображение: 59.950_30.316.gif]]

[[category:Верстка в PHP]][[category:Модуль_GeoIP]]

Использование модуля GeoIP в PHP-шаблоне

2018-07-16T12:54:36Z

Po4emu4ka:

Дочерние классы класса discount модуля emarket

2018-07-16T12:53:44Z

Po4emu4ka:

=Дочерние классы класса discount=

== Описание ==

Стандартно у класса discount имеется три дочерних класса - orderDiscount,itemDiscount и bonusDiscount
Исходные коды классов находятся в директории classes\modules\emarket\classes\discounts\discounts в файлах orderDiscount.php, itemDiscount.php и bonusDiscount.php соответственно.
В каждом из этих классов определено всего два метода - это validate() и search()

:Класс orderDiscount предоставляет доступ к объектам- скидкам на заказ в интернет-магазине
:Класс itemDiscount предоставляет доступ к объектам- скидкам на товары в интернет-магазине
:Класс bonusDiscount предоставляет доступ к объектам- накопительным скидкам в интернет-магазине

== Методы ==

=== validate() ===

Метод validate():

*для класса orderDiscount проверяет применима ли скидка к заказу
*для класса itemDiscount проверяет подходит ли скидка для товара
*для класса bonusDiscount проверяет начислять ли бонусы при оплате заказа

'''Параметры:''' 

*для класса orderDiscount
order $order:
объект заказ 

*для класса itemDiscount
iUmiHierarchyElement $element:
товар в каталоге 

*для класса bonusDiscount
order $order:
объект заказ 

'''Результат:'''Boolean true|false

=== search()===

Метод search():

*для класса orderDiscount находит наиболее подходящую скидку для заказа
*для класса itemDiscount находит наиболее оптимальную скидку для товара
*для класса bonusDiscount находит наиболее подходящую скидку для заказа

*для класса orderDiscount
order $order:
объект заказ 

*для класса itemDiscount
iUmiHierarchyElement $element:
товар в каталоге 

*для класса bonusDiscount
order $order:
объект заказ 

'''Результат:'''

*для класса orderDiscount - orderDiscount самая подходящая скидка для заказа $order
*для класса itemDiscount - itemDiscount скидка на товар
*для класса bonusDiscount - bonusDiscount самая подходящая скидка для заказа $order

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Вывод похожих товаров с изображениями (XSLT)

2018-07-16T12:52:33Z

Po4emu4ka:

'''Задача:''' на сайте, требуется реализовать, чтобы при просмотре объекта каталога пользователь под описанием товара и его характеристик видел: "С этим товаром обычно покупают" и ссылка на аксессуар с его изображением, или "Похожий товар" и ссылка, и т.д.

'''Решение:''' В стандартном шаблоне demodizzy уже внедрено необходимое решение по выводу подобных ссылок ([[wiki.umisoft.ru/Пример_использования_поля_"ссылка_на_дерево"]]), но они выводятся без изображений товаров. Предлагаемое решение также подойдет и для сайтов из каталога готовых шаблонов.

Доработка стандартного шаблона будет заключаться в следующем:

1) Откроем файл /templates/demodizzy/xslt/modules/catalog/recommended.xsl и уберем из него следующую часть кода:
<source lang="xml">
<xsl:template match="property[@name = '&property-recommended;']">
<hr />
<h4>
<xsl:text>&recommended-items;:</xsl:text>
</h4>

<xsl:apply-templates select="value/page" mode="short-view">
<xsl:with-param name="cart_items" select="document('udata://emarket/cart/')/udata/items" />
</xsl:apply-templates>

<div class="clear"></div>
</xsl:template>
</source>

2)Вместо убранного кода, добавим наш:
<source lang="xml">
<xsl:template match="property[@name = '&property-recommended;']" mode="extra_goods">
<xsl:value-of select="title" />:
<div style="width:100%; overflow: hidden;padding: 2px 0;" ><xsl:apply-templates select="value/page" mode="extra_goods" /></div>
</xsl:template>

<xsl:template match="page" mode="extra_goods">
<div style="float: left; width:31%;text-align:center;border:1px #FE8D00 solid;margin: 0 5px;">
<a href="{@link}">
<xsl:apply-templates select="document(concat('upage://', @id,'.photo'))/udata" mode="extra_goods"/>
</a>
<xsl:value-of select="name" />
</div>
</xsl:template>

<xsl:template match="property" mode="extra_goods">
<xsl:apply-templates select="document(concat('udata://system/makeThumbnail/(',substring(value,2),')/(auto)/100'))/udata" />
</xsl:template>
</source>
В добавленном коде, мы получаем xml свойства &property-recommended; и обращаемся к каждому элементу <page> через темплейт match="page" mode="extra_goods", в котором мы выводим имя товара и ссылку на него, а также через протокол upage и id страницы получаем путь к изображению товара, который передаем в темплейт match="property" mode="extra_goods", где при помощи макроса system/makeThumbnail/ получаем миниатюру изображения с нужными нам размерами. Вывод информации оформлен при помощи встроенных в теги div стилевых правил, которые в реальном проекте лучше вынести в файл css.
Так как макрос makeThumbnail работает с путями к изображениям без предваряющего слеша /, а получаемый путь через upage этот слеш содержит, то чтобы его вырезать была применена строковая функция substring (), которая вернула путь начиная со 2-го символа, т.е. весь путь к изображению, но без первого слеша.

3) В файле /templates/demodizzy/xslt/modules/catalog/object-view.xsl необходимо найти темплейт <xsl:template match="/result[@module = 'catalog' and @method = 'object']"> и в нем для элемента apply-templates со свойством &property-recommended; добавить mode:
<source lang="xml">
<div>
<xsl:apply-templates select=".//property[@name = '&property-recommended;']" mode="extra_goods" />
</div>
</source>

В результате у нас получиться: 
[[Файл:31-08-2013.png]]

[[category:Верстка в XSLT]]

Как изменить сообщение об успешной отправке письма из формы обратной связи

2018-07-16T12:52:27Z

Po4emu4ka:

'''Где:''' модуль "Обратная связь", вкладка "Шаблоны писем". 
'''Задача:''' вывести свое сообщение после отправки формы.

'''Решение:'''
Для того, чтобы подхватывалось значение из поля "Сообщение об отправке",
необходимо в макрос webforms posted передавать id формы.

Т.е. в шаблоне макроса webforms add для xslt (/xsltTpls/modules/webforms/posted.xsl) должна быть подобная строчка:
<source lang="php">
<input type="hidden" name="ref_onsuccess" value="{$lang-prefix}/webforms/posted/{/udata/@form_id}/" />
</source>

Для tpl в шаблоне tpls/data/reflection/webforms.tpl должна быть такая строчка:
<source lang="php">
<input type="hidden" value="%pre_lang%/webforms/posted/%form_id%/" name="ref_onsuccess">
</source>

'''Примечание:''' Если Вы используете tpl-шаблоны и у Вас на сайте имеются шаблоны для xslt, то в приоритете будут шаблоны написанные на xslt. В этом случае, чтобы функционал работал по tpl-шаблону, необходимо переименовать соответствующий шаблон в папке xslt.

Автор: Отдел разработки
[[category:Верстка в XSLT]], [[category:Верстка в TPL]], [[category:Модуль Обратная связь]]

Как изменить сообщение об успешной отправке письма из формы обратной связи

2018-07-16T12:49:33Z

Po4emu4ka:

'''Где:''' модуль "Обратная связь", вкладка "Шаблоны писем". 
'''Задача:''' вывести свое сообщение после отправки формы.

'''Решение:'''
Для того, чтобы подхватывалось значение из поля "Сообщение об отправке",
необходимо в макрос webforms posted передавать id формы.

Т.е. в шаблоне макроса webforms add для xslt (/xsltTpls/modules/webforms/posted.xsl) должна быть подобная строчка:
<source lang="php">
<input type="hidden" name="ref_onsuccess" value="{$lang-prefix}/webforms/posted/{/udata/@form_id}/" />
</source>

Для tpl в шаблоне tpls/data/reflection/webforms.tpl должна быть такая строчка:
<source lang="php">
<input type="hidden" value="%pre_lang%/webforms/posted/%form_id%/" name="ref_onsuccess">
</source>

'''Примечание:''' Если Вы используете tpl-шаблоны и у Вас на сайте имеются шаблоны для xslt, то в приоритете будут шаблоны написанные на xslt. В этом случае, чтобы функционал работал по tpl-шаблону, необходимо переименовать соответствующий шаблон в папке xslt.

Автор: Отдел разработки
[[category:Верстка в XSLT]], [[Категория:Верстка в TPL]], [[Категория:Модуль Обратная связь]]

Дочерние классы класса delivery модуля emarket

2018-07-16T12:48:27Z

Po4emu4ka:

=Дочерние классы класса delivery=

== Описание ==

Стандартно у класса delivery имеется три дочерних класса - courierDelivery, russianpostDelivery, selfDelivery
Исходные коды классов находятся в директории classes\modules\emarket\classes\delivery\systems в файлах courier.php, russianpost.php и self.php соответственно.
В каждом из этих классов определено всего два метода - это validate() и getDeliveryPrice(), которые объявлены в качестве абстрактных в родительском классе delivery

== Методы ==

=== validate()===

Метод validate() подтверждает заказ в качестве текущего.
'''Параметры:''' 
order $order:
объект заказ 
'''Результат:'''true

=== getDeliveryPrice()===

Метод getDeliveryPrice() получает цену данного способа доставки
'''Параметры:''' 
order $order:
объект заказ 
'''Результат:'''0 - всегда для класса selfDelivery int $deliveryPrice - для класса courierDelivery string $flag = " {$price} руб. (займет от {$min} до {$max} дней)"

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[category:Модуль Интернет магазин]]

Дочерние классы класса discount модуля emarket

2018-06-09T14:20:39Z

Po4emu4ka:

=Дочерние классы класса discount=

== Описание ==

Стандартно у класса discount имеется три дочерних класса - orderDiscount,itemDiscount и bonusDiscount
Исходные коды классов находятся в директории classes\modules\emarket\classes\discounts\discounts в файлах orderDiscount.php, itemDiscount.php и bonusDiscount.php соответственно.
В каждом из этих классов определено всего два метода - это validate() и search()

:Класс orderDiscount предоставляет доступ к объектам- скидкам на заказ в интернет-магазине
:Класс itemDiscount предоставляет доступ к объектам- скидкам на товары в интернет-магазине
:Класс bonusDiscount предоставляет доступ к объектам- накопительным скидкам в интернет-магазине

== Методы ==

=== validate() ===

Метод validate():

*для класса orderDiscount проверяет применима ли скидка к заказу
*для класса itemDiscount проверяет подходит ли скидка для товара
*для класса bonusDiscount проверяет начислять ли бонусы при оплате заказа

'''Параметры:''' 

*для класса orderDiscount
order $order:
объект заказ 

*для класса itemDiscount
iUmiHierarchyElement $element:
товар в каталоге 

*для класса bonusDiscount
order $order:
объект заказ 

'''Результат:'''Boolean true|false

=== search()===

Метод search():

*для класса orderDiscount находит наиболее подходящую скидку для заказа
*для класса itemDiscount находит наиболее оптимальную скидку для товара
*для класса bonusDiscount находит наиболее подходящую скидку для заказа

*для класса orderDiscount
order $order:
объект заказ 

*для класса itemDiscount
iUmiHierarchyElement $element:
товар в каталоге 

*для класса bonusDiscount
order $order:
объект заказ 

'''Результат:'''

*для класса orderDiscount - orderDiscount самая подходящая скидка для заказа $order
*для класса itemDiscount - itemDiscount скидка на товар
*для класса bonusDiscount - bonusDiscount самая подходящая скидка для заказа $order

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Дочерние классы класса delivery модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[Категория:Модуль Интернет магазин]]

Дочерние классы класса delivery модуля emarket

2018-06-09T14:13:26Z

Po4emu4ka:

=Дочерние классы класса delivery=

== Описание ==

Стандартно у класса delivery имеется три дочерних класса - courierDelivery, russianpostDelivery, selfDelivery
Исходные коды классов находятся в директории classes\modules\emarket\classes\delivery\systems в файлах courier.php, russianpost.php и self.php соответственно.
В каждом из этих классов определено всего два метода - это validate() и getDeliveryPrice(), которые объявлены в качестве абстрактных в родительском классе delivery

== Методы ==

=== validate()===

Метод validate() подтверждает заказ в качестве текущего.
'''Параметры:''' 
order $order:
объект заказ 
'''Результат:'''true

=== getDeliveryPrice()===

Метод getDeliveryPrice() получает цену данного способа доставки
'''Параметры:''' 
order $order:
объект заказ 
'''Результат:'''0 - всегда для класса selfDelivery int $deliveryPrice - для класса courierDelivery string $flag = " {$price} руб. (займет от {$min} до {$max} дней)"

== Дополнительно ==

Другие статьи по классам emarket:

<ul>
<li>[[Класс customer модуля emarket]]</li>
<li>[[Класс order модуля emarket]]</li>
<li>[[Класс orderItem модуля emarket]]</li>
<li>[[Класс optionedOrderItem модуля emarket]]</li>
<li>[[Класс delivery модуля emarket]]</li>
<li>[[Класс discount модуля emarket]]</li>
<li>[[Класс discountModificator и его дочерние классы (модуль emarket) ]]</li>
<li>[[Дочерние классы класса discount модуля emarket]]</li>
<li>[[Класс discountRule и его дочерние классы (модуль emarket) ]]</li>
<li>[[Класс payment модуля emarket ]]</li>
<li>[[Класс emarketTop модуля emarket ]]</li>
<li>[[Класс currencyUpdater модуля emarket ]]</li>
</ul>
[[Категория:Модуль Интернет магазин]]

Выборка с одновременным выполнением двух условий ИЛИ

2018-06-09T14:11:51Z

Po4emu4ka:

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

== Задача ==

Предположим у товаров по группам заданы некие поля и необходимо выбрать те товары, у которых в одной группе полей либо одно поле равно указанному значению, либо другое, при этом, одновременно должно выполняться условие, что в другой группе полей одно или второе поле равно заданному значению, т.е. получится условие вида (А или В) и (С или D). Одним запросом при помощи selector, используя два раза режим or-mode такую выборку сделать не получится, так как между двумя условиями "ИЛИ" система поставит еще одно.

== Решение ==
Реализовать такую выборку в UMI.CMS можно сделав два запроса к базе и получить "пересечение" их результатов, т.е. id товаров, а затем отобрать в результирующем запросе товары с данными id:

<source lang="php">

$pages = new selector('pages');
$pages->types('object-type')->id('идентификатор нужного типа данных');

$pages->option('or-mode')->fields('поле_первой_группы1','поле_первой_группы2');

$pages->where('поле_первой_группы1')->equals('значение');

$pages->where('поле_первой_группы2')->equals('значение');

foreach($pages as $page){

$mass[]=$page->id;

}

$pages1 = new selector('pages');
$pages1->types('object-type')->id('идентификатор нужного типа данных');

$pages1->option('or-mode')->fields('поле_второй_группы1','поле_второй_группы2');

$pages1->where('поле_второй_группы1')->equals('значение');

$pages1->where('поле_второй_группы2')->equals('значение');

foreach($pages1 as $page1){

$mass2[]=$page1->id;
}

$diff = array_intersect($mass,$mass2);

$final = new selector('pages');
$final->types('object-type')->id('идентификатор нужного типа данных');
$final->where('id')->equals($diff);

foreach($final as $object){

echo "<a href=\"{$object->link}\">{$object->name}</a>\n";
}
echo "Pages found: {$final->length}";

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

Lang.php

2018-06-09T14:08:13Z

Po4emu4ka:

В этом файле хранятся все [[языковые константы]].

Обратите внимание, что в зависимости от текущего языка, может подключаться дополнительный файл. Например, если мы находися в английской версии и префикс у этого языка "en", то при наличи файла lang.en.php в папке модуля будет использоваться именно он.

В этом файле должно быть как минимум следующее содержание:

<source lang="php">
<?php
$C_LANG = Array();
$C_LANG['module_name'] = "Мой модуль";
$LANG_EXPORT = Array();
?>
</source>

Тут есть 2 массива: $C_LANG и $LANG_EXPORT.

Массив $C_LANG устанавливает заголовки по умолчанию для методов нашего модуля. Ключ массива всегда соответствует названию метода. Обратите внимение, что ключ "module_name" в массиве $C_LANG зарезервирован - это название модуля.

Массив $LANG_EXPORT содержит языковые константы, которые может использовать модуль. Каждый ключ этого массива можно использовать как макрос, если заключить его в знаки "%".
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Lang.php

2018-06-09T14:07:48Z

Po4emu4ka:

Файл lang.php

В этом файле хранятся все [[языковые константы]].

Обратите внимание, что в зависимости от текущего языка, может подключаться дополнительный файл. Например, если мы находися в английской версии и префикс у этого языка "en", то при наличи файла lang.en.php в папке модуля будет использоваться именно он.

В этом файле должно быть как минимум следующее содержание:

<source lang="php">
<?php
$C_LANG = Array();
$C_LANG['module_name'] = "Мой модуль";
$LANG_EXPORT = Array();
?>
</source>

Тут есть 2 массива: $C_LANG и $LANG_EXPORT.

Массив $C_LANG устанавливает заголовки по умолчанию для методов нашего модуля. Ключ массива всегда соответствует названию метода. Обратите внимение, что ключ "module_name" в массиве $C_LANG зарезервирован - это название модуля.

Массив $LANG_EXPORT содержит языковые константы, которые может использовать модуль. Каждый ключ этого массива можно использовать как макрос, если заключить его в знаки "%".
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Как изменить сообщение об успешной отправке письма из формы обратной связи

2018-06-09T14:01:29Z

Po4emu4ka:

'''Где:''' модуль "Обратная связь", вкладка "Шаблоны писем". 
'''Задача:''' вывести свое сообщение после отправки формы.

'''Решение:'''
Для того, чтобы подхватывалось значение из поля "Сообщение об отправке",
необходимо в макрос webforms posted передавать id формы.

Т.е. в шаблоне макроса webforms add для xslt (/xsltTpls/modules/webforms/posted.xsl) должна быть подобная строчка:
<source lang="php">
<input type="hidden" name="ref_onsuccess" value="{$lang-prefix}/webforms/posted/{/udata/@form_id}/" />
</source>

Для tpl в шаблоне tpls/data/reflection/webforms.tpl должна быть такая строчка:
<source lang="php">
<input type="hidden" value="%pre_lang%/webforms/posted/%form_id%/" name="ref_onsuccess">
</source>

'''Примечание:''' Если Вы используете tpl-шаблоны и у Вас на сайте имеются шаблоны для xslt, то в приоритете будут шаблоны написанные на xslt. В этом случае, чтобы функционал работал по tpl-шаблону, необходимо переименовать соответствующий шаблон в папке xslt.

Автор: Отдел разработки
[[Категория:Верстка в XSLT]], [[Категория:Верстка в TPL]], [[Категория:Модуль Обратная связь]]

Как закрыть один из доменов системы для внешних пользователей

2018-06-07T09:45:40Z

Po4emu4ka:

'''Актуально для версии 2.9'''
 
Сделать это можно через файл .htaccess, прописав в нем, например, следующее:
<source lang="html4strict">
RewriteEngine On
RewriteCond %{REMOTE_ADDR} !192.168.7.185
RewriteCond %{HTTP_HOST} www.domen.ru [NC]
RewriteRule (.+) http://domen_dlya_perenapravleniya.ru [L]
</source>
Пояснения: во второй строке указан ip, для которого нижеследуещее правило применяться не будет. В третьей - указываем домен, который хотим скрыть. В четвертой можно укакзать домен, на который мы будем перенаправлять пользователей, пытающихся открыть наш домен.

Если же у нас мультисайтовая система и нам нужно закрыть доступ только к определенным сайтам, то мы можем наоборот сначала всем запретить доступ, а затем указать те домены и IP-адреса с которых мы разрешаем открывать наши сайты:
<source lang="html4strict">
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteBase /

RewriteCond %{HTTP_HOST} !^site1.ru
RewriteCond %{REMOTE_ADDR} !8.8.8.4

RewriteRule ^.*$ - [F,L]
</IfModule>
</source>
Пояснения: дописываем указанную конструкцию в конец файла .htaccess. 
Строкой: RewriteCond %{HTTP_HOST} !^ - '''разрешаем''' доступ с указанного домена, 
Строкой: RewriteCond %{REMOTE_ADDR} ! - '''разрешаем''' доступ с указанного IP-адреса.

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

[[Категория:.htaccess]]

Скрыть страницы авторизации

2018-06-07T09:35:37Z

Po4emu4ka:

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

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

<source lang="apache">
RewriteEngine On
RewriteRule ^users/ /index.php [L,R]
</source>

В таком случае будет происходить перенаправление на главную страницу. 
Но если изменить [L,R] на [R], то адрес будет доступен только со статусом 404 Not Found.

Обратите внимание, что ваши кастомные инструкции не следует вносить в блок, обрамленный строками UMI_CMS_HTACCESS_BEGIN и UMI_CMS_HTACCESS_END, поскольку при обновлении системы он будет полностью заменён на новый.
[[category:.htaccess]]

Корректное перенаправление

2018-06-07T09:29:36Z

Po4emu4ka:

=Задача=

Сделать перенаправление с несуществующих страниц на корректные посредством '''.htaccess''''a

=Решение=

Для корректного перенаправления с несуществующей страницы, например, '''news''' на существующую страницу, например '''vse_novosti''' достаточно добавить в файл '''.htaccess''' строку вида

<source lang='apache'>
RewriteRule ^news /vse_novosti [R=301,L]
</source>

Обратите внимание, что ваши кастомные инструкции не следует вносить в блок, обрамленный строками UMI_CMS_HTACCESS_BEGIN и UMI_CMS_HTACCESS_END, поскольку при обновлении системы он будет полностью заменён на новый.
[[Категория:.htaccess]]

Установка кодировки в .htaccess

2018-06-07T09:27:53Z

Po4emu4ka:

Если браузер неправильно определяет кодировку - добавьте в '''.htaccess''' один из следующих вариантов:
<source lang="html4strict">
AddDefaultCharset utf-8
</source>
<source lang="html4strict">
AddCharset utf-8 *
</source>
<source lang="html4strict">
<IfModule mod_charset.c>
CharsetSourceEnc utf-8
CharsetDefault utf-8
</IfModule>
</source>

Обратите внимание, что ваши кастомные инструкции не следует вносить в блок, обрамленный строками UMI_CMS_HTACCESS_BEGIN и UMI_CMS_HTACCESS_END, поскольку при обновлении системы он будет полностью заменён на новый.
[[category:.htaccess]]

Создание поддомена через .htaccess

2018-06-07T09:25:41Z

Po4emu4ka:

[[Категория: .htaccess]]
'''Актуально для версии 2.9.6''' 
'''Задача:''' Необходимо создать поддомен (не управляемый системой, например, для простого html-сайта) при помощи '''.htaccess''', без создания дополнительного сайта в контрольной панели управления хостингом. 
'''Реализация:'''

=== Имеем: ===
# Сайт '''site.ru''' на '''UMI.CMS'''
# В корневой папке '''site.ru''' создана папка '''/sub/''' для поддомена
# Поддомен '''sub.site.ru''', предназначенный для html-сайта
== Решение: ==

После строки '''RewriteEngine On''' добавим в файл '''.htaccess''', который находится в корневой директории системы, следующий код:

<source lang="apache">
RewriteCond %{HTTP_HOST} ^sub\.site\.ru$
RewriteCond %{REQUEST_URI} !/sub/
RewriteRule ^(.*)$ /sub/$1 [L]
</source>

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

А также, создадим файл '''.htaccess''' в директории '''/sub''' и добавим в него следующую строку:
<source lang="apache">
RewriteEngine On
</source>

World wide web (настройка редиректа между зеркалами с www и без в файле .htaccess)

2018-06-07T09:15:28Z

Po4emu4ka:

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

Часто, для SEO продвижения или ещё каких либо целей требуется, чтобы сайт всегда открывался только с www.domain.ru или наоборот, без 'www', т.е. domain.ru

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

Правило следует писать самым первым, перед блоком, обрамленным строками UMI_CMS_HTACCESS_BEGIN и UMI_CMS_HTACCESS_END. Обратите внимание, что ваши кастомные инструкции не следует вносить в этот блок, поскольку при обновлении системы он будет полностью заменён на новый.

Кириллические домены нужно конвертировать в punycode: https://www.punycoder.com/

<h2>Для основного домена без www</h2>

<source lang="apache">
#Включаем работу механизма преобразований.
RewriteEngine On
#Проверяем, что текущий хост выглядит как http://www.domain.ru
#Флаг NC (No Case), позволяет игнорировать регистр при проверке
RewriteCond %{HTTP_HOST} ^www.domain.ru$ [NC]
#Перенаправляем запрос на хост без www, 301 редирект
#Флаг L запрещает дальнейшую обработку правил в этом запросе
RewriteRule ^(.*)$ http://domain.ru/$1 [R=301,L]
</source>

<h2>Для основного домена с www</h2>

<source lang="apache">
#Включаем работу механизма преобразований.
RewriteEngine On
#Проверяем, что текущий хост выглядит как http://domain.ru
#Флаг NC (No Case), позволяет игнорировать регистр при проверке
RewriteCond %{HTTP_HOST} ^domain.ru$ [NC]
#Перенаправляем запрос на хост c www, 301 редирект
#Флаг L запрещает дальнейшую обработку правил в этом запросе
RewriteRule ^(.*)$ http://www.domain.ru/$1 [R=301,L]
</source>

[[category:.htaccess]]

Расположение шаблонов писем-уведомлений

2018-06-06T14:10:41Z

Po4emu4ka:

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

- если система работает на новой реализации модулей и в настройках модуля включена опция "Использовать модуль "Шаблоны уведомлений" для отправки писем" (такая настройка есть, например, в настройках модуля Рассылки, Интернет-магазин, Пользователи и т.д.), то шаблоны можно отредактировать на странице модуля Шаблоны уведомлений (ссылка вида '''<имя сайта>/admin/umiNotifications/notifications/''')

- если такая настройка не выбрана, и система использует новый формат хранения шаблонов[http://dev.docs.umi-cms.ru/shablony_i_makrosy/novyj_format_hraneniya_shablonov/], то сначала поиск шаблона для отправляемого письма происходит в директории '''~/templates/{имя_шаблона}/xslt/mail/''', а затем, если подходящего шаблона не обнаружено, - в директории '''~/templates/{имя_шаблона}/tpls/'''

- если система использует старый формат хранения шаблонов, то сначала поиск происходит в папке '''~/xsltTpls/mail/''', а затем в '''~/tpls/'''

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

На примере демо-сайта demodizzy местоположение формирования и шаблонов может быть таким:

{| border=1
!Название
!Модуль
!Местоположение формирования
!Шаблон
!Местоположение шаблона
|-
|Уведомление об изменении заявки пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:158
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:105
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке администратору
|Онлайн-запись
|/classes/components/appointment/notifier.php:54
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о приближении окончания показа баннеров
|Баннеры
|/classes/components/banners/macros.php:562
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/banner_notification.xsl
|-
|Уведомлениние о комментарии к посту
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомлениние о комментарии к комментарию
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомление о приближении даты потери актуальности
|Структура
|/classes/components/content/handlers.php:180
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/notify.xsl
|-
|Уведомление о снятии страницы с публикации
|Структура
|/classes/components/content/handlers.php:261
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/expired.xsl
|-
|Рассылка по нескольким подписчикам
|Рассылки
|/classes/components/dispatches/admin.php:396
|Управляется через файл шаблона + админ панель
|/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Рассылка по всем подписчикам
|Рассылки
|/classes/components/dispatches/class.php:392
|Управляется через файл шаблона + админ панель
|/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Уведомление о подписке на рассылку
|Рассылки
|/classes/components/dispatches/macros.php:403
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/dispatches/default.xsl
|-
|Уведомление покупателю об изменении заказа
|Интернет-Магазин
|/classes/components/emarket/notification.php:222
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление менеджеру о новом заказе
|Интернет-Магазин
|/classes/components/emarket/notification.php:279
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Письмо со счетом для оплаты заказа
|Интернет-Магазин
|/classes/components/emarket/classes/payment/systems/invoice.php:212
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление об ответе на вопрос
|FAQ
|/classes/components/faq/class.php:119
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса клиенту
|FAQ
|/classes/components/faq/macros.php:448
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса администратору
|FAQ
|/classes/components/faq/macros.php:432
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о создании нового сообщения форума подписчикам
|Форум
|/classes/components/forum/handlers.php:139
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/forum/default.xsl
|-
|Уведомление о регистрации нового пользователя администратору
|Пользователи
|/classes/components/users/handlers.php:235
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с кодом активации для восстановления пароля
|Пользователи
|/classes/components/users/macros.php:730
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Уведомление об успешной регистрации пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Уведомление с просьбой пройти активацию пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с новым паролем пользователя
|Пользователи
|/classes/components/users/macros.php:849
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Автоответ на письмо
|Конструктор форм
|/classes/components/webforms/macros.php:93
|Управляется через админ. панель
|в модуле "Конструктор форм" => "Шаблоны писем"
|-
|Письмо пользователя
|Конструктор форм
|/classes/components/webforms/macros.php:41
|Управляется через админ. панель
|в модуле "Конструктор форм" => "Шаблоны писем"
|}

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

Расположение шаблонов писем-уведомлений

2018-06-06T14:10:14Z

Po4emu4ka:

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

- если система работает на новой реализации модулей и в настройках модуля включена опция "Использовать модуль "Шаблоны уведомлений" для отправки писем" (такая настройка есть, например, в настройках модуля Рассылки, Интернет-магазин, Пользователи и т.д.), то шаблоны можно отредактировать на странице модуля Шаблоны уведомлений (ссылка вида '''<имя сайта>/admin/umiNotifications/notifications/''')

- если такая настройка не выбрана, и система использует новый формат хранения шаблонов[http://dev.docs.umi-cms.ru/shablony_i_makrosy/novyj_format_hraneniya_shablonov/], то сначала поиск шаблона для отправляемого письма происходит в директории '''~/templates/{имя_шаблона}/xslt/mail/''', а затем, если подходящего шаблона не обнаружено, - в директории '''~/templates/{имя_шаблона}/tpls/'''

- если система использует старый формат хранения шаблонов, то сначала поиск происходит в папке '''~/xsltTpls/mail/''', а затем в '''~/tpls/'''

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

На примере демо-сайта demodizzy местоположение формирования и шаблонов может быть таким:

{| border=1
!Название
!Модуль
!Местоположение формирования
!Шаблон
!Местоположение шаблона
|-
|Уведомление об изменении заявки пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:158
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:105
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке администратору
|Онлайн-запись
|/classes/components/appointment/notifier.php:54
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о приближении окончания показа баннеров
|Баннеры
|/classes/components/banners/macros.php:562
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/banner_notification.xsl
|-
|Уведомлениние о комментарии к посту
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомлениние о комментарии к комментарию
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомление о приближении даты потери актуальности
|Структура
|/classes/components/content/handlers.php:180
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/notify.xsl
|-
|Уведомление о снятии страницы с публикации
|Структура
|/classes/components/content/handlers.php:261
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/expired.xsl
|-
|Рассылка по нескольким подписчикам
|Рассылки
|/classes/components/dispatches/admin.php:396
|Управляется через файл шаблона + админ панель
|/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Рассылка по всем подписчикам
|Рассылки
|/classes/components/dispatches/class.php:392
|Управляется через файл шаблона + админ панель
|/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Уведомление о подписке на рассылку
|Рассылки
|/classes/components/dispatches/macros.php:403
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/dispatches/default.xsl
|-
|Уведомление покупателю об изменении заказа
|Интернет-Магазин
|/classes/components/emarket/notification.php:222
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление менеджеру о новом заказе
|Интернет-Магазин
|/classes/components/emarket/notification.php:279
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Письмо со счетом для оплаты заказа
|Интернет-Магазин
|/classes/components/emarket/classes/payment/systems/invoice.php:212
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление об ответе на вопрос
|FAQ
|/classes/components/faq/class.php:119
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса клиенту
|FAQ
|/classes/components/faq/macros.php:448
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса администратору
|FAQ
|/classes/components/faq/macros.php:432
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о создании нового сообщения форума подписчикам
|Форум
|/classes/components/forum/handlers.php:139
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/forum/default.xsl
|-
|Уведомление о регистрации нового пользователя администратору
|Пользователи
|/classes/components/users/handlers.php:235
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с кодом активации для восстановления пароля
|Пользователи
|/classes/components/users/macros.php:730
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Уведомление об успешной регистрации пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Уведомление с просьбой пройти активацию пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с новым паролем пользователя
|Пользователи
|/classes/components/users/macros.php:849
|Управляется через файл шаблона
|/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Автоответ на письмо
|Конструктор форм
|/classes/components/webforms/macros.php:93
|Управляется через админ. панель
|в модуле "Констhуктор форм" => "Шаблоны писем"
|-
|Письмо пользователя
|Конструктор форм
|/classes/components/webforms/macros.php:41
|Управляется через админ. панель
|в модуле "Констhуктор форм" => "Шаблоны писем"
|}

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

Расположение шаблонов писем-уведомлений

2018-06-06T14:01:38Z

Po4emu4ka:

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

- если система работает на новой реализации модулей и в настройках модуля включена опция "Использовать модуль "Шаблоны уведомлений" для отправки писем" (такая настройка есть, например, в настройках модуля Рассылки, Интернет-магазин, Пользователи и т.д.), то шаблоны можно отредактировать на странице модуля Шаблоны уведомлений (ссылка вида '''<имя сайта>/admin/umiNotifications/notifications/''')

- если такая настройка не выбрана, и система использует новый формат хранения шаблонов[http://dev.docs.umi-cms.ru/shablony_i_makrosy/novyj_format_hraneniya_shablonov/], то сначала поиск шаблона для отправляемого письма происходит в директории '''~/templates/{имя_шаблона}/xslt/mail/''', а затем, если подходящего шаблона не обнаружено, - в директории '''~/templates/{имя_шаблона}/tpls/'''

- если система использует старый формат хранения шаблонов, то сначала поиск происходит в папке '''~/xsltTpls/mail/''', а затем в '''~/tpls/'''

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

На примере демо-сайта demodizzy местоположение формирования и шаблонов может быть таким:

{| border=1
!Название
!Модуль
!Местоположение формирования
!Шаблон
!Местоположение шаблона
|-
|Уведомление об изменении заявки пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:158
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:105
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке администратору
|Онлайн-запись
|/classes/components/appointment/notifier.php:54
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о приближении окончания показа баннеров
|Баннеры
|/classes/components/banners/macros.php:562
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/banner_notification.xsl
|-
|Уведомлениние о комментарии к посту
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомлениние о комментарии к комментарию
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомление о приближении даты потери актуальности
|Структура
|/classes/components/content/handlers.php:180
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/notify.xsl
|-
|Уведомление о снятии страницы с публикации
|Структура
|/classes/components/content/handlers.php:261
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/expired.xsl
|-
|Рассылка по нескольким подписчикам
|Рассылки
|/classes/components/dispatches/admin.php:396
|Управляется через файл шаблона + админ панель
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Рассылка по всем подписчикам
|Рассылки
|/classes/components/dispatches/class.php:392
|Управляется через файл шаблона + админ панель
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Уведомление о подписке на рассылку
|Рассылки
|/classes/components/dispatches/macros.php:403
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/dispatches/default.xsl
|-
|Уведомление покупателю об изменении заказа
|Интернет-Магазин
|/classes/components/emarket/notification.php:222
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление менеджеру о новом заказе
|Интернет-Магазин
|/classes/components/emarket/notification.php:279
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Письмо со счетом для оплаты заказа
|Интернет-Магазин
|/classes/components/emarket/classes/payment/systems/invoice.php:212
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление об ответе на вопрос
|FAQ
|/classes/components/faq/class.php:119
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса клиенту
|FAQ
|/classes/components/faq/macros.php:448
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса администратору
|FAQ
|/classes/components/faq/macros.php:432
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о создании нового сообщения форума подписчикам
|Форум
|/classes/components/forum/handlers.php:139
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/forum/default.xsl
|-
|Уведомление о регистрации нового пользователя администратору
|Пользователи
|/classes/components/users/handlers.php:235
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с кодом активации для восстановления пароля
|Пользователи
|/classes/components/users/macros.php:730
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Уведомление об успешной регистрации пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Уведомление с просьбой пройти активацию пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с новым паролем пользователя
|Пользователи
|/classes/components/users/macros.php:849
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Автоответ на письмо
|Конструктор форм
|/classes/components/webforms/macros.php:93
|Управляется через админ. панель
|в модуле "Констhуктор форм" => "Шаблоны писем"
|-
|Письмо пользователя
|Конструктор форм
|/classes/components/webforms/macros.php:41
|Управляется через админ. панель
|в модуле "Констhуктор форм" => "Шаблоны писем"
|}

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

Расположение шаблонов писем-уведомлений

2018-06-06T13:51:10Z

Po4emu4ka:

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

- если система работает на новой реализации модулей и в настройках модуля включена опция "Использовать модуль "Шаблоны уведомлений" для отправки писем" (такая настройка есть, например, в настройках модуля Рассылки, Интернет-магазин, Пользователи и т.д.), то шаблоны можно отредактировать на странице модуля Шаблоны уведомлений (ссылка вида '''<имя сайта>/admin/umiNotifications/notifications/''')

- если такая настройка не выбрана, и система использует новый формат хранения шаблонов[http://dev.docs.umi-cms.ru/shablony_i_makrosy/novyj_format_hraneniya_shablonov/], то сначала поиск шаблона для отправляемого письма происходит в директории '''~/templates/{имя_шаблона}/xslt/mail/''', а затем, если подходящего шаблона не обнаружено, - в директории '''~/templates/{имя_шаблона}/tpls/'''

- если система использует старый формат хранения шаблонов, то сначала поиск происходит в папке '''~/xsltTpls/mail/''', а затем в '''~/tpls/'''

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

На примере демо-сайта demodizzy местоположение формирования и шаблонов может быть таким (в случае если не используется функционал модуля Шаблоны уведомлений):

{| border=1
!Название
!Модуль
!Местоположение формирования
!Шаблон
!Местоположение шаблона
|-
|Уведомление об изменении заявки пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:158
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке пользователю
|Онлайн-запись
|/classes/components/appointment/notifier.php:105
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о новой заявке администратору
|Онлайн-запись
|/classes/components/appointment/notifier.php:54
|Управляется через админ. панель
|в cms3_mail_templates
|-
|Уведомление о приближении окончания показа баннеров
|Баннеры
|/classes/components/banners/macros.php:562
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/banner_notification.xsl
|-
|Уведомлениние о комментарии к посту
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомлениние о комментарии к комментарию
|Блоги
|/classes/components/blogs20/handlers.php:94
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/blogs20/default.xsl
|-
|Уведомление о приближении даты потери актуальности
|Структура
|/classes/components/content/handlers.php:180
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/notify.xsl
|-
|Уведомление о снятии страницы с публикации
|Структура
|/classes/components/content/handlers.php:261
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/expired.xsl
|-
|Рассылка по нескольким подписчикам
|Рассылки
|/classes/components/dispatches/admin.php:396
|Управляется через файл шаблона + админ панель
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Рассылка по всем подписчикам
|Рассылки
|/classes/components/dispatches/class.php:392
|Управляется через файл шаблона + админ панель
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/dispatches/release.xsl + поле каждого сообщения в модуле "Рассылки"
|-
|Уведомление о подписке на рассылку
|Рассылки
|/classes/components/dispatches/macros.php:403
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/dispatches/default.xsl
|-
|Уведомление покупателю об изменении заказа
|Интернет-Магазин
|/classes/components/emarket/notification.php:222
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление менеджеру о новом заказе
|Интернет-Магазин
|/classes/components/emarket/notification.php:279
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Письмо со счетом для оплаты заказа
|Интернет-Магазин
|/classes/components/emarket/classes/payment/systems/invoice.php:212
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/emarket/default.xsl
|-
|Уведомление об ответе на вопрос
|FAQ
|/classes/components/faq/class.php:119
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса клиенту
|FAQ
|/classes/components/faq/macros.php:448
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о получении вопроса администратору
|FAQ
|/classes/components/faq/macros.php:432
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/faq/default.xsl
|-
|Уведомление о создании нового сообщения форума подписчикам
|Форум
|/classes/components/forum/handlers.php:139
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/forum/default.xsl
|-
|Уведомление о регистрации нового пользователя администратору
|Пользователи
|/classes/components/users/handlers.php:235
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с кодом активации для восстановления пароля
|Пользователи
|/classes/components/users/macros.php:730
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Уведомление об успешной регистрации пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Уведомление с просьбой пройти активацию пользователю
|Пользователи
|/classes/components/users/macros.php:607
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/register/default.xsl
|-
|Письмо с новым паролем пользователя
|Пользователи
|/classes/components/users/macros.php:849
|Управляется через файл шаблона
|/sites/demodizzy/src/files/templates/demodizzy/xslt/mail/users/forget/default.xsl
|-
|Автоответ на письмо
|Конструктор форм
|/classes/components/webforms/macros.php:93
|Управляется через админ. панель
|в модуле "Констhуктор форм" => "Шаблоны писем"
|-
|Письмо пользователя
|Конструктор форм
|/classes/components/webforms/macros.php:41
|Управляется через админ. панель
|в модуле "Констhуктор форм" => "Шаблоны писем"
|}

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

Расположение шаблонов писем-уведомлений

2018-06-06T12:46:46Z

Po4emu4ka: Новая страница: «Система имеет в наличии готовые шаблоны для отправки писем-уведомлений (о регистрации нов…»

Активация нового пользователя только модератором

2018-06-06T12:06:03Z

Po4emu4ka:

Стандартным функционалом системы предполагается два варианта регистрации: с автоматической активацией и с активацией переходом по ссылке в присылаемом пользователю письме. А как сделать так, чтобы новый пользователь не мог активироваться по ссылке, а активацию производил модератор сайта? Для этого достаточно удалить из шаблона письма ссылку, перейдя по которой активируется новый пользователь. По умолчанию шаблон письма ищется в файле xsltTpls/mail/users/register/default.xsl. Если по выше указанному пути шаблон не найден, система обратится к адресу tpls/users/register/default.tpl. В шаблоне находим строку:

в xslt:
<pre>
<xsl:text>Чтобы активировать Ваш аккаунт, необходимо перейти по ссылке, либо скопировать ее в адресную строку браузера:</xsl:text> 
<a href="{activate_link}">
<xsl:value-of select="activate_link" />
</a>
</pre>

в tpls:
<pre>
Чтобы активировать Ваш аккаунт, необходимо перейти по ссылке, либо скопировать ее в адресную строку браузера: 
<a href="%activate_link%">%activate_link%</a>
</pre>
и меняем ее примерно на следующую:
<pre>
Ваша учетная запись будет активирована после рассмотрения модератором сайта.
</pre>
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Визуальный редактор: Пользовательская настройка

2018-05-31T12:25:39Z

Po4emu4ka:

С версии '''2.6''' у пользователя появилась возможность "тонкой" настройки визуального редактора, например, подключить свой '''css'''-файл, настроить классы для типовых элементов, изменить настройки по "чистке" избыточного кода и многое другое. Подробное описание всех параметров для настройки визивига можно прочитать [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration здесь].

== Конфигурационный файл ==
Для настройки визивига появился кастомный конфигурационный файл. Этот файл не будет перезаписан при обновлении.

Путь к файлу:
'''/js/cms/wysiwyg/tinymce/jscripts/tiny_mce/tinymce_custom.js'''

Файл содержит код javascript-объекта window.mceCustomSettings, в начальной поставке файл выглядит примерно так:
<source lang="javascript">
// index/reference page for all available core configuration options in TinyMCE:
// http://wiki.moxiecode.com/index.php/TinyMCE:Configuration

window.mceCustomSettings = {
convert_fonts_to_spans : true, // convert tags to 
cleanup : true, // remove all unknown tags and attributes

extended_valid_elements : "script[type=text/javascript|src|languge|lang],map[*],area[*],umi:*[*],input[*]",
// extended tags and atributes
content_css : "/css/cms/style.css", // enable custom CSS
theme_advanced_styles : "Table=my-table;Table Cell=my-table-cell;Table Row=my-table-row" // custom css classes
}
</source>

Начиная с версии '''17 84088''' изменяемый файл '''/js/cms/wysiwyg/tinymce47/tinymce_custom.js'''

Его примерное содержание:
<source lang="javascript">
/**
* Глобальные кастомные настройки tinyMCE 4.7.
* @link https://www.tinymce.com/docs/configure/
* ...
*/
window.mceCustomSettings = {

// Файл с кастомным CSS
// @link https://www.tinymce.com/docs/configure/content-appearance/#content_css
content_css : '/js/cms/wysiwyg/tinymce47/tinymce_custom.css'
};
</source>
'''Обратите внимание:''' при модификации объекта следите за тем, чтобы после последней опции (перед }) не было запятой. В противном случае редактор может не работать в IE
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Визуальный редактор: Пользовательская настройка

2018-05-31T12:20:43Z

Po4emu4ka:

С версии '''2.6''' у пользователя появилась возможность "тонкой" настройки визуального редактора, например, подключить свой '''css'''-файл, настроить классы для типовых элементов, изменить настройки по "чистке" избыточного кода и многое другое. Подробное описание всех параметров для настройки визивига можно прочитать [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration здесь].

== Конфигурационный файл ==
Для настройки визивига появился кастомный конфигурационный файл. Этот файл не будет перезаписан при обновлении.

Путь к файлу:
'''/js/cms/wysiwyg/tinymce/jscripts/tiny_mce/tinymce_custom.js'''

Начиная с версии '''17 84088''' изменяемый файл '''/js/cms/wysiwyg/tinymce47/tinymce_custom.js'''

Файл содержит код javascript-объекта window.mceCustomSettings, в начальной поставке файл выглядит примерно так:
<source lang="javascript">
// index/reference page for all available core configuration options in TinyMCE:
// http://wiki.moxiecode.com/index.php/TinyMCE:Configuration

window.mceCustomSettings = {
convert_fonts_to_spans : true, // convert tags to 
cleanup : true, // remove all unknown tags and attributes

extended_valid_elements : "script[type=text/javascript|src|languge|lang],map[*],area[*],umi:*[*],input[*]",
// extended tags and atributes
content_css : "/css/cms/style.css", // enable custom CSS
theme_advanced_styles : "Table=my-table;Table Cell=my-table-cell;Table Row=my-table-row" // custom css classes
}
</source>

'''Обратите внимание:''' при модификации объекта следите за тем, чтобы после последней опции (перед }) не было запятой. В противном случае редактор перестанет работать в IE
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]

Визуальный редактор: Пользовательская настройка

2018-05-31T12:19:46Z

Po4emu4ka:

С версии '''2.6''' у пользователя появилась возможность "тонкой" настройки визуального редактора, например, подключить свой '''css'''-файл, настроить классы для типовых элементов, изменить настройки по "чистке" избыточного кода и многое другое. Подробное описание всех параметров для настройки визивига можно прочитать [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration здесь].

== Конфигурационный файл ==
Для настройки визивига появился кастомный конфигурационный файл. Этот файл не будет перезаписан при обновлении.

Путь к файлу:
'''/js/cms/wysiwyg/tinymce/jscripts/tiny_mce/tinymce_custom.js'''

Начиная с версии 17 84088 изменяемый файл '''/js/cms/wysiwyg/tinymce47/tinymce_custom.js'''

Файл содержит код javascript-объекта window.mceCustomSettings, в начальной поставке файл выглядит примерно так:
<source lang="javascript">
// index/reference page for all available core configuration options in TinyMCE:
// http://wiki.moxiecode.com/index.php/TinyMCE:Configuration

window.mceCustomSettings = {
convert_fonts_to_spans : true, // convert tags to 
cleanup : true, // remove all unknown tags and attributes

extended_valid_elements : "script[type=text/javascript|src|languge|lang],map[*],area[*],umi:*[*],input[*]",
// extended tags and atributes
content_css : "/css/cms/style.css", // enable custom CSS
theme_advanced_styles : "Table=my-table;Table Cell=my-table-cell;Table Row=my-table-row" // custom css classes
}
</source>

'''Обратите внимание:''' при модификации объекта следите за тем, чтобы после последней опции (перед }) не было запятой. В противном случае редактор перестанет работать в IE
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]]