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

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

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

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

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

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

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

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

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

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

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

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

Панель разделена на вкладки Общие, Виджет и Оформление.

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

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

Что делает каждая настройка, описано в справочнике настроек виджетов. Если виджет в каком-то месте сайта должен выглядеть иначе, сохраните отличия в теге: см. как использовать отзывы за пределами карточки товара.

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

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

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

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

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

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

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

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

Перед сохранением кабинет проверяет синтаксис JavaScript. Скрипт с ошибкой не сохраняется: появится сообщение вида «Скрипт не сохранён: в строке 12 ошибка синтаксиса — Unexpected token», строка с ошибкой будет отмечена в редакторе, а курсор встанет на место ошибки. Описание ошибки приходит на английском. Исправьте код и сохраните снова: отметка пропадёт при первой правке. Проверяется только синтаксис, поэтому опечатку в имени настройки или неверный токен проверка не заметит.

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

В шаге Добавьте контейнеры виджетов на страницы лежит код тегов для каждого виджета, в шаге Дальнейшие шаги — список проверок после установки.

warning

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

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

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

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

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