Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Okunev Agency Try-On: виртуальная примерка одежды
Скриншоты
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
Okunev Agency Try-On добавляет виртуальную примерку одежды по фотографии в интернет-магазин на 1С-Битрикс.
Покупатель загружает своё фото, подтверждает согласие на его отправку в AI-сервис и получает изображение, показывающее, как выбранный товар может выглядеть на нём. Примерка доступна прямо в карточке товара после подключения компонента.
Возможности- Виртуальная примерка одежды по фотографии покупателя.
- Работа с товарами и торговыми предложениями из стандартных инфоблоков 1С-Битрикс.
- Загрузка фотографии товара из детального изображения, изображения анонса или заданного свойства типа «Файл».
- Предварительный просмотр загруженного фото, отображение состояния обработки и готового результата.
- История до шести последних примерок текущего товара в пределах срока хранения.
- Просмотр и удаление собственных фотографий и результатов.
- Настраиваемые лимиты запусков на посетителя и на весь магазин за скользящие 24 часа.
- Защита от повторного запуска одной и той же задачи при повторной отправке запроса.
- Автоматическая очистка просроченных фотографий при регулярном выполнении агентов 1С-Битрикс.
- Два адаптивных шаблона: основной и компактный.
Примерка с регистрацией и без неё
По умолчанию примерка доступна авторизованным пользователям. Администратор может разрешить примерку без регистрации в общих настройках модуля.
В гостевом режиме история и доступ к фотографиям связаны с текущим сеансом посетителя. Новый гостевой сеанс получает отдельный персональный лимит, поэтому дополнительно действует общий лимит магазина.
Оформление под дизайн магазинаРазработчик может изменить HTML-разметку, стили и расположение элементов, сохранив документированные атрибуты. Логика запросов и обработки результатов вынесена в общее JavaScript-расширение, а разметка карточек результатов находится в шаблоне компонента.
Шрифт наследуется от сайта; стили штатных шаблонов ограничены областью виджета. Инструкция по созданию собственного оформления включена в поставку в файле CUSTOMIZATION.md.
AI-сервис и дополнительные расходыДля генерации используется внешний сервис FASHN AI. Владельцу сайта необходимы собственный API-ключ и положительный баланс API-кредитов FASHN.
Использование FASHN не входит в стоимость лицензии модуля и оплачивается владельцем сайта непосредственно поставщику сервиса.
Модуль использует Try-On Max в режиме balanced, разрешение 1k, один результат. По тарифам FASHN на 7 октября 2026 года одна успешная генерация требует 2 API-кредита. При тарифе On-Demand это 0,15 доллара США за результат; минимальная покупка — 100 кредитов за 7,50 доллара США. Тарифы сервиса могут изменяться. Актуальные тарифы FASHN API.
API-ключ используется только на сервере и не передаётся в браузер покупателя.
Работа с фотографиямиФотография покупателя и изображение товара передаются в FASHN сервером сайта. Перед отправкой покупатель подтверждает согласие на обработку фотографии.
На стороне магазина исходные фотографии и результаты хранятся в отдельном приватном каталоге вне публичной директории сайта. Доступ к ним проверяется по владельцу и сроку хранения. Администратор задаёт срок от 1 до 72 часов.
Посетитель может удалить исходное фото и результат своей примерки раньше этого срока. Удаление фотографий из магазина не отменяет уже принятую задачу FASHN и не возвращает потраченные кредиты или локальный лимит запусков. Порядок обработки данных внешним сервисом определяется условиями FASHN отдельно.
Подключение и ограниченияМодуль не изменяет карточки товаров автоматически. Компонент подключает разработчик в шаблоне карточки с передачей ID товара. Для торгового предложения передаётся ID предложения; автоматическое переключение примерки при выборе цвета или размера требует интеграции с шаблоном сайта.
Поддерживаются локальные изображения товаров, доступные через CFile. Облачное файловое хранилище в текущей версии не поддерживается.
AI-визуализация помогает предварительно оценить образ, но не определяет размер и не гарантирует точную посадку одежды.
Технические требования- 1С-Битрикс: Управление сайтом, главный модуль main версии 23.0.0 или новее, модуль «Информационные блоки».
- PHP 8.2 или новее; GD с поддержкой JPEG, PNG и WEBP.
- EXIF рекомендуется для корректной ориентации фотографий с телефона; рекомендуемый memory_limit — от 256 МБ.
- MySQL или MariaDB. PostgreSQL и кластерные конфигурации в текущей версии не заявлены.
- Исходящие HTTPS-соединения с api.fashn.ai.
- Отдельный приватный каталог вне DOCUMENT_ROOT, доступный PHP на чтение и запись и не опубликованный веб-сервером.
- Регулярное выполнение агентов 1С-Битрикс. Для фоновой обработки и очистки без посещений сайта настройте их выполнение через cron.
- HTTPS на сайте и современный браузер.
Технический идентификатор модуля — okunevagency.tryon, компонент — okunevagency:tryon.
Для подключения к карточке товара потребуются доступ к шаблону сайта и навыки разработки на PHP и 1С-Битрикс. Первую установку и проверку рекомендуется выполнять на тестовой копии проекта.
Установка и первоначальная настройка
Проверьте технические требования из описания решения: PHP и GD, версию main, модуль «Информационные блоки», доступ к FASHN и возможность создать приватный каталог вне корня сайта.
Загрузите и установите решение Okunev Agency Try-On: виртуальная примерка одежды стандартными средствами Маркетплейса 1С-Битрикс. После установки новые генерации выключены до заполнения настроек.
Откройте административный раздел: Настройки → Настройки продукта → Настройки модулей → Okunev Agency Try-On: виртуальная примерка одежды.
Относительный адрес страницы настроек на вашем сайте:
/bitrix/admin/settings.php?lang=ru&mid=okunevagency.tryon&mid_menu=1
В поле «API-ключ FASHN» укажите собственный ключ и убедитесь, что на балансе FASHN API достаточно кредитов.
Альтернативный способ — переменная окружения OKUNEVAGENCY_TRYON_FASHN_KEY. Она должна быть доступна процессу PHP и имеет приоритет над ключом из настроек. Не добавляйте ключ в HTML, JavaScript или шаблон компонента.
В поле «ID инфоблоков каталога» перечислите разрешённые инфоблоки через запятую. Для торговых предложений добавьте ID их инфоблока.
При необходимости заполните «Свойство фотографии»: символьный код свойства типа «Файл». Используется первое значение этого свойства.
Если поле пустое, модуль использует DETAIL_PICTURE, а при его отсутствии — PREVIEW_PICTURE. Если свойство задано, именно оно служит источником изображения; автоматического возврата к детальной фотографии при пустом значении свойства нет. Файл должен храниться локально на сайте.
Задайте «Приватное хранилище» — абсолютный путь отдельного пустого каталога вне DOCUMENT_ROOT. Например, на Linux: /var/lib/okunevagency-tryon.
PHP должен иметь права на чтение и запись. Каталог нельзя публиковать через другой виртуальный хост, alias или прямую веб-ссылку.
Настройте ограничения:
- «Запусков на посетителя за 24 часа» — персональный лимит; по умолчанию 5.
- «Запусков на весь магазин за 24 часа» — общий лимит; по умолчанию 100. Он действует на всю установку модуля, включая её сайты.
- «Хранить фотографии, часов» — от 1 до 72 часов; по умолчанию 24.
- «Запусков на посетителя за 24 часа» — персональный лимит; по умолчанию 5.
Лимиты считаются за скользящие 24 часа. Неудачные попытки также занимают локальный лимит; удаление фотографии его не восстанавливает.
Выберите режим доступа. По умолчанию запуск доступен авторизованным пользователям. Для примерки без регистрации включите «Разрешить гостям» в общих настройках модуля.
История гостя доступна в пределах его текущего сеанса. Смена сеанса позволяет получить новый персональный лимит, поэтому сохраняйте разумный общий лимит магазина.
Проверьте выполнение стандартных агентов 1С-Битрикс. Установщик регистрирует агент обработки заданий и очистки с интервалом 60 секунд.
Для работы без посещений сайта настройте запуск агентов через cron. Отдельный cron-скрипт самого модуля не требуется. Если агенты выполняются только при посещениях, фоновая обработка и физическое удаление просроченных файлов могут задерживаться.
После заполнения настроек включите «Включить примерку» и сохраните изменения. Затем подключите компонент в карточке товара.
Подключение компонентаРазместите вызов в PHP-шаблоне карточки товара, где $arResult['ID'] содержит ID текущего элемента инфоблока:
<?php $APPLICATION->IncludeComponent( 'okunevagency:tryon', '', [ 'PRODUCT_ID' => (int)$arResult['ID'], 'CACHE_TIME' => 0, ], false ); ?> |
PRODUCT_ID — ID товара или торгового предложения из разрешённого инфоблока. Передавайте ID конкретного предложения, если требуется примерить его фотографию. Интеграция с переключением цвета или размера выполняется разработчиком в шаблоне сайта.
Пустое имя шаблона во втором аргументе включает основное оформление. Для компактного оформления замените его на 'compact'. Кеширование компонента отключено.
Изменение оформленияСкопируйте выбранный шаблон компонента из каталога:
/local/components/okunevagency/tryon/templates/в каталог своего шаблона сайта, например:
/local/templates/ВАШ_ШАБЛОН/components/okunevagency/tryon/my_tryon/Передайте 'my_tryon' вторым аргументом IncludeComponent. Изменяйте разметку и CSS в этой копии, сохраняя обязательные атрибуты элементов. Общую логику JavaScript копировать не требуется. Контракт разметки, динамическая инициализация и примеры описаны в файле CUSTOMIZATION.md из поставки.
Проверка перед запуском- Проверьте загрузку фотографии и обязательное согласие на её отправку в FASHN.
- Используйте JPEG, PNG или WEBP размером до 10 МБ и до 20 мегапикселей, с размерами каждой стороны не менее 32 пикселей.
- Убедитесь, что компонент получает нужное изображение товара или предложения.
- Проверьте реальную генерацию, ожидание, получение результата, историю и удаление фотографий.
- Проверьте выбранный режим доступа, персональный и общий лимиты.
- Проверьте работу на мобильном экране и выполнение фоновой очистки.
- Убедитесь, что посетителю понятны условия отправки фото в FASHN и хранения результатов, а тексты согласия и политики сайта соответствуют используемому сценарию.
Реальная генерация использует оплаченные API-кредиты FASHN. Не меняйте API-ключ или каталог хранения при активных заданиях. При удалении модуля с сохранением данных агент очистки отключается: сохранённые фотографии потребуют отдельного удаления или возобновления работы модуля.
По вопросам установки, настройки, обновления и работы решений обращайтесь по электронной почте: support@okunev.agency.
Режим работы: понедельник–пятница, с 10:00 до 18:00 по московскому времени.
Срок первичного ответа — до 1 рабочего дня.
При обращении укажите название и версию решения, редакцию и версию 1С-Битрикс, версию PHP, описание проблемы и последовательность действий для её воспроизведения. При необходимости приложите скриншоты и сообщения журнала ошибок.
Техническая поддержка включает консультации по установке, настройке и работе решения, а также устранение подтверждённых ошибок. Индивидуальные доработки, интеграции и адаптация под особенности конкретного проекта оцениваются отдельно.
Не передавайте в обращениях API-ключи, пароли и другие секретные данные без предварительного согласования безопасного способа их передачи.
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
