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

Как дебажить PHP

2020-10-02T13:42:58Z

Vitaliks:

===Отладка ошибки 500 при помощи register_shutdown_function===

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

<source lang="php">
register_shutdown_function(function(){
if (error_get_last()) {
var_export(error_get_last());
}
});
</source>

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

[http://php.net/manual/ru/function.register-shutdown-function.php Документация по register_shutdown_function]

===Вывод данных отладки в браузере===
Наиболее простой способ вывести любую переменную это функции '''print_r()''', '''var_dump()''' и '''var_export()'''

'''print_r()''' - выводит структуру переменной в удобочитаемом виде

[http://php.net/manual/ru/function.print-r.php Документация по print_r]

'''var_dump()''' - также выводит тип данных для всех переменных

[http://php.net/manual/ru/function.var-dump.php Документация по var_dump]

'''var_export()''' - выводит структуру переменно в формате пригодным для выполнения в PHP

[http://php.net/manual/ru/function.var-export.php Документация var_export]

По умолчанию выводы этих функций используют '\n' в качестве переносов на новую строку.

Так как в браузере эти символы удаляются, то для того, чтобы результат было удобно читать, можно поместить его в тег <pre>

<source lang="php">
echo '<pre>';
print_r($var);
echo '</pre>';
</source>
или так
<source lang="php">
echo '<pre>' . print_r($var, true) . '</pre>';
</source>
В качестве второго аргумента для функций '''print_r()''' и '''var_export()''' можно указать true, если необходимо, чтобы функция возвращала результат, а не выводила его.

Код:
<source lang="php">
echo '<pre>';
print_r($variables['user']);
var_dump($variables['user']);
var_export($variables['user']);
echo '</pre>';
</source>

Результат вывода:

<source lang="php">
Array
(
[id] => 3
[type] => guest
)
array(2) {
["id"]=>
int(3)
["type"]=>
string(5) "guest"
}
array (
'id' => 3,
'type' => 'guest',
)
</source>

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

[http://php.net/manual/ru/function.get-defined-vars.php Документация по get_defined_vars]

===Вывод данных отладки в файл===

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

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

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $variable], true).PHP_EOL, FILE_APPEND | LOCK_EX);
</source>

В результате выполнения данной функции рядом с файлом, из которого было запущено выполнение PHP (обычно это index.php в корне сайта), будет создан файл umitest в который запишется имя файла, строка в нем и содержимое переменной $variable.

__FILE__ - это волшебная константа PHP которая всегда содержит имя текущего файла.

__LINE__ - это волшебная константа PHP которая всегда содержит номер строки в файле в котором она была вызвана.

Эти константы рекомендуется добавлять в вывод по нескольким причинам:

1) Удобство отслеживания из какого файла и строки в нем была сделана запись

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

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

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

Можно вывести в файл все переменные, доступные в текущей области видимости:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, get_defined_vars()], true).PHP_EOL, FILE_APPEND | LOCK_EX);
</source>

или только некоторые из них

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $var1, $var2], true).PHP_EOL, FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.file-put-contents.php Документация по file_put_contents]

===Получить стек вызова функции при помощи debug_backtrace===

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

<source lang="php">
$debug_arr = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)
</source>

Также в качестве второго аргумента можно указать глубину стека.

Стек вызова можно вывести как в браузер:

<source lang="php">
echo '<pre>' . print_r(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS), true) . '</pre>';
</source>

так и записывать в файл:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)], true), FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.debug-backtrace.php Документация по debug_backtrace]

===Получить расположение используемого класса, метода или функции===

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

====Информация о функции====

<source lang="php">
$reflectionMethod = new ReflectionFunction('function_name');
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится функция 'function_name'.

[https://www.php.net/manual/ru/class.reflectionfunction.php Документация по ReflectionFunction]

====Информация о классе====

<source lang="php">
$reflectionClass = new ReflectionClass('class_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionClass->getFileName(), $reflectionClass->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится класс 'class_name'.

[https://www.php.net/manual/ru/class.reflectionclass.php Документация по ReflectionClass]

====Информация о методе====

<source lang="php">
$reflectionMethod = new ReflectionMethod('class_name', 'method_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится метод 'method_name' класса 'class_name'.

Первым аргументом при создании ReflectionMethod можно передавать не только имя класса, но и его экземпляр, например:

<source lang="php">
namespace DebugNamespace;

$className = new class_name();
$reflectionMethod = new \ReflectionMethod($className, 'method_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Обратите внимание, что в данном случае в файле задан namespace 'DebugNamespace', поэтому при получении экземпляра класса \ReflectionMethod необходимо наличие косой черты в начале иначе произойдет ошибка:
Ошибка (Error): Class 'DebugNamespace\ReflectionMethod' not found

[https://www.php.net/manual/ru/class.reflectionmethod.php Документация по ReflectionMethod]

===Время выполнения скрипта===

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

<source lang="php">
$start = microtime(true);
// тут код время выполнения которого необходимо посчитать
$stop = microtime(true) - $start;
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $stop], true).PHP_EOL, FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.microtime.php Документация по microtime]

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

Как дебажить PHP

2020-01-21T14:04:09Z

Vitaliks:

===Отладка ошибки 500 при помощи register_shutdown_function===

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

<source lang="php">
register_shutdown_function(function(){
if (error_get_last()) {
var_export(error_get_last());
}
});
</source>

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

[http://php.net/manual/ru/function.register-shutdown-function.php Документация по register_shutdown_function]

===Вывод данных отладки в браузере===
Наиболее простой способ вывести любую переменную это функции '''print_r()''', '''var_dump()''' и '''var_export()'''

'''print_r()''' - выводит структуру переменной в удобочитаемом виде

[http://php.net/manual/ru/function.print-r.php Документация по print_r]

'''var_dump()''' - также выводит тип данных для всех переменных

[http://php.net/manual/ru/function.var-dump.php Документация по var_dump]

'''var_export()''' - выводит структуру переменно в формате пригодным для выполнения в PHP

[http://php.net/manual/ru/function.var-export.php Документация var_export]

По умолчанию выводы этих функций используют '\n' в качестве переносов на новую строку.

Так как в браузере эти символы удаляются, то для того, чтобы результат было удобно читать, можно поместить его в тег <pre>

<source lang="php">
echo '<pre>';
print_r($var);
echo '</pre>';
</source>
или так
<source lang="php">
echo '<pre>' . print_r($var, true) . '</pre>';
</source>
В качестве второго аргумента для функций '''print_r()''' и '''var_export()''' можно указать true, если необходимо, чтобы функция возвращала результат, а не выводила его.

Код:
<source lang="php">
echo '<pre>';
print_r($variables['user']);
var_dump($variables['user']);
var_export($variables['user']);
echo '</pre>';
</source>

Результат вывода:

<source lang="php">
Array
(
[id] => 3
[type] => guest
)
array(2) {
["id"]=>
int(3)
["type"]=>
string(5) "guest"
}
array (
'id' => 3,
'type' => 'guest',
)
</source>

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

[http://php.net/manual/ru/function.get-defined-vars.php Документация по get_defined_vars]

===Вывод данных отладки в файл===

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

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

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $variable], true)."\n", FILE_APPEND | LOCK_EX);
</source>

В результате выполнения данной функции рядом с файлом, из которого было запущено выполнение PHP (обычно это index.php в корне сайта), будет создан файл umitest в который запишется имя файла, строка в нем и содержимое переменной $variable.

__FILE__ - это волшебная константа PHP которая всегда содержит имя текущего файла.

__LINE__ - это волшебная константа PHP которая всегда содержит номер строки в файле в котором она была вызвана.

Эти константы рекомендуется добавлять в вывод по нескольким причинам:

1) Удобство отслеживания из какого файла и строки в нем была сделана запись

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

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

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

Можно вывести в файл все переменные, доступные в текущей области видимости:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, get_defined_vars()], true)."\n", FILE_APPEND | LOCK_EX);
</source>

или только некоторые из них

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $var1, $var2], true)."\n", FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.file-put-contents.php Документация по file_put_contents]

===Получить стек вызова функции при помощи debug_backtrace===

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

<source lang="php">
$debug_arr = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)
</source>

Также в качестве второго аргумента можно указать глубину стека.

Стек вызова можно вывести как в браузер:

<source lang="php">
echo '<pre>' . print_r(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS), true) . '</pre>';
</source>

так и записывать в файл:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)], true), FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.debug-backtrace.php Документация по debug_backtrace]

===Получить расположение используемого класса, метода или функции===

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

====Информация о функции====

<source lang="php">
$reflectionMethod = new ReflectionFunction('function_name');
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится функция 'function_name'.

[https://www.php.net/manual/ru/class.reflectionfunction.php Документация по ReflectionFunction]

====Информация о классе====

<source lang="php">
$reflectionClass = new ReflectionClass('class_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionClass->getFileName(), $reflectionClass->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится класс 'class_name'.

[https://www.php.net/manual/ru/class.reflectionclass.php Документация по ReflectionClass]

====Информация о методе====

<source lang="php">
$reflectionMethod = new ReflectionMethod('class_name', 'method_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится метод 'method_name' класса 'class_name'.

Первым аргументом при создании ReflectionMethod можно передавать не только имя класса, но и его экземпляр, например:

<source lang="php">
namespace DebugNamespace;

$className = new class_name();
$reflectionMethod = new \ReflectionMethod($className, 'method_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Обратите внимание, что в данном случае в файле задан namespace 'DebugNamespace', поэтому при получении экземпляра класса \ReflectionMethod необходимо наличие косой черты в начале иначе произойдет ошибка:
Ошибка (Error): Class 'DebugNamespace\ReflectionMethod' not found

[https://www.php.net/manual/ru/class.reflectionmethod.php Документация по ReflectionMethod]

===Время выполнения скрипта===

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

<source lang="php">
$start = microtime(true);
// тут код время выполнения которого необходимо посчитать
$stop = microtime(true) - $start;
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $stop], true)."\n", FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.microtime.php Документация по microtime]

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

Как дебажить PHP

2020-01-21T14:03:03Z

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

===Отладка ошибки 500 при помощи register_shutdown_function===

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

<source lang="php">
register_shutdown_function(function(){
if (error_get_last()) {
var_export(error_get_last());
}
});
</source>

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

[http://php.net/manual/ru/function.register-shutdown-function.php Документация по register_shutdown_function]

===Вывод данных отладки в браузере===
Наиболее простой способ вывести любую переменную это функции '''print_r()''', '''var_dump()''' и '''var_export()'''

'''print_r()''' - выводит структуру переменной в удобочитаемом виде

[http://php.net/manual/ru/function.print-r.php Документация по print_r]

'''var_dump()''' - также выводит тип данных для всех переменных

[http://php.net/manual/ru/function.var-dump.php Документация по var_dump]

'''var_export()''' - выводит структуру переменно в формате пригодным для выполнения в PHP

[http://php.net/manual/ru/function.var-export.php Документация var_export]

По умолчанию выводы этих функций используют '\n' в качестве переносов на новую строку.

Так как в браузере эти символы удаляются, то для того, чтобы результат было удобно читать, можно поместить его в тег <pre>

<source lang="php">
echo '<pre>';
print_r($var);
echo '</pre>';
</source>
или так
<source lang="php">
echo '<pre>' . print_r($var, true) . '</pre>';
</source>
В качестве второго аргумента для функций '''print_r()''' и '''var_export()''' можно указать true, если необходимо, чтобы функция возвращала результат, а не выводила его.

Код:
<source lang="php">
echo '<pre>';
print_r($variables['user']);
var_dump($variables['user']);
var_export($variables['user']);
echo '</pre>';
</source>

Результат вывода:

<source lang="php">
Array
(
[id] => 3
[type] => guest
)
array(2) {
["id"]=>
int(3)
["type"]=>
string(5) "guest"
}
array (
'id' => 3,
'type' => 'guest',
)
</source>

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

[http://php.net/manual/ru/function.get-defined-vars.php Документация по get_defined_vars]

===Вывод данных отладки в файл===

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

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

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $variable], true)."\n", FILE_APPEND | LOCK_EX);
</source>

В результате выполнения данной функции рядом с файлом, из которого было запущено выполнение PHP (обычно это index.php в корне сайта), будет создан файл umitest в который запишется имя файла, строка в нем и содержимое переменной $variable.

__FILE__ - это волшебная константа PHP которая всегда содержит имя текущего файла.

__LINE__ - это волшебная константа PHP которая всегда содержит номер строки в файле в котором она была вызвана.

Эти константы рекомендуется добавлять в вывод по нескольким причинам:

1) Удобство отслеживания из какого файла и строки в нем была сделана запись

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

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

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

Можно вывести в файл все переменные, доступные в текущей области видимости:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, get_defined_vars()], true)."\n", FILE_APPEND | LOCK_EX);
</source>

или только некоторые из них

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $var1, $var2], true)."\n", FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.file-put-contents.php Документация по file_put_contents]

===Получить стек вызова функции при помощи debug_backtrace===

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

<source lang="php">
$debug_arr = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)
</source>

Также в качестве второго аргумента можно указать глубину стека.

Стек вызова можно вывести как в браузер:

<source lang="php">
echo '<pre>' . print_r(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS), true) . '</pre>';
</source>

так и записывать в файл:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)], true), FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.debug-backtrace.php Документация по debug_backtrace]

===Получить расположение используемого класса, метода или функции===

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

====Информация о функции====

<source lang="php">
$reflectionMethod = new ReflectionFunction('function_name');
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится функция 'function_name'.

[https://www.php.net/manual/ru/class.reflectionfunction.php Документация по ReflectionFunction]

====Информация о классе====

<source lang="php">
$reflectionClass = new ReflectionClass('class_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionClass->getFileName(), $reflectionClass->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится класс 'class_name'.

[https://www.php.net/manual/ru/class.reflectionclass.php Документация по ReflectionClass]

====Информация о методе====

<source lang="php">
$reflectionMethod = new ReflectionMethod('class_name', 'method_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Этот код запишет в файл umitest путь до файла и номер строки в нем в которой находится метод 'method_name' класса 'class_name'.

Первым аргументом при создании ReflectionMethod можно передавать не только имя класса, но и его экземпляр, например:

<source lang="php">
namespace DebugNamespace;

$className = new class_name();
$reflectionMethod = new \ReflectionMethod($className, 'method_name');
file_put_contents("umicheck", print_r([__FILE__.' '.__LINE__, $reflectionMethod->getFileName(), $reflectionMethod->getStartLine()], true), FILE_APPEND | LOCK_EX);
</source>

Обратите внимание, что в данном случае в файле задан namespace 'DebugNamespace', поэтому при получении экземпляра класса \ReflectionMethod необходимо наличие косой черты в начале иначе произойдет ошибка:
Ошибка (Error): Class 'DebugNamespace\ReflectionMethod' not found

[https://www.php.net/manual/ru/class.reflectionmethod.php Документация по ReflectionMethod]

===Время выполнения скрипта===

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

<source lang="php">
$start = microtime(true);
// тут код время выполнения которого необходимо посчитать
$stop = microtime(true) - $start;
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $stop], true)."\n", FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.microtime.php Документация по microtime]

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

Как дебажить PHP

2020-01-15T14:32:44Z

Vitaliks:

===Отладка ошибки 500 при помощи register_shutdown_function===

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

<source lang="php">
register_shutdown_function(function(){
if (error_get_last()) {
var_export(error_get_last());
}
});
</source>

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

[http://php.net/manual/ru/function.register-shutdown-function.php Документация по register_shutdown_function]

===Вывод данных отладки в браузере===
Наиболее простой способ вывести любую переменную это функции '''print_r()''', '''var_dump()''' и '''var_export()'''

'''print_r()''' - выводит структуру переменной в удобочитаемом виде

[http://php.net/manual/ru/function.print-r.php Документация по print_r]

'''var_dump()''' - также выводит тип данных для всех переменных

[http://php.net/manual/ru/function.var-dump.php Документация по var_dump]

'''var_export()''' - выводит структуру переменно в формате пригодным для выполнения в PHP

[http://php.net/manual/ru/function.var-export.php Документация var_export]

По умолчанию выводы этих функций используют '\n' в качестве переносов на новую строку.

Так как в браузере эти символы удаляются, то для того, чтобы результат было удобно читать, можно поместить его в тег <pre>

<source lang="php">
echo '<pre>';
print_r($var);
echo '</pre>';
</source>
или так
<source lang="php">
echo '<pre>' . print_r($var, true) . '</pre>';
</source>
В качестве второго аргумента для функций '''print_r()''' и '''var_export()''' можно указать true, если необходимо, чтобы функция возвращала результат, а не выводила его.

Код:
<source lang="php">
echo '<pre>';
print_r($variables['user']);
var_dump($variables['user']);
var_export($variables['user']);
echo '</pre>';
</source>

Результат вывода:

<source lang="php">
Array
(
[id] => 3
[type] => guest
)
array(2) {
["id"]=>
int(3)
["type"]=>
string(5) "guest"
}
array (
'id' => 3,
'type' => 'guest',
)
</source>

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

[http://php.net/manual/ru/function.get-defined-vars.php Документация по get_defined_vars]

===Вывод данных отладки в файл===

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

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

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $variable], true)."\n", FILE_APPEND | LOCK_EX);
</source>

В результате выполнения данной функции рядом с файлом, из которого было запущено выполнение PHP (обычно это index.php в корне сайта), будет создан файл umitest в который запишется имя файла, строка в нем и содержимое переменной $variable.

__FILE__ - это волшебная константа PHP которая всегда содержит имя текущего файла.

__LINE__ - это волшебная константа PHP которая всегда содержит номер строки в файле в котором она была вызвана.

Эти константы рекомендуется добавлять в вывод по нескольким причинам:

1) Удобство отслеживания из какого файла и строки в нем была сделана запись

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

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

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

Можно вывести в файл все переменные, доступные в текущей области видимости:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, get_defined_vars()], true)."\n", FILE_APPEND | LOCK_EX);
</source>

или только некоторые из них

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $var1, $var2], true)."\n", FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.file-put-contents.php Документация по file_put_contents]

===Получить стек вызова функции при помощи debug_backtrace===

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

<source lang="php">
$debug_arr = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)
</source>

Также в качестве второго аргумента можно указать глубину стека.

Стек вызова можно вывести как в браузер:

<source lang="php">
echo '<pre>' . print_r(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS), true) . '</pre>';
</source>

так и записывать в файл:

<source lang="php">
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)], true), FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.debug-backtrace.php Документация по debug_backtrace]

===Время выполнения скрипта===

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

<source lang="php">
$start = microtime(true);
// тут код время выполнения которого необходимо посчитать
$stop = microtime(true) - $start;
file_put_contents("umitest", print_r([__FILE__.' '.__LINE__, $stop], true)."\n", FILE_APPEND | LOCK_EX);
</source>

[http://php.net/manual/ru/function.microtime.php Документация по microtime]

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

Установка из консоли (командной строки)

2020-01-09T07:22:05Z

Vitaliks: Актуализация статьи

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

Для установки потребуется:

0) Соответствие сервера системным требованиям UMI.CMS:

