Добавить комментарии на сайты Shopify

Установка из Shopify App Store

1. Откройте страницу FastComments в Shopify App Store.
2. Нажмите Add app и выберите план, который хотите в процессе установки.
3. После завершения установки Shopify перенаправит вас обратно в административную панель FastComments внутри Shopify.

На этом установка завершена. Ничего не нужно вставлять в файлы темы.

Что настраивается для вас

Установка выполняет всё, что вы в противном случае делали бы вручную:

• Для вашего магазина создаётся tenant FastComments и связывается с доменом магазина.
• URL вашего магазина добавляется в список разрешённых доменов tenant'а, чтобы комментарии загружались без ошибки домена.
• Записывается shop metafield fastcomments.tenant_id, чтобы каждый блок знал, какой tenant использовать для рендеринга.
• Единый вход (SSO) для клиентов Shopify включён по умолчанию.
• Оплата проходит через Shopify Managed Pricing. Списания отображаются в вашем обычном счёте Shopify. Обновить тариф, понизить или отменить можно в Settings > Apps and sales channels > FastComments в админке Shopify.

Если ваш магазин уже был клиентом FastComments до установки приложения, установка повторно использует существующий tenant вместо создания нового.

Встроенная админ-панель

Когда вы открываете приложение FastComments из админки Shopify, вы попадаете на дашборд с плитками—одним кликом переходящими в полнофункциональную бэкенд-панель FastComments:

• Dashboard: настройки аккаунта, использование и сведения о подписке.
• Moderation Queue: одобрять, отклонять и отвечать на комментарии по всему магазину.
• Customize: настраивать цвета виджета, шрифты, правила модерации и конфигурацию.
• Ratings & Reviews Helper: настроить рейтинги в виде звёзд и вопросы отзывов, если вы хотите использовать блок Reviews Summary.

Каждая плитка открывает FastComments по одноразовой ссылке для входа, поэтому вам не нужен отдельный логин.

Далее: добавьте блоки в ваш магазин

Откройте редактор темы Shopify (Online Store > Themes > Customize), откройте шаблон, в который вы хотите добавить комментарии или отзывы, и нажмите Add block. Блоки FastComments появятся в разделе Apps. Остальная часть этого руководства рассматривает каждый из них.

The FastComments block is the main commenting widget. Add it to blog post templates, product templates, or any other page where you want a discussion thread or a live chat.

Add the block

1. Open the Shopify theme editor (Online Store > Themes > Customize).
2. Pick the template you want comments on: Blog post, Product, or any other page or section template.
3. In the section where you want comments to appear, click Add block.
4. Under Apps, select FastComments.
5. Click Save.

The block appears immediately. There is no Tenant ID to enter; your store's tenant is wired up automatically when you install the app.

Settings

How the page identifier is chosen

Each comment thread is keyed by a URL ID. The block picks one automatically:

• Blog post template: shopify-article-{article.id}, which is stable across slug and title changes.
• Product template: shopify-product-{product.id}, which is stable across slug and title changes.
• Other templates: the request path.

If you set Custom URL ID, that value is used instead. Use the same Custom URL ID across multiple blocks (for example, on a localized variant of a product page) to share one comment thread.

Threaded vs Streaming

Threaded is the default. Visitors reply to each other, vote, and moderation tools work as expected. Best for blog posts and product reviews.

Streaming drops the threading and shows new comments in real time as they're posted, like a chat feed. Best for product launches, live events, and community pages.

Multiple blocks on the same page

The block can be added more than once to the same template. For example, a Reviews Summary at the top of a product page and a FastComments block at the bottom. The blocks share a URL ID, so the summary reflects the comments below.

Tips

• The block hides itself in the theme editor preview with a yellow notice if it can't find a tenant. If that appears in your live store, reinstall the FastComments app.
• For a product page, the FastComments block doubles as your product reviews widget. Pair it with FastComments - Reviews Summary for a star-rating summary at the top of the page.

The FastComments - Счётчик комментариев блок отображает небольшой счётчик комментариев для отдельной страницы. Используйте его в списках публикаций блога, карточках товаров или в любом шаблоне, который ссылается на страницу с комментариями, чтобы посетители могли увидеть, насколько активна каждая тема, прежде чем переходить по ссылке.

Добавление блока

1. Откройте редактор тем Shopify.
2. Откройте шаблон, в котором вы хотите, чтобы отображался счётчик. Например, шаблон Блог (список публикаций) или секция с перечнем товаров.
3. Нажмите Добавить блок в секции, которая рендерит каждый элемент.
4. В разделе Приложения выберите FastComments - Счётчик комментариев.
5. Нажмите Сохранить.

Параметры

Как счётчик сопоставляет ветку комментариев

Блок Счётчик комментариев использует ту же логику автодетекции, что и блок FastComments:

• 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 в блоке Счётчика комментариев, чтобы они указывали на одну и ту же ветку.

Советы

• Значения счётчиков для всех элементов на странице запрашиваются одним запросом, поэтому добавление блока к каждому элементу в длинном списке не создаёт дополнительных сетевых обращений.
• Один блок Счётчик комментариев на статью или товар в списке — ожидаемый сценарий использования; блок можно добавить столько раз, сколько необходимо.

