Перейти к основному содержимому

Как настроить виджеты в личном кабинете

Как подобрать поведение и оформление виджетов 2.0 на превью в разделе «Виджеты» и отправить настройки на сайт через скрипт провайдера

Подберите поведение и оформление виджетов 2.0 на превью в разделе Виджеты, а затем отправьте настройки на сайт. Если виджеты установлены через скрипт провайдера, код сайта менять не придётся.

Ранний доступ

Раздел Виджеты помечен Превью: состав настроек и названия полей могут меняться. Скрипт провайдера сразу меняет виджеты на всех страницах сайта, поэтому перед первым сохранением согласуйте настройки с поддержкой Aplaut.

Что понадобится​

  • Роль Менеджер или Администратор.
  • OAuth-приложение со скоупами content_api и submissions_api и выданный по нему токен. Первый скоуп нужен, чтобы виджеты читали отзывы, второй — чтобы из формы уходили новые. Приложение создаёт Администратор в разделе Настройки → Разработчикам.
  • Товар, который уже загружен в каталог Aplaut.

Шаг 1. Откройте превью​

  1. В меню слева откройте Виджеты.
  2. В панели справа в разделе Аутентификация выберите OAuth-приложение и Токен. Если выбрать не из чего, у компании нет приложения со скоупом content_api: попросите администратора создать его по ссылке создайте новое.
  3. В разделе Тестовый товар в поле Товар начните вводить название или ID товара и выберите его из списка.
  4. На панели над превью в списке Виджет выберите виджет, который будете настраивать.

Кнопки Подложка, Ширина и Сужаем на той же панели показывают виджет на тёмном фоне, на планшете, на мобильном и в узкой колонке. На сайт они не влияют.

Шаг 2. Настройте поведение и блоки​

  1. В разделе Поведение задайте настройки выбранного виджета: сортировку, число отзывов на странице, ссылку на правила обработки персональных данных. Настройки в подгруппе Общие для страницы действуют на все виджеты на странице, например Показывать ответы на отзывы и AI-сводка в списке отзывов.
  2. В разделе Элементы виджета выключите блоки, которые не нужны на сайте: поиск, фильтр, жалобу, аватары. У информера и приглашения оставить отзыв этого раздела нет.
  3. В разделе Бандл в поле Модули оставьте виджеты, которые стоят на сайте. По умолчанию выбраны все, кроме приглашения оставить отзыв. Невыбранный модуль на сайте не загружается: без модуля формы отзыва кнопка Написать отзыв в виджете отзывов ничего не откроет.

Что делает каждая настройка, описано в справочнике настроек виджетов.

Шаг 3. Подберите оформление​

  1. В разделе Пресеты в поле Выберите тему выберите готовый пресет: По умолчанию, Тёмный, Контрастный, Мягкий или Компактный.
  2. Поправьте цвета в разделе Цвета, отступы и скругления в разделе Размер и форма. После первой правки к названию пресета добавится «с правками».
  3. Сохраните пресет:
    • если правили готовый пресет, нажмите Сохранить пресет и введите название;
    • если правили свой сохранённый пресет, нажмите Сохранить, чтобы записать изменения в него, или Сохранить как новый.

Сохранённые пресеты видят все пользователи компании с доступом к разделу Виджеты. Ненужный пресет удаляет кнопка Удалить пресет. Значения токенов — в справочнике темы оформления.

Шаг 4. Подключите счётчики аналитики​

В разделе Счётчики веб-аналитики укажите Счётчик Яндекс Метрики, Тег Google (вида G-XXXXXXX) или оба. Виджеты будут отправлять туда свои события: открытие формы, отправку отзыва, клики по фильтрам. Для Метрики заведите цели типа «JavaScript-событие» с именами событий из справочника JS API.

Шаг 5. Отправьте настройки на сайт​

На панели над превью нажмите значок Показать инструкции по установке и выберите вкладку по тому, как виджеты установлены на сайте.

  1. Если виджетов на сайте ещё нет, передайте разработчику сайта блок Код для страницы сайта: это загрузчик без настроек, он ставится на все страницы с виджетами.
  2. В блоке Скрипт провайдера нажмите значок Обновить скрипт провайдера. Откроется редактор скрипта с новыми настройками, токеном из раздела Аутентификация и сообщением «Скрипт провайдера обновлён, но не сохранён».
  3. Проверьте код и нажмите Сохранить. Ручной код вокруг маркеров aplaut:playground не меняется: из раздела Виджеты обновляется только блок между ними.
  4. Убедитесь, что включён переключатель Отдавать скрипт провайдера вместо бандла. Пока он выключен, по адресу app.js сайт получает бандл без ваших настроек.

Каждое сохранение создаёт новую версию скрипта, хранятся последние 10. Чтобы вернуть прежнюю, выберите её в поле Версия и нажмите Откатить к этой версии.

warning

Переключатель Отдавать скрипт провайдера вместо бандла действует на все страницы сайта сразу. Прежде чем включать его впервые, проверьте, что в скрипте провайдера есть токен и нужные модули в availableWidgets: иначе виджеты на сайте перестанут отображаться.

Чтобы показать превью коллеге, нажмите Поделиться ссылкой: ссылка откроет тот же товар, виджет, пресет и набор скрытых элементов. Настройки из раздела Поведение и пользовательский CSS в ссылку не попадают. Кнопка недоступна, пока в оформлении есть несохранённые правки.

Проверка результата​

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

Смотрите также: о том, где живут настройки виджетов, установка виджетов 2.0 на веб-сайте, роли и права доступа.