Додати коментарі до сайтів Shopify
FastComments доступний у Магазині додатків Shopify. Встановіть додаток і додайте блоки FastComments до будь‑якого запису блогу, сторінки товару або власної сторінки через редактор тем Shopify. Редагування коду не потрібне.
Коли ви встановлюєте додаток, Shopify автоматично створює ваш обліковий запис FastComments, підключає домен магазину та налаштовує білінг. Вам не потрібно реєструватися окремо на fastcomments.com.
Сторінки цього посібника описують кожен блок FastComments, який надає додаток, як працює єдиний вхід (single sign-on) для ваших клієнтів Shopify, та як імпортувати наявні коментарі Shopify перед переходом.
Встановити додаток FastComments 
Встановлення з Shopify App Store
- Відкрийте сторінку FastComments у Shopify App Store.
- Натисніть Додати додаток і виберіть план, який ви хочете під час процесу встановлення.
- Після завершення встановлення Shopify перенаправить вас назад у адмінку FastComments всередині Shopify.
Це все для встановлення. Нічого не потрібно вставляти у файли теми.
Що буде налаштовано для вас
Встановлення виконує все, що ви інакше робили б вручну:
- Для вашого магазину створюється FastComments tenant і пов’язується з доменом вашого магазину.
- URL вашого магазину додається до дозволених доменів tenant'а, щоб коментарі завантажувалися без помилки домену.
- Записується shop метафілд
fastcomments.tenant_id, щоб кожен блок знав, для якого tenant'а рендеритись. - За замовчуванням для клієнтів вашого магазину Shopify увімкнено єдиний вхід (Single sign-on).
- Оплата здійснюється через Shopify Managed Pricing. Збори з’являються у вашому звичайному рахунку Shopify. Оновити, понизити або скасувати можна в Налаштування > Додатки та канали продажу > FastComments в адмінці Shopify.
Якщо ваш магазин вже був клієнтом FastComments до встановлення додатку, встановлення повторно використовує існуючий tenant замість створення нового.
Вбудована панель адміністратора
Коли ви відкриваєте додаток FastComments з адмінки Shopify, ви потрапляєте на дашборд з плитками з одноразовими посиланнями для входу в повну бек-енд панель FastComments:
- Dashboard: налаштування облікового запису, використання і деталі підписки.
- Moderation Queue: схвалювати, відхиляти та відповідати на коментарі по всьому магазину.
- Customize: налаштувати кольори віджета, шрифти, правила модерації та конфігурацію.
- Ratings & Reviews Helper: налаштувати рейтинги зі зірками та питання для відгуків, якщо ви хочете використовувати блок Reviews Summary.
Кожна плитка відкриває FastComments за допомогою одноразового посилання для входу, тож окремий вхід не потрібен.
Далі: додайте блоки до вашого магазину
Відкрийте редактор тем Shopify (Інтернет-магазин > Теми > Налаштувати), відкрийте шаблон, до якого ви хочете додати коментарі або відгуки, і натисніть Додати блок. Блоки FastComments з’являються під Додатки. Уся решта цього посібника описує кожен із них.
Додати коментарі до блог-постів та продуктів
Блок FastComments — це основний віджет коментарів. Додайте його до шаблонів публікацій блогу, шаблонів товарів або будь-якої іншої сторінки, де ви хочете мати дискусію або живий чат.
Додати блок
- Відкрийте редактор тем Shopify (Online Store > Themes > Customize).
- Оберіть шаблон, на якому ви хочете мати коментарі: Blog post, Product, або будь-який інший шаблон сторінки чи секції.
- У секції, де ви хочете, щоб з'являлися коментарі, натисніть Add block.
- У розділі Apps оберіть FastComments.
- Натисніть Save.
Блок з'являється негайно. Вводити Tenant ID не потрібно; tenant вашого магазину підключається автоматично під час встановлення додатку.
Налаштування
| Налаштування | Що робить | За замовчуванням |
|---|---|---|
| Tenant ID (optional) | Перевизначає, до якого tenant FastComments рендериться блок. Залиште порожнім, щоб використовувати tenant, налаштований автоматично для магазину. Знайдіть ручний Tenant ID на fastcomments.com/auth/my-account/api-secret. | (порожньо) |
| SSO | Автоматично входить відвідувача як його обліковий запис клієнта Shopify перед коментуванням. Див. Автоматичний вхід клієнтів Shopify. | Увімкнено |
| Commenting Style | Вкладена для вкладених відповідей і голосувань, або Потокова для реального часу у вигляді чату. | Вкладена |
| Custom URL ID | Перевизначає автоматично виявлений ідентифікатор сторінки. Використовуйте це, коли ви хочете, щоб дві URL поділяли одну нитку коментарів. | (визначається автоматично) |
Як обирається ідентифікатор сторінки
Кожна нитка коментарів ідентифікується за URL ID. Блок обирає його автоматично:
- Blog post template:
shopify-article-{article.id}, який залишається сталим при зміні slug або заголовка. - Product template:
shopify-product-{product.id}, який залишається сталим при зміні slug або заголовка. - Інші шаблони: шлях запиту.
Якщо ви встановите Custom URL ID, буде використано це значення. Використовуйте однаковий Custom URL ID у кількох блоках (наприклад, на локалізованій версії сторінки товару), щоб спільно використовувати одну нитку коментарів.
Вкладена (Threaded) проти Потокової (Streaming)
Вкладена — це поведінка за замовчуванням. Відвідувачі відповідають один одному, голосують, а інструменти модерації працюють як очікується. Найкраще підходить для публікацій у блогах і оглядів товарів.
Потокова прибирає вкладеність і показує нові коментарі в реальному часі по мірі їх публікації, як у стрічці чату. Найкраще підходить для запусків продуктів, живих подій і спільнот.
Кілька блоків на одній сторінці
Блок можна додати більше одного разу до того самого шаблону. Наприклад, підсумок відгуків у верхній частині сторінки товару й блок FastComments унизу. Блоки ділять URL ID, тому підсумок відображає коментарі знизу.
Поради
- Блок ховається у попередньому перегляді редактора тем із жовтим повідомленням, якщо не може знайти tenant. Якщо це з'являється у вашому живому магазині, перевстановіть додаток FastComments.
- Для сторінки товару блок FastComments одночасно виконує роль віджета відгуків про товар. Поєднайте його з FastComments - Reviews Summary для підсумку рейтингу зірочками у верхній частині сторінки.
Додати значок кількості коментарів
Блок FastComments - Comment Count відображає невеликий лічильник коментарів для однієї сторінки. Використовуйте його у списках постів блогу, картках товарів або будь-якому шаблоні, що посилається на сторінку з коментарями, щоб відвідувачі могли бачити, наскільки активне кожне обговорення, перед переходом.
Додайте блок
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, у якому має з'явитися лічильник. Наприклад, шаблон Blog (список постів) або розділ зі списком товарів.
- Натисніть Add block у розділі, який відображає кожен елемент.
- У розділі Apps виберіть FastComments - Comment Count.
- Натисніть Save.
Налаштування
| Налаштування | Що воно робить | За замовчуванням |
|---|---|---|
| Tenant ID (необов'язково) | Перевизначає, з якого орендаря FastComments зчитується лічильник. Залиште порожнім, щоб використовувати автоматично налаштованого орендаря магазину. | (порожньо) |
| Custom URL ID | Перевизначає ідентифікатор сторінки, який шукає лічильник. Використовуйте це, коли лічильник розташований на іншій сторінці, ніж блок FastComments, який він відстежує. | (визначається автоматично) |
Як лічильник зіставляється з гілкою коментарів
Блок Comment Count використовує ту саму логіку автоматичного визначення, що й блок FastComments:
- Шаблон посту блогу:
shopify-article-{article.id} - Шаблон товару:
shopify-product-{product.id} - Інші шаблони: шлях запиту
Якщо ви встановили Custom URL ID у блоці FastComments на сторінці, встановіть той самий Custom URL ID у блоці Comment Count, щоб вони вказували на одну гілку.
Поради
- Лічильники для всіх елементів на сторінці завантажуються одним запитом, тому додавання блоку до кожного елемента в довгому списку не має додаткових витрат на мережеві запити.
- Один блок Comment Count на статтю або товар у списку — це очікуване використання; блок можна додавати стільки разів, скільки потрібно.
Додати стрічку останніх коментарів
Блок FastComments - Recent Comments показує найновіші коментарі з усього вашого магазину. Використовуйте його, щоб демонструвати свіжу активність у бічній панелі, футері або секції головної сторінки.
Додавання блоку
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, де ви хочете розмістити стрічку. Бічна панель, головна сторінка або індекс блогу — усі варіанти підходять.
- Натисніть Add block у секції, яка має містити блок.
- У розділі Apps виберіть FastComments - Recent Comments.
- Натисніть Save.
Налаштування
| Налаштування | Що воно робить | За замовчуванням |
|---|---|---|
| Tenant ID (необов'язково) | Перевизначає, з якого орендаря FastComments стрічка зчитує дані. Залиште порожнім, щоб використовувати автоматично налаштованого орендаря магазину. | (порожньо) |
| Number of comments | Скільки останніх коментарів показувати. Діапазон від 1 до 50. | 5 |
Поради
- Кожен коментар посилається на сторінку, де він був опублікований, тому блок також слугує навігаційною підказкою «про що зараз говорять люди».
- Стрічка є загальномагазинною. Щоб показати останні коментарі для окремої сторінки, використовуйте натомість блок FastComments на цій сторінці.
Додати стрічку останніх обговорень
Блок FastComments - Recent Discussions показує сторінки вашого магазину з найновішою активністю коментарів, по одному запису на сторінку. Використовуйте його, коли хочете, щоб відвідувачі знаходили активні обговорення, а не окремі коментарі.
Додавання блоку
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, куди хочете додати стрічку, наприклад бічну панель, футер, індекс блогу або секцію головної сторінки.
- Натисніть Add block у секції, яка має містити блок.
- У розділі Apps виберіть FastComments - Recent Discussions.
- Натисніть Save.
Налаштування
| Налаштування | Що робить | За замовчуванням |
|---|---|---|
| Tenant ID (необов'язково) | Перевизначає, з якого орендаря FastComments стрічка читає дані. Залиште порожнім, щоб використовувати автоматично налаштованого орендаря магазину. | (порожньо) |
| Number of comments | Скільки останніх обговорень показувати. Діапазон від 1 до 50. | 20 |
Recent Discussions vs Recent Comments
Обидва блоки беруть дані з одного джерела, але показують різні подання:
- Recent Comments: плоский список останніх окремих коментарів. Найкраще підходить для «що щойно сказали».
- Recent Discussions: один запис на сторінку, упорядкований за останньою активністю. Найкраще підходить для «які обговорення зараз активні».
Ви можете використовувати обидва блоки в одному магазині. Наприклад, Recent Comments у бічній панелі блогу, а Recent Discussions на головній сторінці.
Додати список топ-сторінок
Блок FastComments - Top Pages показує сторінки вашого магазину з найбільшою активністю коментарів загалом. Використовуйте його, щоб виділити найбільш обговорювані публікації або товари.
Додайте блок
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, куди хочете додати список, наприклад бічну панель, футер або розділ індексу блогу.
- Натисніть Add block у розділі, який має його містити.
- У розділі Apps виберіть FastComments - Top Pages.
- Натисніть Save.
Налаштування
| Налаштування | Що робить | За замовчуванням |
|---|---|---|
| Tenant ID (необов'язково) | Перевизначає, з якого тенанта FastComments список зчитує дані. Залиште порожнім, щоб використовувати автоматично налаштований тенант магазину. | (порожньо) |
Top Pages vs Recent Discussions
- Top Pages ранжує за загальною активністю, тому самі публікації зазвичай залишаються вгорі списку деякий час. Добре підходить для бічної панелі «популярних публікацій».
- Recent Discussions ранжує за найновішою активністю, тому список постійно оновлюється. Добре підходить для панелі «що актуально зараз».
Додати підсумок відгуків
Блок FastComments - Reviews Summary показує агрегований зірковий рейтинг і розподіл відгуків для сторінки. Поєднуйте його з блоком FastComments на шаблонах товарів для стандартного макета відгуків: зведення зверху, форма відгуку та відгуки знизу.
Передумова: налаштуйте Ratings & Reviews
Блок Reviews Summary відображає питання оцінювання, які ви налаштували для свого магазину. Спочатку налаштуйте їх:
- Відкрийте застосунок FastComments в адмінці Shopify.
- Натисніть плитку Ratings & Reviews Helper (або відкрийте Ratings & Reviews Helper безпосередньо).
- Додайте питання, на які має відповідати кожен рецензент (загальний зірковий рейтинг, «як сидиться» тощо).
Без налаштованих питань блоку зведення немає чого агрегувати.
Додайте блок
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон Product (або шаблон сторінки, де ви хочете розмістити зведення).
- Натисніть Add block угорі розділу сторінки, вище місця, де буде блок FastComments.
- У розділі Apps виберіть FastComments - Reviews Summary.
- Додайте блок FastComments нижче на тій самій сторінці, якщо ви ще цього не зробили, щоб відвідувачі могли залишати відгуки.
- Натисніть Save.
Налаштування
| Налаштування | Що робить | За замовчуванням |
|---|---|---|
| Tenant ID (необов'язково) | Перевизначає, з якого тенанта FastComments зведення читає дані. Залиште порожнім, щоб використовувати автоматично налаштований тенант магазину. | (порожньо) |
| Custom URL ID | Перевизначає ідентифікатор сторінки, щодо якої агрегується зведення. Використовуйте це, коли зведення розташоване на іншій сторінці, ніж блок FastComments, який воно відображає. | (визначається автоматично) |
Як зведення зіставляється з відгуками
Блок Reviews Summary використовує ту саму логіку автовизначення, що й блок FastComments:
- Шаблон товару:
shopify-product-{product.id} - Шаблон публікації блогу:
shopify-article-{article.id} - Інші шаблони: шлях запиту
Для звичайної сторінки товару зведення та гілка коментарів автоматично мають спільний URL ID без жодного налаштування.
Поради
- Зведення доступне лише для читання. Щоб збирати відгуки, потрібен блок FastComments на тій самій сторінці.
- Якщо ви зміните питання оцінювання в Ratings & Reviews Helper після збору відгуків, зведення буде перераховано за новим набором питань.
Автоматичний вхід для клієнтів Shopify
The FastComments блок підтримує єдиний вхід (SSO), тому ваші клієнти Shopify можуть коментувати від свого імені без створення окремого акаунту FastComments.
Як це працює
Коли відвідувач, який увійшов у ваш магазин, відкриває сторінку з FastComments блоком:
- Блок виявляє об'єкт Shopify
customer. - Він відправляє ім'я та електронну пошту клієнта до FastComments через підписаний запит проксі-додатка.
- FastComments створює або співставляє користувача з ключем
shopify-{customerId}, тому той самий клієнт завжди відповідає тому самому користувачу FastComments у різних сесіях та при повторних перевстановленнях. - Ім'я відвідувача відображається в його коментарях. Його не підказують увійти знову.
Якщо відвідувач не увійшов у магазин, блок переходить на анонімне коментування (або на потік входу FastComments, залежно від налаштування вашого віджету).
Вимкнення SSO
SSO увімкнено за замовчуванням для кожного FastComments блоку. Щоб вимкнути його для конкретного блоку:
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, що містить блок, і клацніть блок, щоб його вибрати.
- Зніміть позначку SSO.
- Натисніть Save.
Вимикайте SSO, якщо ви хочете, щоб коментатори могли вибирати окрему особу для розмови. Наприклад, внутрішня сторінка спільноти, де співробітники коментують під іншим відображуваним ім'ям.
Що отримує FastComments
SSO-пейлоад, що надсилається для кожного клієнта, містить:
- Ідентифікатор користувача, отриманий з ідентифікатора клієнта Shopify (
shopify-{customerId}). - Електронну пошту клієнта (використовується для ідентифікації користувача; не відображається публічно).
- Відображуване ім'я клієнта (використовується як ім'я автора коментаря).
Не надсилається жодної інформації про історію замовлень, оплату або адреси. Пейлоад підписано на боці сервера; браузер клієнта ніколи не бачить облікових даних.
Посилання для входу та виходу
Коли SSO увімкнено, посилання для входу та виходу у віджеті коментарів вказують на /account/login та /account/logout, стандартні маршрути облікового запису клієнта Shopify. Нічого налаштовувати не потрібно. Посилання працюють у будь-якому магазині з увімкненими обліковими записами клієнтів.
Імпорт існуючих коментарів
Якщо у вас уже є коментарі до публікацій блогу Shopify і ви хочете зберегти їх, імпортуйте їх у FastComments перед тим, як вимкнути вбудовані коментарі Shopify.
Імпорт має виконуватися, поки вбудовані коментарі Shopify ще активні та видимі. Після їх вимкнення FastComments більше не зможе їх прочитати.
Як розпочати імпорт
- Переконайтеся, що додаток FastComments встановлено у вашому магазині.
- Поки залиште вбудовані коментарі Shopify увімкненими.
- Відкрийте звернення до служби підтримки і повідомте нам, які блоги потрібно імпортувати.
Імпорт виконується менш ніж за день.
Після того як ваші наявні коментарі будуть у FastComments, додайте блок FastComments до шаблону публікації блогу та видаліть або вимкніть вбудовані коментарі Shopify. Див. Додавання коментарів до публікацій блогу та товарів.
Якщо вам не потрібно зберігати наявні коментарі, ви можете пропустити цю сторінку.
Налаштування
Кольори, шрифти, правила модерування, дозволений HTML та анонімні коментарі — усе можна налаштувати відповідно до брендингу вашого магазину.
Відкрийте додаток FastComments в адмін-панелі Shopify і клацніть плитку Customize, щоб відкрити екран налаштування віджета. Він використовує одноразове посилання для входу, тому вам не потрібен окремий вхід.
Для повного переліку параметрів налаштування див. Посібник із налаштувань і конфігурації.
Помилки домену
Якщо ви встановили FastComments з Shopify App Store, домен вашого магазину автоматично додається до авторизованих доменів орендаря, і ви не повинні бачити помилку домену. Ця сторінка застосовується, якщо ви пройшли шлях ручної інсталяції, або якщо ваш магазин обслуговується на власному домені, який не був зареєстрований у Shopify на момент встановлення додатку.
Ви можете отримати помилку авторизації, яка виглядає так:
Це означає, що FastComments не розпізнає домен, на якому завантажується віджет, як авторизований для вашого орендаря.
Щоб це виправити, додайте домен до вашого облікового запису FastComments: Налаштувати домени.
Ручне встановлення (розширене)
Якщо ви не можете встановити застосунок із Shopify App Store, ви все одно можете додати FastComments, відредагувавши свою тему. Цей шлях корисний, коли ви хочете підключити вже наявний у вас тенант FastComments, або коли ви вбудовуєте віджети на вітрину Shopify, де застосунок недоступний.
Встановлення через застосунок є підтримуваним шляхом для більшості магазинів. Використовуйте цей спосіб, лише якщо застосунок вам не підходить.
Крок 1: Вимкніть нативні коментарі Shopify
В адмінпанелі Shopify перейдіть до Blog posts > Manage blogs, відкрийте кожен блог і встановіть Comments are disabled на панелі праворуч. Збережіть.
Це запобігає показу вбудованих коментарів Shopify разом із FastComments.
Крок 2: Відкрийте шаблон теми блогу
В адмінпанелі Shopify:
- Перейдіть до Online Store > Themes.
- Під вашою поточною темою натисніть Actions > Edit code.
- У файловому браузері ліворуч відкрийте Sections і натисніть
main-article.liquid.
Це шаблон, який Shopify відображає для окремої статті блогу.
Крок 3: Вставте фрагмент FastComments
Прокрутіть приблизно до 100-го рядка main-article.liquid, одразу після закриваючого </div> тіла статті. Вставте наступний фрагмент:
Замініть "demo" на власний Tenant ID зі сторінки fastcomments.com/auth/my-account/api-secret. Натисніть Save.
Крок 4: Авторизуйте домен вашого магазину
Відкрийте запис у блозі на вашому працюючому магазині. Якщо замість віджета коментарів ви бачите помилку авторизації, FastComments потрібно знати, що вашому магазину дозволено використовувати цей тенант. Дивіться Помилки домену.
Додавання FastComments на інші сторінки
Цей самий фрагмент працює на будь-якому шаблоні Liquid, включно зі сторінками товарів, користувацькими сторінками та головною сторінкою. Вставте його там, де ви хочете бачити коментарі, і за потреби змініть urlId, щоб отримати стабільний ідентифікатор для кожної сторінки (наприклад, urlId: "{{ product.id }}" у шаблоні товару).
Додати опитування у ваш магазин Shopify
Як тільки FastComments встановлено у вашому магазині Shopify, ви також можете проводити живі опитування прямо в коментарях. Увімкніть Enable Polls у налаштуваннях налаштування віджета, і кнопка опитування з’явиться на панелі інструментів коментаря. Опитування можуть мати від 2 до 10 варіантів, результати оновлюються в реальному часі для всіх на сторінці, і ви обираєте, хто може створювати опитування і чи вимагає голосування входу в систему. Більше нічого не потрібно встановлювати на Shopify.
Спробуйте демо живих опитувань або прочитайте документацію по опитуванням щоб налаштувати їх.