Системные настройки

Все настройки живут в пространстве имён prism (Система → Системные настройки, фильтр по namespace prism). Значения по умолчанию расставляются при установке; при обновлении пакета изменённые вами значения не перезаписываются.

Всего настроек: 47.

Основные

Ключ	По умолчанию	Назначение
prism.templates	пусто	Id шаблонов через запятую. Пусто — вкладка Prism показывается на всех ресурсах.
prism.video_enable	1	Показывать подвкладку «Видео» и разрешить добавление видео.
prism.files_enable	1	Показывать подвкладку «Файлы» и разрешить прикрепление произвольных файлов.
prism.embed_enable	1	Показывать подвкладку «Embed» и разрешить вставку iframe/HTML (с санитизацией).
prism.signing_key	пусто	Генерируется автоматически при установке. Подписывает URL превью «по запросу», чтобы нельзя было запросить произвольные размеры. Смена ключа делает недействительными все URL превью.
prism.uninstall_drop_tables	0	Если включено, удаление пакета удалит все таблицы prism_* с данными. По умолчанию выключено, чтобы случайное удаление пакета не уничтожило записи о медиа.
prism.cleanup_on_delete	1	Если включено, при удалении элемента (и при очистке корзины ресурсов) физический файл и его превью удаляются с диска. Выключите, если файлы используются где-то ещё.
prism.cache_ttl	0	Верхняя граница для &cache=1 в сниппетах. 0 — хранить до изменения элементов (кэш сбрасывается автоматически при любом изменении в Prism).

Загрузка

Ключ	По умолчанию	Назначение
prism.source_id	1	Id источника файлов MODX, в который загружаются изображения. Карта «шаблон → источник» появится позже.
prism.source_map	пусто	JSON: {"": 1, "3": 2, "5": {"": 2, "video": 3}} — ключ: id шаблона или *, значение: id источника или объект по типам (image, video, file, embed, *). Пусто — используется prism.source_id.
prism.path_template	prism/{resource_id}/	Папка внутри источника. Плейсхолдеры: {resource_id}, {yyyy}, {mm}. По умолчанию prism/{resource_id}/.
prism.image_extensions	jpg,jpeg,png,gif,webp,avif,svg	Через запятую. Тип файла дополнительно проверяется по содержимому, не только по расширению.
prism.max_upload_mb	64	Ограничение на один файл. Загрузка идёт частями, поэтому может превышать upload_max_filesize хостинга.
prism.chunk_size_mb	1	Должен быть меньше upload_max_filesize и post_max_size в PHP. 1 МБ подходит для большинства хостингов.
prism.max_dimension	4096	Изображения с большей стороной уменьшаются при загрузке. 0 — не уменьшать.
prism.max_pixels	80000000	Предел ширина × высота (80 Мпикс). Изображение сверх него отклоняется до чтения — защита от файлов, которые весят мало, а в памяти разворачиваются в гигабайты. 0 — без проверки.
prism.dedupe	1	Если файл с таким же содержимым уже есть в источнике, загрузка вернёт существующий элемент вместо копии.
prism.save_original_name	1	Оригинальное имя файла сохраняется в поле «Название»; имя на диске всегда транслитерируется.
prism.filename_translit	1	Кириллица и диакритика в имени заменяются латиницей: «Горы Кавказа.jpg» → «gory-kavkaza.jpg». Выключено — такие символы просто удаляются. Транслитерация приводит имя к нижнему регистру.
prism.filename_lowercase	1	Выключите, чтобы сохранить регистр исходного имени. Не влияет на транслитерацию и на хеш.
prism.filename_hash	0	Имя заменяется на MD5 исходного, расширение сохраняется: «Прайс 2026.pdf» → «6f1e…c3.pdf». Имеет приоритет над транслитерацией и регистром. Пригодится, если имя файла не должно попадать в URL. Небезопасные символы удаляются всегда, независимо от этих настроек.
prism.new_item_position	end	start — в начало галереи, end — в конец.
prism.keep_gps	0	По умолчанию координаты удаляются из метаданных ради приватности.
prism.video_extensions	mp4,webm,mov,m4v	Локальные видео (провайдер local). Тип проверяется по содержимому.
prism.file_extensions	см. описание	Что можно прикреплять во вкладке «Файлы». Исполняемые типы (php, html, js, exe…) отклоняются всегда.
prism.max_file_mb	256	Лимит для вкладок «Видео» и «Файлы»; для изображений действует prism.max_upload_mb.

