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

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

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

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

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

<table class="table table-bordered table-striped" id="bkmrk-%D0%9A%D0%BB%D1%8E%D1%87-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD"><thead><tr><th style="width: 25%;">Ключ</th><th style="width: 20%;">Название</th><th>Описание</th></tr></thead><tbody><tr><td>**gallery3x.source\_id**</td><td>Источник файлов</td><td>Укажите ID источника файлов (Media Source), где будут храниться изображения. Обычно компонент создает свой источник при установке и прописывает его ID автоматически.</td></tr><tr><td>**gallery3x.driver**</td><td>Драйвер обработки</td><td>Библиотека для обработки изображений на сервере.   
Варианты: `imagick` (рекомендуется) или `gd`.</td></tr><tr><td>**gallery3x.templates**</td><td>Активные шаблоны</td><td>Список ID шаблонов через запятую (например: `1, 3, 5`). Вкладка "Галерея" появится только у ресурсов с этими шаблонами. Если пусто — вкладка скрыта.</td></tr><tr><td>**gallery3x.format**</td><td>Формат конвертации</td><td>Формат, в который будут автоматически конвертироваться все загружаемые изображения. По умолчанию: `webp`.</td></tr><tr><td>**gallery3x.filters**</td><td>Глобальные фильтры</td><td>Строка фильтров phpThumb, применяемая ко всем изображениям.   
Пример: `greyscale` (ч/б) или `blur=5`.</td></tr><tr><td>**gallery3x.watermark\_path**</td><td>Путь к водяному знаку</td><td>Путь к файлу картинки от корня сайта. Оставьте пустым, чтобы отключить водяной знак.  
Пример: `assets/images/logo.png`.</td></tr><tr><td>**gallery3x.watermark\_position**</td><td>Позиция водяного знака</td><td>Расположение водяного знака на изображении.   
Варианты: `top-left`, `top-center`, `top-right`, `center`, `bottom-left`, `bottom-center`, `bottom-right`.</td></tr><tr><td>**gallery3x.watermark\_padding**</td><td>Отступ водяного знака</td><td>Отступ от края изображения в пикселях. По умолчанию: `10`.</td></tr><tr><td>**gallery3x.ignore\_template\_source**</td><td>Игнорировать источник шаблона</td><td>Если `Да`, галерея всегда использует источник из настройки `gallery3x.source_id`, игнорируя настройки медиа-источников, привязанные к TV или контексту.</td></tr><tr><td>**gallery3x.new\_file\_position**</td><td>Позиция новых файлов</td><td>Определяет, куда добавляются свежезагруженные файлы.  
`end` — в конец списка,  
`start` — в начало списка.</td></tr><tr><td>**gallery3x.per\_page**</td><td>Элементов на странице</td><td>Количество изображений, отображаемых на одной странице в админ-панели (пагинация). По умолчанию: `30`.</td></tr><tr><td>**gallery3x.collections\_thumb\_size**</td><td>Размер превью в Collections</td><td>Размер миниатюры при просмотре через компонент Collections.  
Варианты: `small`, `medium`, `large`.</td></tr><tr><td>**gallery3x.video\_enable**</td><td>Включить видео</td><td>Активирует вкладку "Видеогалерея" для добавления ссылок с YouTube, VK, Rutube.</td></tr><tr><td>**gallery3x.groups\_per\_user**</td><td>Изоляция групп</td><td>Если `Да`, каждый менеджер видит и управляет только теми группами (тегами), которые создал сам. Если `Нет` — группы общие.</td></tr></tbody></table>

<div class="horizontal-scroll-wrapper" id="bkmrk-"><div class="table-block-component"><div _ngcontent-ng-c1702402772="" class="table-block has-export-button"><div _ngcontent-ng-c1702402772="" class="table-content not-end-of-paragraph" not-end-of-paragraph="">  
</div><div _ngcontent-ng-c1702402772="" class="table-footer hide-from-message-actions ng-star-inserted" hide-from-message-actions="">  
</div></div></div></div>### Генерация превью

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

