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