Как изменить тексты, тему и стили виджетов
Как заменить тексты виджетов 2.0, включая правила в форме отзыва, переключить язык, менять тему без перезагрузки страницы и добавить свои CSS-стили
Замените тексты, переключайте тему вместе с сайтом и добавьте CSS-стили в коде, если цветов, отступов и переключателей из раздела Виджеты не хватает. Код добавляется в вызов aplaut.init на сайте или в скрипт провайдера.
Замените тексты
- Найдите ключ нужного текста в словаре переводов.
- Передайте в
textsтолько те ключи, которые меняете, сохранив путь до них.
aplaut.init(access_token, {
locale: "ru",
texts: {
ru: {
reviews: { title: "Отзывы покупателей" },
},
},
});
Переменные в фигурных скобках, например {count}, виджет подставляет сам. Формы множественного числа задаются меткой {plural: …} внутри строки. Виджет заменяет метку числом из count и подходящей формой слова:
texts: {
ru: {
reviews: {
summary: {
hint: 'По {plural: [["zero","оценкам"],["one","оценке"],["two","оценкам"],["few","оценкам"],["many","оценкам"]]} покупателей',
},
},
},
},
Названия форм (one, few, many и другие) те же, что у соседних строк словаря.
Тексты шапки окна приглашения и шага выбора товара в форме переехали из ветки form.header.picker в form.header.reviewInvite: mobileTitle, mainTitle, mainSubtitle, title, subtitle. Переопределения в texts со старым путём больше не действуют: перенесите их в новую ветку.
Ключи, которые появились в словаре недавно:
| Ключ | Текст по умолчанию |
|---|---|
reviews.report.submitted | Жалоба отправлена |
reviews.report.error | Не удалось отправить жалобу |
reviews.report.submit | Пожаловатся |
form.reviews.pagination.error | Не удалось загрузить отзывы |
form.reviews.pagination.retryButton | Повторить |
form.questions.pagination.help | Вы просмотрели {pages} вопросов из {count} |
form.questions.pagination.loadMoreButton | Загрузить еще |
form.questions.pagination.error | Не удалось загрузить вопросы |
form.questions.pagination.retryButton | Повторить |
form.personal.email.invalid | Введите корректный email |
reply.form.header.title | Ответ |
reply.form.header.replyTo | Ответ для {name} |
form.stories.* | Тексты формы сторис |
Тексты reviews.report.submitted и reviews.report.error появляются в подсказке у кнопки жалобы после отправки. Сообщения «Введите телефон» и «Введите корректный телефон» под полем телефона в словарь не входят и через texts не меняются.
Правила публикации в форме отзыва
Тексты блока Правила лежат в ветке form.reviews.footer.terms: для формы вопроса — form.questions.footer.terms, для формы ответа — form.reply.footer.terms. Ключи rules, description и agreement принимают HTML, title выводится простым текстом. В description и agreement можно вставить {privacy_link}: виджет заменит его ссылкой на правила обработки персональных данных.
texts: {
ru: {
form: {
reviews: {
footer: {
terms: {
title: "Правила",
rules: "<p>Мы публикуем отзывы без оскорблений и ссылок на другие магазины.</p>",
agreement: 'Я согласен с <a target="_blank" href="{privacy_link}">политикой обработки персональных данных</a>',
},
},
},
},
},
},
Саму ссылку задайте в разделе Виджеты на вкладке Виджет → Поведение → Ссылка на правила ПД.
Переключите язык
Встроенные языки — ru, en и kz, язык задаёт обязательный ключ locale. Для любого другого языка передайте в texts словарь целиком: подстановки из русского словаря нет, и ключи без перевода покажутся как есть, например reviews.title.
Чтобы сменить язык без перезагрузки, вызовите aplaut.setLocale({ locale: "en" }). Переключиться можно только на язык из locale или на полностью переданный в texts. Новый язык получают тексты, которые виджеты выводят после вызова, поэтому вызывайте метод до того, как покупатель откроет виджет.
Переключайте тему без перезагрузки
Если на сайте есть переключатель светлой и тёмной темы, виджеты могут менять оформление вместе с сайтом. Метод aplaut.setTheme перекрашивает виджеты на странице сразу: открытая форма и введённый текст сохраняются.
-
Подберите вторую тему на вкладке Оформление в разделе Виджеты, например от пресета Тёмный. Объект
themeвозьмите из блока Код для страницы сайта. Можно передать его целиком или только токены, которые отличаются от темы вaplaut.init. -
В обработчике переключателя сайта вызовите
aplaut.setThemeс этой темой, а для возврата к теме изaplaut.init—aplaut.setTheme(null):const darkTheme = {cssVars: {color_background_primary: { default: "#111111" },color_text_primary: { default: "#eeeeee" },},};function onSiteThemeChange(isDark) {aplaut.setTheme(isDark ? darkTheme : null);}Каждый вызов накладывается на тему из
aplaut.init, а не на предыдущий вызов: токены из прошлого вызова не сохраняются. -
Если сайт помнит выбор покупателя между загрузками страницы, передайте тему ещё до загрузки скрипта виджетов, сразу после загрузчика. Виджеты отрисуются в ней с первого кадра, без мигания светлой темы:
if (localStorage.getItem("site-theme") === "dark") {aplaut.q.push(["setTheme", darkTheme]);}aplaut.q.pushработает только до загрузки скрипта. После загрузки вызывайтеaplaut.setThemeнапрямую.
Чтобы перекрашивать отдельный виджет, а не все, задайте его теме id в атрибуте data-theme, например data-theme='{"id":"card"}'. Вызов aplaut.setTheme({ id: "card", cssVars: { … } }) изменит только виджеты с этим id. Порядок наложения тем и все варианты вызова — в справочнике JS API.
Добавьте свои CSS-стили
Метод aplaut.applyStyles добавляет CSS в <head> страницы и во все виджеты внутри Shadow DOM, включая те, что появятся позже. Стили действуют на всю страницу, поэтому начинайте селекторы с классов виджета, например .aplaut-review для карточки отзыва. Классы элементов видны в инструментах разработчика браузера.
aplaut.applyStyles(".aplaut-review", {
"background-color": "#f5f5f5",
"border-radius": "8px",
});
Имена свойств пишутся через дефис, значения применяются с !important. Чтобы передать готовый CSS, вызовите метод со строкой и ключом. Повторный вызов с тем же ключом заменит стили, а не добавит вторые:
aplaut.applyStyles(".aplaut-review { background: #fff !important; }", "review-card-theme");
В массиве методов загрузчика applyStyles нет. Вызывайте метод после загрузки скрипта виджетов или допишите его в массив методов загрузчика, см. справочник JS API.
Проверка результата
Откройте страницу товара в режиме инкогнито. Заголовок и правила в форме показывают ваши тексты, карточки отзывов — ваши стили. После переключения темы сайта виджеты меняют цвета без перезагрузки страницы, а после перезагрузки сразу показываются в выбранной теме. Если текст не изменился, сверьте путь ключа со словарём: опечатка в любом уровне вложенности оставляет исходный текст.
Смотрите также: справочник темы оформления, справочник JS API виджетов.