Dodaj komentarze do witryn 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ę liczby komentarzy
Blok FastComments - Comment Count wyświetla mały licznik komentarzy dla pojedynczej strony. Używaj go na listach wpisów na blogu, kartach produktów ani w żadnym szablonie, który prowadzi do strony z komentarzami, aby odwiedzający mogli zobaczyć, jak aktywny jest każdy wątek, zanim klikną.
Dodanie bloku
- Otwórz edytor motywu Shopify.
- Otwórz szablon, w którym ma się pojawić licznik. Na przykład szablon Blog (lista wpisów) lub sekcja z listą produktów.
- Kliknij Add block w sekcji, która renderuje każdy element.
- W sekcji Apps wybierz FastComments - Comment Count.
- Kliknij Save.
Ustawienia
| Ustawienie | Co robi | Wartość domyślna |
|---|---|---|
| Tenant ID (opcjonalne) | Nadpisuje, z którego tenanta FastComments licznik pobiera dane. Pozostaw puste, aby użyć automatycznie skonfigurowanego tenanta sklepu. | (puste) |
| Custom URL ID | Nadpisuje identyfikator strony, którego szuka licznik. Użyj tego, gdy licznik znajduje się na innej stronie niż blok FastComments, który śledzi. | (wykrywane automatycznie) |
Jak licznik dopasowuje wątek komentarzy
Blok Comment Count używa tej samej logiki automatycznego wykrywania co blok FastComments:
- Szablon wpisu na blogu:
shopify-article-{article.id} - Szablon produktu:
shopify-product-{product.id} - Inne szablony: ścieżka żądania
Jeśli ustawiłeś 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.
Wskazówki
- 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ń.
- Jeden blok Comment Count na artykuł lub produkt na liście to oczekiwane użycie; blok można dodać tyle razy, ile potrzebujesz.
Dodaj kanał najnowszych komentarzy
The FastComments - Recent Comments block wyświetla najnowsze komentarze w całym całym sklepie. Użyj go, aby pokazać świeżą aktywność w pasku bocznym, stopce lub sekcji strony głównej.
Dodaj blok
- Otwórz edytor motywu Shopify.
- Otwórz szablon, w którym chcesz umieścić kanał. Sekcja paska bocznego, strona główna lub indeks bloga sprawdzą się dobrze.
- Kliknij Add block w sekcji, w której ma się znajdować.
- W sekcji **Apps wybierz FastComments - Recent Comments.
- Kliknij Save.
Settings
| Ustawienie | Co robi | Domyślne |
|---|---|---|
| Tenant ID (optional) | Zastąp, z którego najemcy FastComments kanał odczytuje komentarze. Pozostaw puste, aby używać najemcy automatycznie skonfigurowanego dla sklepu. | (blank) |
| Number of comments | Ile najnowszych komentarzy wyświetlić. Zakres od 1 do 50. | 5 |
Wskazówki
- Każdy komentarz linkuje do strony, na której został opublikowany, więc blok pełni również funkcję wskazówki nawigacyjnej „co ludzie teraz omawiają”.
- Kanał obejmuje cały sklep. Aby wyświetlić najnowsze komentarze dla jednej strony, użyj zamiast tego bloku FastComments na tej stronie.
Dodaj kanał najnowszych dyskusji
Blok FastComments - Recent Discussions wyświetla listę stron w Twoim sklepie z najnowszą aktywnością komentarzy, po jednym wpisie na stronę. Użyj go, gdy chcesz, aby odwiedzający odkrywali aktywne wątki, a nie pojedyncze komentarze.
Dodawanie bloku
- Otwórz edytor motywu Shopify.
- Otwórz szablon, w którym chcesz umieścić feed, np. pasek boczny, stopkę, indeks bloga lub sekcję strony głównej.
- Kliknij Add block w sekcji, która ma go zawierać.
- W sekcji Apps wybierz FastComments - Recent Discussions.
- Kliknij Save.
Ustawienia
| Ustawienie | Co robi | Domyślnie |
|---|---|---|
| Tenant ID (opcjonalnie) | Nadpisuje, z którego tenanta FastComments feed pobiera dane. Pozostaw puste, aby użyć automatycznie skonfigurowanego tenanta sklepu. | (puste) |
| Number of comments | Ile najnowszych dyskusji wyświetlić. Zakres od 1 do 50. | 20 |
Recent Discussions vs Recent Comments
Oba bloki korzystają z tych samych danych, ale pokazują różne widoki:
- Recent Comments: płaska lista najnowszych pojedynczych komentarzy. Najlepsza do "co właśnie powiedziano".
- Recent Discussions: jeden wpis na stronę, uporządkowany według najnowszej aktywności. Najlepsza do "które wątki są teraz aktywne".
Możesz używać obu w tym samym sklepie. Na przykład Recent Comments na pasku bocznym bloga, a Recent Discussions na stronie głównej.
Dodaj listę najpopularniejszych stron
Blok FastComments - Top Pages wyświetla listę stron w Twoim sklepie z największą ogólną aktywnością komentarzy. Użyj go, aby wyróżnić najczęściej komentowane posty lub produkty.
Dodanie bloku
- Otwórz edytor motywu Shopify.
- Otwórz szablon, w którym chcesz umieścić listę, np. w sekcji paska bocznego, stopki lub indeksu bloga.
- Kliknij Dodaj blok w sekcji, która ma go zawierać.
- W obszarze Aplikacje wybierz FastComments - Top Pages.
- Kliknij Zapisz.
Ustawienia
| Ustawienie | Co robi | Domyślnie |
|---|---|---|
| Tenant ID (opcjonalnie) | Zastępuje tenant FastComments, z którego lista pobiera dane. Pozostaw puste, aby użyć automatycznie skonfigurowanego tenanta sklepu. | (puste) |
Top Pages vs Recent Discussions
- Top Pages klasyfikuje według łącznego zaangażowania, więc te same posty mają tendencję do pozostawania blisko góry przez dłuższy czas. Dobre dla paska bocznego „popularne posty".
- Recent Discussions klasyfikuje według najnowszej aktywności, więc lista często się zmienia. Dobre dla panelu „co jest teraz na topie".
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 pod postami na blogu Shopify i chcesz je zachować, zaimportuj je do FastComments, zanim wyłączysz natywne komentowanie Shopify.
Import musi zostać uruchomiony, dopóki natywne komentarze Shopify są nadal aktywne i widoczne. Po ich wyłączeniu FastComments nie może ich już odczytać.
Jak rozpocząć import
- Upewnij się, że aplikacja FastComments jest zainstalowana w Twoim sklepie.
- Na razie pozostaw natywne komentowanie Shopify włączone.
- Otwórz zgłoszenie do pomocy technicznej i poinformuj nas, które blogi zaimportować.
Import trwa mniej niż jeden dzień.
Gdy Twoje istniejące komentarze znajdą się w FastComments, dodaj blok FastComments do szablonu postu na blogu i usuń lub wyłącz natywne komentarze Shopify. Zobacz Dodawanie komentarzy do postów na blogu i produktów.
Jeśli nie potrzebujesz zachować istniejących komentarzy, możesz pominąć tę stronę.
Dostosowanie
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
Jeśli zainstalowałeś FastComments ze Shopify App Store, domena Twojego sklepu jest automatycznie dodawana do autoryzowanych domen dzierżawy i nie powinieneś zobaczyć błędu domeny. Ta strona dotyczy sytuacji, gdy przeszedłeś ścieżkę ręcznej instalacji lub gdy Twój storefront jest serwowany na domenie niestandardowej, która nie była zarejestrowana w Shopify w momencie instalacji aplikacji.
Możesz otrzymać błąd autoryzacji wyglądający tak:
Oznacza to, że FastComments nie rozpoznaje domeny, na której ładowany jest widget, jako autoryzowanej dla Twojej dzierżawy.
Aby to naprawić, dodaj domenę do swojego konta FastComments: Configure Domains.
Instalacja ręczna (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).
Dodaj ankiety do swojego sklepu Shopify
Gdy FastComments jest już zainstalowany w Twoim sklepie Shopify, możesz także uruchamiać ankiety na żywo bezpośrednio w komentarzach. Włącz Enable Polls w ustawieniach personalizacji widgetu, a przycisk ankiety pojawi się na pasku narzędzi komentarzy. Ankiety mogą mieć od 2 do 10 opcji, wyniki aktualizują się na żywo dla wszystkich na stronie, a Ty decydujesz, kto może tworzyć ankiety i czy głosowanie wymaga logowania. Nie musisz instalować niczego dodatkowego w Shopify.
Try the Live Polls demo lub przeczytaj Polls documentation, aby je skonfigurować.