Dodaj komentarze do stron Shopify
FastComments jest dostępny w Sklepie z aplikacjami Shopify. Zainstaluj aplikację i przeciągnij bloki FastComments na dowolny wpis na blogu, stronę produktu lub stronę niestandardową z edytora motywów Shopify. Nie jest wymagana edycja kodu.
Po zainstalowaniu aplikacji Shopify skonfiguruje Twoje konto FastComments, podłączy domenę sklepu i automatycznie uruchomi rozliczenia. Nie musisz rejestrować się oddzielnie na fastcomments.com.
Strony w tym przewodniku opisują każdy blok FastComments udostępniany przez aplikację, sposób działania jednokrotnego logowania (single sign-on) dla klientów Shopify oraz jak zaimportować istniejące komentarze Shopify przed przełączeniem.
Zainstaluj aplikację FastComments 
Zainstaluj ze Sklepu z aplikacjami Shopify
- Otwórz wpis FastComments w sklepie z aplikacjami Shopify.
- Kliknij Add app i wybierz plan podczas procesu instalacji.
- Po zakończeniu instalacji Shopify przekieruje Cię z powrotem do panelu administracyjnego FastComments wewnątrz Shopify.
To cała instalacja. Nie musisz niczego wklejać do plików motywu.
Co zostanie dla Ciebie skonfigurowane
Proces instalacji wykonuje wszystko, co normalnie trzeba by zrobić ręcznie:
- Dla Twojego sklepu zostaje utworzony tenant FastComments i powiązany z domeną sklepu.
- URL sklepu zostaje dodany do autoryzowanych domen tenant-a, dzięki czemu komentarze ładują się bez błędu domeny.
- Zostaje zapisane pole metafield sklepu
fastcomments.tenant_id, dzięki czemu każdy blok wie, który tenant ma renderować. - Single sign-on dla klientów Shopify jest domyślnie włączony.
- Rozliczenia odbywają się przez Shopify Managed Pricing. Opłaty pojawiają się na Twoim standardowym rachunku Shopify. Możesz ulepszać, obniżać lub anulować subskrypcję w Ustawienia > Aplikacje i kanały sprzedaży > FastComments w panelu administracyjnym Shopify.
Jeżeli Twój sklep był już wcześniej klientem FastComments przed instalacją aplikacji, instalator użyje istniejącego tenant-a zamiast tworzyć nowego.
Zintegrowany panel administracyjny
Po otwarciu aplikacji FastComments z panelu administracyjnego Shopify trafisz na pulpit z kafelkami, które jednym kliknięciem przenoszą do pełnego zaplecza FastComments:
- Dashboard: ustawienia konta, statystyki użycia i szczegóły subskrypcji.
- Moderation Queue: zatwierdzanie, odrzucanie i odpowiadanie na komentarze w całym sklepie.
- Customize: dostosowywanie kolorów widgetu, czcionek, reguł moderacji i konfiguracji.
- Ratings & Reviews Helper: konfiguracja ocen gwiazdkowych i pytań recenzji, jeśli chcesz użyć bloku Reviews Summary.
Każdy kafelek otwiera FastComments za pomocą jednorazowego linku logowania, więc nie potrzebujesz oddzielnego logowania.
Następny krok: dodaj bloki do swojego sklepu
Otwórz edytor motywu Shopify (Online Store > Themes > Customize), otwórz szablon, do którego chcesz dodać komentarze lub recenzje, i kliknij Add block. Bloki FastComments pojawią się pod Apps. Reszta tego przewodnika opisuje każdy z nich.
Dodaj komentarze do wpisów na blogu i produktów
Blok FastComments jest głównym widżetem komentowania. Dodaj go do szablonów postów na blogu, szablonów produktów lub dowolnej innej strony, na której chcesz wątek dyskusji lub czat na żywo.
Dodaj blok
- Otwórz edytor motywu Shopify (Online Store > Themes > Customize).
- Wybierz szablon, na którym chcesz mieć komentarze: Blog post, Product lub dowolny inny szablon strony lub sekcji.
- W sekcji, w której chcesz, aby pojawiły się komentarze, kliknij Add block.
- W sekcji Apps wybierz FastComments.
- Kliknij Save.
Blok pojawia się natychmiast. Nie trzeba wpisywać Tenant ID; tenant Twojego sklepu zostanie skonfigurowany automatycznie po zainstalowaniu aplikacji.
Ustawienia
| Setting | Co robi | Domyślnie |
|---|---|---|
| Tenant ID (optional) | Nadpisuje tenant FastComments, względem którego blok jest renderowany. Pozostaw puste, aby użyć tenanta skonfigurowanego automatycznie dla sklepu. Znajdź ręczny tenant ID na fastcomments.com/auth/my-account/api-secret. | (puste) |
| SSO | Automatycznie loguje odwiedzającego jako jego konto klienta Shopify przed komentowaniem. Zobacz Automatyczne logowanie klientów Shopify. | Włączone |
| Commenting Style | Wybierz Threaded dla zagnieżdżonych odpowiedzi i głosów, lub Streaming dla strumienia czatu w czasie rzeczywistym. | Threaded |
| Custom URL ID | Nadpisuje automatycznie wykryty identyfikator strony. Użyj tego, gdy chcesz, aby dwa adresy URL współdzieliły jeden wątek komentarzy. | (wykrywane automatycznie) |
Jak wybierany jest identyfikator strony
Każdy wątek komentarzy jest kluczowany przez identyfikator URL. Blok wybiera go automatycznie:
- Blog post template:
shopify-article-{article.id}, który jest stabilny przy zmianach slug i tytułu. - Product template:
shopify-product-{product.id}, który jest stabilny przy zmianach slug i tytułu. - Other templates: ścieżka żądania.
Jeśli ustawisz Custom URL ID, używana będzie zamiast tego ta wartość. Użyj tego samego Custom URL ID w kilku blokach (na przykład w zlokalizowanej wersji strony produktu), aby współdzielić jeden wątek komentarzy.
Threaded vs Streaming
Threaded jest domyślne. Odwiedzający odpowiadają sobie nawzajem, głosują, a narzędzia do moderacji działają jak oczekiwano. Najlepsze do postów na blogu i recenzji produktów.
Streaming usuwa zagnieżdżanie i pokazuje nowe komentarze w czasie rzeczywistym w momencie ich dodania, jak strumień czatu. Najlepsze do premier produktów, wydarzeń na żywo i stron społecznościowych.
Kilka bloków na tej samej stronie
Blok można dodać więcej niż raz do tego samego szablonu. Na przykład podsumowanie recenzji na górze strony produktu i blok FastComments na dole. Bloki współdzielą identyfikator URL, dzięki czemu podsumowanie odzwierciedla komentarze poniżej.
Wskazówki
- Blok ukrywa się w podglądzie edytora motywu z żółtym powiadomieniem, jeśli nie może znaleźć tenant. Jeśli pojawi się to w Twoim działającym sklepie, ponownie zainstaluj aplikację FastComments.
- Na stronie produktu blok FastComments pełni jednocześnie rolę widżetu recenzji produktu. Połącz go z FastComments - Reviews Summary, aby uzyskać podsumowanie ocen gwiazdkowych na górze strony.
Dodaj odznakę z liczbą komentarzy
Blok FastComments - Comment Count wyświetla mały licznik komentarzy dla pojedynczej strony. Użyj go na listach wpisów na blogu, kartach produktów lub w dowolnym szablonie, który prowadzi do strony z komentarzami, aby odwiedzający mogli zobaczyć, jak aktywny jest każdy wątek, zanim w niego klikną.
Add the block
- Otwórz edytor motywu Shopify.
- Otwórz szablon, w którym chcesz, aby licznik się pojawił. Na przykład szablon Blog (lista postów) lub sekcja listy produktów.
- Kliknij Add block w sekcji, która renderuje każdy element.
- W sekcji Apps wybierz FastComments - Comment Count.
- Kliknij Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Nadpisuje tenant FastComments, z którego pobierany jest licznik. Pozostaw puste, aby użyć tenant skonfigurowanego automatycznie dla sklepu. | (puste) |
| Custom URL ID | Nadpisuje identyfikator strony, którego używa licznik. Użyj tego, gdy licznik znajduje się na innej stronie niż blok FastComments, który śledzi. | (wykrywane automatycznie) |
How the count matches the comment thread
Blok Comment Count używa tej samej logiki automatycznego wykrywania co blok FastComments:
- Blog post template:
shopify-article-{article.id} - Product template:
shopify-product-{product.id} - Other templates: the request path
Jeśli ustawisz Custom URL ID w bloku FastComments na stronie, ustaw ten sam Custom URL ID w bloku Comment Count, aby wskazywały ten sam wątek.
Tips
- Liczniki dla wszystkich elementów na stronie są pobierane w jednym żądaniu, więc dodanie bloku do każdego elementu w długiej liście nie generuje dodatkowych zapytań.
- Zalecane użycie to jeden blok Comment Count na artykuł lub produkt w zestawieniu; blok można dodać tyle razy, ile potrzebujesz.
Dodaj kanał najnowszych komentarzy
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.
Add the block
- Open the Shopify theme editor.
- Open the template where you want the feed. A sidebar section, the home page, or the blog index all work well.
- Click Add block in the section that should hold it.
- Under Apps, select FastComments - Recent Comments.
- Click Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Override which FastComments tenant the feed reads from. Leave blank to use the store's automatically-configured tenant. | (blank) |
| Number of comments | How many recent comments to show. Range 1 to 50. | 5 |
Tips
- Each comment links to the page it was posted on, so the block doubles as a "what people are talking about right now" navigation hint.
- The feed is store-wide. To show recent comments for a single page, use the FastComments block on that page instead.
Dodaj kanał najnowszych dyskusji
The FastComments - Recent Discussions block wyświetla strony w Twoim sklepie z najnowszą aktywnością komentarzy, po jednym wpisie na stronę. Użyj go, gdy chcesz, by odwiedzający odkrywali aktywne wątki zamiast pojedynczych komentarzy.
Dodaj blok
- Otwórz edytor motywu Shopify.
- Otwórz szablon, w którym chcesz umieścić kanał, np. pasek boczny, stopkę, indeks bloga lub sekcję strony głównej.
- Kliknij Dodaj blok w sekcji, która ma go zawierać.
- W sekcji Aplikacje wybierz FastComments - Recent Discussions.
- Kliknij Zapisz.
Ustawienia
| Ustawienie | Co robi | Domyślne |
|---|---|---|
| Tenant ID (optional) | Nadpisuje tenant FastComments, z którego pobierany jest kanał. Pozostaw puste, aby użyć tenant skonfigurowanego automatycznie dla sklepu. | (puste) |
| Number of comments | Ile najnowszych dyskusji ma być wyświetlonych. Zakres od 1 do 50. | 20 |
Recent Discussions vs Recent Comments
Both blocks pobierają dane z tego samego źródła, ale pokazują różne widoki:
- Recent Comments: płaska lista najnowszych pojedynczych komentarzy. Najlepsze do „co właśnie zostało powiedziane”.
- Recent Discussions: jeden wpis na stronę, posortowany według najnowszej aktywności. Najlepsze do „które wątki są teraz żywe”.
Możesz używać obu na tym samym sklepie. Na przykład, Recent Comments w pasku bocznym bloga i Recent Discussions na stronie głównej.
Dodaj listę najpopularniejszych stron
The FastComments - Najpopularniejsze strony 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 - Najpopularniejsze strony.
- 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. | (puste) |
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.
Dodaj podsumowanie recenzji
Blok FastComments - Reviews Summary pokazuje zebrane oceny w gwiazdkach i rozkład recenzji dla strony. Połącz go z blokiem FastComments na szablonach produktów, aby uzyskać standardowy układ recenzji: podsumowanie u góry, formularz recenzji i recenzje poniżej.
Wymóg wstępny: skonfiguruj Ratings & Reviews
Blok Reviews Summary wyświetla pytania ocen, które skonfigurowałeś dla swojego sklepu. Najpierw je ustaw:
- Otwórz aplikację FastComments w panelu administracyjnym Shopify.
- Kliknij kafelek Ratings & Reviews Helper (lub otwórz bezpośrednio Ratings & Reviews Helper).
- Dodaj pytania, na które chcesz, aby odpowiadał każdy recenzent (ogólna ocena w gwiazdkach, "jak pasuje", itp.).
Bez skonfigurowanych pytań blok podsumowania nie ma czego agregować.
Dodaj blok
- Otwórz edytor motywu Shopify.
- Otwórz szablon Product (lub szablon strony, na którym chcesz mieć podsumowanie).
- Kliknij Add block w górnej części sekcji strony, nad miejscem, gdzie będzie blok FastComments.
- W sekcji Apps wybierz FastComments - Reviews Summary.
- Dodaj blok FastComments niżej na tej samej stronie, jeśli jeszcze go nie masz, aby odwiedzający mogli zostawiać recenzje.
- Kliknij Save.
Ustawienia
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Nadpisuje, z którego tenanta FastComments ma odczytywać podsumowanie. Pozostaw puste, aby użyć automatycznie skonfigurowanego tenant dla sklepu. | (blank) |
| Custom URL ID | Nadpisuje identyfikator strony, według którego agregowane jest podsumowanie. Użyj tego, gdy podsumowanie znajduje się na innej stronie niż blok FastComments, który odzwierciedla. | (auto-detected) |
Jak podsumowanie pasuje do recenzji
Blok Reviews Summary używa tej samej logiki automatycznego wykrywania co blok FastComments:
- Product template:
shopify-product-{product.id} - Blog post template:
shopify-article-{article.id} - Other templates: the request path
Dla normalnej strony produktu podsumowanie i wątek komentarzy automatycznie dzielą ten sam URL ID, bez potrzeby dodatkowej konfiguracji.
Wskazówki
- Podsumowanie jest tylko do odczytu. Aby zbierać recenzje, potrzebujesz bloku FastComments na tej samej stronie.
- Jeśli zmienisz pytania ocen w Ratings & Reviews Helper po zebraniu recenzji, podsumowanie przeliczy się względem nowego zestawu pytań.
Automatyczne logowanie klientów Shopify
The FastComments block obsługuje logowanie jednokrotne (SSO), dzięki czemu Twoi klienci Shopify mogą komentować jako oni sami bez tworzenia oddzielnego konta FastComments.
Jak to działa
Gdy odwiedzający, który jest zalogowany w Twoim sklepie, otworzy stronę z blokiem FastComments:
- Blok wykrywa obiekt Shopify
customer. - Wysyła imię i adres e-mail klienta do FastComments przez podpisane żądanie proxy aplikacji.
- FastComments tworzy lub dopasowuje użytkownika o kluczu
shopify-{customerId}, dzięki czemu ten sam klient zawsze odwzorowuje się na tego samego użytkownika FastComments pomiędzy sesjami i reinstalacjami. - Imię odwiedzającego pojawia się przy jego komentarzach. Nie jest proszony o ponowne zalogowanie.
Jeśli odwiedzający nie jest zalogowany w sklepie, blok przechodzi do anonimowego komentowania (lub do procesu logowania FastComments, w zależności od konfiguracji widżetu).
Wyłączanie SSO
SSO jest domyślnie włączone dla każdego bloku FastComments. Aby wyłączyć je dla konkretnego bloku:
- Otwórz edytor motywu Shopify.
- Otwórz szablon zawierający blok i kliknij blok, aby go wybrać.
- Odznacz SSO.
- Kliknij Zapisz.
Wyłącz SSO, jeśli chcesz, aby komentujący wybierali oddzielną tożsamość w obrębie dyskusji. Na przykład na wewnętrznej stronie społeczności, gdzie pracownicy komentują pod inną nazwą wyświetlaną.
Co otrzymuje FastComments
Ładunek SSO wysyłany dla każdego klienta zawiera:
- ID użytkownika pochodzące z ID klienta Shopify (
shopify-{customerId}). - Adres e-mail klienta (używany do identyfikacji użytkownika; nie jest wyświetlany publicznie).
- Nazwa wyświetlana klienta (używana jako nazwa autora komentarza).
Nie są wysyłane dane historii zamówień, płatności ani adresu. Ładunek jest podpisywany po stronie serwera; przeglądarka klienta nigdy nie widzi poświadczenia.
Linki logowania i wylogowania
Po włączeniu SSO linki do logowania i wylogowania widżetu komentarzy kierują na /account/login i /account/logout, standardowe ścieżki kont klientów Shopify. Nie ma nic do skonfigurowania. Linki działają w każdym sklepie z włączonymi kontami klientów.
Importuj istniejące komentarze
Jeśli masz już komentarze na wpisach swojego bloga na Shopify i chcesz je zachować, zaimportuj je do FastComments zanim wyłączysz natywne komentarze Shopify.
Import musi zostać wykonany, gdy natywne komentarze Shopify są nadal aktywne i widoczne. Po ich wyłączeniu FastComments nie będzie już w stanie ich odczytać.
How to start an import
- Upewnij się, że aplikacja FastComments jest zainstalowana w Twoim sklepie.
- Na razie pozostaw natywne komentarze Shopify włączone.
- Open a support ticket i przekaż nam, które blogi zaimportować.
Import zajmuje mniej niż dzień.
Gdy Twoje istniejące komentarze znajdą się w FastComments, dodaj blok FastComments do szablonu wpisu na blogu i usuń lub wyłącz natywne komentarze Shopify. Zobacz Add Comments to Blog Posts and Products.
Jeśli nie musisz zachowywać istniejących komentarzy, możesz pominąć tę stronę.
Dostosowywanie
Kolory, czcionki, zasady moderacji, dozwolony HTML i anonimowe komentowanie można konfigurować, aby pasowały do identyfikacji wizualnej Twojego sklepu.
Otwórz aplikację FastComments w panelu administracyjnym Shopify i kliknij kafelek Dostosuj, aby otworzyć ekran dostosowywania widżetu. Korzysta on z jednorazowego linku logowania, więc nie potrzebujesz oddzielnego logowania.
Aby zobaczyć pełną listę opcji dostosowywania, zobacz Przewodnik dotyczący dostosowań i konfiguracji.
Błędy domeny
If you installed FastComments from the Shopify App Store, your shop domain is added to the tenant's authorized domains automatically and you should not see a domain error. This page applies if you went through the manual install path, or if your storefront is served on a custom domain that wasn't registered with Shopify at the time the app installed.
You may get an authorization error that looks like this:
This means FastComments doesn't recognize the domain the widget is loading on as authorized for your tenant.
To fix it, add the domain to your FastComments account: Skonfiguruj domeny.
Ręczna instalacja (zaawansowana)
Jeśli nie możesz zainstalować aplikacji Shopify App Store, nadal możesz dodać FastComments, edytując swój motyw. Ta ścieżka jest przydatna, gdy chcesz podłączyć tenant FastComments, który już posiadasz, lub gdy osadzasz komentarze na sklepie Shopify, gdzie aplikacja nie jest dostępna.
Instalacja przez aplikację to obsługiwana ścieżka dla większości sklepów. Skorzystaj z niej tylko, jeśli aplikacja nie pasuje do Twojego przypadku.
Krok 1: Wyłącz natywne komentarze Shopify
W panelu administracyjnym Shopify przejdź do Blog posts > Manage blogs, otwórz każdy blog i ustaw Comments are disabled w panelu po prawej stronie. Zapisz.
To zapobiega wyświetlaniu się wbudowanego systemu komentarzy Shopify obok FastComments.
Krok 2: Otwórz szablon artykułu blogowego
W panelu administracyjnym Shopify:
- Przejdź do Online Store > Themes.
- Pod swoim aktualnym motywem kliknij Actions > Edit code.
- W przeglądarce plików po lewej otwórz Sections i kliknij
main-article.liquid.
To jest szablon, który Shopify renderuje dla pojedynczego artykułu blogowego.
Krok 3: Wklej snippet FastComments
Przewiń mniej więcej do linii 100 pliku main-article.liquid, tuż po zamykającym </div> treści artykułu. Wklej następujący snippet:
Zamień "demo" na własny Tenant ID z fastcomments.com/auth/my-account/api-secret. Kliknij Zapisz.
Krok 4: Autoryzuj domenę sklepu
Otwórz wpis na blogu na swoim sklepie na żywo. Jeśli zamiast widżetu komentarzy zobaczysz błąd autoryzacji, FastComments musi wiedzieć, że Twój sklep może korzystać z tego tenantu. Zobacz Błędy domeny.
Dodawanie FastComments do innych stron
Ten sam snippet działa w dowolnym szablonie Liquid, w tym na stronach produktu, stronach niestandardowych i na stronie głównej. Wklej go tam, gdzie chcesz, aby pojawiały się komentarze i dostosuj urlId, jeśli chcesz mieć stabilny identyfikator dla każdej strony (na przykład, urlId: "{{ product.id }}" w szablonie produktu).