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

Как изменить тексты, тему и стили виджетов

Как заменить тексты виджетов 2.0, включая правила в форме отзыва, переключить язык, менять тему без перезагрузки страницы и добавить свои CSS-стили

Замените тексты, переключайте тему вместе с сайтом и добавьте CSS-стили в коде, если цветов, отступов и переключателей из раздела Виджеты не хватает. Код добавляется в вызов aplaut.init на сайте или в скрипт провайдера.

Замените тексты​

  1. Найдите ключ нужного текста в словаре переводов.
  2. Передайте в 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 перекрашивает виджеты на странице сразу: открытая форма и введённый текст сохраняются.

  1. Подберите вторую тему на вкладке Оформление в разделе Виджеты, например от пресета Тёмный. Объект theme возьмите из блока Код для страницы сайта. Можно передать его целиком или только токены, которые отличаются от темы в aplaut.init.

  2. В обработчике переключателя сайта вызовите 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, а не на предыдущий вызов: токены из прошлого вызова не сохраняются.

  3. Если сайт помнит выбор покупателя между загрузками страницы, передайте тему ещё до загрузки скрипта виджетов, сразу после загрузчика. Виджеты отрисуются в ней с первого кадра, без мигания светлой темы:

    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 виджетов.