Установка модуля ImgChanger для 1С-Битрикс

Шаг 1. Скачать архив модуля

Нажмите «Скачать модуль для Битрикса» — архив imgchanger-bitrix.zip с актуальной версией скачается сразу, без регистрации и email.

Шаг 2. Залить папку модуля в /local/modules/

Внутри архива одна папка — kuratovru.imgchanger/. Она должна оказаться здесь:

/local/modules/kuratovru.imgchanger/

Проще всего — прямо из админки Битрикса, без FTP:

1. Админка → Контент → Структура сайта → Файлы и папки
2. Откройте папку local, в ней — modules. Если их нет, создайте кнопкой «Добавить → Новая папка»: сначала local в корне сайта, затем modules внутри неё
3. В папке /local/modules/ нажмите «Загрузить файл» и выберите скачанный imgchanger-bitrix.zip
4. Нажмите на архив правой кнопкой мыши (или откройте меню значком «≡» слева от имени) и выберите «Распаковать». Откроется окно «Распаковка архива» — путь уже подставлен, остаётся нажать в нём «Распаковать»
5. Проверьте, что появилась папка /local/modules/kuratovru.imgchanger/; сам архив после этого можно удалить

Или по FTP/SFTP (FileZilla, WinSCP, Cyberduck): распакуйте архив у себя на компьютере и загрузите папку kuratovru.imgchanger/ целиком в /local/modules/. Так же можно через файловый менеджер хостинга (cPanel, ISPmanager, Plesk).

Битрикс рекомендует именно /local/, а не /bitrix/modules/: при обновлении ядра модуль не пострадает.

Шаг 3. Установить модуль в админке Битрикса

1. Зайдите в админку: https://ваш-сайт/bitrix/admin/
2. В левом меню: Marketplace → Установленные решения
3. В списке появится строка «imgchanger — AI-замена картинок» со статусом «Не установлен».
4. Нажмите значок «≡» слева от названия — откроется меню действий. Выберите «Установить».
5. Через пару секунд статус в списке сменится на «Установлен».
6. Модуль добавит свой пункт в главное меню админки — «ImgChanger». Обновите страницу, если не видно сразу.

Шаг 4. Получить лицензию (триал — бесплатно)

В меню админки: ImgChanger → Настройки. Здесь два варианта.

Вариант A — триал (5 AI-замен бесплатно):

1. В поле «Email» введите свой email
2. Нажмите «Получить триал»
3. За 5-10 секунд модуль сам обратится к api.imgchanger.org, выпустит лицензию и впишет ключ в поле
4. Сохраните настройки

Вариант B — купленная лицензия:

1. Если вы уже оплатили пакет на imgchanger.org/ru/#price — ключ пришёл вам на email
2. Скопируйте ключ из письма (формат: imc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)
3. Вставьте в поле «Лицензионный ключ» в Настройках модуля
4. Нажмите «Активировать» — модуль проверит ключ на сервере и привяжет к домену вашего сайта

Шаг 5. Первое сканирование

ImgChanger → Сканирование в меню админки.

1. Выберите инфоблок — например «Новости», «Каталог», «Услуги», «Блог»
2. Опционально — задайте фильтр (например «только товары категории X» или «только публикации за 2018-2020»)
3. Нажмите «Сканировать»

Модуль найдёт все картинки внутри выбранного инфоблока:

• PREVIEW_PICTURE и DETAIL_PICTURE — основные иллюстрации элементов
• Файловые свойства элементов и разделов
• Картинки в HTML-полях DETAIL_TEXT и PREVIEW_TEXT (через парсинг <img src=...>)
• Группировка по статьям — видно, в какой публикации сколько картинок

Картинки отображаются в виде сетки с превью. Для каждой — размер, формат, путь, ссылка «Открыть на сайте».

Шаг 6. Генерация AI-замен и применение

Из результатов сканирования отметьте картинки галочками и нажмите «🪄 Сгенерировать».

1. Модуль отправит выбранные картинки на api.imgchanger.org/v1/generate
2. На сервере применяется модель FLUX-dev img2img — создаёт похожую, но юридически чистую картинку
3. Каждая генерация занимает 5-15 секунд. В пакетном режиме — 3 параллельно.
4. Когда готово — рядом с оригиналом появляется AI-превью

Сравните визуально. Не нравится — нажмите «🪄» ещё раз с другим промптом (учтите: каждая попытка списывает 1 единицу с баланса).

Если устраивает — нажмите «✓ Применить»:

• Оригинал автоматически копируется в /upload/imgchanger_backups/<timestamp>/<путь>
• AI-картинка записывается на место оригинала
• EE-токены / Битрикс-токены не трогаются — сайт работает как раньше, просто файл подменён

Bulk-режим (Стандарт и выше): выделите хоть тысячу картинок → нажмите «Применить ко всем». Тысяча картинок обрабатывается ~1 час.

Шаг 7. Бэкапы и откат

Оригиналы лежат в /upload/imgchanger_backups/. Структура:

/upload/imgchanger_backups/
  ├── 2026-05-12_14-32-15/      ← timestamp заходов в применение
  │   ├── /upload/iblock/abc/photo1.jpg
  │   └── /upload/iblock/def/photo2.png
  └── 2026-05-13_10-05-00/
      └── ...

В админке: ImgChanger → История замен — список всех применений с возможностью «Откатить» одной кнопкой (вернёт оригинал из бэкапа).

Бэкапы хранятся неограниченно — это просто файлы в файловой системе. Удалять можно вручную через FTP, когда уверены что замены ОК.