Плагин WooCommerce¶

Ziex Try-On for WooCommerce добавляет на страницу товара кнопку «Примерить». Покупатель загружает своё фото и видит вещь на себе. Настройка — в WordPress, без кода: загрузите архив, вставьте ключ, выберите категории.

Текущая версия — 1.4.0.

Что делает плагин¶

Выводит на странице товара кнопку «Примерить» и по нажатию запускает виджет. Виджет загружается через лоадер сервиса, который плагин добавляет асинхронно: при первом нажатии или сразу — на странице, где во вкладке есть незавершённая примерка этого магазина.
Связывает магазин с сервисом по вашему секретному ключу. Ключ хранится в базе данных WordPress и отправляется сервису только с вашего сервера.
Кладёт на страницы товаров только публикуемый ключ (pk_…). Плагин получает его от сервиса сам. Он работает только в браузере, только на сайте, к которому привязан ключ, и только для примерок. См. Ключи.
Для каждого товара по его категориям решает, показывать ли кнопку и какого типа эта вещь.
Для вариативного товара примеряет фото выбранной покупателем вариации.
Не трогает заказы. Плагин объявляет совместимость с High-Performance Order Storage в WooCommerce.

Фото покупателя уходит из его браузера прямо в сервис, минуя ваш сервер.

Требования¶


WordPress	6.5 или новее (проверено до 7.1)
WooCommerce	8.0 или новее (проверено до 11.1)
PHP	8.0 или новее
Сайт	Работает по https
Ключ	Боевой секретный ключ (`tryon_…`), привязанный к домену вашего магазина

Ключ выдаём мы. Если у вас его нет, обратитесь к своему менеджеру. Ключ показывается один раз, при создании, поэтому сохраните его. Привязка к домену действует и на его вариант с www., и на поддомены.

Где взять плагин¶

Скачайте архив: https://app.ziex-tryon.com/downloads/ziex-tryon-woocommerce.zip. Этот же адрес — download_url записи WooCommerce в блоке integrations ответа GET /api/v1/tryon/integration (см. Создание плагина). В архиве одна папка, ziex-tryon/.

Установка и подключение¶

В WordPress откройте Плагины → Добавить плагин → Загрузить плагин, выберите архив, нажмите Установить, затем Активировать.
Откройте WooCommerce → Примерка онлайн. В английском WordPress пункт называется Virtual try-on.
На вкладке Подключение вставьте секретный ключ в поле Ключ API и нажмите Сохранить и проверить. Плагин спросит у сервиса, подходит ли ключ этому сайту. Карточка станет Подключено и покажет аккаунт, привязанный сайт, тариф и остаток генераций.
Откройте вкладку Категории, нажмите Подсказать по названиям категорий, проверьте выбор и нажмите Сохранить категории.
Откройте страницу товара. Кнопка стоит под кнопкой «В корзину».
Добавьте в политику конфиденциальности абзац о сервисе. См. Конфиденциальность, CSP и тестовые ключи.

Настройки¶

На странице настроек три вкладки.

Подключение¶

Настройка	Что делает
Ключ API	Секретный ключ. После сохранения поле пустое, сохранённый ключ показан в маске. Пустое поле при сохранении оставляет сохранённый ключ. Ключ `pk_…` и ключ неверного вида отклоняются до любого запроса.
Показывать кнопку примерки на страницах товаров (в группе Показ на сайте)	Включено по умолчанию. Если выключить, кнопка пропадёт на всех страницах.
Кабинет посетителя	Включён по умолчанию. Виджет хранит результаты покупателя («Мои образы») в его браузере до 30 дней, а его фото — только если он отметил «Запомнить фото на этом устройстве». Если выключить, то при следующем визите стирается и то, что посетители уже сохранили. Выключите, если на ваших страницах работают скрипты, которым вы не доверяете.
Дополнительно → Адрес сервиса	Не меняйте. Меняйте, только если об этом попросит наша поддержка.
Отключить	Удаляет ключ и скрывает кнопки.

Сохранить и проверить спрашивает сервис о ключе и сохраняет ответ. Плагин повторяет проверку каждый час.

Отказ по ключу (отозван, приостановлен, привязан к другому сайту) скрывает кнопки. Они пропадают при следующей проверке или сразу после Сохранить и проверить. Причина указана в карточке.
Сетевая ошибка или сбой сервиса кнопки никогда не скрывает. Остаётся последний хороший статус, а карточка показывает ошибку последней проверки.
Если карточка пишет, что ключ привязан к другому сайту, домен ключа не совпадает с адресом вашего сайта. Попросите нас привязать ключ к вашему домену.
Если мы перевыпустим публикуемый ключ вашего ключа, виджет на ваших страницах не будет работать, пока плагин не проверит ключ снова, — это случится в течение часа. Нажмите Сохранить и проверить сразу после замены.

Категории¶

Сервис умеет примерять не всё. Вкладка перечисляет, что можно примерить сегодня (верх, верхняя одежда, низ, платья и комбинезоны) и что нельзя (например, обувь и сумки). Список приходит от сервиса и может расти.

Для каждой категории вашего магазина выберите одно значение:

Значение	Смысл
Название категории	Все товары категории магазина примеряются как вещь этого типа.
Нельзя примерить	У товаров нет кнопки. Обувь, сумки, головные уборы, украшения.
Автоопределение (смешанная категория)	Тип вещи определяет сервис. Для смешанных категорий вроде «Спорт».
— не влияет	Категория ничего не решает. Для подборок вроде «Новинки» или «Распродажа». Дочерняя категория берёт значение родительской.