Ознакомиться с ними можно по ссылке:
http://www.umi-cms.ru/support/umi_cms_system_requirements/

Консольный инсталлятор проверяет соответствие системным требованиям при установке. Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).

1) Консольный инсталлятор:

Скачать его можно по ссылке:
[[Файл:Installer.zip]]

Файл installer.php должен быть помещён в корневую директорию сайта, на который производится установка UMI.CMS. Рекомендуется, чтобы эта директория была пустой. Необходимо чтобы она имела права на чтение и запись из php (если затрудняетесь выбрать - ставьте 777).

Права на сам файл installer.php должны быть такими, чтобы php мог его переписать.

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

2) Файл install.ini с настройками для установки конкретного сайта:

Скачать пример этого файла можно по ссылке:
http://www.umi-cms.ru/install/files/hosters/install.ini

Права на файл install.ini должны быть такими, чтобы php мог его переписать. Файл install.ini должен быть помещён в ту же директорию, где находится installer.php, до начала установки. После установки его рекомендуется удалять.

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

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

Файл должен быть сохранен в кодировке utf-8. Значения параметров, содержащие не латинские символы, а также спецсимволы необходимо брать в двойные кавычки ""; (например, пароль)

Пример файла:
<source lang="ini">
;=======================================================
;= инструкции для инсталлятора umi.cms в режиме CLI
;= Обязательные секции и их опции отмечены *
;=======================================================

; информация о PHP
[SERVER]
; phppath="php7.3" ; необходимо указать если версия php в консоли по умолчанию < 7.0 (для проверки выполнить 'php -v').
; phpini=/etc/php5/cli/php.ini - больше не используется.

;Информация о лицензии *
;-------------------------------------------------------
;Информация о лицензии *
[LICENSE]
domain=example.com ; доменное имя *
ip=127.0.1.7 ; ip - адрес *
key=*-*-* ; лицензионный ключ *

;Доступ к базе данных. *
;База данных должна быть создана
;-------------------------------------------------------
[DB]
host=localhost ; имя хоста *
user=root ; логин *
password=";\pass;" ; пароль *
dbname=installer ; имя базы *

;Информация о супервайзере *
;-------------------------------------------------------
[SUPERVISOR]
login=sv ; логин для входа в админку *
password="1" ; пароль *
lname=Installer ; фамилия
fname=cli ; имя
mname=Vasilievich ; отчество

[BRAND]
;Ссылка "Купить UMI.CMS"
buy-lbl="Купить UMI.CMS" ; Текст ссылки
buy-link="http://www.umi-cms.ru/purchase/how-to-buy/" ; Ru URL
en-buy-lbl="Buy UMI.CMS" ; Link text
en-buy-link="http://www.umi-cms.ru/purchase/how-to-buy/" ; En URL

[BACKUP]
mode = "none" ; all или none

[DEMOSITE]
name="_blank" ; Имя предустановленного демо-сайта (demomarket,demodizzy,demohunt,demoold,demooldschool,_blank)

[SETUP]
sleep=500 ; Время простоя для снижения нагрузки на сервер. Указывается в миллисекундах. Одна миллисекунда - одна тясячная одной секунды (500 = полсекунды)
download_by=1024 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах.

</source>

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

[SETUP]
sleep=1 ; Пауза между запросами в миллисекундах, чем меньше - тем быстрее.
download_by=1024 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.

3) Выбор соответствующего демо-сайта для установки:

Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть по ссылке: http://demo.umi-cms.ru/ . Демо-сайт государственной организации (Gov) в настоящее время автоматически не устанавливается.

Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля магазина). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать ошибку http://errors.umi-cms.ru/14022/ , если данный демосайт не подходит.

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

Для редакции Commerce Trial:
[DEMOSITE]
name="demomarket"

Либо сайт без шаблонов (не рекомендуется):
[DEMOSITE]
name="_blank"

4) Персональный гейт для выдачи лицензионных ключей UMI.CMS:

Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей.

Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.

Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).

5) Инструкция:

* Загрузите файл installer.php в корень сервера (DOCUMENT_ROOT)
* Создайте файл install.ini в (DOCUMENT_ROOT), укажите в нем все необходимые данные. Кодировка файла utf-8
* Зайдите на сервер по ssh.
<source lang="bash">
ssh example.com -llogin
</source>
* Сделайте корневую директорию сервера (DOCUMENT_ROOT) текущей.
<source lang="bash">
cd /home/www/example.com/htdocs
</source>
* Запустите инсталлятор
<source lang="bash">
php -f installer.php
</source>

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

6) Коды ошибок:

Практически все коды доступны по ссылке вида http://errors.umi-cms.ru/15000/
где 15000 - числовой код ошибки.

--------------------------------------------------------------------------------------------------------------------------------------------------

Справочная информация:

Описание гейта для выдачи ключей:

Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по URL:

для редакции Commerce Trial:
http://updateserver.umihost.ru/udata/custom/generateLicenseGate/SFNUFTDJYFT/client@email.ru/FirstName/LastName/client.domain.ru/client.ip.address/trial

SFNUFTDJYFT - пример уникального ID вашего хостинга (см. выше про выдачу ключа персонального гейта)
следующие параметры по порядку:
e-mail клиента
имя клиента
фамилия клиента
домен клиента
IP-адрес, на котором расположен сайт с этим доменом

В результате выполнения этого запроса вы получаете XML-данные. Из них вам нужно извлечь значение параметра "domain-keycode" - это доменный ключ, который нужно записать в файл install.ini для инсталлятора UMI.CMS. После этого запустить инсталлятор.
[[Категория:Вопросы установки настройки и переноса]]

Вывод случайного изображения из папки

2019-10-31T10:48:34Z

Vitaliks: /* Использование макроса в PHP */

[[category:Написание кастомных макросов]]
[[category:Верстка в XSLT]]
[[category:Верстка в TPL]]
'''Актуально для версии 20'''

== Задача ==

Вывести случайное изображение из указанной папки.

== Решение ==

Для решения задачи будем использовать кастомный макрос. Назовём его, например - "getRandomImage". Код макроса нужно поместить в файл "/classes/components/custom.php".
<source lang="php">
public function getRandomImage($folder, $template = 'default') {
if (!file_exists($folder)) {
return;
}

$exts = ['gif', 'jpg', 'jpeg', 'png'];
$images = [];
$dh = opendir($folder);
while (($file = readdir($dh)) == true) {
$fileExt = pathinfo($file, PATHINFO_EXTENSION);
if (in_array($fileExt, $exts)) {
$images[] = $file;
}
}

closedir($dh);

$fileName = null;
$imagesCount = count($images);
if ($imagesCount > 0) {
$imageNumber = time() % $imagesCount;
$fileName = $folder.$images[$imageNumber];
}

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

list($image) = def_module::loadTemplates('random/'.$template, 'image');

$blockArr = [];
$blockArr['filename'] = $fileName;

return def_module::parseTemplate($image, $blockArr);
}

</source>

Макрос принимает два параметра: папку с изображениями и шаблон вывода. В XSLT шаблон вывода не используется.

Если же Вы используете TPL, то необходимо создать файл "tpls/random/default.tpl" (это будет шаблон вывода по умолчанию, если не будет указан другой) со следующим содержанием:

<source lang="php">
<?php

$FORMS = Array();

$FORMS['image'] = <<<END

<img src="%filename%" alt="random image" border="0" />

END;

?>
</source>

=== Использование макроса в TPL ===

<source lang="php">
%custom getRandomImage('/images/')%
</source>

=== Использование макроса в XSLT ===

<source lang="html4strict">
<xsl:apply-templates select="document('udata://custom/getRandomImage/(./images/cms)/')/udata" />

<xsl:template match="udata[@module = 'custom'][@method = 'getRandomImage']">
<xsl:variable name="img" select="filename" />
<img src="{$img}" alt="random image" border="0" />
</xsl:template>
</source>

=== Использование макроса в PHP ===

<source lang="php">
<?php
$imageData = $this->macros('custom', 'getRandomImage', ['./images/']);
?>
<img src="<?=$imageData['filename']?>" alt="random image" border="0">
</source>

Вывод случайного изображения из папки

2019-10-31T10:48:01Z

Vitaliks:

[[category:Написание кастомных макросов]]
[[category:Верстка в XSLT]]
[[category:Верстка в TPL]]
'''Актуально для версии 20'''

== Задача ==

Вывести случайное изображение из указанной папки.

== Решение ==

Для решения задачи будем использовать кастомный макрос. Назовём его, например - "getRandomImage". Код макроса нужно поместить в файл "/classes/components/custom.php".
<source lang="php">
public function getRandomImage($folder, $template = 'default') {
if (!file_exists($folder)) {
return;
}

$exts = ['gif', 'jpg', 'jpeg', 'png'];
$images = [];
$dh = opendir($folder);
while (($file = readdir($dh)) == true) {
$fileExt = pathinfo($file, PATHINFO_EXTENSION);
if (in_array($fileExt, $exts)) {
$images[] = $file;
}
}

closedir($dh);

$fileName = null;
$imagesCount = count($images);
if ($imagesCount > 0) {
$imageNumber = time() % $imagesCount;
$fileName = $folder.$images[$imageNumber];
}

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

list($image) = def_module::loadTemplates('random/'.$template, 'image');

$blockArr = [];
$blockArr['filename'] = $fileName;

return def_module::parseTemplate($image, $blockArr);
}

</source>

Макрос принимает два параметра: папку с изображениями и шаблон вывода. В XSLT шаблон вывода не используется.

Если же Вы используете TPL, то необходимо создать файл "tpls/random/default.tpl" (это будет шаблон вывода по умолчанию, если не будет указан другой) со следующим содержанием:

<source lang="php">
<?php

$FORMS = Array();

$FORMS['image'] = <<<END

<img src="%filename%" alt="random image" border="0" />

END;

?>
</source>

=== Использование макроса в TPL ===

<source lang="php">
%custom getRandomImage('/images/')%
</source>

=== Использование макроса в XSLT ===

<source lang="html4strict">
<xsl:apply-templates select="document('udata://custom/getRandomImage/(./images/cms)/')/udata" />

<xsl:template match="udata[@module = 'custom'][@method = 'getRandomImage']">
<xsl:variable name="img" select="filename" />
<img src="{$img}" alt="random image" border="0" />
</xsl:template>
</source>

=== Использование макроса в PHP ===

<source lang="php">
<?php
$imageData = $this->macros('custom', 'getRandomImage', ['./images/']);
?>
<img src="{$imageData['filename']}" alt="random image" border="0">
</source>

Вывод случайного изображения из папки

2019-10-31T10:46:41Z

Vitaliks:

[[category:Написание кастомных макросов]]
[[category:Верстка в XSLT]]
[[category:Верстка в TPL]]
'''Актуально для версии 20'''

== Задача ==

Вывести случайное изображение из указанной папки.

== Решение ==

Для решения задачи будем использовать кастомный макрос. Назовём его, например - "getRandomImage". Код макроса нужно поместить в файл "/classes/modules/custom.php".
<source lang="php">
public function getRandomImage($folder, $template = 'default') {
if (!file_exists($folder)) {
return;
}

$exts = ['gif', 'jpg', 'jpeg', 'png'];
$images = [];
$dh = opendir($folder);
while (($file = readdir($dh)) == true) {
$fileExt = pathinfo($file, PATHINFO_EXTENSION);
if (in_array($fileExt, $exts)) {
$images[] = $file;
}
}

closedir($dh);

$fileName = null;
$imagesCount = count($images);
if ($imagesCount > 0) {
$imageNumber = time() % $imagesCount;
$fileName = $folder.$images[$imageNumber];
}

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

list($image) = def_module::loadTemplates('random/'.$template, 'image');

$blockArr = [];
$blockArr['filename'] = $fileName;

return def_module::parseTemplate($image, $blockArr);
}

</source>

Макрос принимает два параметра: папку с изображениями и шаблон вывода. В XSLT шаблон вывода не используется. Если же Вы используете TPL, то необходимо создать файл "tpls/random/default.tpl" (это будет шаблон вывода по умолчанию, если не будет указан другой) со следующим содержанием:

<source lang="php">
<?php

$FORMS = Array();

$FORMS['image'] = <<<END

<img src="%filename%" alt="random image" border="0" />

END;

?>
</source>

=== Использование макроса в TPL ===

<source lang="php">
%custom getRandomImage('/images/')%
</source>

=== Использование макроса в XSLT ===

<source lang="html4strict">
<xsl:apply-templates select="document('udata://custom/getRandomImage/(./images/cms)/')/udata" />

<xsl:template match="udata[@module = 'custom'][@method = 'getRandomImage']">
<xsl:variable name="img" select="filename" />
<img src="{$img}" alt="random image" border="0" />
</xsl:template>
</source>

=== Использование макроса в PHP ===

<source lang="php">
<?php
$imageData = $this->macros('custom', 'getRandomImage', ['./images/']);
?>
<img src="{$imageData['filename']}" alt="random image" border="0">
</source>

Получение текущего шаблона в кастомном методе

2019-10-31T10:26:49Z

Vitaliks:

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

== Задача ==

