Как настроить виджеты в личном кабинете
Как подобрать поведение и оформление виджетов 2.0 на превью в разделе «Виджеты» и отправить настройки на сайт через скрипт провайдера
Подберите поведение и оформление виджетов 2.0 на превью в разделе Виджеты, а затем отправьте настройки на сайт. Если виджеты установлены через скрипт провайдера, код сайта менять не придётся.
Пункт Виджеты в группе Инструменты появляется в меню, только когда Aplaut включил раздел для вашей компании: см. как подключить функции раннего доступа. Состав настроек и названия полей могут меняться. Скрипт провайдера сразу меняет виджеты на всех страницах сайта, поэтому перед первым сохранением согласуйте настройки с поддержкой Aplaut.
Что понадобится
- Роль Менеджер или Администратор.
- OAuth-приложение со скоупами
content_apiиsubmissions_apiи выданный по нему токен. Первый скоуп нужен, чтобы виджеты читали отзывы, второй — чтобы из формы уходили новые. Приложение создаёт Администратор в разделе Админ → API и доступы → Приложения OAuth: см. как получить токен доступа к API. - Товар, который уже загружен в каталог Aplaut.
Шаг 1. Откройте превью
- В меню слева в группе Инструменты откройте Виджеты. Страница называется Виджеты для сайта.
- В панели настроек справа на вкладке Общие в разделе Аутентификация выберите OAuth-приложение и Токен. Если выбрать не из чего, у компании нет приложения со скоупом
content_api: попросите администратора создать его по ссылке создайте новое. - В разделе Тестовый товар в поле Товар начните вводить название или ID товара и выберите его из списка.
- На панели над превью в списке Виджет выберите виджет, который будете настраивать.
Кнопки Подложка, Ширина и Сужаем на той же панели показывают виджет на тёмном фоне, на планшете, на мобильном и в узкой колонке. В разделе Хост страница можно выбрать Шрифт страницы и включить Показывать границы контейнера. На сайт эти настройки не влияют. Панель настроек скрывает и возвращает кнопка Скрыть панель настроек.
Шаг 2. Настройте поведение и блоки
Панель разделена на вкладки Общие, Виджет и Оформление.
- На вкладке Общие в разделе Общие настройки задайте настройки, которые действуют на все виджеты на странице: Способ авторизации покупателя, Показывать ответы на отзывы, AI-сводка в списке отзывов, Разметка JSON-LD и другие.
- На вкладке Виджет в разделе Поведение задайте настройки выбранного виджета: сортировку, число отзывов или вопросов на странице, ссылку на правила обработки персональных данных. Если у виджета нет своих настроек, вкладка подскажет перейти на Общие и Оформление.
- В разделе Элементы виджета выключите блоки, которые не нужны на сайте: поиск, фильтр, жалобу, аватары. У информера и приглашения оставить отзыв этого раздела нет.
Все виджеты на сайте доступны всегда: код виджета загружается, когда его тег появляется на странице. Чтобы код нужных виджетов загружался сразу при инициализации, на вкладке Общие в разделе Бандл и интеграция отметьте их в поле Предзагрузка виджетов. По умолчанию не выбран ни один. Поле Сборка виджетов выбирает версию кода для превью.
Что делает каждая настройка, описано в справочнике настроек виджетов. Если виджет в каком-то месте сайта должен выглядеть иначе, сохраните отличия в теге: см. как использовать отзывы за пределами карточки товара.
Шаг 3. Подберите оформление
- На вкладке Оформление в разделе Пресеты в поле Выберите тему выберите готовый пресет: По умолчанию, Тёмный, Контрастный, Мягкий или Компактный.
- Поправьте цвета в разделе Цвета, отступы и скругления в разделе Размер и форма, остальные токены — в разделе Прочее. После первой правки к названию пресета добавится «с правками».
- Сохраните пресет:
- если правили готовый пресет, нажмите Сохранить пресет и введите название;
- если правили свой сохранённый пресет, нажмите Сохранить, чтобы записать изменения в него, или Сохранить как новый.
Сохранённые пресеты видят все пользователи компании с доступом к разделу Виджеты. Ненужный пресет удаляет кнопка Удалить пресет. Значения токенов — в справочнике темы оформления.
Шаг 4. Подключите счётчики аналитики
На вкладке Общие в разделе Счётчики веб-аналитики укажите Счётчик Яндекс Метрики, Тег Google (вида G-XXXXXXX) или оба. Виджеты будут отправлять туда свои события: открытие формы, отправку отзыва, клики по фильтрам. События из превью тоже уходят в эти счётчики. Для Метрики заведите цели типа «JavaScript-событие» с именами событий из справочника JS API.
Шаг 5. Отправьте настройки на сайт
На панели над превью нажмите значок Показать инструкции по установке. В шаге Установите загрузчик скрипта выберите вкладку по тому, как виджеты установлены на сайте.
- Настройки в скрипте провайдера
- Настройки в коде сайта
- Если виджетов на сайте ещё нет, передайте разработчику сайта блок Код для страницы сайта: это загрузчик без настроек, он ставится на все страницы с виджетами.
- В блоке Скрипт провайдера нажмите значок Перенести в скрипт провайдера. Той же кнопкой внизу панели настроек можно воспользоваться, не открывая инструкцию. Откроется окно Скрипт провайдера с новыми настройками, токеном из раздела Аутентификация и сообщением «Настройки перенесены в скрипт, но не сохранены».
- Проверьте код и нажмите Сохранить. Ручной код вокруг маркеров
aplaut:playgroundне меняется: из раздела Виджеты обновляется только блок между ними. - Убедитесь, что включён переключатель Отдавать скрипт провайдера вместо бандла: он есть в том же окне. Пока он выключен, по адресу
app.jsсайт получает бандл без ваших настроек.
Перед сохранением кабинет проверяет синтаксис JavaScript. Скрипт с ошибкой не сохраняется: появится сообщение вида «Скрипт не сохранён: в строке 12 ошибка синтаксиса — Unexpected token», строка с ошибкой будет отмечена в редакторе, а курсор встанет на место ошибки. Описание ошибки приходит на английском. Исправьте код и сохраните снова: отметка пропадёт при первой правке. Проверяется только синтаксис, поэтому опечатку в имени настройки или неверный токен проверка не заметит.
Каждое сохранение создаёт новую версию скрипта, хранятся последние 10. Чтобы вернуть прежнюю, выберите её в поле Версия и нажмите Откатить к этой версии. Сохранённый скрипт открывает значок Сохранённый скрипт провайдера на панели над превью, а также раздел Админ → Виджеты и формы → Настройки виджетов, вкладка Widgets 2.0.
- Скопируйте блок Код для страницы сайта. В нём уже есть загрузчик и вызов
aplaut.initс вашими настройками. - Передайте код разработчику сайта. Вместо
<ACCESS_TOKEN>он подставит токен OAuth-приложения.
В шаге Добавьте контейнеры виджетов на страницы лежит код тегов для каждого виджета, в шаге Дальнейшие шаги — список проверок после установки.
Переключатель Отдавать скрипт провайдера вместо бандла действует на все страницы сайта сразу. Прежде чем включать его впервые, проверьте, что в скрипте провайдера есть токен: иначе виджеты на сайте перестанут отображаться.
Чтобы показать превью коллеге, нажмите Поделиться ссылкой: ссылка откроет тот же товар, виджет, тег, пресет, набор скрытых элементов и счётчики аналитики. Настройки из разделов Поведение и Общие настройки и пользовательские стили в ссылку не попадают. Кнопка недоступна, пока в оформлении есть несохранённые правки.
Проверка результата
Откройте страницу товара на сайте в режиме инкогнито. Виджет выглядит так же, как на превью. Скрипт провайдера кешируется до трёх часов, поэтому изменения доходят до сайта с задержкой. Если через три часа оформление прежнее, проверьте переключатель Отдавать скрипт провайдера вместо бандла и что последняя версия скрипта сохранена.
Смотрите также: о том, где живут настройки виджетов, установка виджетов 2.0 на веб-сайте, роли и права доступа.