Данные шаблона (метаданные JSON) ^#3082

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

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

Для описания структуры необходимых Вам данных раскройте список "Настройки", далее - "Данные сайта" и выберите пункт "Метаданные".

Нажмите на кнопку "Создать".

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

• Название - произвольное название, описывающее тип данных (например, "Аккордеон", "Слайдер" и т.д.).
• ID схемы - уникальный числовой идентификатор, по которому будет происходить привязка данных к алиасу.
• Схема JSON - описание самой структуры данных (полей и их типов) в формате json (в нашем примере это просто поле текстового редактора для аккордеона на сайте).

В конце нажмите "Сохранить и закрыть".

Обратите внимание!

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

После сохранения Вы попадете в раздел заполнения данных.

Добавление данных осуществляется нажатием на кнопку "+".

Обратите внимание!

• Тут же Вы можете перейти к окну редактирования структуры метаданных, прописанной в предыдущем. Для этого нажмите на кнопку "Метаданные".

После нажатия на "+" откроется окно создания элемента данных.

Поскольку в нашем примере мы работаем с аккордеоном, необходимо:

• Заполнить поле названия.
• Вписать текст для аккордеона в текстовый редактор.
• Сохранить изменения.

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

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

Обратите внимание!

• Несмотря на то что, как Вы могли обратить внимание, в шаге 3 в структуре мы прописали только одно поле (html с названием "Текст"), при создании элемента мы видим еще одно поле "Название". Дело в том, что поле заголовка создается автоматически, к каждому набору данных. Это нужно учитывать, если в Вашем наборе Вам нужен заголовок - нет необходимости создавать специальное поле, оно и так будет создано.

Для того чтобы привязать созданную структуру к алиасу, перейдите в раздел "Шаблоны и файлы".

 Откройте шаблон, к которому хотите привязать данные (в нашем примере это "_Главная. Верх").

И нажмите на кнопку "Данные".

В открывшемся окне нажмите на кнопку "Добавить новые данные".

Далее заполните следующие поля:

• Название - так будет называться блок в интерфейсе CMS. Укажите любое удобное для вас имя (в нашем примере это "Аккордеон").
• Алиас - имя переменной в шаблоне, помимо этого алиас содержит служебную информацию. Имя алиаса используется в шаблонах для вывода содержимого этой переменной, то есть того, чем будет заполнен блок. Может содержать латинские буквы и знак подчеркивания.
• Тип данных - определяющая часть переменной, например "Файлы", "Тексты", "Иллюстрации", "Меню" и т.д. В нашем примере мы сохраняем вариант "Метаданные", так как используем не готовую выборку, а свою, описанную с помощью json.
• ID схемы - id, который задавали json-структуре в шаге 3.
• Общий - используется, чтобы указать, что данные являются общими, то есть задаются один раз для всех страниц, содержащих этот шаблон (если галочка не установлена, блок будет заполняться для каждой страницы отдельно и будет располагаться в “Данных страницы”, а не в "Общих блоках"). 
• Заполняется массивом - позволяет создать массив элементов, каждый из которых будет соответствовать структуре, описанной в json. В противном случае элемент будет создан в единичном экземпляре.

В конце не забудьте сохранить изменения.

После создания алиаса данных можно приступить к наполнению.

Наполнение данными можно произвести в разделе "Страницы".

Если необходимо заполнить алиас с отмеченным полем "Общий" - можно перейти к редактированию любой из страниц и внести правки на вкладке "Общие блоки".

Если же алиас не общий - перейдите к редактированию той страницы, данные для которой необходимо внести.

В нашем примере - алиас не общий, соответственно, мы открываем для редактирования нужную страницу.

Теперь нажмите на название алиаса, выделенное зеленым цветом и знаком плюса (это означает, что к нему еще не привязаны никакие данные).

Затем нажмите "Выбрать".

И выберите созданные Вами элементы.

Итак, после того, как данные заполнены, они становятся доступны в шаблоне посредством алиаса.

Синтаксис шаблонизатора smarty для данных прост - {$alias.field_name}, где alias - созданный нами алиас, а field_name - имя поля, описанное в структуре json.

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