В кастомном методе узнать какой шаблон используется системой, если шаблоны хранятся в [http://help-dev.umi-cms.ru/chapter.newTemplates.html новом формате].

== Решение ==

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

<source lang="php">
// Полный путь к файлам используемого шаблона
$template_path = cmsController::getInstance()->getResourcesDirectory(true);

// Имя папки используемого шаблона
$template_name = cmsController::getInstance()->detectCurrentDesignTemplate()->getName();
</source>
При использовании старого формата хранения шаблонов, функции возвращают NULL.

'''Примечание'''

Данный функционал был проверен на работоспособность в версии системы 2.8.5.1.

Отключение возможности регистрации пользователей.

2019-10-31T10:12:43Z

Vitaliks:

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

== Отключение возможности регистрации пользователей ==
В административной панели в модуле «Пользователи» у пользователя «''Гость''» убираем право на регистрацию (в блоке «''Пользователи''»). При попытке перехода по ссылке [[«Забыли пароль?»]] (для восстановления пароля) попадаем на страницу авторизации.
Для того, чтобы при отключенной регистрации у пользователей оставалась возможность восстановления пароля, необходимо добавить файл '''permissions.custom.php''' в директорию ''/classes/components/users/'' следующего содержания:
<source lang='php'>
<?php
$permissions = Array(
'login' => Array('forget', 'forget_do', 'restore'),
);

</source>

Автоматическое формирование анонса новости

2019-10-31T10:08:55Z

Vitaliks:

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

Если анонс новости из себя представляет первые несколько предложений из полной новости, то для его формирования можно использовать кастомный метод, работающий по событиям systemCreateElement и systemModifyElement.
Добавим вызов нашего будущего метода в файл ~/classes/components/news/custom_events.php
<source lang="php">
<?php
new umiEventListener('systemCreateElement', 'news', 'anonsGenerate');
new umiEventListener('systemModifyElement', 'news', 'anonsGenerate');

</source>
после этого напишем сам обработчик в файл ~/classes/components/news/customAdmin.php
<source lang="php">

public function anonsGenerate(iUmiEventPoint $oEventPoint){
if ($oEventPoint->getMode() === "after"){
$object = $oEventPoint->getRef("element");
$content = $object->getValue('content');
$limit = 199;
$result = substr($content, 0, $limit) . '...';
$object->setValue('anons', $result);
$object->commit();
return true;
}
}

</source>
в данной функции происходит получение содержимого поля content новости, и в поле anons записывается первые 199 символов содержимого поля content, это ограничение указывается в переменной $limit.
Для правильной работы, необходимо не забыть добавить запись об этой функции в файл permissions.custom.php.
Теперь, при добавлении/редактировании новости, анонс будет формироваться автоматически.
<p>
Данный функционал был проверен на работоспособность в версии системы 2.8.5.2.
</p>
[[Категория:Написание кастомных макросов]][[Категория:Модуль Новости]]

Добавление полей для ввода пользователем в модуле FAQ

2019-10-31T09:01:05Z

Vitaliks:

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

В системе UMI.CMS для модуля FAQ предусмотрен ввод пользователем вопроса, ника, адреса его электронной почты и темы. Если требуется ввод дополнительных данных (возраст, профессия и т.д.) добавить поле в тип данных "Вопрос в FAQ" и создать одноимённое поле в форме недостаточно.
Для того чтобы заполнить произвольное поле для вопроса в FAQ, нужно создать кастомный метод в файле customMacros.php модуля "FAQ".
Содержимое метода должно быть примерно следующее:
<source lang="php">
public function onQuestionPostDopPolja(iUmiEventPoint $event) {
if ($event->getMode() == 'after') {
$questionId = $event->getParam('element_id');
$string = getRequest('new_pole');
$hierarchy = umiHierarchy::getInstance();
$faq = $hierarchy->getElement($questionId);
$faq->setValue('new_pole', $string);
$faq->commit();
}
}
</source>
где new_pole - идентификатор поля, которое нужно записать.

Этот метод должен запускаться обработчиком событий, который нужно поместить в файл custom_events.php
обработчик должен иметь следующий вид:
<source lang="php">
<?php
new umiEventListener('faq_post_question', 'faq', 'onQuestionPostDopPolja');
</source>
[[Категория:Написание кастомных макросов]][[Категория:Модуль FAQ]]

Добавление полей для ввода пользователем в модуле FAQ

2019-10-31T09:00:48Z

Vitaliks: Актуализация статьи

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

В системе UMI.CMS для модуля FAQ предусмотрен ввод пользователем вопроса, ника, адреса его электронной почты и темы. Если требуется ввод дополнительных данных (возраст, профессия и т.д.) добавить поле в тип данных "Вопрос в FAQ" и создать одноимённое поле в форме недостаточно.
Для того чтобы заполнить произвольное поле для вопроса в FAQ, нужно создать кастомный метод в файле customMacros.php модуля "FAQ".
Содержимое метода должно быть примерно следующее:
<source lang="php">
public function onQuestionPostDopPolja(iUmiEventPoint $event) {
if ($event->getMode() == 'after') {
$questionId = $event->getParam('element_id');
$string = getRequest('new_pole');
$hierarchy = umiHierarchy::getInstance();
$faq = $hierarchy->getElement($questionId);
$faq->setValue('new_pole',$string);
$faq->commit();
}
}
</source>
где new_pole - идентификатор поля, которое нужно записать.

Этот метод должен запускаться обработчиком событий, который нужно поместить в файл custom_events.php
обработчик должен иметь следующий вид:
<source lang="php">
<?php
new umiEventListener('faq_post_question', 'faq', 'onQuestionPostDopPolja');
</source>
[[Категория:Написание кастомных макросов]][[Категория:Модуль FAQ]]

Описание структуры файлов и таблиц базы данных

2019-10-15T09:12:26Z

Vitaliks: Обновил

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

== Файловая структура ==

* classes - ядро и модули системы
** components - модули системы
** system - ядро системы
** vendor - зависимости Composer-а
* files - пользовательские файлы
* images - пользовательские изображения
** cms - миниатюры изображений и пользовательские изображения
* styles - шаблоны и стили админки
** common - файлы оформления системных страниц
** skins - скины админки
* sys-temp - вспомогательные файлы системы
** manifest - директория для временных файлов манифестов
** runtime-cache - временные файлы системы
** static-cache - директория для файлов статического кеша
** updates - файлы обновления системы
** uploads - директория для загрузки файлов из форм
** logs - директория с логами
** yml - кеш импорта/экспорта YML
** packer - собранные пакеты модулей/решений/расширений для маркета
* templates - шаблоны
* tests - тесты
** core - тесты ядра
** install - тесты установки
** logs - логи тестов
** modules - тесты модулей
** PHPUnit - тесты на PHPUnit
** Runner - функционал для запуска тестов
** simpletest - файлы фреймворка SimpleTest для выполнения тестов
** updates - тесты обновления

== Структура базы данных ==

{|class="wikitable"
!Название таблицы !! Описание таблицы
|-
||cms3_apiship_orders || заявки на доставку через ApiShip
|-
||cms3_appointment_employee_schedule || расписания сотрудников записи на прием
|-
||cms3_appointment_employees || сотрудники записи на прием
|-
||cms3_appointment_employees_services || связи сотрудник-услуга для записи на примем
|-
||cms3_appointment_orders || заявки записи на прием
|-
||cms3_appointment_service_groups || группы услуг для записи на прием
|-
||cms3_appointment_services || услуги для записи на прием
|-
||cms3_data_cache || кеш
|-
||cms3_domain_mirrows || зеркала для доменов
|-
||cms3_domains || домены сайтов в системе
|-
||cms3_emarket_top || статистика о популярных товарах
|-
||cms3_fields_controller || связи между полями и группами полей в типах данных
|-
||cms3_hierarchy || страницы сайта
|-
||cms3_hierarchy_relations || иерархические связи страниц сайта
|-
||cms3_hierarchy_types || базовые типы данных
|-
||cms3_import_apiship_orders || связи импорта заказов из ApiShip
|-
||cms3_import_appointment_employee_schedule || связи импорта расписания сотрудников записи на прием
|-
||cms3_import_appointment_employees || связи импорта сотрудников записи на прием
|-
||cms3_import_appointment_employees_services || связи импорта связей сотрудник-услуга для записи на примем
|-
||cms3_import_appointment_orders || связи импорта заявок записи на прием
|-
||cms3_import_appointment_service_groups || связи импорта групп услуг для записи на прием
|-
||cms3_import_appointment_services || связи импорта услуг для записи на прием
|-
||cms3_import_domain_mirrors || связи импорта зеркал для доменов
|-
||cms3_import_domains || связи импорта доменов в системе
|-
||cms3_import_fields || связи полей с внешними сущностями
|-
||cms3_import_groups || связи групп полей с внешними сущностями
|-
||cms3_import_langs || связи импорта языков в системе
|-
||cms3_import_links || связи импорта ссылок сайта
|-
||cms3_import_links_sources || связи импорта источников ссылок
|-
||cms3_import_mail_notifications || связи импорта шаблонов уведомлений
|-
||cms3_import_mail_templates || связи импорта данных шаблонов
|-
||cms3_import_mail_variables || связи импорта
|-
||cms3_import_objects || связи импорта объектов
|-
||cms3_import_offer_list || связи импорта торговых предложений
|-
||cms3_import_offer_price_list || связи импорта цен торговых предложений
|-
||cms3_import_offer_price_type_list || связи импорта типов цен торговых предложений
|-
||cms3_import_redirects || связи импорта редиректов
|-
||cms3_import_relations || связи импорта иерархические связей страниц сайта
|-
||cms3_import_restrictions || связи импорта ограничений полей
|-
||cms3_import_sliders || связи импорта слайдеров
|-
||cms3_import_slides || связи импорта слайдов
|-
||cms3_import_sources || связи импорта источников ссылок
|-
||cms3_import_stock_balance_list || связи импорта складских остатков торговых предложений
|-
||cms3_import_templates || связи импорта шаблонов
|-
||cms3_import_types || связи импорта типов
|-
||cms3_langs || языки в системе
|-
||cms3_links || список всех ссылок сайта для модуля SEO
|-
||cms3_links_sources || источники ссылок
|-
||cms3_mail_notifications || данные о шаблонах писем уведомлений
|-
||cms3_mail_templates || шаблоны писем уведомлений
|-
||cms3_mail_variables || данные о переменных в шаблонах писем уведомлений
|-
||cms3_messages || для системных сообщений
|-
||cms3_messages_inbox || информация об открытии системных сообщений пользователями
|-
||cms3_object_content || значения полей с типами "Кнопка-флажок", "Цвет", "Дата", "Число с точкой", "Число", "Ссылка на объектный тип данных", "Составное", "Пароль", "Цена", "Выпадающий список", "Выпадающий список с множественным выбором", "Строка", "Ссылка на дерево", "Теги", "Простой текст", "HTML-текст" для всех объектов в системе
|-
||cms3_object_content_cnt || хранилище для значений полей типа "Счетчик"
|-
||cms3_object_domain_id_list || хранилище для значений полей типа "Ссылка на домен" и "Ссылка на список доменов"
|-
||cms3_object_field_groups || группы полей объектов
|-
||cms3_object_field_types || типы полей объектов
|-
||cms3_object_fields || поля объектов
|-
||cms3_object_fields_restrictions || ограничения полей
|-
||cms3_object_files || хранилище для значений полей типа "Файл" и "Набор файлов"
|-
||cms3_object_images || хранилище для значений полей типа "Изображение", "Набор изображений" и "Флеш-ролик"
|-
||cms3_object_offer_id_list || хранилище для значений полей типа "Ссылка на торговое предложение" и "Ссылка на список торговых предложений"
|-
||cms3_object_type_tree || иерархия типов данных объектов
|-
||cms3_object_types || типы объектов
|-
||cms3_objects || объекты системы
|-
||cms3_objects_expiration || время действия временных объектов до удаления
|-
||cms3_offer_list || торговые предложения
|-
||cms3_offer_price_list || цены торговых предложений
|-
||cms3_offer_price_type_list || типы цен торговых предложений
|-
||cms3_permissions || права доступа к страницам сайта
|-
||cms3_redirects || редиректы
|-
||cms3_response_error_entry_list || лог записей обработки ответа с ошибкой
|-
||cms3_search || время индексации страниц сайта
|-
||cms3_search_index || данные индексации страниц сайта
|-
||cms3_search_index_words || данные о проидексированых словах
|-
||cms3_sliders || слайдеры
|-
||cms3_slides || слайды
|-
||cms3_stock_balance_list || складские остатки торговых предложений
|-
||cms3_templates || шаблоны в системе
|-
||cms_backup || резервные копии страниц
|-
||cms_permissions || права доступа на модули и методы
|-
||cms_reg || данные системного реестра
|-
||cms_sitemap || карта сайта
|-
||cms_stat_domains || статистика по доменам
|-
||cms_stat_entry_points || статистика точек входа
|-
||cms_stat_entry_points_events || статистика событий точек входа
|-
||cms_stat_events || статистика событий
|-
||cms_stat_events_collected || статистика собранных событий
|-
||cms_stat_events_rel || статистика связей событий
|-
||cms_stat_events_urls || статистика событий ссылок
|-
||cms_stat_finders || статистика поиска
|-
||cms_stat_hits || статистика попадений
|-
||cms_stat_holidays || статистика по выходным
|-
||cms_stat_pages || статистика по страницам
|-
||cms_stat_paths || статистика по путям
|-
||cms_stat_phrases || статистика по фразам
|-
||cms_stat_sites || статистика по сайтам
|-
||cms_stat_sites_groups || статистика
|-
||cms_stat_sources || статистика источников
|-
||cms_stat_sources_coupon || статистика источников купонов
|-
||cms_stat_sources_coupon_events || статистика источников событий купонов
|-
||cms_stat_sources_openstat || статистика источников из openstat
|-
||cms_stat_sources_openstat_ad || статистика источников из openstat по рекламным объявлениям
|-
||cms_stat_sources_openstat_campaign || статистика источников из openstat компании
|-
||cms_stat_sources_openstat_service || статистика источников из openstat сервисы
|-
||cms_stat_sources_openstat_source || статистика источников из openstat источники
|-
||cms_stat_sources_pr || статистикам источников от рекламной компании
|-
||cms_stat_sources_pr_events || статистика источников событий рекламной компании
|-
||cms_stat_sources_pr_sites || статистика источников от рекламной компании по сайтам
|-
||cms_stat_sources_search || статистика источников поиска
|-
||cms_stat_sources_search_engines || статистика источников по поисковым движкам
|-
||cms_stat_sources_search_queries || статистика источников по поисковым запросам
|-
||cms_stat_sources_sites || статистика источников по сайтам
|-
||cms_stat_sources_sites_domains || статистика источников по доменам
|-
||cms_stat_sources_ticket || статистика источников заявок
|-
||cms_stat_users || статистика пользователей
|-
||cms_stat_users_browsers || статистика по браузерам пользователей
|-
||cms_stat_users_os || статистика по операционным системам пользователей
|-
||umi_event_feeds || события для модуля События
|-
||umi_event_types || типы событий для модуля События
|-
||umi_event_user_history || история событий пользователей для модуля События
|-
||umi_event_users || события пользователей для модуля События
|}

[[Категория:Решение проблем и ошибок]]

Описание структуры файлов и таблиц базы данных

2019-09-30T16:32:01Z

Vitaliks: Новая страница: «'''Актуально для версии 20''' == Файловая структура == * classes - ядро, модули системы и пакеты ав…»

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

== Файловая структура ==

* classes - ядро, модули системы и пакеты автозагрузки
** components - модули системы
** system - файлы ядра системы
** vendor - пакеты автозагрузки
* files - пользовательские файлы
* images - пользовательские изображения
** cms - системные изображения
** icons - иконки сайта
* styles - шаблоны и стили админки
** common - файлы оформления системных страниц
** skins - скины админки
* sys-temp - веременные файлы системы
** manifest - директория для временных операций, которыми занимаются манифесты
** runtime-cache - временные файлы системы
** static-cache - директория для временных операций статического кэширования
** updates - файлы обновления системы
** uploads - директория для загрузки файлов из форм
* templates - шаблоны
* tests - тесты
** core - тесты ядра
** install - тесты установки
** logs - логи тестов
** modules - тесты модулей
** PHPUnit - тесты на PHPUnit
** Runner - функционал для запуска тестов
** simpletest - файлы фреймворка SimpleTest для выполнения тестов
** updates - тесты обновления

== Структура базы данных ==

{|class="wikitable"
!Название таблицы!!Описание таблицы
|-
||cms3_apiship_orders || Хранит заказы оформелнные с доставкой через ApiShip
|-
|cms3_appointment_employee_schedule || Хранит расписания сотрудников записи на прием
|-
|cms3_appointment_employees || Хранит сотрудников записи на прием
|-
|cms3_appointment_employees_services || Хранит связи сотрудник-услуга для записи на примем
|-
|cms3_appointment_orders || Хранит заявки записи на прием
|-
|cms3_appointment_service_groups || Хранит группы услуг для записи на прием
|-
|cms3_appointment_services || Хранит услуги для записи на прием
|-
|cms3_data_cache || Хранит кеш
|-
|cms3_domain_mirrows || Хранит зеркала для доменов
|-
|cms3_domains || Хранит домены сайтов в системе
|-
|cms3_emarket_top || Хранит статистику о популярных товарах
|-
|cms3_fields_controller || Хранит связи между полями и группами полей в типах данных
|-
|cms3_hierarchy || Хранит все страницы структуры сайта
|-
|cms3_hierarchy_relations || Хранит иерархические связи страниц структуры сайта
|-
|cms3_hierarchy_types || Хранит типы данных страниц структуры сайта
|-
|cms3_import_apiship_orders || Хранит связи импорта заказов из ApiShip
|-
|cms3_import_appointment_employee_schedule || Хранит связи импорта расписания сотрудников записи на прием
|-
|cms3_import_appointment_employees || Хранит связи импорта сотрудников записи на прием
|-
|cms3_import_appointment_employees_services || Хранит связи импорта связей сотрудник-услуга для записи на примем
|-
|cms3_import_appointment_orders || Хранит связи импорта заявок записи на прием
|-
|cms3_import_appointment_service_groups || Хранит связи импорта групп услуг для записи на прием
|-
|cms3_import_appointment_services || Хранит связи импорта услуг для записи на прием
|-
|cms3_import_domain_mirrors || Хранит связи импорта зеркал для доменов
|-
|cms3_import_domains || Хранит связи импорта доменов в системе
|-
|cms3_import_fields || Хранит связи полей с внешними сущностями
|-
|cms3_import_groups || Хранит связи групп полей с внешними сущностями
|-
|cms3_import_langs || Хранит связи импорта языков в системе
|-
|cms3_import_links || Хранит связи импорта ссылок сайта
|-
|cms3_import_links_sources || Хранит связи импорта источников ссылок
|-
|cms3_import_mail_notifications || Хранит связи импорта шаблонов уведомлений
|-
|cms3_import_mail_templates || Хранит связи импорта данных шаблонов
|-
|cms3_import_mail_variables || Хранит связи импорта
|-
|cms3_import_objects || Хранит связи импорта объектов
|-
|cms3_import_offer_list || Хранит связи импорта торговых предложений
|-
|cms3_import_offer_price_list || Хранит связи импорта цен торговых предложений
|-
|cms3_import_offer_price_type_list || Хранит связи импорта типов цен торговых предложений
|-
|cms3_import_redirects || Хранит связи импорта редиректов
|-
|cms3_import_relations || Хранит связи импорта иерархические связей страниц структуры сайта
|-
|cms3_import_restrictions || Хранит связи импорта рестрикшенов
|-
|cms3_import_sliders || Хранит связи импорта слайдеров
|-
|cms3_import_slides || Хранит связи импорта слайдов
|-
|cms3_import_sources || Хранит связи импорта испточников ссылок
|-
|cms3_import_stock_balance_list || Хранит связи импорта ?
|-
|cms3_import_templates || Хранит связи импорта шаблонов
|-
|cms3_import_types || Хранит связи импорта типов
|-
|cms3_langs || Хранит языки в системе
|-
|cms3_links || Хранит список всех ссылок сайта для модуля SEO
|-
|cms3_links_sources || Хранит источники ссылок
|-
|cms3_mail_notifications || Хранит данные о шаблонах писем уведомлений
|-
|cms3_mail_templates || Хранит шаблоны писем уведомлений
|-
|cms3_mail_variables || Хранит данные о переменных в шаблонах писем уведомлений
|-
|cms3_messages || ? класс umiMessage протокол umess
|-
|cms3_messages_inbox || ? класс umiMessage протокол umess
|-
|cms3_object_content || Хранит поля всех объектов в системе
|-
|cms3_object_content_cnt || Хранит счетчики
|-
|cms3_object_domain_id_list || Хранит ссылки на домены
|-
|cms3_object_field_groups || Хранит группы полей объектов
|-
|cms3_object_field_types || Хранит типы полей объектов
|-
|cms3_object_fields || Хранит поля объектов
|-
|cms3_object_fields_restrictions || Хранит рестрикшены
|-
|cms3_object_files || Хранит данные объектов типа файл
|-
|cms3_object_images || Хранит данные объектов типа изображение
|-
|cms3_object_offer_id_list || Хранит ссылки на торговые предложения
|-
|cms3_object_type_tree || Хранит иерархию типов данных объектов
|-
|cms3_object_types || Хранит типы объектов
|-
|cms3_objects || Хранит объекты системы
|-
|cms3_objects_expiration || Хранит время действия временых объектов до удаления
|-
|cms3_offer_list || Хранит все торговые предложения
|-
|cms3_offer_price_list || Хранит цену торговых предложений
|-
|cms3_offer_price_type_list || Хранит типы цен торговых предложений
|-
|cms3_permissions || Хранит права доступа к страницам сайта
|-
|cms3_redirects || Хранит редиректы
|-
|cms3_response_error_entry_list || ?
|-
|cms3_search || Хранит время индексации страниц сайта
|-
|cms3_search_index || Хранит данные индексации страниц сайта
|-
|cms3_search_index_words || Хранит данные о проидексированых словах
|-
|cms3_sliders || Хранит слайдеры
|-
|cms3_slides || Хранит слайды
|-
|cms3_stock_balance_list || ?
|-
|cms3_templates || Хранит шаблоны в системе
|-
|cms_backup || Хранит резервные копии страниц
|-
|cms_permissions || Хранит права доступа на модули и методы
|-
|cms_reg || Хранит данные системного реестра
|-
|cms_sitemap || Хранит сайтмап
|-
|cms_stat_domains || Хранит статистику
|-
|cms_stat_entry_points || Хранит статистику
|-
|cms_stat_entry_points_events || Хранит статистику
|-
|cms_stat_events || Хранит статистику
|-
|cms_stat_events_collected || Хранит статистику
|-
|cms_stat_events_rel || Хранит статистику
|-
|cms_stat_events_urls || Хранит статистику
|-
|cms_stat_finders || Хранит статистику
|-
|cms_stat_hits || Хранит статистику
|-
|cms_stat_holidays || Хранит статистику
|-
|cms_stat_pages || Хранит статистику
|-
|cms_stat_paths || Хранит статистику
|-
|cms_stat_phrases || Хранит статистику
|-
|cms_stat_sites || Хранит статистику
|-
|cms_stat_sites_groups || Хранит статистику
|-
|cms_stat_sources || Хранит статистику
|-
|cms_stat_sources_coupon || Хранит статистику
|-
|cms_stat_sources_coupon_events || Хранит статистику
|-
|cms_stat_sources_openstat || Хранит статистику
|-
|cms_stat_sources_openstat_ad || Хранит статистику
|-
|cms_stat_sources_openstat_campaign || Хранит статистику
|-
|cms_stat_sources_openstat_service || Хранит статистику
|-
|cms_stat_sources_openstat_source || Хранит статистику
|-
|cms_stat_sources_pr || Хранит статистику
|-
|cms_stat_sources_pr_events || Хранит статистику
|-
|cms_stat_sources_pr_sites || Хранит статистику
|-
|cms_stat_sources_search || Хранит статистику
|-
|cms_stat_sources_search_engines || Хранит статистику
|-
|cms_stat_sources_search_queries || Хранит статистику
|-
|cms_stat_sources_sites || Хранит статистику
|-
|cms_stat_sources_sites_domains || Хранит статистику
|-
|cms_stat_sources_ticket || Хранит статистику
|-
|cms_stat_users || Хранит статистику
|-
|cms_stat_users_browsers || Хранит статистику
|-
|cms_stat_users_os || Хранит статистику
|-
|umi_event_feeds || Хранит события для модуля События
|-
|umi_event_types || Хранит типы событий для модуля События
|-
|umi_event_user_history || Хранит историю событий пользователей для модуля События
|-
|umi_event_users || Хранит события пользователей для модуля События
|}

[[Категория:Решение проблем и ошибок]]

Выгрузка из 1С информации по складам

2019-09-05T07:24:08Z

Vitaliks: Проверено, обновлено

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

Если Вы хотите, чтобы из 1С в систему выгружалась информация из тегов:
<source lang='xml'>
<Склад ИдСклада="6257b501-c90c-11e2-bd93-001e67494c74" КоличествоНаСкладе="84"/>
<Склад ИдСклада="885f414e-4d67-11e5-ac2e-001e67494c75" КоличествоНаСкладе="20"/>
</source>

То вам необходимо добавить следующий шаблон в файл /xsl/import/custom/commerceML2.xsl
<source lang='xml'>
<xsl:template match="ПакетПредложений">
<objects>
<xsl:for-each select="Склады/Склад">
<object id="{Ид}" type-id="81" name="{Наименование}" />
</xsl:for-each>
</objects>
<pages>
<xsl:apply-templates select="Предложения/Предложение" />
</pages>
<options>
<xsl:apply-templates select="Предложения/Предложение" mode="stores_state" />
</options>
</xsl:template>

<xsl:template match="Предложения/Предложение" mode="stores_state">
<entity page-id="{Ид}" field-name="stores_state">
<xsl:for-each select="Склад">
<option int="{@КоличествоНаСкладе}" float="0" object-id="{@ИдСклада}" />
</xsl:for-each>
</entity>
</xsl:template>
</source>
[[category:Интеграция с 1С]]

Google reCAPTCHA v3 в Demomarket

2019-08-31T10:22:42Z

Vitaliks:

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

== Задача ==
Реализовать использование Google reCaptcha v3 в шаблоне Demomarket.

== Решение ==
Для использования Google reCaptcha v3 необходимо внести небольшие изменения в несколько файлов шаблона:

===DemomarketPhpExtension.php===
Файл находится по адресу /templates/demomarket/php/library/DemomarketPhpExtension.php

В файле нужно изменить метод '''getRecaptchaUrl''' так, чтобы в GET параметре render передавался SiteKey Google reCaptcha v3:
<source lang='php'>
/**
* Возвращает url скрипта recaptcha
* @param array $variables описание страницы
*
* [
* 'lang' => string // код языка
* ]
*
* @return string
*/
public function getRecaptchaUrl(array $variables) {
$lang = isset($variables['lang']) ? $variables['lang'] : 'ru';
return "https://www.google.com/recaptcha/api.js?render=".$this->getRecaptchaSiteKey()."&onload=CaptchaCallback&render=explicit&hl={$lang}";
}
</source>

===head.phtml===
Файл находится по адресу /templates/demomarket/php/layout/head.phtml

Этот файл отвечает за код который размещается в теге <head> всех страниц сайта и тут нужно поменять код инициализации Google reCaptcha v3:
<source lang='php'>
<?php
/**
* Содержимое html-тега <head>.
*
* @var umiTemplaterPHP|ViewPhpExtension|DemomarketPhpExtension $this
* @var array $variables
*/
?>

<base href="<?= $this->getResourceDirectory() ?>">
<title><?= $this->escape($variables['title']) ?></title>

<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="<?= $this->escape($variables['meta']['description']) ?>">
<meta name="keywords" content="<?= $this->escape($variables['meta']['keywords']) ?>">
<meta name="author" content="Umisoft">

<?= $this->macros('content', 'includeFrontendResources') ?>

<link rel="stylesheet" href="compiled/demomarket.lib.min.css">
<link rel="stylesheet" href="compiled/demomarket.min.css">

<?= $this->getCanonicalLinkTag($variables) ?>

<script type="text/javascript" src="/ulang/<?= $variables['lang'] ?>/common/emarket/?js" charset="utf-8"></script>
<script src="compiled/demomarket.lib-min.js"></script>
<script src="compiled/demomarket-min.js"></script>

<?php if ($this->isRecaptchaEnabled()): ?>
<script src="<?= $this->getRecaptchaUrl($variables) ?>" async defer></script>


<script>
var CaptchaCallback = function() {
$('.g-recaptcha')
.append('<input type="hidden" name="g-recaptcha-response" class="g-recaptcha-response">')
.append('<input type="hidden" name="action" class="recaptcha-action" value="homepage">');

grecaptcha.ready(function() {
grecaptcha.execute("<?=$this->getRecaptchaSiteKey()?>", {action: 'homepage'}).then(function(token) {
$('.g-recaptcha-response').val(token);
$('.recaptcha-action').val('homepage');
});
});
};
</script>
<?php endif; ?>

<style>
<?= $this->getUserCss() ?>
</style>
</source>

===Результат===
Если все сделано правильно в правом нижнем углу сайта появится виджет:

[[Файл:Google reCaptcha v3.png]]

Благодаря тому, что Google reCaptcha v3 работает в фоне и не отвлекает пользователя от выполнения действий на сайте повышается удобство его использования и соответственно увеличивается конверсия.

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

Google reCAPTCHA v3 в Demomarket

2019-08-31T10:22:12Z

Vitaliks: Новая страница: «'''Актуально для версии 20''' == Задача == Реализовать использование Google reCaptcha v3 в шаблоне Demoma…»

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

== Задача ==
Реализовать использование Google reCaptcha v3 в шаблоне Demomarket.

== Решение ==
Для использования Google reCaptcha v3 необходимо внести небольшие изменения в несколько файлов шаблона:

===DemomarketPhpExtension.php===
Файл находится по адресу /templates/demomarket/php/library/DemomarketPhpExtension.php

В файле нужно изменить метод '''getRecaptchaUrl''' так, чтобы в GET параметре render передавался SiteKey Google reCaptcha v3:
<source lang='php'>
/**
* Возвращает url скрипта recaptcha
* @param array $variables описание страницы
*
* [
* 'lang' => string // код языка
* ]
*
* @return string
*/
public function getRecaptchaUrl(array $variables) {
$lang = isset($variables['lang']) ? $variables['lang'] : 'ru';
return "https://www.google.com/recaptcha/api.js?render=".$this->getRecaptchaSiteKey()."&onload=CaptchaCallback&render=explicit&hl={$lang}";
}
</source>

===head.phtml===
Файл находится по адресу /templates/demomarket/php/layout/head.phtml

Этот файл отвечает за код который размещается в теге <head> всех страниц сайта и тут нужно поменять код инициализации Google reCaptcha v3:
<source lang='php'>
<?php
/**
* Содержимое html-тега <head>.
*
* @var umiTemplaterPHP|ViewPhpExtension|DemomarketPhpExtension $this
* @var array $variables
*/
?>

<base href="<?= $this->getResourceDirectory() ?>">
<title><?= $this->escape($variables['title']) ?></title>

<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="<?= $this->escape($variables['meta']['description']) ?>">
<meta name="keywords" content="<?= $this->escape($variables['meta']['keywords']) ?>">
<meta name="author" content="Umisoft">

<?= $this->macros('content', 'includeFrontendResources') ?>

<link rel="stylesheet" href="compiled/demomarket.lib.min.css">
<link rel="stylesheet" href="compiled/demomarket.min.css">

<?= $this->getCanonicalLinkTag($variables) ?>

<script type="text/javascript" src="/ulang/<?= $variables['lang'] ?>/common/emarket/?js" charset="utf-8"></script>
<script src="compiled/demomarket.lib-min.js"></script>
<script src="compiled/demomarket-min.js"></script>

<?php if ($this->isRecaptchaEnabled()): ?>
<script src="<?= $this->getRecaptchaUrl($variables) ?>" async defer></script>


<script>
var CaptchaCallback = function() {
$('.g-recaptcha')
.append('<input type="hidden" name="g-recaptcha-response" class="g-recaptcha-response">')
.append('<input type="hidden" name="action" class="recaptcha-action" value="homepage">');

grecaptcha.ready(function() {
grecaptcha.execute("<?=$this->getRecaptchaSiteKey()?>", {action: 'homepage'}).then(function(token) {
$('.g-recaptcha-response').val(token);
$('.recaptcha-action').val('homepage');
});
});
};
</script>
<?php endif; ?>

<style>
<?= $this->getUserCss() ?>
</style>
</source>

===Результат===
Если все сделано правильно в правом нижнем углу сайта появится виджет:

[[Файл:Google reCaptcha v3.png]]

Благодаря тому, что Google reCaptcha v3 работает в фоне и не отвлекает пользователя от выполнения действий на сайте повышается его удобство использования и соответственно увеличивается конверсия.

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

Файл:Google reCaptcha v3.png

2019-08-31T10:09:54Z

Vitaliks:

Вывод фотографий в обратном порядке

2019-08-28T09:18:16Z

Vitaliks:

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

== Задача ==

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

== Решение ==

Для реализации данной задачи необходимо переопределить макрос album из файла /classes/components/photoalbum/macros.php в файле /classes/components/photoalbum/customMacros.php добавив к нему возможность сортировки.

1. Добавим к макросу album параметр $sort = 'asc', которым сможет принимать значения 'asc' для сортировки по умолчанию, 'desc' для вывода в обратном порядке, 'rand' для вывода в случайном порядке.

В итоге первая строка определения функции будет такой:
<source lang="php">
public function album($path = false, $template = 'default', $limit = false, $ignore_paging = false, $sort = 'asc') {
</source>
2. Добавляем в макрос конструкцию switch case для вывода фотографий в соответствии с указанным способом сортировки:
<source lang="php">
$photos->types('hierarchy-type')->name('photoalbum', 'photo');
// Сортировка
switch ($sort) {
case 'asc':
$photos->order('ord')->asc();
break;
case 'desc':
$photos->order('ord')->desc();
break;
case 'rand':
$$photos->order('rand');
break;
}

</source>

3. В итоге код макроса в файле /classes/components/photoalbum/customMacros.php должен получиться такой:
<source lang="php">
<?php

/** Класс пользовательских макросов */
class PhotoAlbumCustomMacros {

/** @var photoalbum $module */
public $module;

/**
* Возвращает фотографии заданного фотоальбома
* @param bool|int|string $path идентификатор или адрес фотоальбома
* @param string $template имя шаблона (для tpl)
* @param bool|int $limit ограничение на количество выводимых элементов
* @param bool $ignore_paging игнорировать пагинацию
* @return mixed
* @throws ErrorException
* @throws coreException
* @throws publicException
* @throws selectorException
*/
public function album($path = false, $template = 'default', $limit = false, $ignore_paging = false, $sort = 'asc') {
$curr_page = (int) getRequest('p');
$per_page = $limit ?: $this->module->per_page;

$element_id = $this->module->analyzeRequiredPath($path);

if ($element_id === false && $path != KEYWORD_GRAB_ALL) {
throw new publicException(getLabel('error-page-does-not-exist', null, $path));
}

list($template_block, $template_block_empty, $template_line) = photoalbum::loadTemplates(
'photoalbum/' . $template,
'album_block',
'album_block_empty',
'album_block_line'
);

$photos = new selector('pages');
$photos->types('hierarchy-type')->name('photoalbum', 'photo');
// Сортировка
switch ($sort) {
case 'asc':
$photos->order('ord')->asc();
break;
case 'desc':
$photos->order('ord')->desc();
break;
case 'rand':
$$photos->order('rand');
break;
}

if ($path != KEYWORD_GRAB_ALL) {
$photos->where('hierarchy')->page($element_id);
}

$photos->option('load-all-props')->value(true);
$this->module->setAlbumListLimit($photos, $curr_page, $per_page, $ignore_paging);
$result = $photos->result();
$total = $photos->length();

$block_arr = [];
$block_arr['id'] = $block_arr['void:album_id'] = $element_id;

if ($total == 0) {
return photoalbum::parseTemplate($template_block_empty, $block_arr, $element_id);
}

$lines = [];
$umiLinksHelper = umiLinksHelper::getInstance();

foreach ($result as $photo) {
$line_arr = [];

if (!$photo instanceof iUmiHierarchyElement) {
continue;
}

$photo_element_id = $photo->getId();
$line_arr['attribute:id'] = $photo_element_id;
$line_arr['attribute:link'] = $umiLinksHelper->getLinkByParts($photo);
$line_arr['xlink:href'] = 'upage://' . $photo_element_id;
$line_arr['node:name'] = $photo->getName();

photoalbum::pushEditable('photoalbum', 'photo', $photo_element_id);
$lines[] = photoalbum::parseTemplate($template_line, $line_arr, $photo_element_id);
}

$block_arr['subnodes:items'] = $block_arr['void:lines'] = $lines;
$block_arr['total'] = $total;
$block_arr['per_page'] = $per_page;
$block_arr['link'] = umiHierarchy::getInstance()->getPathById($element_id);
return photoalbum::parseTemplate($template_block, $block_arr, $element_id);
}
}

</source>

Теперь в макросе album можно использовать пятый, необязательный параметр, устанавливая его в значение 'asc', 'desc' или 'rand'.

Вызов в PHP:
<source lang="php">
$albums = $this->macros('photoalbum', 'album', [$page->getId(),null,null,null,'desc']);
</source>
Вызов в XSLT:
<source lang="xml">
<xsl:variable name="albums" select="document('udata://photoalbum/album/47////desc/')/udata" />
</source>
Вызов в TPL:
<source lang="php">
%photoalbum album('47',0,0,0,'desc')%
</source>

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

Кастомизация маршрутизации путей в системе

2019-08-28T09:13:12Z

Vitaliks: Новая страница: «'''Актуально для версии 20''' == Задача == Иногда появляется необходимость, что-бы по определ…»

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

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

Например сделать чтобы по адресу site.ru/order/ открывалось "Оформление заказа в один клик" site.ru/emarket/purchasing_one_step/

== Решение ==
Эту задачу можно решить при помощи кастомизации роутинга (маршрутизации) в системе. Для этого мы воспользуемся событием 'routing'.

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

Создадим слушатель в модуле Интернет-магазин (emarket), для этого в директории /classes/components/emarket/ добавим файл '''custom_events.php''' со следующим содержимым:
<source lang="php">
<?php
new umiEventListener("routing", "emarket", "route");
?>

</source>

В файл '''customMacros.php''' добавляем метод для обработки события и класс '''FakeRouter''' с методом '''analyzePath''' для обработки адреса:
<source lang="php">
<?php
use UmiCms\Service;
/**
* Класс пользовательских макросов
*/
class EmarketCustomMacros {
/**
* @var emarket $module
*/
public $module;

public function route(iUmiEventPoint $eventPoint) {
if (Service::Request()->isAdmin() || $eventPoint->getMode() !== 'before') {
return;
}

$request = Service::Request();
$path = $request->getPath();

if ($path == 'order') {
$router = new FakeRouter('emarket','purchasing_one_step');
$eventPoint->setParam('router', $router);
}
}
}

class FakeRouter {

private $module;

private $method;

private $elementId;

function __construct($module, $method, $elementId = false) {
$this->module = $module;
$this->method = $method;
$this->elementId = $elementId;
}

public function analyzePath() {
$cmsController = cmsController::getInstance();
$cmsController->setCurrentModule($this->module);
$cmsController->setCurrentMethod($this->method);
$cmsController->setCurrentElementId($this->elementId);
}
}
?>

</source>

Теперь при переходе по адресу site.ru/order/ будет открываться страница "Оформление заказа в один клик".

[[category:Написание кастомных макросов]]

Что такое Cron.php и для чего он нужен

2019-06-28T10:02:16Z

Vitaliks: Vitaliks переименовал страницу Что такое Cron.php и для чего он нужен? в Что такое Cron.php и для чего он нужен

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

== Что такое Сron.php? ==

Сron.php - это скрипт позволяющий настроить выполнение определенных действий в системе по расписанию без участия администратора сайта.

== Настройка выполнения Cron.php ==

Алгоритм настройки выполнения Cron.php зависит от используемого хостинга.

Обычно в админке хостинга есть раздел с названием «Планировщик заданий» или «Управление Crontab» в котором и выполняется настройка.

Запускать Cron.php можно командой

<source lang='bash'>
wget http://ваш_сайт/cron.php
</source>

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

О различных вариантах запуска Cron.php описано в нашей документации:

http://dev.docs.umi-cms.ru/nastrojka_sistemy/cron/

== Системные функции Сron.php в модулях ==

Тут перечислены системные модули и функции в них которые могут выполняться при запуске Cron.php.

При необходимости вы можете добавить свои функции, которые будут выполняться по расписанию, например:

[http://wiki.umisoft.ru/%D0%9E%D1%87%D0%B8%D1%81%D1%82%D0%BA%D0%B0_%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA%D0%B0_%22%D0%9D%D0%B5%D0%B7%D0%B0%D1%80%D0%B5%D0%B3%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BF%D0%BE%D0%BA%D1%83%D0%BF%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%22_%D0%BF%D0%BE_cron Очистка справочника "Незарегистрированный покупатель" по cron]

[http://wiki.umisoft.ru/Автоматическая_подготовка_экспорта_в_формат_YML_с_помощью_cron Автоматическая подготовка экспорта в формат YML с помощью cron]

=== Интеренет-магазин (emarket) ===
'''onCronSyncCurrency''' - Синхронизирует курсы валют с цб

'''onCronCheckExpiredCustomers''' - Удаляют "просроченные" объекты незарегистрированных покупателей

'''onCronCheckExpiredOrders''' - Удаляют "просроченные" объекты незавершенных заказов

'''onCronCheckExpiredCustomersOneClick''' - Удаляют "просроченные" объекты незавершенных заказов в 1 клик

=== Резервирование (backup) ===
'''onCronCleanChangesHistory''' - Очищает историю изменений модуля "Резервирование" в соответствии с настройками времени хранения событий

=== Конфигурация (config) ===
'''maintainDataBaseCache''' - Выполняет операции по обслуживанию кеширования через базу данных

'''runGarbageCollector''' - Запускает системный сборщик мусора(в частности устаревшие файлы файлового кэша и мусор в БД);

=== Структура (content) ===
'''cronSendNotification''' - Проверяет необходимость послать уведомление об окончании срока публикации, и, соответственно, посылка таковых;

'''cronUnpublishPage''' - Проверяет окончание срока публикации и деактивация таких объектов;

=== Новости (news) ===
'''feedsImportListener''' - Импортирует все фиды RSS.

'''cronActivateNews''' - Активирует новости с подходящей датой публикации

=== Каталог (catalog) ===
'''reIndexOnCron''' - Выполняет переиндексацию фильтров разделов каталога

=== Рассылки (dispatches) ===
'''onAutosendDispathes''' - Выполняет отправку запланированных рассылок

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

Что такое Cron.php и для чего он нужен?

2019-06-28T10:02:16Z

Vitaliks: Vitaliks переименовал страницу Что такое Cron.php и для чего он нужен? в Что такое Cron.php и для чего он нужен

#перенаправление [[Что такое Cron.php и для чего он нужен]]

Что такое Cron.php и для чего он нужен

2019-06-28T09:59:55Z

Vitaliks: Об

Получение доступа к методам модулей

2019-06-28T08:13:06Z

Vitaliks: Проверена актуальность

[[category:Написание кастомных макросов]]
'''Актуально для версии 20'''

Для того, чтобы получить доступ к методам какого либо модуля, необходимо получить
экземпляр этого модуля. Допустим, если необходимо в кастомном методе выполнить метод
basket, модуля emarket, то берем экземпляр этого модуля и выполняем нужный метод:
<source lang="php">
$ini = cmsController::getInstance()->getModule('emarket');
$ini->basket('put', 'element', 45);
</source>

Аналогичный принцип и для всех остальных модулей.

Использование серверных переменных в XSLT-шаблонах

2019-06-26T12:34:50Z

Vitaliks: Проверена актуальность

[[category:Верстка в XSLT]]
'''Актуально для версии 20'''

В UMI.CMS предусмотрена возможность использования серверных переменных (массив $_SERVER) в XSLT-шаблонах. Для этого серверные переменные необходимо инициализировать как глобальные параметры в шаблоне при помощи инструкции <xsl:param> (после инструкции <xsl:output>, на одном уровне c <xsl:template>).

Имя параметра должно начинаться с "_" (нижнее подчеркивание), например: '''_http_user_agent'''. После этого параметр можно использовать в шаблоне указав '''$_http_user_agent'''.

Например, если создать следующий шаблон:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" encoding="UTF-8" indent="yes"/>

<xsl:param name="_request_time" />
<xsl:param name="_query_string" />
<xsl:param name="_http_accept" />
<xsl:param name="_http_accept_charset" />
<xsl:param name="_http_accept_encoding" />
<xsl:param name="_http_accept_language" />
<xsl:param name="_http_host" />
<xsl:param name="_http_referer" />
<xsl:param name="_http_user_agent" />
<xsl:param name="_remote_addr" />
<xsl:param name="_remote_host" />
<xsl:param name="_request_uri" />



<xsl:template match="/">

<html>

<head></head>

<body>

<ul>
<li>$_request_time: <xsl:value-of select="$_request_time" /></li>
<li>$_query_string: <xsl:value-of select="$_query_string" /></li>
<li>$_http_accept: <xsl:value-of select="$_http_accept" /></li>
<li>$_http_accept_charset: <xsl:value-of select="$_http_accept_charset" /></li>
<li>$_http_accept_encoding: <xsl:value-of select="$_http_accept_encoding" /></li>
<li>$_http_accept_language: <xsl:value-of select="$_http_accept_language" /></li>
<li>$_http_host: <xsl:value-of select="$_http_host" /></li>
<li>$_http_referer: <xsl:value-of select="$_http_referer" /></li>
<li>$_http_user_agent: <xsl:value-of select="$_http_user_agent" /></li>
<li>$_remote_addr: <xsl:value-of select="$_remote_addr" /></li>
<li>$_remote_host: <xsl:value-of select="$_remote_host" /></li>
<li>$_request_uri: <xsl:value-of select="$_request_uri" /></li>
</ul>

<p>
<xsl:choose>
<xsl:when test="contains($_http_user_agent, 'Firefox')">
<xsl:text>You are using Firefox.</xsl:text>
</xsl:when>
<xsl:when test="contains($_http_user_agent, 'Chrome')">
<xsl:text>You are using Chrome.</xsl:text>
</xsl:when>
<xsl:when test="contains($_http_user_agent, 'MSIE')">
<xsl:text>You are using MSIE.</xsl:text>
</xsl:when>
<xsl:when test="contains($_http_user_agent, 'Opera')">
<xsl:text>You are using Opera.</xsl:text>
</xsl:when>
<xsl:when test="contains($_http_user_agent, 'Safari')">
<xsl:text>You are using Safari.</xsl:text>
</xsl:when>
<xsl:otherwise>
<xsl:text>Browser was not identified.</xsl:text>
</xsl:otherwise>
</xsl:choose>
</p>

</body>

</html>

</xsl:template>

</xsl:stylesheet>
</source>

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

<source lang="text">
* $_request_time: 1283867773
* $_query_string: path=about/
* $_http_accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
* $_http_accept_charset: windows-1251,utf-8;q=0.7,*;q=0.7
* $_http_accept_encoding: gzip,deflate
* $_http_accept_language: ru,en-us;q=0.7,en;q=0.3
* $_http_host: localhost
* $_http_referer:
* $_http_user_agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; ru; rv:1.9.2.8) Gecko/20100722 Firefox/3.6.8
* $_remote_addr: 127.0.0.1
* $_remote_host:
* $_request_uri: /about/

You are using Firefox.
</source>

Файл:RBS.zip

2019-06-11T08:54:45Z

Vitaliks: Vitaliks загрузил новую версию Файл:RBS.zip

Файл:RBS.zip

2019-06-05T14:38:12Z

Vitaliks: Vitaliks загрузил новую версию Файл:RBS.zip

Файл:RBS.zip

2019-06-04T11:49:46Z

Vitaliks: Vitaliks загрузил новую версию Файл:RBS.zip

Добавление способа оплаты Сбербанк эквайринг

2019-06-04T11:47:55Z

Vitaliks:

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

== Задача ==

Добавить способ оплаты Сбербанк эквайринг.

== Решение ==

=== Установка способа оплаты ===

Для установки способа оплаты Сбербанк эквайринг нужно скачать [[Файл:RBS.zip]] со следующими файлами:

# Директория classes - содержит классы и методы необходимые для работы способа оплаты. <br> Eе нужно скопировать в корень сайта и проверить, что файл rbs.php появился в директории ~/classes/modules/emarket/classes/payment/systems/
# Директория templates - содержит шаблон для отображения способа оплаты на сайте. <br> Папку 'php' необходимо скопировать в директорию с шаблоном: ~/templates/{Ваш шаблон}/. В директории ~/templates/{Ваш шаблон}/php/emarket/payment/ должен появиться файл rbs.phtml.
# rbspayment_install.php - установщик, который создает тип данных способа оплаты RBS Payment со всеми необходимыми полями. <br> Этот файл нужно разместить в корневую папку сайта и запустить его <nowiki>http://{Ваш сайт}/rbspayment_install.php</nowiki>

=== Настройка способа оплаты ===

Для добавления способа оплаты нужно в модуле Интернет-магазин на вкладке Оплата нажать кнопку Добавить способ и выбрать "RBS Payment".

Для работы оплаты необходимо заполнить поля:

# Логин - Логин магазина, полученный при подключении
# Пароль - Пароль магазина, полученный при подключении

Необязательные поля:

# Двух-стадийность платежа - использование дополнительного подтверждения платежеспособности карты с блокированием средств на счету клиента
# Тестовый режим - использование тестового платежного шлюза
# Передавать данные для печати чека - передавать данные для печати чека по ФЗ-54
# Вести журнал - в файл rbs_payment.log в корне сайта будет записываться лог ответов от платежного шлюза

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

=== Итоги ===

Мы установили и настроили способ оплаты Сбербанк эквайринг и теперь он доступен во время оформления заказа при выборе способа оплаты:

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

Добавление способа оплаты Сбербанк эквайринг

2019-06-04T11:47:35Z

Vitaliks: Новая страница: «'''Актуально для версии 20.''' == Задача == Добавить способ оплаты Сбербанк эквайринг. == Реше…»

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

== Задача ==

Добавить способ оплаты Сбербанк эквайринг.

== Решение ==

=== Установка способа оплаты ===

Для установки способа оплаты Сбербанк эквайринг нужно скачать [[Файл:RBS.zip]] со следующими файлами:

# Директория classes - содержит классы и методы необходимые для работы способа оплаты. <br> Eе нужно скопировать в корень сайта и проверить, что файл rbs.php появился в директории ~/classes/modules/emarket/classes/payment/systems/
# Директория templates - содержит шаблон для отображения способа оплаты на сайте. <br> Папку 'php' необходимо скопировать в директорию с шаблоном: ~/templates/{Ваш шаблон}/. В директории ~/templates/{Ваш шаблон}/php/emarket/payment/ должен появиться файл rbs.phtml.
# rbspayment_install.php - установщик, который создает тип данных способа оплаты RBS Payment со всеми необходимыми полями. <br> Этот файл нужно разместить в корневую папку сайта и запустить его <nowiki>http://{Ваш сайт}/rbspayment_install.php</nowiki>

=== Настройка способа оплаты ===

Для добавления способа оплаты нужно в модуле Интернет-магазин на вкладке Оплата нажать кнопку Добавить способ и выбрать "RBS Payment".

Для работы оплаты необходимо заполнить поля:

# Логин - Логин магазина, полученный при подключении
# Пароль - Пароль магазина, полученный при подключении

Необязательные поля:

# Двух-стадийность платежа - использование дополнительного подтверждения платежеспособности карты с блокированием средств на счету клиента
# Тестовый режим - использование тестового платежного шлюза
# Передавать данные для печати чека - передавать данные для печати чека по ФЗ-54
# Вести журнал - в файл rbs_payment.log в корне сайта будет записываться лог ответов от платежного шлюза

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

=== Итог ===

Мы установили и настроили способ оплаты Сбербанк эквайринг и теперь он доступен во время оформления заказа при выборе способа оплаты:

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

Файл:Sbs pay.png

2019-06-04T11:46:22Z

Vitaliks:

Файл:Sbr.png

2019-06-04T11:10:52Z

Vitaliks:

Файл:RBS.zip

2019-06-04T10:25:24Z

Vitaliks:

Автоматическое копирование фотографии в другую языковую версию

2019-05-31T12:06:41Z

Vitaliks:

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

== Задача ==

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

== Решение ==

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

1. Для добавления обработчика события нужно создать файл ~/classes/components/content/custom_events.php и в него добавить сдедующий код::
<source lang="php">
<?php
new umiEventListener('systemCreateElement', 'content', 'copy_on_other_lang');

</source>

2. Сам обработчик нужно поместить в файл ~/classes/components/content/customMacros.php. Код обработчика будет примерно следующий:
<source lang="php">
<?php

/** Класс пользовательских макросов */
class ContentCustomMacros {

/** @var content $module */
public $module;

public function copy_on_other_lang(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "after") {
$object = $oEventPoint->getRef("element");
$module = $object->getModule();
//Если модуль photoalbum, выполняем копирование
if ($module == 'photoalbum') {
$hierarchy = umiHierarchy::getInstance();
$parentId = $object->getParentId();
$newPhoto = $hierarchy->copyElement($object->id, $parentId);
$hierarchy = umiHierarchy::getInstance();
$photo = $hierarchy->getElement($newPhoto);
$photo->setLangId(2);
$hierarchy->moveFirst($newPhoto, 343);
$photo->commit();
}
return true;
}
}
}

?>
</source>
в данном случае, при добавлении фотографии будет создана её виртуальная копия в языковой версии с id 2 в фотогалерею с id 343. Если требуется производить копирование ещё в несколько языковых версий, следует повторить для каждой языковой версии участок кода
<source lang="php">
<?php
$newPhoto = $hierarchy->copyElement($object->id, $parentId);
$hierarchy = umiHierarchy::getInstance();
$photo = $hierarchy->getElement($newPhoto);
$photo->setLangId(/*id_языковой_версии*/);
$hierarchy->moveFirst($newPhoto, /*id_фотогалереи_в_другой_языковой_версии*/);
$photo->commit();
?>
</source>
указывая необходимые id языковой версии и фотогалереи в ней. Если требуется копирование страницы, а не создание виртуальной копии, то в обработчике нужно заменить copyElement на cloneElement.

3. Для работы обработчика, необходимо добавить в файл ~/classes/components/content/permissions.custom.php права на этот кастомный метод:
<source lang="php">
<?php
$permissions = Array(
'sitetree' => Array('copy_on_other_lang')
);

</source>

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

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

Автоматическое копирование фотографии в другую языковую версию

2019-05-31T12:00:44Z

Vitaliks:

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

== Задача ==

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

== Решение ==

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

1. Для добавления обработчика события нужно создать файл ~/classes/components/content/custom_events.php и в него добавить сдедующий код::
<source lang="php">
<?php
new umiEventListener('systemCreateElement', 'content', 'copy_on_other_lang');

</source>

2. Сам обработчик нужно поместить в файл ~/classes/components/content/customMacros.php. Код обработчика будет примерно следующий:
<source lang="php">
<?php

/** Класс пользовательских макросов */
class ContentCustomMacros {

/** @var content $module */
public $module;

public function copy_on_other_lang(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "after") {
$object = $oEventPoint->getRef("element");
$module = $object->getModule();
//Если модуль photoalbum, выполняем копирование
if ($module == 'photoalbum') {
$hierarchy = umiHierarchy::getInstance();
$parentId = $object->getParentId();
$newPhoto = $hierarchy->copyElement($object->id, $parentId);
$hierarchy = umiHierarchy::getInstance();
$photo = $hierarchy->getElement($newPhoto);
$photo->setLangId(2);
$hierarchy->moveFirst($newPhoto, 343);
$photo->commit();
}
return true;
}
}
}

?>
</source>
в данном случае, при добавлении фотографии будет создана её виртуальная копия в языковой версии с id 2 в фотогалерею с id 343. Если требуется производить копирование ещё в несколько языковых версий, следует повторить для каждой языковой версии участок кода
<source lang="php">
<?php
$newPhoto = $hierarchy->copyElement($object->id, $parentId);
$hierarchy = umiHierarchy::getInstance();
$photo = $hierarchy->getElement($newPhoto);
$photo->setLangId(/*id_языковой_версии*/);
$hierarchy->moveFirst($newPhoto, /*id_фотогалереи_в_другой_языковой_версии*/);
$photo->commit();
?>
</source>
указывая необходимые id языковой версии и фотогалереи в ней. Если требуется копирование страницы, а не создание виртуальной копии, то в обработчике нужно заменить copyElement на cloneElement.
3. Для работы обработчика, необходимо добавить в файл ~/classes/components/content/permissions.custom.php права на этот кастомный метод:
<source lang="php">
<?php
$permissions = Array(
'sitetree' => Array('copy_on_other_lang')
);

</source>

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

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

Вывод фотографий в обратном порядке

2019-05-31T10:11:07Z

Vitaliks: Обновлено

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

== Задача ==

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

== Решение ==

Для реализации данной задачи необходимо переопределить макрос album из файла /classes/components/photoalbum/macros.php в файле /classes/components/photoalbum/customMacros.php добавив к нему возможность сортировки.

1. Добавим к макросу album параметр $sort = 'asc', которым сможет принимать значения 'asc' для сортировки по умолчанию, 'desc' для вывода в обратном порядке, 'rand' для вывода в случайном порядке.

В итоге первая строка определения функции будет такой:
<source lang="php">
public function album($path = false, $template = 'default', $limit = false, $ignore_paging = false, $sort = 'asc') {
</source>
2. Добавляем в макрос конструкцию switch case для вывода фотографий в соответствии с указанным способом сортировки:
<source lang="php">
$photos->types('hierarchy-type')->name('photoalbum', 'photo');
// Сортировка
switch ($sort) {
case 'asc':
$photos->order('ord')->asc();
break;
case 'desc':
$photos->order('ord')->desc();
break;
case 'rand':
$$photos->order('rand');
break;
}

</source>

3. В итоге код макроса в файле /classes/components/photoalbum/customMacros.php должен получиться такой:
<source lang="php">
<?php

/** Класс пользовательских макросов */
class PhotoAlbumCustomMacros {

/** @var photoalbum $module */
public $module;

/**
* Возвращает фотографии заданного фотоальбома
* @param bool|int|string $path идентификатор или адрес фотоальбома
* @param string $template имя шаблона (для tpl)
* @param bool|int $limit ограничение на количество выводимых элементов
* @param bool $ignore_paging игнорировать пагинацию
* @return mixed
* @throws ErrorException
* @throws coreException
* @throws publicException
* @throws selectorException
*/
public function album($path = false, $template = 'default', $limit = false, $ignore_paging = false, $sort = 'asc') {
$curr_page = (int) getRequest('p');
$per_page = $limit ?: $this->module->per_page;

$element_id = $this->module->analyzeRequiredPath($path);

if ($element_id === false && $path != KEYWORD_GRAB_ALL) {
throw new publicException(getLabel('error-page-does-not-exist', null, $path));
}

list($template_block, $template_block_empty, $template_line) = photoalbum::loadTemplates(
'photoalbum/' . $template,
'album_block',
'album_block_empty',
'album_block_line'
);

$photos = new selector('pages');
$photos->types('hierarchy-type')->name('photoalbum', 'photo');
// Сортировка
switch ($sort) {
case 'asc':
$photos->order('ord')->asc();
break;
case 'desc':
$photos->order('ord')->desc();
break;
case 'rand':
$$photos->order('rand');
break;
}

if ($path != KEYWORD_GRAB_ALL) {
$photos->where('hierarchy')->page($element_id);
}

$photos->option('load-all-props')->value(true);
$this->module->setAlbumListLimit($photos, $curr_page, $per_page, $ignore_paging);
$result = $photos->result();
$total = $photos->length();

$block_arr = [];
$block_arr['id'] = $block_arr['void:album_id'] = $element_id;

if ($total == 0) {
return photoalbum::parseTemplate($template_block_empty, $block_arr, $element_id);
}

$lines = [];
$umiLinksHelper = umiLinksHelper::getInstance();

foreach ($result as $photo) {
$line_arr = [];

if (!$photo instanceof iUmiHierarchyElement) {
continue;
}

$photo_element_id = $photo->getId();
$line_arr['attribute:id'] = $photo_element_id;
$line_arr['attribute:link'] = $umiLinksHelper->getLinkByParts($photo);
$line_arr['xlink:href'] = 'upage://' . $photo_element_id;
$line_arr['node:name'] = $photo->getName();

photoalbum::pushEditable('photoalbum', 'photo', $photo_element_id);
$lines[] = photoalbum::parseTemplate($template_line, $line_arr, $photo_element_id);
}

$block_arr['subnodes:items'] = $block_arr['void:lines'] = $lines;
$block_arr['total'] = $total;
$block_arr['per_page'] = $per_page;
$block_arr['link'] = umiHierarchy::getInstance()->getPathById($element_id);
return photoalbum::parseTemplate($template_block, $block_arr, $element_id);
}
}

</source>

Теперь в макросе album можно использовать пятый, необязательный параметр, устанавливая его в значение 'asc', 'desc' или 'rand'.

Вызов в PHP:
<source lang="php">
$albums = $this->macros('photoalbum', 'album', [$page->getId(),null,null,null,'desc']);
</source>
Вызов в XSLT:
<source lang="xml">
<xsl:variable name="albums" select="document('udata://photoalbum/album/47////desc/')/udata" />
</source>
Вызов в TPL:
<source lang="tpl">
%photoalbum album('47',0,0,0,'desc')%
</source>

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

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

2019-05-31T07:59:33Z

Vitaliks:

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

== Задача ==

Реализовать автоматическую подготовку экспорта в формат YML c помощью cron.

== Решение ==

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

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

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

</source>

2) В файле classes/components/exchange/customMacros.php добавьте следующий код:

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

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

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

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

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

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

В коде необходимо указать идентификатор экспорта данных в YML настроенного в модуле Обмен данными. Его можно посмотреть в адресной строке при редактировании экспорта данных или на вкладке Экспорт данных при наведении:

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

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

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

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

Файл:Export YML id.png

2019-05-31T07:56:33Z

Vitaliks:

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

2019-05-31T07:30:57Z

Vitaliks: проверено, обновлено

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

== Задача ==

Сделать активными только импортируемые товары, все остальные товары в каталоге должны стать неактивными.

== Решение ==

В директорию \classes\components\exchange\ нужно добавить файл custom_events.php со следующим содержанием:

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

</source>

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

<source lang="php">
<?php

/** Класс пользовательских макросов */
class ExchangeCustomMacros {

/** @var exchange $module */
public $module;

public function onExchangeDisactivateElements(iUmiEventPoint $event) {
if ($event->getMode() === 'after') {
return;
}

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

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

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

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

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

$element->setIsActive(true);
}

public function onImportFinishUnsetFlag(iUmiEventPoint $event) {
if (file_exists("onExchangeDisactivateElementsFlag")) {
unlink("onExchangeDisactivateElementsFlag");
}
}
}

</source>

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

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

Категория:Верстка в PHP

2019-05-30T11:23:29Z

Vitaliks:

'''Документация:'''
*PHP-шаблонизатор UMI.CMS [http://dev.docs.umi-cms.ru/shablony_i_makrosy/php-shablonizator_umi_cms/ dev.docs.umi-cms.ru/shablony_i_makrosy/php-shablonizator_umi_cms/]

{{Индекс категории}}

Файл настроек config.ini

2019-05-30T11:17:45Z

Vitaliks:

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

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

Начиная с версии 2.8.х появился основной файл настройки системы '''config.ini''', который располагается в корневой директории DOCUMENT_ROOT и содержит большинство настроек системы. Туда переехали почти все константы, многие настройки из реестра и появились совершенно новые. [http://help-dev.umi-cms.ru/part.Config.syntax.html Синтаксис config.ini]

[http://dev.docs.umi-cms.ru/nastrojka_sistemy/dostupnye_sekcii/ Описание в документации]

== Пример ==
<source lang="ini">
; Настройки защиты от спама
[anti-spam]
; Включить или отключить службу.
service.enabled = "0"
; Имя используемой службы.
service.name = "akisment"
; API-ключ для анти-спам сервиса по умолчанию "Akisment"
akisment.wp-api-key = "6317fd125041"
; Включить или отключить CAPTCHA.
captcha.enabled = "1"
; Класс отрисовки изображений. Можно заменить стандартную отрисовку CAPTCHA.
captcha.drawer = "default"

; Настройки кэширования системы
[cache]
; Текущий кэширующий механизм.
; На текущий момент доступны: memcache, memcached, fs, database, redis.
engine = ""
; Включение/выключение режима отладки динамического кеширования
engine.debug = "0"
; Включает кэширование протоколов. Доступно через административную панель
; (раздел «Конфигурация», вкладка «Производительность»)
streams.cache-enabled = "0"
; Указывает время жизни кэша протоколов в секундах. Доступно через административную
; панель (раздел «Конфигурация», вкладка «Производительность»)
streams.cache-lifetime = "3600"
; Список IP адресов, при заходе с которых данные не будут загружаться из кэша.
filter.ip[] = ""
; Валидатор ключей кеша. Значения:
; WhiteList - валидация по белому списку. Будет кешироваться только то, что указано в опции whitelist[].
; BlackList - валидация по черном списку. Не будет кешироваться то, что указано в опции blacklist[].
; MixedList - валидация по черному и белому списку. По умолчанию ключ невалиден, проверка по черному списку имеет больший приоритет.
key-validator = "BlackList"
; Вхождения в ключи, которые нужно кешировать.
whitelist[] = ""
; Вхождения в ключи, которые не нужно кешировать. Не рекомендуется удалять методы, указанные по умолчанию.
blacklist[] = "appointment/getAppointmentsData"
blacklist[] = "appointment/postAppointment"
blacklist[] = "emarket/basket"
blacklist[] = "emarket/purchase"
blacklist[] = "emarket/getCompareList"
blacklist[] = "emarket/ordersList"
blacklist[] = "emarket/compare"
blacklist[] = "emarket/getCompareList"
blacklist[] = "emarket/purchasing_one_step"
blacklist[] = "emarket/price"
blacklist[] = "ApiShip"
blacklist[] = "emarket/getOrderDeliveryAddress"
blacklist[] = "blogs20/postEdit"
blacklist[] = "blogs20/postAdd"
blacklist[] = "blogs20/commentAdd"
blacklist[] = "blogs20/itemDelete"
blacklist[] = "blogs20/editUserBlogs"
blacklist[] = "comments/post"
blacklist[] = "comments/comment"
blacklist[] = "dispatches/subscribe"
blacklist[] = "dispatches/subscribe_do"
blacklist[] = "dispatches/unsubscribe"
blacklist[] = "filemanager/download"
blacklist[] = "forum/message"
blacklist[] = "forum/topic_post"
blacklist[] = "forum/message_post"
blacklist[] = "forum/topic_post_do"
blacklist[] = "forum/message_post_do"
blacklist[] = "faq/addQuestionForm"
blacklist[] = "faq/post_question"
blacklist[] = "system/includeEditInPlaceJs"
blacklist[] = "system/numpages"
blacklist[] = "system/listErrorMessage"
blacklist[] = "system/captcha"
blacklist[] = "search/search_do"
blacklist[] = "search/insert_form"
blacklist[] = "tickets/manage"
blacklist[] = "content/getRecentPages"
blacklist[] = "content/getMobileModesList"
blacklist[] = "content/ieditor"
blacklist[] = "content/getImageData"
blacklist[] = "users/settings"
blacklist[] = "users/activate"
blacklist[] = "users/registrate_done"
blacklist[] = "users/restore"
blacklist[] = "users/forget_do/"
blacklist[] = "users/login_do/"
blacklist[] = "users/loadUserSettings/"
blacklist[] = "users/saveUserSettings/"
blacklist[] = "data/getEditForm"
blacklist[] = "data/getCreateForm"
blacklist[] = "vote/post"
blacklist[] = "vote/poll"
blacklist[] = "vote/results"
blacklist[] = "webforms/posted"
blacklist[] = "webforms/send"
blacklist[] = "core/navibar"
blacklist[] = "dispatches/subscribe_do"
blacklist[] = "includeQuickEditJs"
blacklist[] = "includeFrontendResources"
; В последних версиях системы является устаревшим аналогом blacklist[]
not-allowed-methods[] = ""
; В последних версиях системы является устаревшим аналогом blacklist[]
not-allowed-streams[] = ""
; Настройки механизма кеширования Redis
; Адрес хоста сервера Redis
redis.host = "localhost"
; Порт сервера Redis
redis.port = "6379"
; Имя базы Redis
redis.base = "1"
; Пароль для доступа к Redis
redis.auth = ""
; Настройки механизма кеширования memcache
; Адрес сервера memcache, или путь к unix.socket.
memcache.host = "localhost"
; Порт для подключения к memcachе. При использовании unix socket значение =0.
memcache.port = "11211"
; Включение/выключение сжатия сохраняемых данных (с помощью zlib)
memcache.compress = "0"
; Адрес сервера memcached
memcached.host = "localhost"
; Порт для подключения к memcached
memcached.port = "11211"
; Включение/выключение статического кэширования
static.enabled = "0"
; Режим работы статического кэширования. Возможные значения:
; normal - Значение по умолчанию. Время хранения кэша — 24 часа.
; short - Время хранения кэша — 10 минут.
; long - Время хранения кэша — 1 месяц.
; nginx - Управляется настройками nginx.
static.mode = "normal"
; Включает режим отладки статического кэша.
static.debug = "0"
; Создавать отдельный статический кеш для мобильных устройств.
static.cache-for-mobile-devices = "1"
; Реализация браузерного кеширования. Возможные значения:
; None - браузерное кеширование отключено
; LastModified - браузерное кеширование с помощью заголовка "Last-Modified"
; Expires - браузерное кешированиt с помощью заголовка "Expires"
browser.engine = "None"
; Опция управления директивой ответа заголовка Cache-Control (возможные значения: private или public)
browser.cache-control = "private"
; Время жизни кеша для заголовка "Expires"
browser.expires.time-to-live = "86400"

; Настройки сторонних скинов
[casual-skins]
; Настройки скинов Edit-in-place.
_eip[] = "content::eip_add_page"
; Настройки решений.
solutions[] = "config::getFullSolutionList"

; Настройка подключения к базе данных.
[connections]
; Тип подключения
core.type = "mysql"
; Хост
core.host = "localhost"
; Логин
core.login = "ipumisoftr_umi0"
; Пароль
core.password = "g6$Pp3T@6AYo"
; Имя базы данных
core.dbname = "ipumisoftr_umi0"
; Порт
core.port = ""
; Постоянное соединение
core.persistent = "0"
; Использовать сжатие при передачи данных между БД и системой
core.compression = "0"
; Название API для работы с бд (mysql или mysqli).
core.api = "mysql"

; Настройки режима отладки
[debug]
; Включить режим отладки
enabled = "0"
; Вывод ошибок только для посетителей с указанными ip.
filter.ip[] = ""
; Включить отображение отладочной информации в сообщениях о неперехваченных исключениях.
; Эта информация может быть полезной при обращении в Службу Заботы, однако, из соображений
; безопасности по умолчанию эта опция отключена
show-backtrace = "0"
; Вывод отладочной информации только для посетителей с указанными ip.
allowed-ip[] = ""
; Выключить вывод стека вызовов, при использовании флага "?showStreamsCalls=1" в адресе страницы
callstack.disabled = "0"
; Включает/отключает ведение лога неперехваченных исключений. Информация сохраняется в директорию errors/logs.
log-exceptions = "0"
; Отображать ошибки при аварийном завершении запроса
handle-shutdown = "0"

; Настройки edit-in-place
[edit-in-place]
; Список типов для edit-in-place. Эти настройки менять не рекомендуется.
allowed-types[] = "content::page <- *"
allowed-types[] = "news::rubric <- *"
allowed-types[] = "news::item <- news::rubric"
allowed-types[] = "catalog::category <- *"
allowed-types[] = "catalog::object <- catalog::category"
allowed-types[] = "faq::project <- *"
allowed-types[] = "faq::category <- faq::project"
allowed-types[] = "faq::question <- faq::category"
allowed-types[] = "forum::conf <- *"
allowed-types[] = "forum::topic <- forum::conf"
allowed-types[] = "filemanager::shared_file <- *"
allowed-types[] = "photoalbum::album <- *"
allowed-types[] = "photoalbum::photo <- photoalbum::album"
allowed-types[] = "blogs20::blog <- *"
allowed-types[] = "blogs20::post <- blogs20::blog"
; Путь до файла стилей панели быстрого редактирования.
theme = "~/styles/skins/_eip/css/theme.css"
; Определяет стиль редактирования текстовых полей. Возможные значения:
; inline - Текстовые поля редактируются в стандартном виде (textarea).
; tinymce47 - При редактировании текстовых полей подключается WYSIWYG "TinyMCE".
wysiwyg = "tinymce47"

; Список путей, используемых системой.
; С их помощью можно значительно преобразовать структуру файловой системы
[includes]
; Ядро системы
system.kernel = "~/classes/system/"
; Классы внутренних протоколов
system.kernel.streams = "~/classes/system/subsystems/streams/"
; Класс базового модуля
system.default-module = "~/classes/modules/"
; Классы модулей
system.modules = "~/classes/modules/"
; Классы виртуальных модулей
system.virtual-modules = "~/classes/modules/"
; Библиотечные файлы (в данный момент поддерживается только частично)
system.libs = "~/libs/"
; Папка для временных операций, которыми занимаются манифесты.
system.manifest = "~/sys-temp/manifest/"
; Временные файлы системы
system.runtime-cache = "~/sys-temp/runtime-cache/"
; Папка для временных операций статического кэширования
system.static-cache = "~/sys-temp/static-cache/"
; Страницы ошибок
system.error = "~/errors/"
; Страница-заглушка
system.stub = "~/errors/stub.php"
; Скины
templates.skins = "~/styles/skins/{skin}/"
; Tpl-шаблоны (в пути можно указывать макросы {lang} и {domain})
templates.tpl = "~/tpls/"
; Xslt-шаблоны (в пути можно указывать макросы {lang} и {domain})
templates.xsl = "~/xsltTpls/"
; Путь до файла с логом запросов к БД
mysql-queries-log = "~/queries.log"
; Путь до пользовательских файлов.
user-files-path = "~/files"
; Путь до пользовательских изображений.
user-images-path = "~/images"
; Путь до логов ошибок.
errors-logs-path = "~/errors/logs"
; Путь до директории с временными системными файлами.
sys-temp-path = "~/sys-temp"
; Путь до директории с файлами системных логов.
sys-log-path = "~/sys-temp/logs"
; Путь до изображения, которое будет использовано в качестве "заглушки" при генерации миниатюр.
no-image-holder = "~/images/cms/no_image.png"
;изображение заглушка для слишком больших файлов
too-big-image-holder = "~/images/cms/too_big_foto.png"

; Настройки ядра системы
[kernel]
; Выводить содержимое текстовых полей well-formed xml'ом при доступе из через внутренние протоколы.
property-value-mode = ""
; Выводить меню одним деревом при работе с xslt-шаблонами
xslt-nested-menu = "1"
; Установить максимальное количество join-таблиц в запросе, после которого нужно отключить оптимизатор запросов mysql'а
selection-max-joins = "-1"
; Включить коррекцию кэша при работе системы в кластере (1 db-server, > 2 app-server)
cluster-cache-correction = "0"
; Ключевое слово для выборки всех элементов в макросах
grab-all-keyword = "mode=all"
; Использовать расширение reflection для вызова подключаемых библиотек
use-reflection-extension = "0"
; Игнорировать совпадение адресов страниц и названий модулей.
; По умолчанию система исправляет название страницы, чтобы избежать коллизий.
ignore-module-names-overwrite = "0"
; Автоматически индексировать изменения страниц
pages-auto-index = "1"
; Автоматически индексировать импортируемые данные.
; Обратите внимание: для включения автоматической индексации при импорте,
; необходимо, чтобы для параметра pages-auto-index, также было выставлено значение "1"
import-auto-index = "0"
; Обнулять значения поля, если в импортируемом csv файле поле пустое.
import-csv-reset-value = "0"
; Включить предварительную авторизацию
enable-pre-auth = "1"
; Форматировать выводимый xml-документы
xml-format-output = "1"
; Разрешить перехват вызываемых адресов umap'ом
matches-enabled = "1"
; Позволяет отключить обработку tpl-макросов, присутствующих в контенте страниц сайта, работающего в XSLT-режиме
xml-macroses-disable = "0"
; Позволяет задать массив макросов, которые будут отрабатывать при включенной директиве xml-macroses-disable
xml-macroses.allowed[] = "content/get_page_url"
; Включает отображение макросов, которые не отработали
show-broken-macro = "1"
; Включает отправку дополнительных заголовков (additional-header)
send-additional-status-header = "1"
; Включает использование справочника с заблокированными ip.
use-ip-blacklist-guide = "0"
; Управление черным списком IP-адресов перенесено в административный раздел в модуль
; "Шаблоны данных", справочник "Список IP-адресов, которым недоступен сайт"
ip-blacklist = ""
; Ограничивает количество элементов в выпадающем списке. По умолчанию = 50.
; Значение должно быть числовым и не может быть меньше 15
max-guided-items = "50"
; Указывает необходимость проводить загружаемые jpg и jpeg-файлы через php-библиотеку "gd".
; При установленном значении "1" увеличивает безопасность сайта (становится невозможным загрузить
; вредоносный php-файл в виде jpg-картинки), однако, ведет к снижению качества загружаемых изображений.
jpg-through-gd = "1"
; Управляет отображением времени генерации страницы в её исходном коде
show-generate-time = "1"
; Включает защиту от вредоносных межсайтовых запросов (CSRF)
csrf_protection = "1"
; Количество объектов, для которых можно хранить в кэше все значения всех их полей.
objects-props-cash-size = "100"
; Отключает учет прав текущего пользователя при фильтрации страниц по индексу.
ignore-permissions-in-filter = "1"
; Включает прикрепление к отправляемым письмам изображений, которые в них размещались.
inner-img-to-attachment = "1"
; Переключает реализацию скачивания файла в зависимости от сервера (apache/nginx).
umi-file-download-mode = "apache"
; Включает логгирование запросов к MySQL
mysql-queries-log-enable = "0"
; Тип логгера запросов к MySQL. Имя класса реализации логгера будет иметь вид <значение-опции>MysqlLogger .
; Класс логгера должен реализовывать интерфейс iMysqlLogger.
; Пример определения класса логгера TestMysqlLogger можно найти в файле ~/classes/system/utils/logger/mysql/TestMysqlLogger.php
mysql-queries-log-type = "Test"
; Ограничение на минимальное количество символов для поиска (не меньше 2х символов).
search-min-word-length = "3"
; Включает поиск по вхождению в любую часть строки.
search-in-any-part-of-string = "0"
; Включает сортировку элементов справочников по ид.
order-guide-items-by-id = "0"
; Определяет количество проверяемых временных (незарегистрированных покупателей, брошенный корзин и т.д.) объектов за один запуск сборщика мусора.
expired-objects-limit = "50"
; Определяет время жизни временных объектов по умолчанию.
objects-expiration-time = "86400"
; Название расширения для обработки изображений (imagick/gd)
image-processor = ""
; Включение проверки родительских страниц на предмет доступности для приложения в социальной сети
social_network.check-parents = "0"

; Настройки отправки писем
[mail]
; Определяет класс, ответственный за отправку писем. Возможные значения:
; phpMail - класс отправки с помощью php функции mail();
; smtp - класс отправки по протоколу smtp;
; nullEngine - класс заглушки отправки;
engine = "phpMail"
; Определяет таймаут для отправки писем по smtp. Значение задается в секундах.
smtp.timeout = ""
; Определяет хост для подключения по smtp.
smtp.host = ""
; Определяет порт для подключения по smtp.
smtp.port = ""
; Определяет шифрование подключения по smtp (ssl, tls, auto).
smtp.encryption = ""
; Определяет необходимость авторизации для отправки по smtp.
smtp.auth = ""
; Определяет логин авторизации для отправки по smtp.
smtp.user-name = ""
; Определяет пароль авторизации для отправки по smtp.
smtp.password = ""
; Определяет режим отладки отправки по smtp.
; Отправка писем может кидать исключения
; Ведется лог обращений по stmp в /sys-temp/logs/smtp/
smtp.debug = ""
; Определяет необходимость генерации VERP адреса при отправке.
smtp.use-verp = ""

; Настройки подсистемы внутренних сообщений
[messages]
; Перехватывать и записывать в лог системные события (сохранять в системный журнал событий).
catch-system-events = "0"

; Индивидуальные настройки модулей
[modules]
; Модуль "Интернет-магазин". Класс для расчета номера следующего заказа.
emarket.numbers = "default"
; Модуль "Интернет-магазин". Определяет необходимость конвертации валюты при импорте
emarket.currency.convert_on_import = "0"
; Модуль "Интернет-магазин". URL для автоматической синхронизации курсов валют.
emarket.currency.sync.source = "http://www.cbr.ru/scripts/XML_daily.asp"
; Модуль "Интернет-магазин". Шаблон обработки результатов для синхронизации курсов валют.
emarket.currency.sync.xsl = "cbr2internal.xsl"
; Модуль "Интернет-магазин". Максимальное число товаров, которые можно добавить к сравнению.
emarket.compare.max-items = "3"
; Модуль "Интернет-магазин". Максимальное количество самых часто покупаемых товаров,
; отображаемых в списке Популярные товары на вкладке Статистика.
; Можно изменить в настройках модуля на вкладке настройки модуля ("Максимум популярных товаров").
emarket.popular.max-items = "30"
; Модуль "Интернет-магазин". Максимальное количество заказов, которые должны быть переиндексированы.
; Можно изменить в настройках модуля на вкладке настройки модуля ("Максимум переиндексируемых заказов").
emarket.reindex.max-items = "10"
; Модуль "Интернет-магазин". При добавлении товаров с перечисленными группами полей,
; он будет рассматриваться как товар с опциями ;(опционный товар).
emarket.order-types.optioned.groups[] = "catalog_option_props"
; Модуль "Интернет-магазин". При добавлении товаров с перечисленными полями,
; он будет рассматриваться как товар с опциями (опционный товар).
emarket.order-types.optioned.fields[] = ""
; Модуль "Интернет-магазин". Время жизни незарегистрированного покупателя по умолчанию, в секундах.
emarket.customer-expiration-time = "2678400"
; Модуль "Интернет-магазин".
; https://api.kupivkredit.ru/ - URL для обращения к платежной системе КупиВКредит, установлен по умолчанию;
emarket.payment.kupivkredit.api-url = "https://api.kupivkredit.ru/"
; Модуль "Обмен данными". Количество элементов выгружаемое за один раз при импорте больших объемов.
exchange.splitter.limit = "25"
; Модуль "Обмен данными". Количество элементов выгружаемое за один раз при экспорте больших объемов.
exchange.export.limit = "25"
; Модуль "Обмен данными". Определяет задержку выполнения скрипта при интеграции с 1С.
exchange.commerceML.timeout = "0"
; Модуль "Обмен данными". Устанавливает сплиттер, с помощью которого производится импорт данных из 1С.
exchange.commerceML.splitter = "commerceML2"
; Модуль "Обмен данными". Устанавливает необходимость переименования файлов при импорте
; из 1С. значение "1" - импортируемые файлы переименовываются, значение "0" отключает переименование.
exchange.commerceML.renameFiles = "1"
; Модуль "Обмен данными". Устанавливает максимально возможный размер в байтах части
; файла при выгрузке из 1С. Если выгрузка заказов не проходит, необходимо увеличить этот параметр.
exchange.commerceML.maxFileSize = "102400"
; одуль "Обмен данными". Включает обработку zip архивов при интеграции с 1С.
exchange.commerceML.accept-zip = "0"
; Модуль "Обмен данными". Ограничивает экспорт заказов текущим доменом. Если параметр имеет
; значение "1", то экспорт заказов в формат CommerceML будет происходить с фильтрацией по
; текущему домену. Если используется значение по умолчанию - "0", заказы будут
; экспортированы из всех доменов системы.
exchange.commerceML.ordersByDomains = "0"
; Модуль "Обмен данными". Задает ограничение на количество заказов, выгружаемых в 1С за один сеанс.
exchange.commerceML.ordersLimit = "150"
; Модуль "Обмен данными". Идентификатор цены в "1С:Управление торговлей" по умолчанию.
; Если в "1С:Управление торговлей" существует только один тип цен, то этот параметр будет проигнорирован.
; Если существует 2 и более, то будет взят указанный в этом параметре тип (в случае наличия такого типа в "1С:Управление торговлей"), либо выбран первый из встретившихся.
exchange.translator.1c_price_type_id = "3c49a673-e8ba-11de-adfb-000c297d6967"
; Модуль "Обмен данными". Определяет будут ли созданы разделы каталога активными или нет, при импорте из CommerceML.
exchange.translator.catalog_rubric_activity = "0"
; Модуль "Обмен данными". Определяет будут ли созданы объекты каталога активными или нет, при импорте из CommerceML.
exchange.translator.catalog_item_activity = "1"
; Модуль "Обмен данными". Определяет будут ли созданы разделы каталога видимыми в меню или нет, при импорте из CommerceML.
exchange.translator.catalog_rubric_visible = "1"
; Модуль "Обмен данными". Определяет задержку выполнения скрипта при интеграции с 1С.
exchange.translator.catalog_item_visible = "0"
; Модуль "Обмен данными". Определяет какой шаблон будет использован по умолчанию
; для отображения страниц импортированных товаров каталога. Укажите здесь имя файла шаблона (с расширением .xsl или .tpl).
; Если не указан, будет использован шаблон назначенный на сайте по умолчанию.
exchange.translator.catalog_item_template = ""
; Модуль "Обмен данными". Определяет какой шаблон будет использован по умолчанию для
; отображения страниц импортированных разделов каталога. Укажите здесь имя файла шаблона (с расширением .xsl или .tpl).
; Если не указан, будет ипользован шаблон, назначенный на сайте по умолчанию.
exchange.translator.catalog_rubric_template = ""
; Модуль "Рассылки". Определяет ограничение количества писем в час, отправляемое через рассылку.
; Если выставлено значение по умолчанию, количество ограничиваться не будет.
dispatches.max_messages_in_hour = "0"
; Модуль "Баннеры". Включает/выключает пересчет количества показов баннеров в процессе формирования страницы.
; "1" - пересчет количества показов и проверка, был ли баннер уже показан заданное количество раз, происходит при формировании страницы;
; "0" - после загрузки страницы.
; Параметр предназначен для устранения проблем с некоторыми версиями php.
banners.disable-update-optimization = "1"
; Включает запись даты последнего посещения авторизованного пользователя.
users.calculate-last-request-time = "0"
; Включает автоматическое обновление индекса фильтров при изменении товаров.
catalog.allow-auto-update-filter-index = "1"
; Количество индексируемых товаров за одну итерацию при ручной индексации фильтров.
catalog.index.limit = "25"
; Включает возможность указывать уровень вложенности искомых товаров относительно индексируемого раздела при ручной индексации фильтров.
catalog.index.advanced-mode = "1"
; Включает переиндексацию фильтров всех индексируемых разделов каталога при запуске системного крона.
catalog.reindex-on-cron-event-enable = "0"
; Модуль "Структура". Определяет максимальное количество последних просмотренных страниц, хранящихся в системе.
content.recent-pages.max-items = "100"
; Модуль "Поиск". Включить индексацию виртуальных копий.
; Можно изменить в настройках модуля ("Индексировать виртуальные копии").
search.allow-virtual-copies = "1"
; Модуль "GeoIP". Cписок имен заблокированных сервисов определения Geo локации по IP.
; Можно изменить в настройках модуля.
geoip.service.blacklist[] = ""

; Seo-настройки
[seo]
; Символ для разделения слов в псевдостатическом адресе страницы. Возможны варианты - "_" или "-"
alt-name-separator = "-"
; Окончание, добавляемое к ссылкам в адресной строке (например: "http://domain.ru/catalog/tovar/").
; Применяется для ;SEO-оптимизации. Например, когда для ссылок нужно добавить
; окончание ".html" - свидетельство для поисковиков о том, что это статическая
; страница, а не каталог. Указанное окончание добавляется в том случае, если параметр url-suffix.add равен "1"
url-suffix = "/"
; Добавлять ли указанное в url-suffix окончание к ссылкам
url-suffix.add = "1"
; Следить за историей изменений адресов страниц (переименования, перемещения)
; При включенной опции ведется статистика изменений, при попадании пользователя на перемещенную страницу,
; система будет осуществлять seo-корректное перенаправление на новый адрес страницы
watch-redirects-history = "1"
; Значение crawl-delay в robots.txt
crawl-delay = "3"
; Переадресовывать ли на корень сайта при запросе "index.php".
index-redirect = "1"
; Переадресовывать на основной домен, если пользователь зашел на зеркало
primary-domain-redirect = "0"
; Используется ли текущий домен с префиксом www или без него
primary-www = "0"

; Настройки работы сессий
[session]
; Время жизни сессионной cookie в секундах.
cookie-lifetime = "1209600"
; Путь в домене, где cookie будет работать. Используйте одну косую черту ('/') для всех путей в домене.
cookie-path = "/"
; Домен cookie, например 'www.test.ru'. Чтобы сделать cookies видимыми для всех поддоменов, перед именем домена нужно поставить точку, например '.test.ru'.
cookie-domain = ""
; Если установлено 1, то cookies будут передаваться только через защищённые соединения.
cookie-secure-flag = "0"
; Если установлено 1, то система попытается отправить флаг httponly при настройке сессионной cookie.
cookie-http-flag = "1"
; Максимальное время активности сессии в минутах.
active-lifetime = "60"
; Устанавливает имя сессии.
name = "PHPSESSID"

; Настройки rest-протоколов
[streams]
; Список доступных системе протоколов
enable[] = "udata"
enable[] = "utype"
enable[] = "upage"
enable[] = "uobject"
enable[] = "ufs"
enable[] = "usel"
enable[] = "umap"
enable[] = "uhttp"
enable[] = "ulang"
enable[] = "umess"
; Разрешения на доступ к протоколам через HTTP
udata.http.allow = "1"
utype.http.allow = "1"
upage.http.allow = "1"
uobject.http.allow = "0"
ufs.http.allow = "0"
usel.http.allow = "0"
umap.http.allow = "0"
uhttp.http.allow = "0"
ulang.http.allow = "0"
umess.http.allow = "1"
; Настройка прав доступа на вызов протоколов через HTTP. Возможные значения:
; admin - доступно только администраторам сайта.
; sv - доступно только супервайзерам.
; auth - доступно только авторизованным пользователям.
; all - доступно всем
; так же можно указать id пользователей через запятую
udata.http.permissions = "all"
utype.http.permissions = "all"
upage.http.permissions = "all"
uobject.http.permissions = "all"
ufs.http.permissions = "all"
usel.http.permissions = "all"
umap.http.permissions = "all"
uhttp.http.permissions = "all"
ulang..http.allow = "all"
umess.http.permissions = "all"
; Настройка прав доступа на вызов протоколов через HTTP по ip адресу.
udata.http.ip-allow = ""
utype.http.ip-allow = ""
upage.http.ip-allow = ""
uobject.http.ip-allow = ""
ufs.http.ip-allow = ""
usel.http.ip-allow = ""
umap.http.ip-allow = ""
uhttp.http.ip-allow = ""
ulang.http.ip-allow = ""
umess.http.ip-allow = ""
; Разрешение на вывод расширенных полей и групп по протоколу UData через HTTP
udata.http.extended.allow = "0"
; Заголовок "User Agent", который будет отправлять система при доступе к внешним данным
user-agent = "UMI.CMS libxml agent"
; Включить или отключить автоматическое определение и подключение config.ini для текущего шаблона
udata.autoload.custom.config = "1"

; Настройки страницы-заглушки
[stub]
; Включить заглушку
enabled = "0"
; Список адресов, для которых не будет показываться страница-заглушка.
filter.ip[] = ""

; Основные системные настройки
[system]
; Текущий драйвер БД системы. На данный момент поддерживается 2 значения: "mysql" и "xml"
db-driver = "mysql"
; Редакция системы. Определяется при установке. Возможные значения:
; demo - включение демонстрационного режима
; В Демонстрационном режиме блокирован такой функционал, как:
; Обновление системы
; Применение патчей
; Управление файловой системой сайта(файловый менеджер позволяет только чтение)
; Изменение настроек модулей
; Просмотр Доменного ключа в модуле Конфигурация
version-line = ""
; Скин административного интерфейса по умолчанию
default-skin = "modern"
; Список скинов, доступных в системе
skins[] = "mac"
skins[] = "modern"
; Список доступных языковых версий
interface-langs[] = "ru"
interface-langs[] = "en"
; Формат вывода даты по умолчанию
default-date-format = "Y-m-d H:i:s"
; Часовой пояс по умолчанию
time-zone = "Europe/Moscow"
; Код валюты по умолчанию
default-currency = "RUR"
; Настройки удаления через edit-in-place ( 0 - Страницы будут перемещены в корзину. Объекты — удалены.)
eip.fake-delete = "0"
; Определяет метод работы с шаблонизаторами. С версии 2.8.5.1 является устаревшим и не используется
use-old-templater = "1"
; Позволяет отключить транслитерацию имен загружаемых файлов.
transliterate-uploaded-files = "1"
; Предназначен для вырезания из конечного HTML-кода атрибутов из пространства имён "umi"
; (umi:method, umi:element-id и так далее) для неавторизованых пользователей
clean-eip-attributes = "0"
; Позволяет управлять возможностью редактирования объектов справочника для администраторов сайта, не являющихся владельцами (создателями) данных объектов.
allow-object-editing = "1"
; Позволяет включить выполнение макросов внутри html-комментариев. По умолчанию параметр равен 0
parse-macroses-in-comments = "0"
; Указывает максимально допустимый суммарный размер файлов из папок /files и /images. По умолчанию не ограничено. Поддерживаются суффиксы KB, MB, GB. Значение по умолчанию - в байтах.
quota-files-and-images = "0"
; Указывает максимально допустимый размер файлов из директории /sys-temp/uploads/. По умолчанию не ограничено. Поддерживаются суффиксы KB, MB, GB. Значение по умолчанию - в байтах.
quota-uploads = "0"
; Кодировка по умолчанию для обмена данными в формате CSV
default-exchange-encoding = "windows-1251"
; Позволяет управлять протоколом при генерации адресов системой. Возможные значения - "http" и "https". Пример генерируемых адресов: ссылки в sitemap.xml, в yml и т.д.
server-protocol = "http"
; Включает режим совместимых модулей (из директории /classes/components). Режим совместимых модулей будет включен вне зависимости от значения директивы, если на сервере используется PHP версии 7.*.*
compatible-modules = "1"
; Позволяет указать свои методы в качестве шлюзов (cmsController::isGateway()). При вызове методов-шлюзов игнорируется проверка HTTP referer.
gateways[] = "module-method"
; Возможность очищать данные для php шаблона от разметки массивов для xml транслятора.
use-php-template-data-cleaning = "0"
; Использовать только базовые данные о текущей странице для шаблонизации.
use-only-base-client-variables = "0"
; Подавлять исключения в php-шаблонизаторе для вызываемых макросов.
suppress-exceptions-in-php-macros = "0"
; Возможность получать в php шаблоне выполненный макрос текущей страницы в виде массива.
return-array-from-macros-execution = "0"
; Версия визуального редактора tinyMCE для административной панели.
admin-wysiwyg-version = "tinymce47"
; Предназначен для системных целей, генерируется автоматически
salt = "0d6d84cfe8e325bae5898ab5656d8922dee3d284"
; При загрузке изображений на сервер они будут сжаты до указанного в опции уровня (в процентах, где 1 - максимальное сжатие, 100 - отсутствие сжатия).
image-compression = "100"
; Коэффициент расчета занимаемой памяти для одного пикселя изображения в байтах
bitmap-memory-rate = "2.2"

; Настройки обновления
[updates]
; Способ обновления таблиц базы данных. Если данный параметр равен "1", то при
; обновлении система будет проверять количество записей в таблицах базы данных.
; В случае, если таблица содержит более 10000 записей, её обновление будет происходить частями по 1000 строк.
; Данная возможность необходима, например, для серверов с маленьким значением максимально
; возможного времени выполнения скрипта.
update-database-by-parts = "1"
; Ограничение на количество записей при обновлении базы данных.
db-scheme-converter-iteration-limit = "10000"

; Автозагрузка дополнительных классов.
[autoload]
; Путь до PHP-файла с определением класса.
className[] = "~/file/Path"
</source>

[[Категория:Модуль Конфигурация]][[Категория:Вопросы_установки_настройки_и_переноса]]

Цена в зависимости от условий

2019-05-28T08:53:35Z

Vitaliks:

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

== Задача ==

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

== Решение ==

1. Нужно написать обработчик события. Более подробную информацию о событиях вы можете прочитать здесь http://api.umi-cms.ru/events.html
Вам необходимо создать в файл classes/components/catalog/custom_events.php. В нём прописать следующий код:
<source lang="php">
<?php
new umiEventListener("umiObjectProperty_loadPriceValue", "catalog", "onLoadPriceHandler");
?>
</source>
Это событие будет вызывать кастомный макрос определяющий цену.

2. Написать кастомный макрос. Для этого в файле classes/components/catalog/customMacros.php Описать следующую функцию:
<source lang="php">
public function onLoadPriceHandler(iUmiEventPoint $oEventPoint) {
// get plain price relation
$price = &$oEventPoint->getRef('price');
// get object id
$object_id = $oEventPoint->getParam('object_id');
// TODO: write your custom logic here
// ....
// and set new $price value
$price = 6436;
}
?>
</source>
== Итог ==

Мы привели Вам примерный текст макроса.
Теперь необходимо описать соответствующие условия и присвоить переменной $price необходимую вариацию цены.

<br/>Также смотрите статью с примером реализации описанной логики: [[Использование нескольких Цен для одного товара]]
[[Категория:Написание кастомных макросов]][[Категория:Модуль Каталог]][[Категория:Модуль Интернет магазин]]

Цена в зависимости от условий

2019-05-28T08:53:11Z

Vitaliks:

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

----

== Задача == В интернет-магазине цена должна быть в зависимости от каких-то условий.

== Решение ==

1. Нужно написать обработчик события. Более подробную информацию о событиях вы можете прочитать здесь http://api.umi-cms.ru/events.html
Вам необходимо создать в файл classes/components/catalog/custom_events.php. В нём прописать следующий код:
<source lang="php">
<?php
new umiEventListener("umiObjectProperty_loadPriceValue", "catalog", "onLoadPriceHandler");
?>
</source>
Это событие будет вызывать кастомный макрос определяющий цену.

2. Написать кастомный макрос. Для этого в файле classes/components/catalog/customMacros.php Описать следующую функцию:
<source lang="php">
public function onLoadPriceHandler(iUmiEventPoint $oEventPoint) {
// get plain price relation
$price = &$oEventPoint->getRef('price');
// get object id
$object_id = $oEventPoint->getParam('object_id');
// TODO: write your custom logic here
// ....
// and set new $price value
$price = 6436;
}
?>
</source>
== Итог ==

Мы привели Вам примерный текст макроса.
Теперь необходимо описать соответствующие условия и присвоить переменной $price необходимую вариацию цены.

<br/>Также смотрите статью с примером реализации описанной логики: [[Использование нескольких Цен для одного товара]]
[[Категория:Написание кастомных макросов]][[Категория:Модуль Каталог]][[Категория:Модуль Интернет магазин]]

Добавление нового правила скидки

2019-05-25T08:45:47Z

Vitaliks:

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

== Задача ==

Добавить новое правило скидок

== Решение ==

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

Допустим, у товаров есть поле Производитель, типа выпадающий список, идентификатор поля '''proizvoditel''', справочник для поля - «Производитель». Тогда добавим дочерний тип по отношению к «Правила скидок», модуль "Шаблоны данных". Назовем новый тип «На раздел и производителя». В поле «Назначение типа» выберем «Правило скидки», добавим поле "Раздел" с типом «Ссылка на дерево», строковый идентификатор 'razdely'. Также добавим поле "Производитель", с типом выпадающий список, а справочник укажем такой же как и для товаров, т.е. «Производитель». Будем считать, что новый тип данных имеет object_id = 1062.

Откроем содержание справочника «Типы правил для скидок», добавим еще один элемент, с названием «На раздел и производителя», Идентификатор – brand, Тип данных – 1062, Допустимые типы скидки - На товары каталога.

Далее в папку '''/classes/components/emarket/classes/discounts/rules/''' добавим файл '''brand.php''', со следующим содержанием:
<source lang="php">
<?php

class brandDiscountRule extends discountRule implements itemDiscountRule {
public function validateItem(iUmiHierarchyElement $orderItem) {
if(!is_array($this->razdely)) {
return false;
}
// слева, proizvoditel - идентификатор поля в Правиле скидки
// справа, proizvoditel - идентификатор поля у товара
if($this->proizvoditel == $orderItem->proizvoditel){

foreach($this->razdely as $catalogItem) {
if($catalogItem->id == $orderItem->getParentId()) {
return true;
}
}
}
return false;
}
};
?>
</source>

Теперь остается добавить саму скидку. В модуле Интернет-магазин, вкладка «Скидки», добавляем скидку:
*Тип скидки - На товары каталога
*Модификатор цены - Процент от суммы
*Правила валидации - На раздел и производителя

Указываем необходимые параметры скидки:
*Процент скидки
*Разделы
*Производитель

«Раздел» должен быть прямым родителям для объекта каталога, т.е. указание промежуточного раздела, в котором есть подразделы, в данном случае не сработает.
[[Категория:Модуль Интернет магазин]]

Добавление нового правила скидки

2019-05-25T08:45:30Z

Vitaliks:

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

== Задача ==

Добавить новое правило скидок

== Решение ==

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

Допустим, у товаров есть поле Производитель, типа выпадающий список, идентификатор поля '''proizvoditel''', справочник для поля - «Производитель». Тогда добавим дочерний тип по отношению к «Правила скидок», модуль "Шаблоны данных". Назовем новый тип «На раздел и производителя». В поле «Назначение типа» выберем «Правило скидки», добавим поле "Раздел" с типом «Ссылка на дерево», строковый идентификатор 'razdely'. Также добавим поле "Производитель", с типом выпадающий список, а справочник укажем такой же как и для товаров, т.е. «Производитель». Будем считать, что новый тип данных имеет object_id = 1062.

Откроем содержание справочника «Типы правил для скидок», добавим еще один элемент, с названием «На раздел и производителя», Идентификатор – brand, Тип данных – 1062, Допустимые типы скидки - На товары каталога.

Далее в папку '''/classes/components/emarket/classes/discounts/rules/''' добавим файл '''brand.php''', со следующим содержанием:
<source lang="php">
<?php

class brandDiscountRule extends discountRule implements itemDiscountRule {
public function validateItem(iUmiHierarchyElement $orderItem) {
if(!is_array($this->razdely)) {
return false;
}
// слева, proizvoditel - идентификатор поля в Правиле скидки
// справа, proizvoditel - идентификатор поля у товара
if($this->proizvoditel == $orderItem->proizvoditel){

foreach($this->razdely as $catalogItem) {
if($catalogItem->id == $orderItem->getParentId()) {
return true;
}
}
}
return false;
}
};
?>
</source>

Теперь остается добавить саму скидку. В модуле Интернет-магазин, вкладка «Скидки», добавляем скидку:
*Тип скидки - На товары каталога
*Модификатор цены - Процент от суммы
*Правила валидации - На раздел и производителя

Указываем необходимые параметры скидки:
*Процент скидки
*Разделы
*Производитель

«Раздел» должен быть прямым родителям для объекта каталога, т.е. указание промежуточного раздела, в котором есть подразделы, в данном случае не сработает.
[[Категория:Модуль Интернет магазин]]

Добавление нового правила скидки

2019-05-25T08:44:15Z

Vitaliks:

'''Актуально для версии 18.'''<br/><br/>
== Задача == Добавить новое правило скидок<br/><br/>
'''Реализация:'''

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

Допустим, у товаров есть поле Производитель, типа выпадающий список, идентификатор поля '''proizvoditel''', справочник для поля - «Производитель». Тогда добавим дочерний тип по отношению к «Правила скидок», модуль "Шаблоны данных". Назовем новый тип «На раздел и производителя». В поле «Назначение типа» выберем «Правило скидки», добавим поле "Раздел" с типом «Ссылка на дерево», строковый идентификатор 'razdely'. Также добавим поле "Производитель", с типом выпадающий список, а справочник укажем такой же как и для товаров, т.е. «Производитель». Будем считать, что новый тип данных имеет object_id = 1062.

Откроем содержание справочника «Типы правил для скидок», добавим еще один элемент, с названием «На раздел и производителя», Идентификатор – brand, Тип данных – 1062, Допустимые типы скидки - На товары каталога.

Далее в папку '''/classes/components/emarket/classes/discounts/rules/''' добавим файл '''brand.php''', со следующим содержанием:
<source lang="php">
<?php

class brandDiscountRule extends discountRule implements itemDiscountRule {
public function validateItem(iUmiHierarchyElement $orderItem) {
if(!is_array($this->razdely)) {
return false;
}
// слева, proizvoditel - идентификатор поля в Правиле скидки
// справа, proizvoditel - идентификатор поля у товара
if($this->proizvoditel == $orderItem->proizvoditel){

foreach($this->razdely as $catalogItem) {
if($catalogItem->id == $orderItem->getParentId()) {
return true;
}
}
}
return false;
}
};
?>
</source>

Теперь остается добавить саму скидку. В модуле Интернет-магазин, вкладка «Скидки», добавляем скидку:
*Тип скидки - На товары каталога
*Модификатор цены - Процент от суммы
*Правила валидации - На раздел и производителя

Указываем необходимые параметры скидки:
*Процент скидки
*Разделы
*Производитель

«Раздел» должен быть прямым родителям для объекта каталога, т.е. указание промежуточного раздела, в котором есть подразделы, в данном случае не сработает.
[[Категория:Модуль Интернет магазин]]

Выгрузка нескольких изображений для шаблона Demomarket

2019-05-24T08:45:09Z

Vitaliks: Новая страница: «'''Актуально для версии 20''' == Задача == Выгрузить несколько изображений из 1С на сайт с шаб…»

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

== Задача ==

Выгрузить несколько изображений из 1С на сайт с шаблоном Demomarket так, что-бы они сразу отображались на сайте.

== Решение ==

Основная задача которую надо решить это реализация кастомного шаблона преобразования информации об изображениях из файла с форматом CommerceML 2.0 в данные формата umiDump 2.0.

Фрагмент данных файла выгрузки из 1С содержащий информацию об изображениях:

<source lang="xml">
<Картинка>import_files/15/15db4a947d4f11e9499ffa163e9c8758_1ba9b1727d4f11e9499ffa163e9c8758.png</Картинка>
<Картинка>import_files/15/15db4a947d4f11e9499ffa163e9c8758_2390e7a27d4f11e9499ffa163e9c8758.jpg</Картинка>
<Картинка>import_files/15/15db4a947d4f11e9499ffa163e9c8758_9ff1425a7d5511e9499ffa163e9c8758.jpg</Картинка>
</source>

Фрагмент данных файла umiDump 2.0 который должен получиться после применения шаблона преобразования:

<source lang="xml">
<property name="photo" type="img_file">
<title>Картинка</title>
<value><![CDATA[./images/cms/data/import_files/15/15db4a947d4f11e9499ffa163e9c8758_1ba9b1727d4f11e9499ffa163e9c8758.png]]></value>
</property>
<property name="photos" type="multiple_image">
<title>Дополнительные фотографии товара</title>
<value path="./images/cms/data/import_files/15/15db4a947d4f11e9499ffa163e9c8758_2390e7a27d4f11e9499ffa163e9c8758.jpg"/>
<value path="./images/cms/data/import_files/15/15db4a947d4f11e9499ffa163e9c8758_9ff1425a7d5511e9499ffa163e9c8758.jpg"/>
</property>
</source>

Ознакомится со стандартным шаблоном преобразования данных из 1С можно в файле /xsl/import/commerceML2.xsl

Для реализации задачи необходимо переопределить шаблон '''Товары/Товар''' и добавить один дополнительный шаблон '''Товар/Картинка[position() &gt; 1]'''.

Переопределять и добавлять кастомные шаблоны преобразования можно в файле /xsl/import/custom/commerceML2.xsl.

После внесения изменений шаблон '''Товары/Товар''' будет выглядеть следующим образом (все внесенные изменения отмечены комментариями):

<source lang="xml">
<xsl:template match="Товары/Товар">
<xsl:param name="group_id" select="string(Группы/Ид)" />

<xsl:param name="name">
<xsl:choose>
<xsl:when test="string-length(ПолноеНаименование)">
<xsl:value-of select="ПолноеНаименование" />
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="Наименование" />
</xsl:otherwise>
</xsl:choose>
</xsl:param>

<page id="{Ид}" parentId="{$group_id}" type-id="{$group_id}">
<xsl:choose>
<xsl:when test="Статус = 'Удален'">
<xsl:attribute name="is-deleted">1</xsl:attribute>
</xsl:when>
<xsl:when test="$isCatalogItemsRestoreOnImport = 1">
<xsl:attribute name="is-deleted">0</xsl:attribute>
</xsl:when>
</xsl:choose>

<xsl:if test="not(Группы/Ид)">
<xsl:attribute name="parentId"><xsl:value-of select="$catalog-id" /></xsl:attribute>
<xsl:attribute name="type-id">root-catalog-object-type</xsl:attribute>
</xsl:if>

<default-active>
<xsl:value-of select="$catalog_item_activity" />
</default-active>

<default-visible>
<xsl:value-of select="$catalog_item_visible" />
</default-visible>

<basetype module="catalog" method="object">Объекты каталога</basetype>

<name><xsl:value-of select="$name" /></name>

<xsl:if test="string-length($catalog_item_template)">
<default-template>
<xsl:value-of select="$catalog_item_template" />
</default-template>
</xsl:if>
<properties>
<xsl:call-template name="common-group">
<xsl:with-param name="name" select="$name" />
</xsl:call-template>

<group name="product">
<title>1C: Общие свойства</title>

<xsl:if test="string-length(Описание)">
<property name="description" title="Описание" type="wysiwyg" allow-runtime-add="1">
<type data-type="wysiwyg" />
<title>Описание</title>
<value>
<xsl:choose>
<xsl:when test="Описание/@ФорматHTML = 'true'">
<xsl:value-of select="Описание"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="php:function('nl2br', string(Описание))" disable-output-escaping="yes" />
</xsl:otherwise>
</xsl:choose>
</value>
</property>
</xsl:if>

<property name="1c_catalog_id" type="string">
<title>Идентификатор каталога 1С</title>
<value><xsl:value-of select="$catalog-id" /></value>
</property>

<property name="1c_product_id" type="string">
<title>Идентификатор в 1С</title>
<value><xsl:value-of select="Ид" /></value>
</property>

<property name="artikul" type="string">
<title>Артикул</title>
<value><xsl:value-of select="Артикул" /></value>
</property>

<property name="bar_code" type="string">
<title>Штрих-код</title>
<value><xsl:value-of select="Штрихкод" /></value>
</property>

<property name="weight" type="float">
<title>Вес</title>
<value><xsl:value-of select="ЗначенияРеквизитов/ЗначениеРеквизита[Наименование = 'Вес']/Значение"/></value>
</property>


<xsl:apply-templates select="Картинка[1]" />


<property name="photos" type="multiple_image">
<title>Дополнительные фотографии товара</title>
<xsl:apply-templates select="Картинка[position() > 1]" />
</property>
</group>

<xsl:apply-templates select="ЗначенияСвойств" />
</properties>
</page>
</xsl:template>
</source>

Далее необходимо добавить шаблон '''Товар/Картинка[position() &gt; 1]''' который будет выглядеть следующим образом:

<source lang="xml">
<xsl:template match="Товар/Картинка[position() > 1]">
<xsl:if test="string-length(.)">
<value><xsl:attribute name="path">./images/cms/data/<xsl:value-of select="." /></xsl:attribute></value>
</xsl:if>
</xsl:template>
</source>

После внесения всех изменений файл /xsl/import/custom/commerceML2.xsl, если Вы не вносили другие изменения, будет выглядеть вот так:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>


<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:php="http://php.net/xsl"
xmlns:udt="http://umi-cms.ru/2007/UData/templates"
extension-element-prefixes="php"
exclude-result-prefixes="xsl php udt">

<xsl:template match="Товары/Товар">
<xsl:param name="group_id" select="string(Группы/Ид)" />

<xsl:param name="name">
<xsl:choose>
<xsl:when test="string-length(ПолноеНаименование)">
<xsl:value-of select="ПолноеНаименование" />
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="Наименование" />
</xsl:otherwise>
</xsl:choose>
</xsl:param>

<page id="{Ид}" parentId="{$group_id}" type-id="{$group_id}">
<xsl:choose>
<xsl:when test="Статус = 'Удален'">
<xsl:attribute name="is-deleted">1</xsl:attribute>
</xsl:when>
<xsl:when test="$isCatalogItemsRestoreOnImport = 1">
<xsl:attribute name="is-deleted">0</xsl:attribute>
</xsl:when>
</xsl:choose>

<xsl:if test="not(Группы/Ид)">
<xsl:attribute name="parentId"><xsl:value-of select="$catalog-id" /></xsl:attribute>
<xsl:attribute name="type-id">root-catalog-object-type</xsl:attribute>
</xsl:if>

<default-active>
<xsl:value-of select="$catalog_item_activity" />
</default-active>

<default-visible>
<xsl:value-of select="$catalog_item_visible" />
</default-visible>

<basetype module="catalog" method="object">Объекты каталога</basetype>

<name><xsl:value-of select="$name" /></name>

<xsl:if test="string-length($catalog_item_template)">
<default-template>
<xsl:value-of select="$catalog_item_template" />
</default-template>
</xsl:if>
<properties>
<xsl:call-template name="common-group">
<xsl:with-param name="name" select="$name" />
</xsl:call-template>

<group name="product">
<title>1C: Общие свойства</title>

<xsl:if test="string-length(Описание)">
<property name="description" title="Описание" type="wysiwyg" allow-runtime-add="1">
<type data-type="wysiwyg" />
<title>Описание</title>
<value>
<xsl:choose>
<xsl:when test="Описание/@ФорматHTML = 'true'">
<xsl:value-of select="Описание"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="php:function('nl2br', string(Описание))" disable-output-escaping="yes" />
</xsl:otherwise>
</xsl:choose>
</value>
</property>
</xsl:if>

<property name="1c_catalog_id" type="string">
<title>Идентификатор каталога 1С</title>
<value><xsl:value-of select="$catalog-id" /></value>
</property>

<property name="1c_product_id" type="string">
<title>Идентификатор в 1С</title>
<value><xsl:value-of select="Ид" /></value>
</property>

<property name="artikul" type="string">
<title>Артикул</title>
<value><xsl:value-of select="Артикул" /></value>
</property>

<property name="bar_code" type="string">
<title>Штрих-код</title>
<value><xsl:value-of select="Штрихкод" /></value>
</property>

<property name="weight" type="float">
<title>Вес</title>
<value><xsl:value-of select="ЗначенияРеквизитов/ЗначениеРеквизита[Наименование = 'Вес']/Значение"/></value>
</property>


<xsl:apply-templates select="Картинка[1]" />


<property name="photos" type="multiple_image">
<title>Дополнительные фотографии товара</title>
<xsl:apply-templates select="Картинка[position() > 1]" />
</property>
</group>

<xsl:apply-templates select="ЗначенияСвойств" />
</properties>
</page>
</xsl:template>

<xsl:template match="Товар/Картинка[position() > 1]">
<xsl:if test="string-length(.)">
<value><xsl:attribute name="path">./images/cms/data/<xsl:value-of select="." /></xsl:attribute></value>
</xsl:if>
</xsl:template>
</xsl:stylesheet>
</source>

Теперь при выгрузке из 1С все дополнительные изображения товаров будут сразу отображаться на сайте:

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

[[category:Интеграция с 1С]]

Файл:Multiple image.png

2019-05-24T08:44:43Z

Vitaliks:

Скидка по карте

2019-05-20T06:50:28Z

Vitaliks:

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

Задача: активировать скидку, если у пользователя есть дисконтная карта.

Создадим новый справочник "Скидочные карты" в модуле Шаблоны данных вкладка Справочники кнопка "Добавить справочник". <br/>
[[Файл:Screenshot_207.png]]<br/>
В этом справочнике будут храниться номера дисконтных карт. Для добавления кода карты необходимо выбрать справочник и нажать кнопку "Посмотреть"<br/>
[[Файл:Screenshot_209.png]]<br/>
Далее нужно создать новый тип, дочерний к типу "Правила скидок", назовем его "Скидка по карте".<br/>

[[Файл:Screenshot_210.png]][[Файл:Screenshot_208.png]]<br/>
В справочник "Типы правил скидки" необходимо добавить новый элемент с именем "Скидочная карта" для которого указать:
Идентификатор - discountcard, Тип данных (id) - нужно указать id созданного ранее типа данных "Скидка по карте", "Допустимые типы скидки" добавить "На заказ"<br/>
[[Файл:Screenshot_212.png]][[Файл:Screenshot_211.png]]<br/>
В типе данных "Пользователь" необходимо добавить поле для номера дисконтной карты (пользователь сможет заполнить его в личном кабинете) в группу полей "Дополнительная информация" с идентификатором - card_discount.

При создании новой скидки выберем тип "На заказ" и в качестве правила скидки - созданное выше.
В файле /classes/modules/emarket/classes/discounts/rules/discountcard.php (его необходимо создать) пишем следующий код:
<source lang="php">
<?php
class discountcardDiscountRule extends discountRule implements orderDiscountRule {

public function validateOrder(order $order) {
$permissions = permissionsCollection::getInstance();
$currentUserId = $permissions->getUserId();
$objects = umiObjectsCollection::getInstance();
$userObject = $objects->getObject($currentUserId);

if ($userObject instanceof umiObject) {
$cardNum = $userObject->getValue("card_discount");
$nums = new selector ('objects');
$nums->types('object-type')->id('188');
$nums->where('name')->equals($cardNum);
$res=$nums->result;
if (count($res)){
return true;
} else {
return false;
}
}
}
}

</source>

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

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