Promodo CMS

Создание шаблона данных

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

Для создания шаблона данных необходимо:

  1. В панели администратора во вкладке «Настройки сайта» перейти в раздел «Шаблоны данных».
  2. Нажать на кнопку «Создать шаблон данных».
Создание шаблона данных.

Создание шаблона данных состоит из двух шагов:

  1. Выбор назначения шаблона данных;
  2. Создание групп и полей для создаваемого шаблона.

На первом шаге необходимо заполнить поле «Название» и выбрать из выпадающего списка назначение создаваемого шаблона данных.

«Название» - текстовое поле, определяющее название шаблона.

«Назначение» - выпадающий список типов шаблона данных. Данная опция позволяет выбрать назначение шаблона: каталог, раздел каталога, объект каталога, категория, страница, форма обратной связи, меню.

Созданный шаблон будет доступен для выбора при создании выбранного в поле «Назначение» объекта.

Создание шаблона данных. Шаг первый.

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

На втором этапе необходимо задать поля для объектов, т.е. для шаблона данных.

Для удобства навигации поля разбиваются на группы.

Создание группы полей

Например, для создания шаблона характеристик товара можно выделить такие группы: «Габариты», «Функции».

  • В группе «Габариты» можно выделить следующие поля: «Вес» , «Длина» , «Ширина».
  • В группе «Функции» указать поля: «Режимы», «Скорость».

Для создания группы полей необходимо нажать на кнопку «Создать группу полей». В появившемся окне необходимо заполнить поля «Название». Поле «Идентификатор» заполняется автоматически и необходимо для определения поля в шаблоне вывода. Кнопка «Создать» завершает процесс создания группы полей.

Кнопка «Создать поле» дает возможность создать поле. Для этого необходимо заполнить следующие поля: «Название», «Идентификатор», «Значение по умолчанию», «Обязательное», «Мультизначение», «Видимое» и выбрать тип создаваемого поля.

Поле «Название» - названия поля. Это поле обязательное для заполнения.

Поле «Идентификатор» (необходимо для определения поля в шаблоне вывода) создается автоматически путем транслитерации поля «Название». Это поле обязательное для заполнения.

В поле «Значение по умолчанию» можно задать значение поля, которое будет установлено по умолчанию при создании объекта сайта.

Флажок напротив «Обязательное» говорит о обязательности заполнения этого поля при наполнении объекта сайта.

Флажок напротив «Видимое» говорит о видимости поля при наполнении объекта сайта. Если флажок не установлен, значит данное поле не будет отображаться для заполнения.

Опция «Мультизначение» позволяет при наполнении объекта сайта создавать несколько значений для данного поля. Опция работает для следующих типов полей: целое число, вещественное число, строка, файл, изображение и цена.

Выбор типа поля представляет собой выпадающий список с выбором типов:

Выбор типа поля
  • целое число (например, 122);
  • дата;
  • строка (строка до 200 символов);
  • текст – дает возможность задавать текст, неограниченный в объемах;
  • вещественное число – дает возможность задавать вещественное число;
  • ссылка на контент (ссылку на любой объект, имеющийся на сайте);
  • файл – дает возможность загружать файл;
  • изображение – дает возможность загружать изображение;
  • флажок (checkbox) – задает возможность выбора;
  • пароль;
  • цена – дает возможность задавать цену товара;
  • выбор из списка – возможность производить выбор значений из заранее определенного списка, созданного при создании этого поля;
  • множественный выбор из списка – дает возможность производить выбор нескольких значений из заранее определенного списка, созданного при создании этого поля.

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

Выбор из списка

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

Создание шаблона данных. Шаг второй.

Для окончательного создания шаблона данных необходимо нажать кнопку «Создать шаблон данных».

Далее можно настроить вывод создаваемых полей, т.е. «Шаблон вывода».

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

Важно!
При изменении шаблона вывода важно соблюдать синтаксис языка шаблонов Smarty.

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

  • title - полный заголовок страницы
  • title_short - короткий заголовок страницы
  • textShort - текст, обрезанный до метки <!--pagecut-->
  • page_title - заголовок страницы
  • text - описание/текст страницы
  • meta_keywords - значение мета-тега keywords
  • meta_description - значение мета-тега description
  • meta_robots  - значение мета-тега robots 
  • meta_author - значение мета-тега author
  • date_entered - дата создания страницы
  • date_modified - дата последнего редактирования страницы
  • id - идентификатор страницы
  • alias - псевдоним, часть url страницы
  • content_type_id - идентификатор типа данных страницы
  • visible_on_site - видимость страницы на сайте
  • is_home_page - флаг, является ли страница главной
  • content_template_id - идентификатор шаблона данных

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

{$mainContent.name},

где name - имя свойства (например, {$mainContent.alias} передает псевдоним страницы).

Для вывода даты используйте следующую конструкцию:

{$mainContent.date_entered->toString("j F Y", "php", "ru")},

где j - день, F - месяц, Y - год.

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

{$mainContent.template_group.template_field},

где template_group - идентификатор группы объектов, template_field - идентификатор поля.

Пример создания шаблона данных для объекта каталога.

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

Для создания нового шаблона нажимаем кнопку «Создать шаблон».

Задаем имя шаблона - «Товар». Выбираем назначение - «Объект каталога». Нажимаем «Сохранить».

Создаем группу полей «Характеристики товара».

Создаем поля «Вес», «Цвет» и «Изображение».

Для поля «Вес» задаем тип «Целое число». Для поля «Цвет» выбираем тип «Выбор из списка» и ставим галочку «Обязательное», если хотим, чтоб это поле было обязательно заполнено. В появившемся ниже поле заполняем значения цветов, каждое с новой строки: синий, красный, зеленый. Для поля «Изображение» выбираем тип «Изображение» и ставим флажок напротив «Мультизначение».

Создаем еще группу полей, даем ей название «Описание». В ней создаем поле «Описание товара». Присваиваем этому полю тип «Текст».

Пример создания шаблона данных

Нажимаем кнопку «Сохранить».

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

Пример использования шаблона данных

Для редактирования шаблона данных необходимо выбрать необходимый шаблон и под ним нажать иконку «Редактировать».

Скачать документацию

Создание шаблона данных. Шаг первый.
Создание шаблона данных. Шаг второй.
Пример создания шаблона данных
Пример использования шаблона данных
Создание шаблона данных.
Создание группы полей
Выбор типа поля
Выбор из списка