Инструменты пользователя


Наборы параметров

Наборы параметров позволяют упростить управление вызовом сниппетов убрав необходимость задания всех параметров при вызове сниппета. Например стандартный вызов сниппета vcatGetPage выглядит следующим образом:

[[!vcatGetPage?element=`getResources`&tmplId=`1`&parents=`3`&debug=`1`&tpl=`catItem`&includeTVs=`1`&includeTVList=`currency,price`]]

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

[[!vcatGetPage@catalog]]

В данном случае, система произведёт вызов сниппета vcatGetPage и передаст в качестве параметров, все параметры, которые были созданы на вкладке «Параметры» при редактировании сниппета.

Рисунок 1. Вкладка "Параметры"

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

Управление наборами параметров

Для управления наборами параметров существует специальный интерфейс доступный из главного меню, в разделе «Инструменты» → «Наборы параметров»

Рисунок 2. Меню "Инструменты"

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

Рисунок 3. Панель управления наборами параметров

В панели слева размещается список наборов параметров. Если развернуть каждый элемент в списке, будут отображены элементы (сниппеты), к которым привязан данный набор параметров. Один и тот же набор, может быть использован для различных элементов (сниппетов, чанков и т.д.). Например, в нашем случае набор параметров test привязан сразу к двум сниппетам: getPages и vcatGetPage. Указанная информация говорит о том, что данные в указанных наборах параметров могут быть использованы при вызове и того и другого сниппета.

Рисунок 4. Пример привязки набора параметров к нескольким сниппетам

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

Рисунок 5. Обозначение параметров

Редактирование значения параметров осуществляется стандартным образом при помощи двойного клика по ячейке в колонке «Значение», при этом текущее значение будет заменено на поле для ввода. При этом для сохранения введённых изменений необходимо воспользоваться кнопкой .

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

Рисунок 6. Создание привязки наборов параметров

В указанном окне необходимо выбрать вид элемента в поле «Имя класса»:

  1. modChunk - если вы хотите связать параметры с чанком;
  2. modPlugin - если вы хотите связать параметры с плагином;
  3. modSnippet - если вы хотите связать параметры со сниппетом;
  4. modTemplateVar - если вы хотите связать параметры с переменной шаблона;

Затем в поле «Элемент» необходимо выбрать элемент, с которым вы хотите установить связь. После этого необходимо нажать на кнопку сохранить и указанный набор параметров можно будет использовать при вызове указанного элемента или при настройке указанного элемента.