Видео и embed

Ключ	По умолчанию	Назначение
prism.embed_whitelist	см. описание	Через запятую. Iframe с других доменов отклоняются. Поддомены совпадают автоматически (player.vimeo.com входит в vimeo.com).
prism.video_poster_second	1	Из локального видео на этой секунде берётся постер, если установлен ffmpeg.
prism.ffmpeg_path	пусто	Каталог с ffmpeg/ffprobe, если их нет в PATH. Пусто — автоопределение.
prism.download_counter	0	Если включено, ссылки файлов идут через download.php и счётчик хранится в properties.downloads.

Превью

Ключ	По умолчанию	Назначение
prism.thumb_mode	ondemand	ondemand — превью генерируются при первом запросе (нужен rewrite на img/index.php); pregenerate — все пресеты создаются сразу при загрузке.
prism.driver	gd	gd или imagick. Imagick быстрее и лучше по качеству, если установлен.
prism.default_format	auto	auto — чанк выводит <picture> с avif/webp и запасным исходным форматом; jpg, png, webp, avif — конкретный формат.
prism.thumb_quality	82	От 1 до 100 для пресетов без явного качества.
prism.watermark	пусто	Путь к картинке от корня сайта, например assets/watermark.png. Пусто — без знака. Накладывается на все превью; отдельный пресет может отключить его или задать свой в поле «Опции».
prism.watermark_position	bottom-right	top-left, top, top-right, left, center, right, bottom-left, bottom, bottom-right.
prism.watermark_padding	10	Отступ от края превью.
prism.watermark_width	пусто	Ширина знака: 120 (пиксели) или 25% от превью. Пусто — исходный размер.
prism.watermark_opacity	100	От 1 до 100. 100 — без прозрачности.
prism.filters	пусто	Эффекты для всех превью: greyscale, sepia, blur=10, pixel=8, sharp=15, bri=-20, con=15, gam=1.5. Несколько — через |. Можно передать JSON-объект параметров Glide.

Вывод на сайте

Ключ	По умолчанию	Назначение
prism.lightbox	пусто	Что открывать по клику на изображение: пусто (ничего, только разметка), photoswipe или fancybox. Переопределяется параметром сниппета &lightbox.
prism.layout	grid	grid — обычная сетка, masonry — плитка разной высоты, swiper — слайдер. Переопределяется параметром сниппета &layout.
prism.register_assets	1	Если выключить, сниппет выдаст только разметку, а CSS и JS библиотеки вы подключите сами. Полезно, когда библиотеки уже есть в сборке темы.
prism.libraries	пусто	JSON: переопределение путей и опций по умолчанию для photoswipe, fancybox, swiper, masonry. Пусто — встроенные копии из assets/components/prism/vendor. Fancybox в пакет не входит (платная лицензия), укажите здесь свою копию. Удобнее править на странице Компоненты → Prism → Вывод.

Панель администратора

Ключ	По умолчанию	Назначение
prism.rte_enable	1	Добавляет кнопку над полями RTE (TinyMCE RTE, CKEditor, обычный textarea). Для кнопки в тулбаре TinyMCE добавьте «prism» в tinymcerte.toolbar1.
prism.rte_templates	см. описание	JSON «имя → HTML». Плейсхолдеры: {url} {thumb} {thumb2x} {alt} {title} {name} {width} {height} {embed} {size}.
prism.per_page	40	Сколько элементов медиа загружает сетка админки за один запрос.
prism.dev_server	пусто	Только для разработки. Если задано (например http://localhost:5173), панель загружает React-приложение с dev-сервера Vite с горячей перезагрузкой вместо собранного бандла. На продакшене оставьте пустым.