Установка на веб-сайте
Как установить виджеты 2.0 через скрипт провайдера: добавить загрузчик на страницы сайта, разместить теги виджетов и проверить установку
Добавьте загрузчик виджетов на все страницы, где будут виджеты, и поставьте теги виджетов туда, где они должны появиться. Настройки виджетов приходят на сайт из скрипта провайдера: они хранятся в Aplaut и меняются в личном кабинете, а код сайта при этом не правится. Установка занимает 5–15 минут.
Что понадобится
- Доступ к HTML-шаблонам сайта.
- Код загрузчика. Готовый код с вашими настройками показывает раздел Инструменты → Виджеты по значку Показать инструкции по установке, раздел открыт ролям Менеджер и Администратор. Без него понадобится Company ID из раздела Админ → API и доступы → Токены аутентификации (роль Администратор).
- Сохранённый скрипт провайдера с токеном и включённый переключатель Отдавать скрипт провайдера вместо бандла: см. как настроить виджеты в личном кабинете. Пока переключатель выключен, по адресу загрузчика приходят виджеты без настроек, и на сайте они не появляются.
Шаг 1. Добавьте загрузчик в <head>
Вставьте код в <head> на всех страницах с виджетами, до любых вызовов aplaut.* в коде страницы. Замените <COMPANY_ID> в адресе в конце загрузчика на Company ID вашей компании: загрузчик берёт по адресу https://get.aplaut.io/f/v2/<COMPANY_ID>/app.js код виджетов вместе со скриптом провайдера.
<link rel="preconnect" href="https://get.aplaut.io" />
<link rel="preconnect" href="https://get.apltcdn.com" />
<script>!function(t, e, n, c){if(!t[n]){var r, o, c;function s(t){r[t]=function(){o.push([t].concat(Array.prototype.slice.call(arguments, 0)))}}t[n]={}, (r=t[n]).v="1.0", r.q=[], o=r.q, r.init=function(t, e){r.initArgs=arguments}, r.start=function(){for(i=0;i<c.length;i++)s(c[i])}, r.start(), a=document.createElement("script"), m=document.getElementsByTagName("script")[0], a.async=1, a.src=e, a.type="module", m.parentNode.insertBefore(a, m)}}(window, "https://get.aplaut.io/f/v2/<COMPANY_ID>/app.js", "aplaut", ["createWidget", "setUser", "on", "off", "emit", "setParams", "setConsumer", "setAuthParams", "manageOrder", "clearFormData", "setAuthStrategy"]);</script>
Шаг 2. Разместите теги виджетов
Поставьте тег виджета в то место страницы, где он должен появиться, и укажите в data-context-id ID товара, под которым товар загружен в Aplaut (offer.id из YML-каталога).
<ap-informer data-context-id="12345"></ap-informer>
<ap-reviews data-context-id="12345"></ap-reviews>
| Виджет | Тег |
|---|---|
| Отзывы | <ap-reviews> |
| Информер с рейтингом | <ap-informer> |
| Вопросы и ответы | <ap-questions-answers> |
| Галерея фото и видео | <ap-reviews-gallery> |
| AI-сводка отзывов | <ap-reviews-summary> |
| Форма отзыва без списка | <ap-reviews-form> |
| Сторис | <ap-stories> |
| Форма сторис | <ap-stories-form> |
| Приглашение оставить отзыв | <ap-product-review-invite> |
До загрузки тег — пустой блок. Виджет использует container queries, поэтому задайте тегу ширину родительского блока стилями, а информеру и отзывам — минимальную высоту min-height, чтобы страница не прыгала при загрузке.
Если информер или AI-сводка стоят на одной странице с виджетом отзывов, обязательно настройте прокрутку к отзывам по клику: сами по себе они к отзывам не ведут. Дайте контейнеру виджета отзывов id, у информера укажите этот id в data-scroll-target-id, а на AI-сводку повесьте обработчик клика:
<ap-informer data-context-id="12345" data-scroll-target-id="reviews"></ap-informer>
<ap-reviews-summary data-context-id="12345"></ap-reviews-summary>
<div id="reviews">
<ap-reviews data-context-id="12345"></ap-reviews>
</div>
<script>
document.querySelector('ap-reviews-summary').addEventListener('click', () => {
document.getElementById('reviews').scrollIntoView({ behavior: 'smooth' });
});
</script>
Виджеты по умолчанию занимают всю ширину контейнера. Если нужны отступы по краям, задайте их контейнеру, в который ставите тег виджета, например через padding.
Проверка результата
Откройте страницу с виджетом. Виджет появился там, где стоит тег, в консоли браузера нет ошибок, а на вкладке «Сеть» запросы к API Aplaut отвечают 200.
| Признак | Причина | Что сделать |
|---|---|---|
| Ответ 401 | Токен в скрипте провайдера не подходит или истёк: по умолчанию токен действует два года | Выдайте новый токен приложения со скоупами content_api и submissions_api, выберите его в разделе Виджеты → Аутентификация и перенесите настройки в скрипт провайдера |
| Ответ 403 при отправке отзыва | У токена в скрипте провайдера нет скоупа submissions_api | Выберите токен приложения с этим скоупом и перенесите настройки в скрипт провайдера |
| Ответ 404 | Товара нет в Aplaut | Проверьте, что товар загружен и data-context-id совпадает с offer.id из фида |
| Тег пустой, запросов нет | Выключен переключатель Отдавать скрипт провайдера вместо бандла, в скрипте провайдера нет токена или в адресе загрузчика чужой Company ID | Включите переключатель в окне скрипта провайдера раздела Виджеты, проверьте токен и Company ID |
| Изменения из личного кабинета не видны на сайте | Скрипт провайдера кешируется до трёх часов | Подождите и проверьте страницу в режиме инкогнито |
Смотрите также: как настроить виджеты в личном кабинете, что делать, если опубликованный отзыв не виден на сайте.