Что делать, если виджет отзывов Astrina не отображается на вашем сайте
Страница может загружаться нормально, но виджет отзывов Astrina при этом так и останется невидимым. В этом и заключается первая ловушка, из-за которой часто возникает вопрос, почему не показывается виджет Astrina. Сайт работает, URL открывается, шапка и подвал выглядят нормально, а виджета просто нет.
Это различие важно, потому что «страница открылась» не значит, что виджет отрендерился. Главная может загружаться за 1 секунду, карточка товара может показывать свой контент, а виджет отзывов всё равно может не сработать именно на этом шаблоне, и в итоге Astrina виджет не виден на сайте. Если вы проверяете каждый сайт, за которым следите, это как раз тот случай, когда проблема скрывается на виду.
Почему виджет отзывов Astrina не показывается, хотя страница открыта?
Начните с узкого вопроса: страница загрузилась или виджет не появился? Это не одно и то же. Живая страница может вернуть статус 200, показать текст и всё равно не иметь виджета отзывов, потому что скрипт виджета так и не запустился, блок скрыт или правило размещения не совпало.
Здесь помогает одна практическая проверка. Откройте страницу в обычном окне браузера, а не только в предпросмотре редактора. Затем обновите её один раз. Если виджет появляется в предпросмотре, но не на опубликованной странице, проблема обычно не в самом виджете, а в настройке страницы, шаблоне или условии, которое срабатывает только после публикации.
Часть «сайт работает» может сбивать с толку. Не стоит на этом зацикливаться. Если на живой странице виджета нет, сначала считайте это проблемой рендера, а уже потом — проблемой контента. Такой порядок экономит время.
Виджет вообще включён для этой страницы или места размещения?
Многие проблемы с виджетом сводятся к простому несоответствию: виджет включён глобально, но не для той страницы, которую вы проверяете. Владелец сайта может включить его для главной страницы, а потом ждать, что он появится на каждой странице товара. Но так происходит не всегда автоматически.
Проверьте настройки виджета по трём пунктам: страница, шаблон и секция. Если Astrina позволяет размещать виджет только в определённых областях, убедитесь, что правило размещения включает текущий тип страницы. Запись блога, страница категории и лендинг могут вести себя по-разному. Одного неверного клика достаточно.
Если вы управляете несколькими страницами, сравните рабочую страницу с той, где виджет отсутствует. Используйте то же имя шаблона, ту же секцию и то же правило виджета. Если на одной странице отзывы отображаются, а на другой нет, разница обычно в размещении, а не в самом содержимом отзывов. Для команд, которые ведут больше одного проекта, все сайты клиентов в одной панели позволяют сравнивать такие вещи гораздо быстрее.
Не пропускайте мелочи. Виджет может быть включён для «всех страниц товара» и при этом не появляться на одной конкретной странице, потому что там используется кастомный шаблон. Такое случается чаще, чем кажется.
Есть ли код виджета в исходнике страницы?
Если виджет включён, следующий вопрос простой: есть ли код на странице вообще? Откройте исходный код страницы или используйте инспектор браузера и найдите сниппет встраивания Astrina. Если сниппета нет, виджет не сможет отрендериться. Нет скрипта — нет виджета.
Эта проверка особенно важна после изменений в шаблоне CMS, конструкторе страниц или общем компоненте. Разработчик может перенести виджет в подключаемый footer, а потом заменить этот include. Или редактор может поменять блок и незаметно удалить embed. В обоих случаях страница всё равно загружается, из-за чего отсутствие виджета кажется загадкой, хотя на самом деле его просто нет в исходнике.
Проверяйте шаблон, а не только редактор страницы. Если виджет однажды вставили в общий раздел, изменение этого раздела повлияет на все страницы, которые из него собраны. Это одно изменение с широким эффектом. Если вы используете astrina через кастомную интеграцию, убедитесь, что скрипт по-прежнему попадает в вывод страницы после последнего деплоя.
Здесь помогает один быстрый тест. Найдите в исходнике «Astrina» или URL скрипта виджета. Если ничего не находится, код не передаётся в браузер. Если код есть, проблема смещается из категории «отсутствует код» в категорию «код есть, но не виден или заблокирован».
Не перекрывает ли виджет другой элемент и не уводит ли его за пределы видимости?
Иногда виджет отзывов Astrina есть на странице, но пользователи его не видят. Так бывает, когда его перекрывает другой элемент, контейнер схлопывается или CSS уводит его ниже видимой области так, как никто не ожидал. Вам страница кажется нормальной, потому что вы знаете, где должен быть виджет. Посетитель — нет.
Частая причина — аккордеоны. Другая — вкладки. Если виджет находится внутри свернутой вкладки или панели, которая открывается только после клика, он технически может отрендериться, но останется скрытым при первой загрузке. То же самое бывает с лениво загружаемыми секциями, закреплёнными баннерами или панелями согласия, которые перекрывают нижнюю часть экрана.
Проверьте макет через инспектор браузера. Посмотрите на родительские контейнеры виджета и убедитесь, что у них нет `display:none`, нулевой высоты или правил overflow, которые обрезают содержимое. Также проверьте значения z-index. Баннер cookie с более высоким z-index может лежать поверх виджета и создавать впечатление, что его нет.
Одна небольшая деталь может испортить отображение. Достаточно обёртки div с фиксированной высотой 0. То же самое может сделать правило темы, скрывающее любой элемент ниже определённого брейкпоинта. Если виджет есть на десктопе, но не на мобильном, в первую очередь смотрите на CSS.
Зависит ли виджет от согласия, региона или условия, которое блокирует показ?
Некоторые виджеты не появляются сразу, потому что ждут согласия пользователя или правила, связанного с регионом или устройством. Это нормально, если у вас настроено ожидание согласия. Становится непонятно только тогда, когда владелец страницы ожидает, что виджет появится ещё до нажатия «принять».
Проверьте, не настроен ли виджет на загрузку после согласия на cookie. Если да, протестируйте страницу дважды: до принятия и после. Если виджет появляется только после согласия, значит он работает как задумано. Если он не появляется вообще, правило согласия может быть слишком строгим или событие согласия не доходит до скрипта.
Региональные правила тоже могут скрывать виджет. Сайт может показывать его только в одной стране, на одном языке или на одном рынке. Это нормальное бизнес-правило. Но из-за него легко сделать ложный вывод, что виджет сломан, если проверяющий оказался вне разрешённого региона.
Задайте один конкретный вопрос: при каком условии виджет должен появляться? Запишите это. «После согласия», «на англоязычных страницах» или «только на страницах товара» гораздо полезнее, чем «он должен показываться везде». Чёткие правила ускоряют отладку.
Не блокируют ли виджет расширения браузера, блокировщики рекламы или ограничения сети?
Блокировщики на стороне браузера — частая причина. Ad blocker, расширения для приватности, корпоративные фильтры и даже некоторые DNS-инструменты могут остановить загрузку скрипта виджета. Если на телефоне виджет есть, а на рабочем ноутбуке нет, проблема может быть в устройстве, а не в сайте.
Проверьте в чистом профиле браузера. Затем откройте страницу в режиме инкогнито с отключёнными расширениями. Если там виджет появляется, вероятнее всего дело в блокировщике, а не в сломанной интеграции. Это полезная информация: следующий шаг меняется с «исправить код» на «выяснить, что именно блокирует загрузку».
Ограничения сети тоже имеют значение. Корпоративный файрвол может блокировать домен стороннего скрипта. Строгая настройка браузера может делать то же самое. Если запрос скрипта даже не уходит из браузера, виджет не сможет отрендериться. Перезагрузка страницы ничего не изменит.
Полезно разделить сценарии. Если виджет не работает только у одного пользователя, подозревайте расширения или сетевые правила. Если он не работает у всех, ищите проблему в странице, шаблоне или источнике скрипта.
Что проверить в консоли браузера, если виджет всё ещё не появляется?
Если виджет по-прежнему отсутствует, откройте консоль браузера и посмотрите на ошибки. Консоль часто показывает, в чём дело: отсутствует скрипт, запрос заблокирован или на странице конфликтует JavaScript. Одна эта панель может сэкономить много времени на догадках.
Начните с вкладки Network, затем обновите страницу один раз. Найдите запрос скрипта Astrina. Если он возвращает 404, источник указан неверно. Если запроса вообще нет, embed, возможно, не запускается. Если скрипт загружается, но в консоли появляется ошибка JavaScript, виджет может ломаться из-за того, что раньше падает другой скрипт на странице.
Конфликты часто приходят из другого фронтенд-кода. Скрипт темы может упасть и не дать инициализироваться следующим скриптам. Конструктор страниц может вставить дублирующий код. Пользовательский инструмент cookie может выбросить ошибку и остановить выполнение. Возможно, виджет ни при чём.
Здесь важна одна точная деталь: первая ошибка в консоли. Не последняя. Обычно именно первая ошибка указывает на реальную поломку. Если не уверены, скопируйте URL страницы, текст ошибки и время проверки. Эти три вещи помогают разработчику намного быстрее диагностировать проблему.
Если вы также отслеживаете другие функции сайта, сохраняйте ту же привычку на страницах статей и документации astrina. Скриншот с открытой консолью всегда полезнее, чем расплывчатая заметка.
Когда стоит передать проблему в поддержку Astrina или разработчику?
Передавайте проблему дальше, когда базовые проверки уже выполнены, а виджет всё ещё не появляется на нужной странице, в нужном браузере и при нужном условии. Обычно это значит, что дело уже не в настройке контента. Это либо проблема интеграции, либо конфликт на фронтенде.
Перед отправкой обращения соберите пять вещей: URL страницы, ожидаемое место размещения, что уже проверено, есть ли ошибки в консоли и появляется ли виджет в другом браузере или на другом устройстве. Эти пять пунктов избавляют от переписки туда-сюда, которая съедает целый день. Если можете ещё указать точное имя шаблона, сделайте и это.
Командам поддержки нужны детали. «Виджет не отображается» — этого недостаточно. «Виджет включён для страниц товара, код есть в исходнике, в Chrome на десктопе он появляется после согласия, но в Safari на iPhone — нет» — уже гораздо лучше. В такой фразе есть вся форма проблемы.
Если у вас кастомная настройка, разработчику может понадобиться проверить render hook, данные, передаваемые в виджет, или порядок загрузки скриптов. Если у вас свой процесс сборки, обязательно упомяните это. Если у вас несколько окружений, скажите и об этом. Staging и live-сайт могут вести себя по-разному по одной простой причине: разный результат сборки.
Держите URL страницы под рукой, когда связываетесь с Astrina. Используйте именно ту страницу, где виджет должен отображаться, а не общий линк на главную, и укажите, в каком браузере вы проверяли. Если вам нужна помощь с настройкой или сравнением параметров, страница astrina подскажет подходящий тариф и путь к поддержке.
Самый удобный формат передачи — короткий список и один скриншот. Добавьте URL, ожидаемое место и первую ошибку в консоли. Этого обычно достаточно, чтобы разработчик начал с правильного уровня, а не гадал.
