Добавяне на коментари към 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 показва малък брой коментари за една страница. Използвайте го в списъци с блог публикации, продуктови карти или всеки шаблон, който води към страница с коментари, така че посетителите да видят колко активна е всяка тема, преди да кликнат.
Добавяне на блока
- Отворете редактора на Shopify темата.
- Отворете шаблона, в който искате броячът да се показва. Например шаблона Blog (списъкът с публикации) или секция със списък с продукти.
- Кликнете Add block в секцията, която изобразява всеки елемент.
- Под Apps изберете FastComments - Comment Count.
- Кликнете Save.
Настройки
| Настройка | Какво прави | По подразбиране |
|---|---|---|
| Tenant ID (по избор) | Презаписва от кой FastComments tenant се чете броячът. Оставете празно, за да се използва автоматично конфигурираният tenant на магазина. | (празно) |
| 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 tenant чете лентата. Оставете празно, за да се използва автоматично конфигурираният tenant на магазина. | (празно) |
| 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.
Настройки
| Настройка | Какво прави | По подразбиране |
|---|---|---|
| Tenant ID (по избор) | Презаписва от кой FastComments tenant чете списъкът. Оставете празно, за да се използва автоматично конфигурираният tenant на магазина. | (празно) |
Top Pages срещу 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 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 чрез подписана заявка към 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 акаунт: Конфигуриране на домейни.
Ръчна инсталация (Разширено)
Ако не можете да инсталирате приложението от Shopify App Store, все пак можете да добавите FastComments, като редактирате вашата тема. Този път е полезен, когато искате да свържете FastComments наемател (tenant), който вече притежавате, или когато вграждате в 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.
Опитайте демото за живи анкети или прочетете документацията за анкети, за да ги настроите.