<div class="horizontal-scroll-wrapper" id="bkmrk-%D0%9A%D0%BB%D1%8E%D1%87-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD-1"><div class="table-block-component"><div _ngcontent-ng-c1702402772="" class="table-block has-export-button"><div _ngcontent-ng-c1702402772="" class="table-content not-end-of-paragraph" not-end-of-paragraph=""><table><thead><tr><td>Ключ</td><td>Название</td><td>Описание</td></tr></thead><tbody><tr><td>**gallery3x.format**</td><td>Формат превью</td><td>Укажите формат, в который будут конвертироваться все превью (например, `webp`, `avif`, `jpg`). Оставьте пустым, чтобы сохранить оригинальный формат файла.</td></tr><tr><td>**gallery3x.filters**</td><td>Фильтры изображений</td><td>Позволяет применить один или несколько фильтров к превью. Фильтры перечисляются через | (Вертикальная черта)</td></tr><tr><td>**gallery3x.watermark\_path**</td><td>Путь к водяному знаку</td><td>Путь к файлу водяного знака от корня сайта. **Пример:** `assets/images/watermark.png`. Оставьте пустым, чтобы отключить.</td></tr><tr><td>**gallery3x.watermark\_position**</td><td>Позиция водяного знака</td><td>Расположение водяного знака. Возможные значения: `top-left`, `top`, `top-right`, `left`, `center`, `right`, `bottom-left`, `bottom`, `bottom-right`.</td></tr><tr><td>**gallery3x.watermark\_padding**</td><td>Отступ водяного знака</td><td>Отступ водяного знака от краев изображения в пикселях.</td></tr></tbody></table>

</div></div></div></div>
### Плейсхолдеры изображений

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

<div class="horizontal-scroll-wrapper" id="bkmrk-%D0%9A%D0%BB%D1%8E%D1%87-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD-2"><div class="table-block-component"><div _ngcontent-ng-c1702402772="" class="table-block has-export-button"><div _ngcontent-ng-c1702402772="" class="table-content not-end-of-paragraph" not-end-of-paragraph=""><table><thead><tr><td>Ключ</td><td>Название</td><td>Описание</td></tr></thead><tbody><tr><td>**gallery3x.set\_placeholders**</td><td>Включить плейсхолдеры на сайте</td><td>Главный переключатель. Установите в "Да", чтобы плагин начал создавать плейсхолдеры `[[+g3x.0]]`, `[[+g3x.1.url]]` и т.д. **Включайте, только если это действительно нужно.**</td></tr><tr><td>**gallery3x.placeholders\_tpl**</td><td>Чанк для плейсхолдеров</td><td>Имя чанка для оформления плейсхолдера `[[+g3x.N]]`. Если пусто, будет выведен массив данных. Поддерживается Fenom.</td></tr><tr><td>**gallery3x.placeholders\_for\_templates**</td><td>Включить для шаблонов</td><td>Список ID шаблонов через запятую, для которых будет работать эта функция. Если пусто — работает для всех.</td></tr><tr><td>**gallery3x.placeholders\_thumbs**</td><td>Размеры превью для плейсхолдеров</td><td>Список размеров превью через запятую, которые нужно выбирать (например, `small,medium`). Это экономит ресурсы.</td></tr></tbody></table>

</div></div></div></div>
### Настройки имен файлов

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

<div class="horizontal-scroll-wrapper" id="bkmrk-%D0%9A%D0%BB%D1%8E%D1%87-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD-3"><div class="table-block-component"><div _ngcontent-ng-c1702402772="" class="table-block has-export-button"><div _ngcontent-ng-c1702402772="" class="table-content not-end-of-paragraph" not-end-of-paragraph=""><table><thead><tr><td>Ключ</td><td>Название</td><td>Описание</td></tr></thead><tbody><tr><td>**gallery3x.filename\_as\_hash**</td><td>Использовать хеш в качестве имени файла</td><td>Если "Да", имя файла будет заменено на его MD5-хеш (например, `a1b2c3d4...jpg`). Гарантирует уникальность, но делает имена нечитаемыми. Имеет наивысший приоритет.</td></tr><tr><td>**gallery3x.filename\_translit**</td><td>Транслитерировать имена файлов</td><td>Если "Да", кириллические символы будут заменены на латиницу. **Пример:** `Фото.jpg` → `foto.jpg`.</td></tr><tr><td>**gallery3x.filename\_sanitize**</td><td>Очищать имена файлов от спецсимволов</td><td>Если "Да", все спецсимволы (кроме букв, цифр, `-` и `_`) будут удалены. Пробелы заменяются на дефис. **Пример:** `мой файл (1)!.jpg` → `moy-fayl-1.jpg`.</td></tr><tr><td>**gallery3x.filename\_lowercase**</td><td>Приводить имена файлов к нижнему регистру</td><td>Если "Да", все имена и расширения будут преобразованы в нижний регистр. **Пример:** `MyPhoto.JPG` → `myphoto.jpg`.</td></tr></tbody></table>

</div></div></div></div>### Контроль доступа

У администраторов должны быть права на создание и сохранение (ну или "неограниченные права у администратора")  
  
[![Screenshot_2.jpg](https://docs.ivan345.com/uploads/images/gallery/2025-11/scaled-1680-/eqwjZsk4OjLjdNy8-screenshot-2.jpg)](https://docs.ivan345.com/uploads/images/gallery/2025-11/eqwjZsk4OjLjdNy8-screenshot-2.jpg)