Редактируемые элементы (Editables)
Редактируемые элементы — это заполнители в шаблонах, которые отображаются как виджеты для ввода в администраторском интерфейсе (так называемом режиме редактирования), а также выводят содержимое в режиме фронтенда. Редактируемые элементы являются важной частью управления контентом в документах.
Пример использования
Следующий код делает заголовок <h1> редактируемым в документе:
<h1>{{ pimcore_input("headline") }}</h1>
В некоторых случаях, особенно с областями блоков (areablocks), редактируемые элементы могут вызывать исключения. Поскольку Pimcore внутренне использует метод __toString для рендеринга редактируемых элементов, Pimcore не может выбрасывать исключения в этом месте. Поэтому Pimcore ловит исключение и выводит его как строку, если включен режим отладки.
Чтобы избежать этого и заставить Pimcore выбрасывать исключение, вы можете вызывать редактируемые элементы следующим образом:
<h1>{{ pimcore_input("headline").render()|raw }}</h1>
Pimcore автоматически отображает виджет ввода в режиме редактирования и рендерит содержимое при доступе к документу через фронтенд.
Список редактируемых элементов
| Название | Описание |
|---|---|
| Areablock | это набор для создания контента, который позволяет вам вставлять предопределённые мини-приложения / блоки содержимого, называемые кирпичиками (brick), в areablock.. |
| Area | Area позволяет вам использовать кирпичики определённого типа (так же, как и Areablock). |
| Block | Block — это компонент цикла, который может содержать другие редактируемые элементы. |
| Checkbox | Реализация чекбокса / булевого значения для документов. |
| Date | Поле выбора даты с отображением даты в заданном формате. |
| Relation | Возможность создать ссылку на любой другой элемент в Pimcore (документ, ассет, объект). |
| Relations (Many-To-Many Relation) | Возможность редактирования нескольких ссылок на другие элементы в Pimcore (документы, ассеты, объекты). |
| Image | Место, где вы можете назначить изображение (из модуля ассетов). |
| Input | Однострочный текстовый ввод. |
| Link | Редактируемый компонент ссылки. |
| Multiselect | Реализация множественного выбора для документов. |
| Numeric | Числовой редактируемый элемент аналогичен текстовому вводу, но с особыми параметрами для чисел (например, минимальное значение, десятичная точность и т. д.). |
| Этот редактируемый элемент позволяет вставить ассеты документов (pdf, doc, xls и т. д.) в документы (как видео, изображение и т. д.). | |
| Renderlet | Renderlet — это специальный контейнер, который может обрабатывать любой объект в Pimcore (документы, ассеты, объекты). |
| Select | Выпадающий список, используемый как редактируемый элемент. |
| Snippet (embed) | Используйте редактируемый элемент Snippet для встраивания повторно используемого документа, например, для создания тизеров, блоков и так далее. |
| Table | Этот редактируемый элемент позволяет добавлять полностью редактируемую таблицу. |
| Textarea | Реализация текстовой области для документов. |
| Video | Используйте редактируемый элемент Video для вставки активных фильмов в содержание страниц. |
| WYSIWYG | WYSIWYG-редактор. |
| Scheduled Block | Запланированные блоки позволяют планировать контент на определенные временные метки. |
Вы можете предложить улучшение документации или задать вопрос в комментариях.
Если вам нужна полноценная консультация — вы можете заказать её на нашем сайте.