Свойства (Properties)

Общее

Каждый элемент в Pimcore может иметь произвольные свойства. Их можно найти на вкладке Properties для каждого типа элементов (документы, ассеты, объекты).

Свойства можно использовать для задания специального поведения при рендеринге документа.

Несколько примеров использования:

• Скрыть основную навигацию
• Показать боковую панель
• Подключить дополнительную таблицу стилей

Получение свойства в шаблоне

Ниже приведён пример того, как получить значение свойства в шаблоне:

{# получить значение свойства с именем "hideNavigation" #}  
{% set hideNavigation = document.getProperty('hideNavigation') %}  

Предопределённые (Predefined) свойства

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

Предопределённое не означает, что значение будет автоматически доступно для каждого документа. Если нужно добавить глобальные свойства, доступные везде, используйте Website Settings.

Пример конфигурации

Конфигурация предопределённых свойств находится в меню Settings -> Predefined properties.

В конфигурации доступны следующие поля

Название	Обязательное?	Описание
Name	Да	: удобочитаемое имя, отображаемое в селекторе.
Description	Нет	описание, помогающее понять назначение свойства.
Key	Да	поле-ключ, который используется в коде для получения значения свойства. Пример: $document->getProperty("key");
Type	Да	указывает тип содержимого, который разрешён в свойстве. Доступные типы: text, document, asset, object, bool (checkbox), select.
Value	Нет	здесь можно определить значение по умолчанию для этого свойства, которое будет автоматически добавлено в элемент при добавлении свойства. Поле необязательно. Более подробную информацию смотрите в примере конфигурации, приведенном выше.
Configuration	Нет	используется для настройки свойства. В текущей версии применяется только для типа свойства select. Опции разделяются запятой.
Content-Type	Да	определяет для какого типа элемента (document, asset или object) свойство должно быть доступно.

Примечание
Любое из этих полей можно переопределить на конкретном элементе после добавления свойства.