arrow_back Все платформы

Интеграция виджета

1С-Битрикс

Вставка в шаблон детальной страницы catalog.element. Поля товара берутся из $arResult.

1. Studio

  1. Откройте Профиль → Виджет и создайте магазин.
  2. Укажите URL интернет-магазина и сохраните.
  3. Переведите кредиты на баланс виджета.
  4. Скопируйте код во вкладке «Битрикс» (ключи уже подставлены).

2. Чеклист

  • Создайте магазин во вкладке «Виджет» в Studio и скопируйте Shop ID / API-ключ.
  • Укажите URL сайта магазина (домен нужен для проверки источника запросов).
  • Переведите кредиты на баланс виджета.
  • URL страницы товара и изображения товара — только HTTPS.
  • Сопоставьте тип товара с tops, bottoms или one-pieces.

3. Вставка кода

Вставьте фрагмент в шаблон детальной страницы компонента bitrix:catalog.element (файл template.php вашего шаблона). Сопоставьте SECTION_CODE с типом примерки. При относительных путях к картинкам допишите абсолютный HTTPS-URL при необходимости.

<?php
/**
 * Pixel Fit — шаблон детальной страницы catalog.element
 */
$pfCategoryMap = [
  'futbolki' => 'tops',
  'bryuki' => 'bottoms',
  'platya' => 'one-pieces',
];
$pfCategory = 'tops';
$sectionCode = (string)($arResult['SECTION']['CODE'] ?? '');
if (isset($pfCategoryMap[$sectionCode])) {
  $pfCategory = $pfCategoryMap[$sectionCode];
}

$pfProductUrl = (string)($arResult['DETAIL_PAGE_URL'] ?? '');
$pfImageUrl = (string)(
  $arResult['DETAIL_PICTURE']['SRC']
  ?? $arResult['PREVIEW_PICTURE']['SRC']
  ?? ''
);
?>
<script src="<?= htmlspecialcharsbx('https://widget.pixel-fit.ru/widget.js') ?>"
  data-shop-id="<?= htmlspecialcharsbx('YOUR_SHOP_ID') ?>"
  data-api-key="<?= htmlspecialcharsbx('YOUR_API_KEY') ?>"
  data-product-url="<?= htmlspecialcharsbx($pfProductUrl) ?>"
  data-image-url="<?= htmlspecialcharsbx($pfImageUrl) ?>"
  data-category="<?= htmlspecialcharsbx($pfCategory) ?>"
  data-locale="ru"
  async></script>

4. Категории примерки

  • Верх (tops) — футболки, рубашки, худи, лонгсливы, куртки
  • Низ (bottoms) — брюки, юбки, шорты
  • Цельная вещь (one-pieces) — платья, комбинезоны, комбидресс

5. Проверка

  1. Откройте карточку товара на боевом (или тестовом) HTTPS-домене.
  2. Убедитесь, что домен совпадает с URL в настройках магазина Studio.
  3. Запустите примерку и проверьте, что подставилось нужное фото.
  4. Демо-магазин: /demo

6. Если не работает

Кнопка «Примерить» не появляется

Проверьте, что скрипт загружается (CDN widget.pixel-fit.ru), Shop ID и API-ключ верные, на странице нет ошибок в консоли.

Ошибка или пустой товар на примерке

Задайте data-image-url на главное фото товара (HTTPS). Без изображения генерация не запустится.

Домен отклонён

В настройках магазина в Studio укажите тот же домен, с которого открыт виджет (например shop.ru).

Недостаточно кредитов

Переведите кредиты Studio → Виджет на вкладке «Виджет» в профиле.

Плохой результат примерки

Проверьте data-category: платья — one-pieces, брюки — bottoms, иначе по умолчанию используется tops.

Помощь: support@pixel-fit.ru