Додавання коментарів на сайти 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 для підсумку рейтингу зірочками у верхній частині сторінки.
Додати бейдж з кількістю коментарів
The FastComments - Comment Count block відображає невеликий лічильник коментарів для однієї сторінки. Використовуйте його в списках постів блогу, картках товарів або в будь-якому шаблоні, що посилається на сторінку з коментарями, щоб відвідувачі бачили, наскільки активна кожна тема, перш ніж переходити.
Add the block
- Відкрийте редактор тем Shopify.
- Відкрийте шаблон, де ви хочете, щоб лічильник з'явився. Наприклад, шаблон Blog (список постів) або секцію зі списком товарів.
- Натисніть Add block у секції, яка виводить кожен елемент.
- У розділі Apps оберіть FastComments - Comment Count.
- Натисніть Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Перезаписує, з якого оренданта FastComments зчитується лічильник. Залиште порожнім, щоб використовувати оренданта, налаштованого автоматично для магазину. | (порожньо) |
| Custom URL ID | Перезаписує ідентифікатор сторінки, за яким шукається лічильник. Використовуйте це, коли лічильник знаходиться на іншій сторінці, ніж блок FastComments, який він відстежує. | (визначається автоматично) |
How the count matches the comment thread
The Comment Count block uses the same auto-detection logic as the FastComments block:
- Blog post template:
shopify-article-{article.id} - Product template:
shopify-product-{product.id} - Other templates: the request path
Якщо ви встановили Custom URL ID у блоці FastComments на сторінці, встановіть той самий Custom URL ID у блоці Comment Count, щоб вони вказували на одну і ту ж нитку коментарів.
Tips
- Лічильники для всіх елементів на сторінці отримуються одним запитом, тому додавання блоку до кожного елемента в довгому списку не додає додаткових кругових запитів.
- Очікуване використання — один блок Comment Count на статтю або товар у списку; блок можна додавати стільки разів, скільки потрібно.
Додати стрічку останніх коментарів
The FastComments - Recent Comments block shows the most recent comments across your whole store. Use it to show fresh activity in a sidebar, footer, or homepage section.
Додати блок
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, де ви хочете розмістити стрічку. Підійдуть бічна секція, головна сторінка або індекс блогу.
- Клацніть Add block у секції, яка має містити блок.
- У розділі Apps виберіть FastComments - Recent Comments.
- Клацніть Save.
Налаштування
| Налаштування | Що це робить | За замовчуванням |
|---|---|---|
| Tenant ID (необов'язково) | Перезаписує, з якого тенанта FastComments читається стрічка. Залиште порожнім, щоб використовувати автоматично налаштований тенант магазину. | (пусто) |
| Кількість коментарів | Скільки останніх коментарів показати. Діапазон від 1 до 50. | 5 |
Поради
- Кожен коментар містить посилання на сторінку, де він було опубліковано, тому блок також слугує підказкою навігації типу "про що зараз говорять люди".
- Стрічка охоплює весь магазин. Щоб показати останні коментарі для однієї сторінки, використайте блок FastComments на цій сторінці замість цього.
Додати стрічку останніх обговорень
The FastComments - Recent Discussions block lists the pages on your store with the most recent comment activity, one entry per page. Use it when you want visitors to discover active threads rather than individual comments.
Додати блок
- Відкрийте редактор теми Shopify.
- Відкрийте шаблон, куди хочете додати стрічку, наприклад бічну панель, футер, індекс блогу або секцію на головній сторінці.
- Клацніть Add block в секції, яка має його містити.
- У розділі Apps оберіть FastComments - Recent Discussions.
- Клацніть Save.
Налаштування
| Налаштування | Що робить | За замовчуванням |
|---|---|---|
| Tenant ID (optional) | Перевизначає, з якого FastComments tenant читається стрічка. Залиште порожнім, щоб використовувати tenant, автоматично налаштований для магазину. | (blank) |
| Number of comments | Скільки нещодавніх обговорень показати. Діапазон від 1 до 50. | 20 |
Recent Discussions vs Recent Comments
Both blocks pull from the same data, but they show different views:
- Recent Comments: a flat list of the latest individual comments. Best for "what was just said".
- Recent Discussions: one entry per page, ordered by most recent activity. Best for "which threads are alive right now".
You can use both on the same store. For example, Recent Comments in the blog sidebar and Recent Discussions on the home page.
Додати список найпопулярніших сторінок
The FastComments - Top Pages block lists the pages on your store with the most comment activity overall. Use it to surface your most-discussed posts or products.
Add the block
- Open the Shopify theme editor.
- Open the template where you want the list, such as a sidebar, footer, or blog index section.
- Click Add block in the section that should hold it.
- Under Apps, select FastComments - Top Pages.
- Click Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Override which FastComments tenant the list reads from. Leave blank to use the store's automatically-configured tenant. | (blank) |
Top Pages vs Recent Discussions
- Top Pages ranks by total engagement, so the same posts tend to stay near the top for a while. Good for a "popular posts" sidebar.
- Recent Discussions ranks by most recent activity, so the list churns. Good for a "what's hot right now" panel.
Додати зведення відгуків
The FastComments - Reviews Summary block shows an aggregated star rating and review breakdown for a page. Pair it with the FastComments block on product templates for the standard reviews layout: summary up top, review form and reviews below.
Передумова: налаштуйте 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 (optional) | Override which FastComments tenant the summary reads from. Leave blank to use the store's automatically-configured tenant. | (blank) |
| Custom URL ID | Override the page identifier the summary aggregates against. Use this when the summary lives on a different page from the FastComments block it reflects. | (auto-detected) |
Як підсумок зіставляється з відгуками
Блок Reviews Summary використовує ту ж логіку автоматичного визначення, що й блок FastComments:
- Product template:
shopify-product-{product.id} - Blog post template:
shopify-article-{article.id} - Other templates: the request path
Для звичайної сторінки продукту підсумок і тред коментарів автоматично мають спільний 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: Налаштувати домени.
Ручна установка (для просунутих)
If you can't install the Shopify App Store app, you can still add FastComments by editing your theme. This path is useful when you want to wire up a FastComments tenant you already own, or when you're embedding on a Shopify storefront where the app isn't an option.
The app-based install is the supported path for most stores. Reach for this only if the app doesn't fit.
Step 1: Disable Shopify's native comments
In your Shopify admin, go to Blog posts > Manage blogs, open each blog, and set Comments are disabled in the right-hand panel. Save.
This stops Shopify's built-in commenting from showing alongside FastComments.
Step 2: Open the blog theme template
In your Shopify admin:
- Go to Online Store > Themes.
- Under your current theme, click Actions > Edit code.
- In the file browser on the left, open Sections and click
main-article.liquid.
This is the template Shopify renders for a single blog article.
Step 3: Paste the FastComments snippet
Scroll to roughly line 100 of main-article.liquid, just after the closing </div> of the article body. Paste the following snippet:
Replace "demo" with your own Tenant ID from fastcomments.com/auth/my-account/api-secret. Click Save.
Step 4: Authorize your shop domain
Open a blog post on your live store. If you see an authorization error instead of the comment widget, FastComments needs to know your store is allowed to use this tenant. See Domain Errors.
Adding FastComments to other pages
The same snippet works on any Liquid template, including product pages, custom pages, and the home page. Paste it where you want comments to appear and adjust urlId if you want a stable identifier per page (for example, urlId: "{{ product.id }}" on a product template).