Skip to main content

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

Все настройки компонента Gallery3x находятся в админ-панели MODX в разделе Настройки → Системные настройки. В выпадающем списке "Пространство имен" выберите gallery3x, чтобы увидеть все доступные опции.

Настройки разделены на логические группы для удобства управления.

Основные настройки

то ключевые параметры, которые определяют, где компонент будет работать и хранить файлы.

Ключ Название Описание
gallery3x.source_id Источник файлов Укажите ID источника файлов (Media Source), где будут храниться изображения. Обычно компонент создает свой источник при установке и прописывает его ID автоматически.
gallery3x.driver Драйвер обработки Библиотека для обработки изображений на сервере.
Варианты: imagick (рекомендуется) или gd.
gallery3x.templates Активные шаблоны Список ID шаблонов через запятую (например: 1, 3, 5). Вкладка "Галерея" появится только у ресурсов с этими шаблонами. Если пусто — вкладка скрыта.
gallery3x.format Формат конвертации Формат, в который будут автоматически конвертироваться все загружаемые изображения. По умолчанию: webp.
gallery3x.filters Глобальные фильтры Строка фильтров phpThumb, применяемая ко всем изображениям.
Пример: greyscale (ч/б) или blur=5.
gallery3x.watermark_path Путь к водяному знаку Путь к файлу картинки от корня сайта. Оставьте пустым, чтобы отключить водяной знак.
Пример: assets/images/logo.png.
gallery3x.watermark_position Позиция водяного знака Расположение водяного знака на изображении.
Варианты: top-left, top-center, top-right, center, bottom-left, bottom-center, bottom-right.
gallery3x.watermark_padding Отступ водяного знака Отступ от края изображения в пикселях. По умолчанию: 10.
gallery3x.ignore_template_source Игнорировать источник шаблона Если Да, галерея всегда использует источник из настройки gallery3x.source_id, игнорируя настройки медиа-источников, привязанные к TV или контексту.
gallery3x.new_file_position Позиция новых файлов Определяет, куда добавляются свежезагруженные файлы.
end — в конец списка,
start — в начало списка.
gallery3x.per_page Элементов на странице Количество изображений, отображаемых на одной странице в админ-панели (пагинация). По умолчанию: 30.
gallery3x.collections_thumb_size Размер превью в Collections Размер миниатюры при просмотре через компонент Collections.
Варианты: small, medium, large.
gallery3x.video_enable Включить видео Активирует вкладку "Видеогалерея" для добавления ссылок с YouTube, VK, Rutube.
gallery3x.groups_per_user Изоляция групп Если Да, каждый менеджер видит и управляет только теми группами (тегами), которые создал сам. Если Нет — группы общие.

 


Генерация превью

Эти настройки позволяют глобально управлять тем, как будут обрабатываться все генерируемые превью (при загрузке или перегенерации).

Ключ Название Описание
gallery3x.format Формат превью Укажите формат, в который будут конвертироваться все превью (например, webp, avif, jpg). Оставьте пустым, чтобы сохранить оригинальный формат файла.
gallery3x.filters Фильтры изображений Позволяет применить один или несколько фильтров к превью. Фильтры перечисляются через | (Вертикальная черта)
gallery3x.watermark_path Путь к водяному знаку Путь к файлу водяного знака от корня сайта. Пример: assets/images/watermark.png. Оставьте пустым, чтобы отключить.
gallery3x.watermark_position Позиция водяного знака Расположение водяного знака. Возможные значения: top-left, top, top-right, left, center, right, bottom-left, bottom, bottom-right.
gallery3x.watermark_padding Отступ водяного знака Отступ водяного знака от краев изображения в пикселях.

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

Эта группа настроек управляет функцией автоматического вывода плейсхолдеров изображений на страницах сайта (аналог функции из ms2Gallery).

Ключ Название Описание
gallery3x.set_placeholders Включить плейсхолдеры на сайте Главный переключатель. Установите в "Да", чтобы плагин начал создавать плейсхолдеры [[+g3x.0]], [[+g3x.1.url]] и т.д. Включайте, только если это действительно нужно.
gallery3x.placeholders_tpl Чанк для плейсхолдеров Имя чанка для оформления плейсхолдера [[+g3x.N]]. Если пусто, будет выведен массив данных. Поддерживается Fenom.
gallery3x.placeholders_for_templates Включить для шаблонов Список ID шаблонов через запятую, для которых будет работать эта функция. Если пусто — работает для всех.
gallery3x.placeholders_thumbs Размеры превью для плейсхолдеров Список размеров превью через запятую, которые нужно выбирать (например, small,medium). Это экономит ресурсы.

Настройки имен файлов

Эти опции позволяют автоматически приводить имена загружаемых файлов к единому, безопасному формату.

Ключ Название Описание
gallery3x.filename_as_hash Использовать хеш в качестве имени файла Если "Да", имя файла будет заменено на его MD5-хеш (например, a1b2c3d4...jpg). Гарантирует уникальность, но делает имена нечитаемыми. Имеет наивысший приоритет.
gallery3x.filename_translit Транслитерировать имена файлов Если "Да", кириллические символы будут заменены на латиницу. Пример: Фото.jpgfoto.jpg.
gallery3x.filename_sanitize Очищать имена файлов от спецсимволов Если "Да", все спецсимволы (кроме букв, цифр, - и _) будут удалены. Пробелы заменяются на дефис. Пример: мой файл (1)!.jpgmoy-fayl-1.jpg.
gallery3x.filename_lowercase Приводить имена файлов к нижнему регистру Если "Да", все имена и расширения будут преобразованы в нижний регистр. Пример: MyPhoto.JPGmyphoto.jpg.

Контроль доступа

У администраторов должны быть права на создание и сохранение (ну или "неограниченные права у администратора")

Screenshot_2.jpg