Добавление комментариев на сайты Shopify
FastComments доступен в Shopify App Store. Установите приложение и добавьте блоки FastComments на любую запись в блоге, страницу товара или пользовательскую страницу через редактор тем Shopify. Редактирование кода не требуется.
Когда вы устанавливаете приложение, Shopify создаёт ваш аккаунт FastComments, подключает домен вашего магазина и автоматически настраивает биллинг. Вам не нужно отдельно регистрироваться на fastcomments.com.
Страницы этого руководства охватывают каждый блок FastComments, который предоставляет приложение, как работает единый вход (single sign-on) для ваших клиентов Shopify и как импортировать существующие комментарии Shopify перед переключением.
Установить приложение FastComments 
Установка через Shopify App Store
- Откройте страницу FastComments в магазине приложений Shopify.
- Нажмите Add app и выберите тарифный план во время процесса установки.
- После завершения установки Shopify перенаправит вас обратно в админку FastComments внутри Shopify.
Это вся установка. Ничего вставлять в файлы темы не требуется.
Что настраивается автоматически
Установка выполняет всё то, что вы в противном случае делали бы вручную:
- Для вашего магазина создаётся тенант FastComments и связывается с доменом вашего магазина.
- URL вашего магазина добавляется в список авторизованных доменов тенанта, чтобы комментарии загружались без ошибки домена.
- В магазин записывается метаполе
fastcomments.tenant_id, чтобы каждый блок знал, против какого тенанта рендериться. - Единый вход (SSO) для ваших клиентов Shopify включён по умолчанию.
- Оплата проводится через Shopify Managed Pricing. Списания отображаются в вашем обычном счёте Shopify. Обновить тариф, понизить или отменить можно в Настройки > Приложения и каналы продаж > FastComments в админке Shopify.
Если ваш магазин уже был клиентом FastComments до установки приложения, установка повторно использует существующий тенант вместо создания нового.
Встраиваемая админ-панель
Когда вы открываете приложение FastComments из админки Shopify, вы попадаете на панель с плитками для быстрого доступа в полный бэкенд FastComments:
- Dashboard: настройки аккаунта, использование и сведения о подписке.
- Moderation Queue: одобрение, отклонение и ответы на комментарии по всему магазину.
- Customize: настройка цветов виджета, шрифтов, правил модерации и конфигурации.
- Ratings & Reviews Helper: настройте звездные рейтинги и вопросы для обзоров, если вы хотите использовать блок Reviews Summary.
Каждая плитка открывает FastComments по одноразовой ссылке для входа, поэтому отдельная авторизация не требуется.
Далее: добавьте блоки в магазин
Откройте редактор темы Shopify (Онлайн-магазин > Темы > Настроить), откройте шаблон, в который вы хотите добавить комментарии или отзывы, и нажмите Добавить блок. Блоки FastComments появятся в разделе Приложения. Остальная часть этого руководства описывает каждый из них.
Добавить комментарии к записям блога и товарам
Блок FastComments — основной виджет комментариев. Добавьте его в шаблоны записей блога, шаблоны товаров или на любую другую страницу, где вы хотите поток обсуждений или живой чат.
Add the block
- Откройте редактор темы Shopify (Online Store > Themes > Customize).
- Выберите шаблон, на котором вы хотите разместить комментарии: Blog post, Product или любой другой шаблон страницы или секции.
- В секции, где должны отображаться комментарии, нажмите Add block.
- В разделе Apps выберите FastComments.
- Нажмите Save.
Блок появляется сразу. Вводить Tenant ID не нужно; арендатор вашего магазина подключается автоматически при установке приложения.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Переопределяет, против какого Tenant FastComments рендерит блок. Оставьте пустым, чтобы использовать автоматически настроенный tenant магазина. Найти ручной Tenant ID можно на fastcomments.com/auth/my-account/api-secret. | (пусто) |
| SSO | Автоматически входи́т посетителя как его аккаунт покупателя Shopify перед комментированием. Смотрите Auto-Login Shopify Customers. | Включено |
| Commenting Style | Threaded для вложенных ответов и голосований, или Streaming для потока чата в реальном времени. | Threaded |
| Custom URL ID | Переопределяет автоматически обнаруживаемый идентификатор страницы. Используйте это, когда хотите, чтобы два URL делили одну ветку комментариев. | (определяется автоматически) |
How the page identifier is chosen
Каждая ветка комментариев идентифицируется по URL ID. Блок выбирает его автоматически:
- Blog post template:
shopify-article-{article.id}, который остаётся неизменным при смене slug и заголовка. - Product template:
shopify-product-{product.id}, который остаётся неизменным при смене slug и заголовка. - Other templates: путь запроса.
Если вы зададите Custom URL ID, будет использовано это значение. Используйте один и тот же Custom URL ID в нескольких блоках (например, на локализованной версии страницы товара), чтобы они использовали одну ветку комментариев.
Threaded vs Streaming
Threaded — значение по умолчанию. Посетители отвечают друг другу, голосуют, и инструменты модерации работают как ожидалось. Лучше подходит для записей в блоге и отзывов о товарах.
Streaming убирает вложенность и показывает новые комментарии в реальном времени по мере их публикации, как в чате. Лучше подходит для запусков продуктов, живых мероприятий и сообществ.
Multiple blocks on the same page
Блок можно добавить более одного раза в один и тот же шаблон. Например, сводка отзывов вверху страницы товара и блок FastComments внизу. Блоки используют общий URL ID, поэтому сводка отображает комментарии ниже.
Tips
- Блок скрывается в превью редактора темы с жёлтым уведомлением, если не может найти tenant. Если это появляется в вашем реальном магазине, переустановите приложение FastComments.
- Для страницы товара блок FastComments одновременно может выступать виджетом отзывов о товаре. Скомбинируйте его с FastComments - Reviews Summary для отображения сводки рейтингов звёздами вверху страницы.
Добавить значок количества комментариев
The FastComments - Счётчик комментариев block renders a small comment count for a single page. Use it in blog post lists, product cards, or any template that links to a page with comments, so visitors can see how active each thread is before clicking through.
Add the block
- Open the Shopify theme editor.
- Open the template where you want the count to appear. For example, the Blog template (the post list) or a product listing section.
- Click Add block in the section that renders each item.
- Under Apps, select FastComments - Comment Count.
- Click Save.
Settings
| Параметр | Что делает | По умолчанию |
|---|---|---|
| Tenant ID (optional) | Переопределяет, из какого тенанта FastComments считывается счётчик. Оставьте пустым, чтобы использовать автоматически настроенный для магазина тенант. | (blank) |
| Custom URL ID | Переопределяет идентификатор страницы, по которому выполняется поиск счётчика. Используйте это, когда счётчик находится на другой странице, чем блок FastComments, за которым он отслеживает комментарии. | (auto-detected) |
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
If you set a Custom URL ID on the FastComments block on a page, set the same Custom URL ID on the Comment Count block so they point at the same thread.
Tips
- Counts for every item on the page are fetched in one request, so adding the block to every item in a long list has no extra round-trip cost.
- One Comment Count block per article or product in a listing is the expected usage; the block can be added as many times as you need.
Добавить ленту последних комментариев
The FastComments - Recent Comments block показывает самые последние комментарии по всему вашему магазину. Используйте его, чтобы показывать свежую активность в боковой панели, футере или разделе домашней страницы.
Добавьте блок
- Откройте редактор темы Shopify.
- Откройте шаблон, в котором вы хотите разместить ленту. Подойдет секция боковой панели, главная страница или индекс блога.
- Нажмите Добавить блок в секции, которая должна его содержать.
- В разделе Приложения выберите FastComments - Recent Comments.
- Нажмите Сохранить.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Переопределяет tenant FastComments, из которого будет считываться лента. Оставьте пустым, чтобы использовать tenant, автоматически настроенный для магазина. | (пусто) |
| Number of comments | Сколько последних комментариев показывать. Диапазон от 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.
Add the block
- Откройте редактор темы Shopify.
- Откройте шаблон, в котором вы хотите разместить ленту, например боковую панель, футер, индекс блога или секцию домашней страницы.
- Нажмите Add block в секции, которая должна его содержать.
- В разделе Apps выберите FastComments - Recent Discussions.
- Нажмите Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Переопределяет, из какого тенанта FastComments будет считываться лента. Оставьте пустым, чтобы использовать автоматически настроенный для магазина тенант. | (пусто) |
| Number of comments | Сколько последних обсуждений показать. Диапазон от 1 до 50. | 20 |
Recent Discussions vs Recent Comments
Оба блока используют одни и те же данные, но показывают разные представления:
- Recent Comments: плоский список последних отдельных комментариев. Лучше подходит для "что только что было сказано".
- Recent Discussions: по одной записи на страницу, упорядоченные по недавней активности. Лучше подходит для "какие обсуждения сейчас активны".
You can use both on the same store. For example, Recent Comments in the blog sidebar and Recent Discussions on the home page.
Добавить список популярных страниц
Блок FastComments - Top Pages отображает страницы в вашем магазине с наибольшей активностью комментариев в целом. Используйте его, чтобы выделить самые обсуждаемые записи или товары.
Добавить блок
- Откройте редактор темы Shopify.
- Откройте шаблон, где вы хотите разместить список, например в боковой панели, футере или разделе индекса блога.
- Нажмите Добавить блок в разделе, который должен его содержать.
- В разделе Приложения выберите FastComments - Top Pages.
- Нажмите Сохранить.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Переопределяет, из какого tenant FastComments читается список. Оставьте пустым, чтобы использовать tenant, настроенный автоматически для магазина. | (blank) |
Top Pages vs Recent Discussions
- Top Pages ранжирует по общей вовлеченности, поэтому одни и те же посты, как правило, в течение длительного времени остаются в верхней части списка. Подходит для боковой панели «популярные записи».
- Recent Discussions ранжирует по последней активности, поэтому список постоянно обновляется. Подходит для панели «что сейчас популярно».
Добавить сводку отзывов
The FastComments - Reviews Summary block показывает агрегированный рейтинг в звездах и разбивку по отзывам для страницы. Сопоставьте его с блоком FastComments в шаблонах товара для стандартного расположения отзывов: сводка сверху, форма отзыва и сами отзывы — ниже.
Предварительное условие: настройте Ratings & Reviews
Блок Reviews Summary отображает вопросы рейтинга, которые вы настроили для своего магазина. Сначала настроьте их:
- Откройте приложение FastComments в админке Shopify.
- Нажмите плитку Ratings & Reviews Helper (или откройте Ratings & Reviews Helper напрямую).
- Добавьте вопросы, на которые должен отвечать каждый рецензент (общая оценка в звездах, «как подошла вещь», и т.д.).
Если вопросы не настроены, у сводного блока нечего агрегировать.
Добавьте блок
- Откройте редактор темы Shopify.
- Откройте шаблон Product (или шаблон страницы, где вы хотите разместить сводку).
- Нажмите Add block рядом с верхней частью секции страницы, над тем местом, где будет блок FastComments.
- В разделе Apps выберите FastComments - Reviews Summary.
- Добавьте блок FastComments ниже на той же странице, если вы ещё этого не сделали, чтобы посетители могли оставлять отзывы.
- Нажмите Save.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Переопределяет, из какого FastComments tenant будет считываться сводка. Оставьте пустым, чтобы использовать автоматически настроенный tenant магазина. | (пусто) |
| Custom URL ID | Переопределяет идентификатор страницы, по которому выполняется агрегирование сводки. Используйте это, когда сводка находится на другой странице, чем блок FastComments, который она отображает. | (авто-определяется) |
Как сводка сопоставляется с отзывами
Блок Reviews Summary использует ту же логику автоопределения, что и блок FastComments:
- Шаблон товара:
shopify-product-{product.id} - Шаблон статьи блога:
shopify-article-{article.id} - Другие шаблоны: путь запроса
Для обычной страницы товара сводка и поток комментариев автоматически используют один и тот же URL ID, дополнительной настройки не требуется.
Советы
- Сводка доступна только для чтения. Чтобы собирать отзывы, на той же странице должен быть блок FastComments.
- Если вы измените вопросы рейтинга в Ratings & Reviews Helper после сбора отзывов, сводка будет пересчитана с учётом нового набора вопросов.
Автоматический вход клиентов Shopify
Блок FastComments поддерживает единый вход (SSO), чтобы ваши клиенты Shopify могли комментировать от своего имени без создания отдельной учетной записи FastComments.
Как это работает
Когда посетитель, вошедший в ваш магазин, открывает страницу с блоком FastComments:
- Блок обнаруживает объект Shopify
customer. - Он отправляет имя и электронную почту клиента в FastComments через подписанный запрос прокси-приложения.
- FastComments создаёт или сопоставляет пользователя с ключом
shopify-{customerId}, поэтому один и тот же клиент всегда соответствует одному и тому же пользователю FastComments между сессиями и при переустановках. - Имя посетителя отображается в его комментариях. Ему не предлагается повторно входить в систему.
Если посетитель не вошёл в магазин, блок переключается на анонимное комментирование (или на поток входа FastComments, в зависимости от конфигурации виджета).
Отключение SSO
SSO включён по умолчанию для каждого блока FastComments. Чтобы отключить его для конкретного блока:
- Откройте редактор темы Shopify.
- Откройте шаблон, содержащий блок, и щёлкните по блоку, чтобы выделить его.
- Снимите галочку с SSO.
- Нажмите Сохранить.
Отключайте SSO, если вы хотите, чтобы комментаторы могли выбирать отдельную личность для разговора. Например, внутренняя страница сообщества, где сотрудники комментируют под другим отображаемым именем.
Какие данные получает FastComments
SSO-пейлоад, отправляемый для каждого клиента, содержит:
- Идентификатор пользователя, получаемый из ID клиента 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. Нажмите Сохранить.
Шаг 4: Авторизуйте домен вашего магазина
Откройте запись блога на вашем живом магазине. Если вместо виджета комментариев вы видите ошибку авторизации, FastComments нужно знать, что вашему магазину разрешено использовать этот тенант. См. Ошибки домена.
Добавление FastComments на другие страницы
Тот же сниппет работает в любом шаблоне Liquid, включая страницы товаров, кастомные страницы и главную страницу. Вставьте его туда, где вы хотите, чтобы появлялись комментарии, и при необходимости отрегулируйте urlId, если вы хотите стабильный идентификатор для каждой страницы (например, urlId: "{{ product.id }}" в шаблоне товара).