Товар с несколькими категориями разбирается в таком порядке:

Выбор на самом товаре (ниже).
Любая категория со значением Нельзя примерить: кнопки нет.
Ровно одна конкретная категория среди категорий товара: берётся она.
Несколько разных конкретных категорий или только Автоопределение: автоопределение.
Ни одна категория не задаёт значение: кнопки нет.

Подсказать по названиям категорий заполняет очевидные категории по их названиям, русским и английским. Сама по себе кнопка ничего не сохраняет. Обновить список сразу забирает у сервиса список категорий. Без неё плагин проверяет список раз в час, а сам список кешируется на 12 часов.

Когда сервис добавляет категорию, появляется уведомление, которое можно закрыть, с просьбой проверить сопоставление.
Когда сервис убирает категорию, которую вы выбрали, она остаётся выбранной и помечается «(недоступно)». Товары в ней остаются без кнопки, пока вы не выберете другое значение.
Когда сервис недоступен, вкладка показывает список последней успешной проверки.

Итог по каталогу внизу считает товары с кнопкой, товары, которые нельзя примерить, отключённые на самом товаре и те, тип которых не задаёт ни одна категория, — со ссылками на последние.

Кнопка¶

Настройка	Что делает
Текст кнопки	Пусто — «Примерить» (или его перевод по языку сайта).
Расположение	После кнопки «В корзину» (по умолчанию), Перед кнопкой «В корзину», Под основной информацией о товаре или Только там, где стоит шорткод [ziex_tryon_button].

Кнопка выводится только на странице товара.

Выбор на товаре¶

Откройте товар на редактирование. Данные товара → Общие → Примерка онлайн предлагает четыре варианта: По категориям товара (по умолчанию), категория, Автоопределение и Выключено для этого товара. Поле также сообщает, что товар получает сейчас, например «Сейчас: кнопки примерки нет.». Пользуйтесь им для товара из смешанной категории, например платья-свитера среди трикотажа.

Как проверить, что всё работает¶

На вкладке Подключение зелёная карточка Подключено с вашим аккаунтом и вашим сайтом (Разрешённый сайт).
На вкладке Категории в Итоге по каталогу число «Товаров с кнопкой примерки» больше нуля.
Откройте товар, категорию которого можно примерить. Кнопка на месте.
Нажмите её, загрузите фото и дождитесь результата. На вашей странице откроется окно виджета.
Войдите в клиентский портал на https://app.ziex-tryon.com. Примерка есть в списке задач с названием товара и ссылкой на него, а на странице API-ключей в последней метке ключа указано woocommerce/1.4.0.

Если у товара нет кнопки, причина написана на экране редактирования товара. Товары, которые не решает ни одна категория, перечислены на вкладке Категории. Кроме того, у товара должно быть фото.

Обновление¶

Когда есть более новая версия, вкладка Подключение показывает «Доступна версия плагина X (установлена Y)» со ссылкой Скачать. О последней версии плагин узнаёт из ответа сервиса — из блока plugin ответа GET /api/v1/tryon/integration.

Чтобы обновить, скачайте новый архив и загрузите его так, как описано в разделе Установка и подключение.

Метка интеграции¶

Плагин называет себя сервису: woocommerce/<версия>, например woocommerce/1.4.0. Виджет отправляет метку с каждой примеркой, а плагин — со своими двумя серверными вызовами, в заголовке X-Ziex-Integration. Настраивать ничего не нужно. См. Идентификация.

Конфиденциальность, CSP и тестовые ключи¶

Конфиденциальность. Фото покупателя отправляется сервису. Сервис хранит фото и результат 180 дней, и политика конфиденциальности вашего магазина должна об этом говорить. Готовый абзац на русском и английском — на странице Текст для политики конфиденциальности; тот же текст есть в readme плагина. Согласие и передача данных за границу — вопросы к вашему юристу.
CSP. Если ваш магазин отправляет заголовок Content-Security-Policy, разрешите хосты со страницы CSP. Плагин передаёт странице свои настройки в небольшом встроенном скрипте, поэтому при строгом script-src этому скрипту нужен nonce или хеш. См. Две вещи, которые блокируются при строгой политике.
Тестовые ключи. Поле Ключ API принимает только боевой ключ: tryon_ и 32 буквы или цифры. Тестовый ключ (tryon_test_…) форма отклонит. Тестовые ключи нужны, чтобы собирать интеграцию; см. Тестовые ключи.

Если что-то не так¶

Симптом	Что проверить
Карточка пишет, что ключ привязан к другому сайту	Домен ключа не совпадает с адресом сайта. Попросите нас привязать ключ к нужному домену.
«Ключ ещё не привязан ни к одному сайту»	Ключ выдан без домена. Попросите нас привязать его.
У товара нет кнопки	Причину пишет экран редактирования товара. Проверьте итог на вкладке Категории, переключатель Показывать кнопку примерки на страницах товаров и наличие у товара фото.
Кнопки пропали у всех товаров	Ключ отозван или аккаунт приостановлен. Вкладка Подключение показывает ошибку последней проверки.
Виджет не работает после того, как мы перевыпустили ключ	Нажмите Сохранить и проверить.
Кнопка пишет, что сервис сейчас недоступен	Скрипт виджета не загрузился. Проверьте свой CSP и доступность `https://api.ziex-tryon.com` из сети покупателя.

Ошибки, которые виджет показывает покупателю, перечислены на странице Ошибки. Чтобы обратиться за помощью, назовите метку woocommerce/<версия> и идентификатор запроса, описанный на странице Идентификация.