Skip to main content

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

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

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

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

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

Ключ Название Описание
gallery3x.source_id Источник файлов для изображений Укажите ID источника файлов, который будет использоваться для хранения изображений галереи. При установке компонент автоматически создает "Gallery3x Source" и прописывает сюда его ID.
gallery3x.templates На каких шаблонах показывать вкладку галереи Список ID шаблонов через запятую, для которых будет активна вкладка "Галерея" на странице редактирования ресурса. Пример: 5,10. Если оставить пустым, вкладка не будет отображаться.

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

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

Ключ Название Описание
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 Транслитерировать имена файлов Если "Да", кириллические символы будут заменены на латиницу. Пример: Фото.jpg → foto.jpg.
gallery3x.filename_sanitize Очищать имена файлов от спецсимволов Если "Да", все спецсимволы (кроме букв, цифр, - и _) будут удалены. Пробелы заменяются на дефис. Пример: мой файл (1)!.jpg → moy-fayl-1.jpg.
gallery3x.filename_lowercase Приводить имена файлов к нижнему регистру Если "Да", все имена и расширения будут преобразованы в нижний регистр. Пример: MyPhoto.JPG → myphoto.jpg.
Back to top