Перейти к основному содержимому

Редактируемые элементы (Editables)

Редактируемые элементы — это заполнители в шаблонах, которые отображаются как виджеты для ввода в администраторском интерфейсе (так называемом режиме редактирования), а также выводят содержимое в режиме фронтенда. Редактируемые элементы являются важной частью управления контентом в документах.

Пример использования

Следующий код делает заголовок <h1> редактируемым в документе:

<h1>{{ pimcore_input("headline") }}</h1>  

В некоторых случаях, особенно с областями блоков (areablocks), редактируемые элементы могут вызывать исключения. Поскольку Pimcore внутренне использует метод __toString для рендеринга редактируемых элементов, Pimcore не может выбрасывать исключения в этом месте. Поэтому Pimcore ловит исключение и выводит его как строку, если включен режим отладки.

Чтобы избежать этого и заставить Pimcore выбрасывать исключение, вы можете вызывать редактируемые элементы следующим образом:

<h1>{{ pimcore_input("headline").render()|raw }}</h1>  

Pimcore автоматически отображает виджет ввода в режиме редактирования и рендерит содержимое при доступе к документу через фронтенд.

Список редактируемых элементов

НазваниеОписание
Areablockэто набор для создания контента, который позволяет вам вставлять предопределённые мини-приложения / блоки содержимого, называемые кирпичиками (brick), в areablock..
AreaArea позволяет вам использовать кирпичики определённого типа (так же, как и Areablock).
BlockBlock — это компонент цикла, который может содержать другие редактируемые элементы.
CheckboxРеализация чекбокса / булевого значения для документов.
DateПоле выбора даты с отображением даты в заданном формате.
RelationВозможность создать ссылку на любой другой элемент в Pimcore (документ, ассет, объект).
Relations (Many-To-Many Relation)Возможность редактирования нескольких ссылок на другие элементы в Pimcore (документы, ассеты, объекты).
ImageМесто, где вы можете назначить изображение (из модуля ассетов).
InputОднострочный текстовый ввод.
LinkРедактируемый компонент ссылки.
MultiselectРеализация множественного выбора для документов.
NumericЧисловой редактируемый элемент аналогичен текстовому вводу, но с особыми параметрами для чисел (например, минимальное значение, десятичная точность и т. д.).
PDFЭтот редактируемый элемент позволяет вставить ассеты документов (pdf, doc, xls и т. д.) в документы (как видео, изображение и т. д.).
RenderletRenderlet — это специальный контейнер, который может обрабатывать любой объект в Pimcore (документы, ассеты, объекты).
SelectВыпадающий список, используемый как редактируемый элемент.
Snippet (embed)Используйте редактируемый элемент Snippet для встраивания повторно используемого документа, например, для создания тизеров, блоков и так далее.
TableЭтот редактируемый элемент позволяет добавлять полностью редактируемую таблицу.
TextareaРеализация текстовой области для документов.
VideoИспользуйте редактируемый элемент Video для вставки активных фильмов в содержание страниц.
WYSIWYGWYSIWYG-редактор.
Scheduled BlockЗапланированные блоки позволяют планировать контент на определенные временные метки.

Вы можете предложить улучшение документации или задать вопрос в комментариях.
Если вам нужна полноценная консультация — вы можете заказать её на нашем сайте.