Наборы параметров позволяют упростить управление вызовом сниппетов убрав необходимость задания всех параметров при вызове сниппета. Например стандартный вызов сниппета vcatGetPage выглядит следующим образом:
[[!vcatGetPage?element=`getResources`&tmplId=`1`&parents=`3`&debug=`1`&tpl=`catItem`&includeTVs=`1`&includeTVList=`currency,price`]]
При этом большая часть параметров вызова сниппета - стандартные и не меняются. Для того, чтобы сократить размер вызова можно использовать наборы параметров, которые позволяют сгруппировать и сохранить данные под общим именем, тем самым упростив вызов сниппета, например:
[[!vcatGetPage@catalog]]
В данном случае, система произведёт вызов сниппета vcatGetPage и передаст в качестве параметров, все параметры, которые были созданы на вкладке «Параметры» при редактировании сниппета.
При использовании наборов параметров рекомендуется создавать новые наборы воспользовавшись кнопкой и указав имя и описание набора. При этом имя должно быть уникальным среди всех сниппетов системы, т.е. наборы параметров не зависят от сниппета, а являются отдельной сущностью.
Для управления наборами параметров существует специальный интерфейс доступный из главного меню, в разделе «Инструменты» → «Наборы параметров»
При вызове указанного пункта меню, на экране будет отображена панель редактирования наборов параметров:
В панели слева размещается список наборов параметров. Если развернуть каждый элемент в списке, будут отображены элементы (сниппеты), к которым привязан данный набор параметров. Один и тот же набор, может быть использован для различных элементов (сниппетов, чанков и т.д.). Например, в нашем случае набор параметров test привязан сразу к двум сниппетам: getPages и vcatGetPage. Указанная информация говорит о том, что данные в указанных наборах параметров могут быть использованы при вызове и того и другого сниппета.
Для редактирования наборов параметров, достаточно в дереве параметров выбрать набор или связанный с ним элемент, и в таблице справа, будут отображены либо все параметры указанного набора, либо все параметры выбранного элемента с учётом параметров изменённых в данном наборе. Они будут отображены в таблицы другим цветом, например параметр pageFirstTpl окрашен зелёным, т.к. он изменён относительно стандартного набора параметров сниппета getPage:
Редактирование значения параметров осуществляется стандартным образом при помощи двойного клика по ячейке в колонке «Значение», при этом текущее значение будет заменено на поле для ввода. При этом для сохранения введённых изменений необходимо воспользоваться кнопкой .
Если вы хотите привязать дополнительный элемент (сниппет, чанк и т.д.) к набору параметров, необходимо выполнить щелчок правой кнопкой мыши по набору параметров в дереве параметров слева и выбрать в контекстном меню пункт «Связать с элементом», при этом на экране будет отображено окно привязки набора параметров к элементу:
В указанном окне необходимо выбрать вид элемента в поле «Имя класса»:
Затем в поле «Элемент» необходимо выбрать элемент, с которым вы хотите установить связь. После этого необходимо нажать на кнопку сохранить и указанный набор параметров можно будет использовать при вызове указанного элемента или при настройке указанного элемента.