Настройки компонента

Все настройки — в Настройки → Системные настройки, пространство имён gallery3x. При обновлении пакета изменённые вами значения сохраняются.

Основные

Ключ	По умолчанию	Описание
`gallery3x.templates`	пусто	ID шаблонов через запятую, у которых появляются вкладки компонента. Пусто — вкладок нет нигде.
`gallery3x.source_id`	`ID «Gallery3x Source»`	Источник файлов по умолчанию. Заполняется при установке.
`gallery3x.source_map`	пусто	Разные источники для разных шаблонов, по правилу в строке: `12:3` — шаблон 12 в источник 3; `15,16:4` — шаблоны 15 и 16; `*:2` — все остальные; `12:video:5` — только превью видео шаблона 12 (типы: image, video, attach, embed). Строки с `#` или `//` — комментарии. Пусто — везде `gallery3x.source_id`.
`gallery3x.ignore_template_source`	`Да`	Да — не учитывать поле «Источник файлов» самого шаблона. Нет — источник шаблона используется, если для него нет правила в `gallery3x.source_map`.
`gallery3x.per_page`	`30`	Сколько фото показывать на одной странице вкладки в админке.
`gallery3x.new_file_position`	`end`	Куда ставить новые фото: `end` — в конец, `start` — в начало.
`gallery3x.groups_per_user`	`Нет`	Да — каждый менеджер видит только свои фото, видео и группы (созданные им). Нет — всё общее.
`gallery3x.collections_thumb_size`	`small`	Размер превью для сниппета `g3xCollectionsThumbnail` (колонка в Collections).

Вкладки

Ключ	По умолчанию	Описание
`gallery3x.video_enable`	`Нет`	Вкладка «Видео G3x».
`gallery3x.files_enable`	`Нет`	Вкладка «Файлы G3x» (вложения PDF, DOC, ZIP и др.).
`gallery3x.embed_enable`	`Нет`	Вкладка «Embed G3x» (карты, виджеты, iframe).

Обработка изображений

Размеры превью задаются не здесь, а в свойствах источника файлов — см. Генерация превью. Настройки ниже применяются ко всем превью; оригинал не меняется. После изменения перегенерируйте превью.

Ключ	По умолчанию	Описание
`gallery3x.driver`	`imagick`	Библиотека обработки: `imagick` (рекомендуется) или `gd`.
`gallery3x.format`	`webp`	Формат всех превью: `webp`, `avif`, `jpg`, `png`. Перекрывает `fm` в размерах источника. Пусто — формат оригинала.
`gallery3x.filters`	пусто	Эффекты Glide через `\|`, например `greyscale`, `blur=5`, `sepia\|bri=10\|con=-5`.
`gallery3x.watermark_path`	пусто	Файл водяного знака от корня сайта, например `assets/images/logo.png`. Пусто — без водяного знака.
`gallery3x.watermark_position`	`bottom-right`	`top-left`, `top`, `top-right`, `left`, `center`, `right`, `bottom-left`, `bottom`, `bottom-right`.
`gallery3x.watermark_padding`	`10`	Отступ водяного знака от края, px.

Загрузка и имена файлов

Ключ	По умолчанию	Описание
`gallery3x.upload_parallel`	`1`	Сколько файлов загружать одновременно. На виртуальном хостинге — 1, на своём сервере можно 5–10.
`gallery3x.upload_multiple`	`Нет`	Да — несколько файлов в одном запросе (быстрее, но упирается в `max_file_uploads` PHP). Нет — каждый файл отдельно.
`gallery3x.save_original_name`	`Да`	Записывать исходное имя файла (без расширения) в поле «Название».
`gallery3x.filename_translit`	`Да`	Кириллицу в имени файла — латиницей: `Фото.jpg` → `foto.jpg`.
`gallery3x.filename_sanitize`	`Да`	Убирать из имени всё, кроме букв, цифр, `-` и `_`; пробелы — в дефис.
`gallery3x.filename_lowercase`	`Да`	Имя и расширение — в нижнем регистре.
`gallery3x.filename_as_hash`	`Нет`	Имя файла — его MD5-хэш. Важнее трёх настроек выше.

Совпадающие имена не перезаписываются: к новому файлу добавляется номер. Максимальный размер файла ограничивает настройка MODX upload_maxsize и upload_max_filesize / post_max_size в PHP.

Плейсхолдеры изображений

См. Плейсхолдеры изображений.

Ключ	По умолчанию	Описание
`gallery3x.set_placeholders`	`Нет`	Включить плейсхолдеры `[[+g3x.N]]` на страницах сайта.
`gallery3x.placeholders_tpl`	`@INLINE <a href=…><img src=…></a>`	Чанк для `[[+g3x.N]]`. Пусто — вместо разметки выводится массив данных (для отладки).
`gallery3x.placeholders_for_templates`	пусто	ID шаблонов, где работают плейсхолдеры. Пусто — все шаблоны.
`gallery3x.placeholders_thumbs`	`small,medium,big`	Какие размеры превью отдавать в плейсхолдерах.

Визуальный редактор

Ключ	По умолчанию	Описание
`gallery3x.rte_enable`	`Нет`	Кнопка «Вставить из галереи» в CKEditor / TinyMCE RTE.
`gallery3x.rte_templates`	пусто	Шаблоны с кнопкой: пусто — как `gallery3x.templates`, `*` — все.
`gallery3x.rte_views`	пусто	JSON со своими видами вывода. См. Вставка галерей в визуальный редактор.

Дополнительные поля

У фото, видео, файлов и embed есть поля extra_text, extra_text2, extra_num, extra_date. Их подписи в окне редактирования меняют настройки gallery3x.<тип>_label_extra_text и т.д., название вкладки — gallery3x.<тип>_label_tab_extra, где тип — image, video, attach, embed. Пусто — подпись по умолчанию.

Прочее

Ключ	По умолчанию	Описание
`gallery3x.groups_processor`	`Gallery3x\Processors\GetGroupsCombined`	Класс процессора списка групп. См. Кастомизация процессора групп.
`gallery3x.kinescope_api_token`	пусто	Токен Kinescope API: название, описание и обложка видео Kinescope. Без токена данные берутся из страницы плеера.
`gallery3x.vk_app_id`	пусто	Интеграция с API VK (`vk_refresh_token`, `vk_device_id` заполняются при авторизации). См. API VK.com.

Права доступа

При установке создаётся политика доступа с правами компонента. Менеджеру нужны права на просмотр и сохранение ресурсов, а для работы с галереей — права gallery3x_view, gallery3x_save, gallery3x_remove (у администратора с полными правами они есть).