Блок FastComments - Recent Comments показывает самые свежие комментарии по всему вашему магазину. Используйте его, чтобы показать свежую активность в сайдбаре, футере или разделе на главной странице.

Add the block

1. Откройте редактор тем Shopify.
2. Откройте шаблон, в котором вы хотите разместить ленту. Раздел в сайдбаре, главная страница или индекс блога — все это подходит.
3. Нажмите Add block в разделе, который должен его содержать.
4. В разделе Apps выберите FastComments - Recent Comments.
5. Нажмите Save.

Settings

Tips

• Каждый комментарий содержит ссылку на страницу, на которой он был опубликован, поэтому блок также служит подсказкой навигации «о чем люди сейчас говорят».
• Лента охватывает весь магазин. Чтобы показать последние комментарии только для одной страницы, вместо этого используйте блок FastComments на этой странице.

Блок FastComments - Recent Discussions перечисляет страницы в вашем магазине с самой свежей активностью комментариев, по одной записи на страницу. Используйте его, когда хотите, чтобы посетители находили активные обсуждения, а не отдельные комментарии.

Добавить блок

1. Откройте редактор темы Shopify.
2. Откройте шаблон, где вы хотите разместить ленту, например боковую панель, нижний колонтитул, индекс блога или секцию главной страницы.
3. Нажмите Add block в секции, которая должна его содержать.
4. В разделе Apps выберите FastComments - Recent Discussions.
5. Нажмите Save.

Настройки

Recent Discussions vs Recent Comments

Оба блока берут данные из одного источника, но показывают разные представления:

• Recent Comments: плоский список последних отдельных комментариев. Лучше подходит для «что было сказано только что».
• Recent Discussions: по одной записи на страницу, отсортировано по последней активности. Лучше подходит для «какие темы сейчас живы».

Вы можете использовать оба на одном магазине. Например, Recent Comments в боковой панели блога и Recent Discussions на главной странице.

Блок FastComments - Top Pages отображает страницы вашего магазина с наибольшей общей активностью комментариев. Используйте его, чтобы выделить ваши самые обсуждаемые записи или товары.

Добавить блок

1. Откройте редактор темы Shopify.
2. Откройте шаблон, в котором вы хотите разместить список, например боковая панель, футер или секцию индекса блога.
3. Нажмите Добавить блок в секции, которая должна его содержать.
4. В разделе Приложения выберите FastComments - Top Pages.
5. Нажмите Сохранить.

Настройки

Top Pages vs Recent Discussions

• Top Pages ранжирует по общему вовлечению, поэтому одни и те же записи обычно остаются вверху некоторое время. Подходит для боковой панели «популярные записи».
• Recent Discussions ранжирует по самой недавней активности, поэтому список часто обновляется. Подходит для панели «что сейчас в тренде».

The FastComments block поддерживает единый вход (SSO), поэтому ваши покупатели Shopify могут комментировать от своего имени без создания отдельной учетной записи FastComments.

Как это работает

Когда посетитель, вошедший в ваш магазин, открывает страницу с блоком FastComments:

1. Блок обнаруживает объект Shopify customer.
2. Он отправляет имя и адрес электронной почты клиента в FastComments через подписанный запрос прокси-приложения.
3. FastComments создаёт или сопоставляет пользователя с ключом shopify-{customerId}, поэтому один и тот же покупатель всегда сопоставляется с тем же пользователем FastComments между сессиями и при повторной установке.
4. Имя посетителя отображается в их комментариях. Им не предлагается входить в систему снова.

Если посетитель не вошёл в магазин, блок переходит к анонимному комментированию (или к процедуре входа FastComments, в зависимости от конфигурации виджета).

Отключение SSO

SSO включён по умолчанию для каждого блока FastComments. Чтобы отключить его для конкретного блока:

1. Откройте редактор темы Shopify.
2. Откройте шаблон, который содержит блок, и щёлкните по блоку, чтобы выбрать его.
3. Снимите флажок SSO.
4. Нажмите Сохранить.

Отключите SSO, если вы хотите, чтобы комментаторы могли выбрать отдельную личность для обсуждения. Например, внутренняя страница сообщества, где сотрудники комментируют под другим отображаемым именем.

Что получает FastComments

Отправляемый для каждого клиента SSO-пэйлоад содержит:

• Идентификатор пользователя, полученный из ID клиента Shopify (shopify-{customerId}).
• Электронную почту клиента (используется для идентификации пользователя; не отображается публично).
• Отображаемое имя клиента (используется как имя автора комментария).

Не отправляются данные о заказах, оплате или адресах. Пэйлоад подписывается на стороне сервера; браузер клиента никогда не видит учётных данных.

Ссылки входа и выхода

Когда SSO включён, ссылки виджета комментариев для входа и выхода указывают на /account/login и /account/logout — стандартные маршруты аккаунта клиента Shopify. Ничего дополнительно настраивать не нужно. Ссылки работают для любого магазина с включёнными учетными записями клиентов.

Цвета, шрифты, правила модерации, разрешённый HTML и анонимное комментирование — всё это можно настроить в соответствии с фирменным стилем вашего магазина.

Откройте приложение FastComments в админке Shopify и нажмите плитку Customize, чтобы открыть экран настройки виджета. Для входа используется одноразовая ссылка, поэтому отдельная авторизация не требуется.

Для полного списка опций настройки см. Руководство по настройке и конфигурации.