Порядок, теги, точка фокуса, свои поля
Порядок
Перетаскиванием плиток. Он же — порядок вывода по умолчанию (&sortby=rank).
Выделение работает рамкой, Ctrl/Cmd-кликом и Shift-диапазоном; массовые действия применяются
к выделению. Клавиатура: стрелки, Delete, Ctrl/Cmd+A.
Теги
Теги общие для всего сайта, а не для ресурса: у каждого имя, латинский алиас и цвет. Назначаются в диалоге элемента, в том числе сразу нескольким выделенным.
В выводе фильтруются &tags=, режим — &tagsMode=AND|OR:
[[!prism? &tags=`nature,sea` &tagsMode=`AND`]]
Кадр
В диалоге элемента выделите рамкой нужную часть снимка. Соотношения — свободно, 1:1, 16:9, 3:2, 4:3; «Весь кадр» снимает обрезку.
Обрезка не трогает файл: прямоугольник хранится долями оригинала и применяется при создании
превью, до того как пресет уменьшает картинку. Значит её можно переделать или снять в любой
момент, она действует во всех пресетах и в лайтбоксе, а srcset и размеры в разметке считаются
от кадра.
Адрес превью от кадра не зависит, поэтому при сохранении кадра кэш превью этого элемента сбрасывается сам — вручную ничего делать не нужно.
Точка фокуса
Куда смотреть при обрезке. Пресеты с position: focal кадрируют вокруг неё, и её же учитывает
обрезка средствами CSS — чанки изображений выводят object-position из точки фокуса.
Если у элемента есть кадр, точка указывается по видимому кадру. Хранится она относительно оригинала — это свойство снимка, а не рамки, — но пресеты кадрируют внутри того, что им дали, поэтому диалог пересчитывает координаты в обе стороны.
Особые элементы
Флаг «особый» (featured) поднимает элемент вперёд при &featuredFirst=1, и prismThumbnail
берёт обложкой сначала особые.
Свои поля
Заводятся на странице Компоненты → Prism → Пользовательские поля: ключ латиницей
([a-z][a-z0-9_]*), подпись, тип и типы элементов, к которым поле применяется.
| Тип | Что хранит |
|---|---|
text | Строка |
textarea | Многострочный текст |
number | Число |
date | Дата ГГГГ-ММ-ДД |
bool | Флажок |
select | Один вариант из списка |
Значения проверяются по типу при сохранении и лежат в колонке Item.extra. В чанках доступны как
[[+extra.ключ]], в Fenom — {$extra.ключ}.
По ним можно сортировать и фильтровать:
[[!prism? &sortby=`extra.rating` &sortdir=`DESC`]]
[[!prism? &where=`{"extra.rating:>=": 4}`]]
Значение сравнивается по типу поля: число как число (10 идёт раньше 9, а не после), дата как
дата. Индекса по этим значениям нет — они хранятся в JSON-колонке; для галереи ресурса это
незаметно, для выборок в тысячи элементов учитывайте.
Переименование поля не переносит уже сохранённые значения. Удаление поля оставляет значения в данных, но они перестают проверяться и показываться.