Добавяне на коментари в сайтове на Shopify
FastComments е наличен в Магазин за приложения на Shopify. Инсталирайте приложението и поставете FastComments блокове върху всяка публикация в блога, страница на продукт или персонализирана страница от редактора на тема на Shopify. Не е необходимо редактиране на код.
Когато инсталирате приложението, Shopify създава вашия FastComments акаунт, свързва домейна на магазина ви и автоматично настройва фактурирането. Не е необходимо да се регистрирате отделно на fastcomments.com.
Страниците в това ръководство обхващат всеки FastComments блок, който приложението предоставя, как работи единното влизане (single sign-on) за вашите клиенти в Shopify и как да импортирате съществуващите коментари от Shopify преди да преминете.
Инсталиране на приложението FastComments 
Инсталиране от Shopify App Store
- Отворете страницата на FastComments в Shopify App Store.
- Кликнете Add app и изберете плана, който искате по време на инсталацията.
- Shopify ще ви пренасочи обратно в административния панел на FastComments вътре в Shopify след завършване на инсталацията.
Това е цялата инсталация. Няма нищо за поставяне във файловете на вашата тема.
Какво се настройва за вас
Инсталацията изпълнява всичко, което иначе бихте направили ръчно:
- За вашия магазин се създава FastComments tenant и се свързва с домейна на магазина ви.
- URL адресът на вашия магазин се добавя в разрешените домейни на tenant-а, така че коментарите да се зареждат без грешка за домейн.
- Пише се shop metafield
fastcomments.tenant_id, така че всеки блок да знае за кой tenant да рендерира. - Single sign-on за вашите клиенти в Shopify е включен по подразбиране.
- Таксуването се управлява чрез Shopify Managed Pricing. Таксите се появяват във вашата обичайна сметка в Shopify. Надстройвайте, понижaвайте или анулирайте от 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 блокът е основният уиджет за коментари. Добавете го в шаблони за публикации в блога, шаблони за продукти или в която и да е друга страница, където искате дискусия или чат на живо.
Добавяне на блока
- Отворете редактора на тема на Shopify (Online Store > Themes > Customize).
- Изберете шаблона, върху който искате да има коментари: Blog post, Product, или който и да е друг шаблон за страница или секция.
- В секцията, където искате да се показват коментарите, кликнете Add block.
- Под Apps изберете FastComments.
- Кликнете Save.
Блокът се появява незабавно. Няма Tenant ID за въвеждане; tenant-ът на вашия магазин се свързва автоматично при инсталиране на приложението.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Презаписва срещу кой FastComments tenant да рендерира блокът. Оставете празно, за да използвате автоматично конфигурирания tenant на магазина. Намерете ръчен tenant ID на fastcomments.com/auth/my-account/api-secret. | (blank) |
| SSO | Автоматично логва посетителя като неговия Shopify customer акаунт преди да коментира. Вижте Auto-Login Shopify Customers. | On |
| Commenting Style | Threaded за вложени отговори и гласувания, или Streaming за реалновременен чат-поток. | Threaded |
| Custom URL ID | Презаписва автоматично открития идентификатор на страницата. Използвайте това, когато искате два URL-а да споделят един и същи низ за коментари. | (auto-detected) |
Как се избира идентификаторът на страницата
Всяка нишка от коментари е ключирана по URL ID. Блокът избира такъв автоматично:
- Blog post template:
shopify-article-{article.id}, който е стабилен при промяна на slug или заглавие. - Product template:
shopify-product-{product.id}, който е стабилен при промяна на slug или заглавие. - Други шаблони: пътят на заявката.
Ако зададете Custom URL ID, тази стойност се използва вместо това. Използвайте един и същ Custom URL ID в няколко блока (например на локализирана версия на продуктова страница), за да споделят една и съща нишка от коментари.
Threaded vs Streaming
Threaded е по подразбиране. Посетителите отговарят един на друг, гласуват и инструментите за модериране работят както се очаква. Подходящо за публикации в блога и продуктови ревюта.
Streaming премахва нишките и показва новите коментари в реално време, докато се публикуват, подобно на чат поток. Подходящо за пускане на продукт, живи събития и общностни страници.
Няколко блока на една и съща страница
Блокът може да бъде добавян повече от веднъж в един и същи шаблон. Например, обобщение на ревютата в горната част на продуктовата страница и FastComments блок в долната. Блоковете споделят URL ID, така че обобщението отразява коментарите по-долу.
Съвети
- Блокът се скрива в прегледа на редактора на тема с жълтo съобщение, ако не може да намери tenant. Ако това се появи в живия ви магазин, преинсталирайте приложението FastComments.
- За продуктова страница FastComments блокът служи и като вашия уиджет за ревюта на продукти. Комбинирайте го с FastComments - Reviews Summary за обобщение на оценките със звезди в горната част на страницата.
Добавяне на значка с брой коментари
Блокът FastComments - Comment Count показва малък брой коментари за една страница. Използвайте го в списъци с публикации в блога, в карти на продукти или във всеки шаблон, който връзва към страница с коментари, така че посетителите да могат да видят колко активна е всяка нишка преди да кликнат.
Add the block
- Отворете редактора на темата в Shopify.
- Отворете шаблона, където искате броячът да се показва. Например, шаблона Blog (списък с публикации) или секция за листинг на продукти.
- Кликнете Add block в секцията, която рендерира всеки елемент.
- Под Apps изберете FastComments - Comment Count.
- Кликнете Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Замества кой FastComments tenant да чете броячът. Оставете празно, за да използвате автоматично конфигурирания tenant на магазина. | (blank) |
| Custom URL ID | Замества идентификатора на страницата, който броячът търси. Използвайте това, когато броячът е на различна страница от блока FastComments, който следи. | (auto-detected) |
How the count matches the comment thread
Блокът Comment Count използва същата логика за автоматично откриване като блока FastComments:
- Шаблон за публикация в блога:
shopify-article-{article.id} - Шаблон за продукт:
shopify-product-{product.id} - Други шаблони: пътят на заявката
Ако зададете Custom URL ID на блока FastComments на дадена страница, задайте същия Custom URL ID и на блока Comment Count, така че те да сочат към същата нишка.
Tips
- Броят за всеки елемент на страницата се извлича с една заявка, така че добавянето на блока към всеки елемент в дълъг списък не води до допълнителни заявки.
- Очакваното използване е един блок Comment Count за статия или продукт в списък; блокът може да бъде добавян толкова пъти, колкото ви е необходимо.
Добавяне на емисия с последни коментари
Блокът FastComments - Recent Comments показва най-новите коментари в целия ви магазин. Използвайте го, за да показвате свежа активност в страничен панел, футър или секция на началната страница.
Add the block
- Отворете редактора на теми на Shopify.
- Отворете шаблона, в който искате да се появи емисията. Секция в страничен панел, началната страница или индексът на блога са подходящи.
- Кликнете Add block в секцията, която трябва да го съдържа.
- Под Apps, изберете FastComments - Recent Comments.
- Кликнете Save.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Задайте от кой FastComments tenant да се чете емисията. Оставете празно, за да използвате автоматично конфигурирания за магазина tenant. | (blank) |
| Number of comments | Колко последни коментара да се покажат. Диапазон от 1 до 50. | 5 |
Съвети
- Всеки коментар съдържа връзка към страницата, на която е публикуван, така че блокът служи и като подсказка за навигация „за какво хората говорят в момента“.
- Емисията е за целия магазин. За да покажете последните коментари само за една страница, използвайте блока FastComments на тази страница вместо това.
Добавяне на емисия с последни дискусии
Блокът FastComments - Recent Discussions изброява страниците във вашия магазин с най-нови активности по коментари, по един запис на страница. Използвайте го, когато искате посетителите да откриват активни теми, а не отделни коментари.
Добавяне на блока
- Отворете редактора на темата на Shopify.
- Отворете шаблона, където искате емисията, като странична лента, футър, индекс на блога или секция на началната страница.
- Кликнете Add block в секцията, която трябва да го съдържа.
- Под Apps изберете FastComments - Recent Discussions.
- Кликнете Save.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (по избор) | Презаписва от кой FastComments tenant емисията чете. Оставете празно, за да се използва автоматично конфигурираният tenant за магазина. | (празно) |
| Number of comments | Колко последни дискусии да се показват. От 1 до 50. | 20 |
Recent Discussions срещу Recent Comments
И двата блока извличат данни от един и същ източник, но показват различни изгледи:
- Recent Comments: плосък списък с най-новите отделни коментари. Най-подходящ за "какво току-що беше казано".
- Recent Discussions: по един запис на страница, подредени по най-скорошна активност. Най-подходящ за "кои теми са живи в момента".
Можете да използвате и двата на един и същ магазин. Например, Recent Comments в страничната лента на блога и Recent Discussions на началната страница.
Добавяне на списък с най-популярните страници
Блокът FastComments - Top Pages изброява страниците във вашия магазин с най-голяма активност по коментари като цяло. Използвайте го, за да покажете вашите най-обсъждани публикации или продукти.
Добавете блока
- Отворете редактора на теми на Shopify.
- Отворете шаблона, където искате да се появи списъкът, например странична лента, футър или секция за индекс на блога.
- Кликнете върху Add block в секцията, която трябва да го съдържа.
- Под Apps, изберете FastComments - Top Pages.
- Кликнете върху Save.
Настройки
| 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.
Добавяне на обобщение на отзивите
Блокът FastComments - Обобщение на ревюта показва агрегирана оценка със звезди и разбивка на ревютата за страница. Сдвоете го с FastComments блок в шаблоните за продукти за стандартното оформление на ревютата: обобщение отгоре, формуляр за ревюта и ревюта по-долу.
Предварително условие: настройте Оценки и ревюта
Блокът Обобщение на ревюта показва въпросите за оценяване, които сте конфигурирали за вашия магазин. Настройте ги първо:
- Отворете приложението FastComments във вашия Shopify администратор.
- Кликнете върху плочката Помощник за оценки и ревюта (или отворете Ratings & Reviews Helper директно).
- Добавете въпросите, на които искате всеки рецензент да отговори (обща оценка със звезди, "как е прилягането", и т.н.).
Без конфигурирани въпроси, блокът за обобщение няма какво да агрегира.
Добавяне на блока
- Отворете редактора на темата на Shopify.
- Отворете шаблона Продукт (или шаблона на страницата, където искате обобщението).
- Щракнете върху Добави блок близо до върха на секцията на страницата, над мястото, където ще бъде FastComments блок.
- Под Приложения, изберете FastComments - Обобщение на ревюта.
- Добавете FastComments блок по-надолу на същата страница, ако още не сте, за да могат посетителите да оставят ревюта.
- Щракнете върху Запази.
Настройки
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Override which FastComments tenant the summary reads from. Leave blank to use the store's automatically-configured tenant. | (празно) |
| 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. | (автоматично засечено) |
Как обобщението съответства на ревютата
Блокът Обобщение на ревюта използва същата логика за автоматично откриване като FastComments блок:
- Шаблон за продукти:
shopify-product-{product.id} - Шаблон за статия:
shopify-article-{article.id} - Други шаблони: пътят на заявката
За нормална продуктова страница, обобщението и нишката с коментари споделят URL ID автоматично, без нужда от конфигурация.
Съвети
- Обобщението е само за четене. За да събирате ревюта, ви трябва FastComments блок на същата страница.
- Ако промените въпросите за оценяване в Помощник за оценки и ревюта след събирането на ревюта, обобщението се пресмята спрямо новия набор от въпроси.
Автоматично влизане на клиенти в Shopify
Блокът FastComments поддържа единно влизане (SSO), така че вашите клиенти в Shopify могат да коментират като себе си, без да създават отделен акаунт в FastComments.
Как работи
Когато посетител, който е влязъл в магазина ви, отвори страница с блока FastComments:
- Блокът открива Shopify обекта
customer. - Изпраща името и имейла на клиента до FastComments чрез подписана заявка към app proxy.
- 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, домейнът на вашия магазин се добавя автоматично към упълномощените домейни на наемателя и не би трябвало да виждате грешка с домейна. Тази страница се прилага, ако сте минали по ръчния път на инсталиране, или ако витрината на вашия магазин се обслужва на персонализиран домейн, който не е бил регистриран в 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.
Стъпка 1: Деактивирайте вградените коментари на Shopify
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.
Стъпка 2: Отворете шаблона на блога в темата
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.
Стъпка 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.
Стъпка 4: Авторизирайте домейна на магазина си
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.
Добавяне на FastComments към други страници
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).