Dostosowania i konfiguracja

Możesz zauważyć, że widżet komentarzy można użyć z Tenant ID ustawionym na "demo", na przykład:

Przykładowy Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

To służy tylko do wypróbowania i zabawy z widżetem komentarzy. W środowisku produkcyjnym należy przekazać swój Tenant ID, w ten sposób:

Określanie Twojego Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

Twój Tenant ID jest już zastosowany w widżecie komentarzy fragmencie kodu w Twoim koncie.

Swój Tenant ID możesz też znaleźć i zarządzać kluczami API na stronie poświadczeń API.

Od tego momentu, jeśli jesteś zalogowany w FastComments, przykłady kodu będą używać Twojego rzeczywistego Tenant ID (jeśli jesteś zalogowany na https://fastcomments.com).

Podczas renderowania wątku komentarzy lub pozostawiania komentarza, FastComments musi wiedzieć, do której strony, artykułu lub produktu te komentarze należą.

Aby to zrobić, używamy czegoś, co nazywamy „URL ID”. Jest to identyfikator, taki jak ciąg znaków lub liczba, lub adres URL.

Domyślnie, jeśli nie określisz urlId, zostanie użyty adres URL strony. Weźmiemy bieżący adres URL strony i oczyścimy go, usuwając wszelkie typowe parametry marketingowe lub identyfikatory śledzenia.

W przypadku integracji zewnętrznych, takich jak WordPress, nasza wtyczka zazwyczaj użyje identyfikatora, który reprezentuje aktualnie wyświetlaną treść jako URL ID, na przykład identyfikatora artykułu/strony.

Definiowanie własnego URL ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

Jedną rzeczą, do której często odwołujemy się w tym dokumencie, jest interfejs UI dostosowywania widgetu.

Ten interfejs UI może być używany do wprowadzania wielu zmian w widgetcie komentarzy bez użycia kodu.

Tworząc regułę dostosowywania, często chcemy, aby obowiązywała na wszystkich stronach naszej witryny. Jednak w niektórych przypadkach chcemy dostosować widget komentarzy na konkretnej stronie, aby zastosować niestandardowy styl lub ewentualnie uczynić komentarze na tej stronie anonimowymi. Można również, na przykład, ustawić wyświetlanie komentarzy na żywo od razu na niektórych stronach, a na innych ukrywać je pod przyciskami powiadomień.

Wszystko to jest możliwe dzięki polu wprowadzania URL ID na tej stronie, które wygląda następująco:

Pole wprowadzania URL ID na stronie dostosowywania widgetu

Wartość w tym polu powinna odpowiadać parametrowi urlId przekazywanemu do widgetu komentarzy. Jeśli chcesz, aby Twoja reguła dostosowywania była niezależna od urlId, pozostaw to pole puste lub wpisz *.

Od 2023 roku pole URL ID w dostosowywaniu widgetu przyjmuje również wzorce! Na przykład możesz użyć */blog/*, aby dodać styl specyficzny dla Twojego bloga oraz */store/*, aby mieć styl specyficzny dla Twojego sklepu, przy jednoczesnym używaniu tej samej domeny.

Pułapki

1. Jeśli Twoja strona ma parametry hash (np. example.com#page-1) – będzie to część URL ID, domyślnie.
2. Podczas migracji, na przykład z WordPressa do Gatsby, może być konieczne przeniesienie wartości komentarzy URL ID po początkowej migracji. W takim przypadku skontaktuj się z nami.

FastComments jest zaprojektowany tak, aby można go było dostosowywać. Sam widget komentarzy działa wewnątrz iframe ze względów bezpieczeństwa, więc aby zastosować własne style, musisz wybrać jedną z dwóch metod.

Pierwsza, najprostsza metoda, którą polecamy, to użycie strony dostosowywania widgetu.

Na stronie dostosowywania widgetu, zobacz sekcję „Pokaż zaawansowane opcje”, pod którą znajduje się obszar oznaczony „Custom CSS”:

Obszar wprowadzania niestandardowego CSS

Ta metoda ma kilka zalet:

1. Wprowadzony CSS jest minifikowany przed wysłaniem do użytkownika, a formatowanie pozostaje spójne w interfejsie edycji.
2. Otrzymujesz wszystkie korzyści płynące z UI dostosowywania widgetu, na przykład łatwe dostosowywanie widgetu komentarzy dla różnych witryn.
3. Gdy wprowadzamy zmiany w widgetcie komentarzy, Twoje własne style będą testowane jako część naszego procesu wydawniczego.

Druga metoda polega na określeniu parametru customCSS w konfiguracji widgetu, w następujący sposób:

Passing Custom CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

Jednak ma ona ograniczenia:

1. Istnieje limit ilości niestandardowego CSS, który może zostać przekazany, zanim nasze serwery odrzucą żądanie, ze względu na rozmiar nagłówków.
2. Musisz zarządzać niestandardowym CSS w swojej infrastrukturze i systemie budowania. Może to być zarówno zaleta, jak i wada.
3. W tym scenariuszu następuje dodatkowy koszt przesyłania niestandardowego CSS dwukrotnie przez sieć – najpierw do naszych serwerów, a potem z powrotem w treści iframe. Dla większości rozmiarów ładunku nie jest to zauważalne.
4. Powszechną optymalizacją jest minifikacja CSS w celu zmniejszenia jego rozmiaru w sieci, jednak przy tej metodzie musisz to obsłużyć samodzielnie.
5. Twój niestandardowy CSS nie będzie testowany, gdy wprowadzamy zmiany.

Zewnętrzne pliki CSS

Możesz nakazać widgetowi pobranie zewnętrznego pliku, używając @import!

Zaleca się umieszczenie @import w regule dostosowywania. Dzięki temu, jeśli kiedykolwiek będziemy musieli wprowadzić zmianę w widgetcie komentarzy, będziemy mogli użyć naszego automatycznego narzędzia weryfikacji Twojej konfiguracji. Na przykład, utwórz regułę dostosowywania w UI Dostosowywania Widgetu, kliknij Advanced i wprowadź w polu Custom CSS:

@import url(https://example.com/styles.css);

W kodzie – niezalecane

Możesz także załadować zewnętrzny plik CSS poprzez właściwość customCSS:

External CSS File

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Jednak pamiętaj, że Twój CSS nie będzie mógł być testowany przez nas, jeśli użyjesz tej metody.

Stylowanie modala profilu użytkownika

Modale profilu użytkownika można również stylować przy użyciu niestandardowego CSS. Aby zapewnić, że własne style zostaną zastosowane do profili użytkowników, wszystkie selektory CSS muszą być poprzedzone prefiksem .user-profile. Bez tego prefiksu własne style będą ignorowane w modalach profilu użytkownika.

Na przykład:

User Profile CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Zgodność wsteczna

W FastComments wiemy, że nasi klienci dostosowują widget komentarzy. To jest zamierzone – ostatnią rzeczą, jaką chcemy, jest spowodowanie niespójności projektowych w Twoim produkcie.

Ponieważ jest to ważna część naszego produktu, mamy pipeline budowania, który pozwala nam przeglądać zmiany w widgetcie komentarzy, per‑klient, przy każdym wydaniu.

Jeśli znajdziemy drobne problemy, zaktualizujemy Twoje konto, aby zapewnić płynne wydanie. Jeśli zauważymy poważne, łamiące zmiany, pozwoli nam to wstrzymać wydanie.

Dla klientów z planami Pro lub Enterprise możliwy jest white-labeling. Po prostu skontaktuj się z nami, a chętnie pomożemy.

Jeśli chcesz jedynie usunąć nasze logo z widgetu komentarzy, jest to automatycznie włączone w planach Flex i Pro.

Te plany zapewniają również taką samą funkcjonalność dla wiadomości e-mail wysyłanych z naszej platformy.

Dla stron, które umożliwiają przełączanie trybu ciemnego po początkowym załadowaniu strony, jest to trochę bardziej skomplikowane.

Po pierwsze, wszystkie obecne wersje biblioteki widżetu komentarzy (React, Vue) zawierają przykłady przełączania trybu ciemnego w swoich repozytoriach.

Dla widżetu VanillaJS będziemy musieli wykonać dodatkową pracę. Funkcja FastCommentsUI zwraca obiekt z funkcjami "destroy" i "update".

Możemy po prostu wywołać funkcję update za każdym razem, gdy chcemy zaktualizować konfigurację widżetu komentarzy, w następujący sposób. Oto kompletny działający przykład przełączania trybu ciemnego przy użyciu widżetu VanillaJS.

Kompletny przykład przełączania trybu ciemnego

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

Z FastComments cały tekst w widżecie komentarzy jest konfigurowalny.

Możesz nadpisać pojedynczy fragment tekstu, na przykład przycisk wyślij, lub cały tekst w całym widżecie komentarzy.

Domyślnie tekst w widżecie komentarzy jest tłumaczony w zależności od lokalizacji użytkownika. Jednak możemy nadpisać tekst, jeśli jesteśmy pewni, że nasza baza użytkowników używa tej samej lokalizacji/języka, na przykład:

Niestandardowy tekst

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Wszystkie konfigurowalne tłumaczenia można znaleźć tutaj pod zakładką „zaawansowane opcje”.

Jednak istnieje prostszy sposób, poprzez interfejs UI dostosowywania widżetu. Tam możemy po prostu znaleźć tekst wyświetlany w widżecie komentarzy w lokalizacji EN_US i określić jego zamiennik.

Niestandardowy tekst

Wszystkie nadpisania tłumaczeń obecnie wpływają na wszystkie lokalizacje.

Kiedy użytkownik po raz pierwszy komentuje przy użyciu FastComments, spróbujemy pobrać jego awatar z https://gravatar.com/.

Jednakże, jeśli nie znajdziemy awatara lub użytkownik nigdy nie ustawi go w swoim koncie, wyświetlimy statyczny domyślny obraz awatara.

Aby określić własny statyczny obraz awatara, możemy użyć ustawienia defaultAvatarSrc.

Zastąp domyślny awatar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widgetu, zobacz sekcję „Domyślny awatar”.

Dostosowywanie domyślnego awatara

Zauważ, że definiowanie awatara dla konkretnego użytkownika, np. przy użyciu SSO, jest opisane w osobnej sekcji.

Awatary mogą być całkowicie usunięte z widżetu komentarzy, nawet jeśli użytkownicy zdefiniowali własny awatar.

Ukrywanie awatarów

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widżetu:

Ukrywanie awatarów

W przypadku większych projektów niestandardowego stylowania może być wskazane rozpoczęcie od czystej karty i nieużywanie wcale domyślnego stylu.

Całe domyślne stylowanie można usunąć, ustawiając parametr noStyles na true, w następujący sposób:

Disabling All Default Styles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu, w sekcji Zaawansowane opcje:

Wyłączanie wszystkich domyślnych stylów

Domyślnie odpowiedzi na komentarze najwyższego poziomu są wyświetlane.

Można to skonfigurować tak, aby użytkownik musiał kliknąć "Show Replies" na komentarzach najwyższego poziomu, aby zobaczyć odpowiedzi podrzędne.

Collapse Replies to Top Level Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu:

Ukryj odpowiedzi

To ustawienie nie wpłynie na liczbę początkowo załadowanych komentarzy najwyższego poziomu. Jeśli masz jeden komentarz najwyższego poziomu i 29 odpowiedzi, przy włączonym tym ustawieniu zobaczysz:

• Zobacz komentarz najwyższego poziomu.
• Zobacz Show Replies (29) pod tym komentarzem.

Jeśli chcesz wyświetlić wszystkie komentarze najwyższego poziomu w połączeniu z tą opcją, ustaw starting page to -1.

Domyślnie funkcje formatowania w FastComments są realizowane przez dodawanie widocznych tagów kotwic, takich jak <b></b> wokół Twojego tekstu. Klikanie paska narzędzi lub używanie skrótów klawiaturowych robi to za Ciebie. Jednak niektóre społeczności mogą chcieć korzystać z formatowania bez tagów kotwic. Nazywa się to włączeniem edytora WYSIWYG (what you see is what you get). Ten edytor wygląda dokładnie tak samo jak domyślny, z wyjątkiem tego, że ładuje dodatkowy kod, który pozwala użytkownikom pogrubiać, podkreślać itp. ich tekst bez widocznych tagów kotwic.

Enabling WYSIWYG Editing

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widżetu, zobacz opcję „Enable Advanced Formatting”.

Włącz WYSIWYG

Domyślnie FastComments wyświetla pasek narzędzi podczas pisania komentarza, aby zapewnić skróty do formatowania tekstu i przesyłania obrazów.

Ten pasek narzędzi można wyłączyć w kodzie lub za pomocą interfejsu UI dostosowywania.

Wyłączanie paska narzędzi

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widgetu zobacz opcję „Disable The Reply Toolbar”.

Wyłączanie paska narzędzi

Domyślnie FastComments pozwala użytkownikom blokować innych użytkowników. Zablokowanie użytkownika spowoduje, że jego komentarze będą maskowane, zapobiegnie powiadomieniom między użytkownikami i tak dalej.

Możliwe, że zechcesz wyłączyć tę funkcjonalność. Można to zrobić w następujący sposób:

Wyłącz blokowanie

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

Można to również zrobić bez kodu, co umożliwia prawidłową walidację po stronie serwera, za pomocą interfejsu UI Dostosowywania Widżetu:

Wyłącz blokowanie

Domyślnie używane są zlokalizowane względne daty. Na przykład, obok niedawno pozostawionego komentarza możesz zobaczyć "11 minut temu".

Może być konieczne lub pożądane użycie dat absolutnych, w takim przypadku ustaw ten parametr na true.

Użyj dat absolutnych

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu, w sekcji Zaawansowane opcje:

Użyj dat absolutnych

Domyślnie używane są zlokalizowane daty względne. Na przykład, obok niedawno pozostawionego komentarza możesz zobaczyć „11 minut temu”.

Może być konieczne lub pożądane zachowanie tego formatu daty względnej, ale jednocześnie wyświetlenie pełnej daty obok niej; w takim przypadku ustaw ten parametr na true.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu, w sekcji Opcje zaawansowane. Najpierw musisz włączyć Daty absolutne, aby zobaczyć tę opcję w interfejsie użytkownika.

Użyj zarówno dat absolutnych, jak i względnych

Niektóry tekst, taki jak nagłówek lub wiadomość, może być wyświetlany poniżej liczby komentarzy, ale powyżej tekstu statusu logowania.

Nazywamy to nagłówkiem i domyślnie jest ukryty.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu, w sekcji Zaawansowane opcje:

Specifying Header HTML

Domyślnie FastComments renderuje linki w ten sposób: https://exmaple.com - gdzie adres URL linku staje się klikalnym znacznikiem HTML anchor.

Niektóre witryny mogą chcieć to wyłączyć, na przykład aby zniechęcić oszustów. Udostępniamy to poprzez ustawienie opcji Comment HTML Rendering Option na Links as Text.

Można to dostosować bez kodu, na stronie dostosowywania widgetu, dla całej domeny lub konkretnej strony:

Renderuj linki jako tekst

Domyślnie FastComments renderuje zarówno pole wprowadzania komentarza, jak i wątek komentarzy jednocześnie. Aby zaoszczędzić trochę pionowej przestrzeni, ukryje również wszystkie inne wymagane pola, dopóki widget nie zostanie użyty.

Jednak widget komentarzy może być ukryty za przyciskiem, na przykład:

Kliknij, aby wyświetlić komentarze

Przycisk używa innego przetłumaczonego tekstu w zależności od tego, czy komentarze są aktualnie wyświetlane, czy nie. Jeśli komentarze są ukryte, używa translations.SHOW_COMMENTS_BUTTON_TEXT. Jeśli komentarze są wyświetlane, używa translations.HIDE_COMMENTS_BUTTON_TEXT. Tłumaczenia mogą zawierać tekst [count], który zostanie zastąpiony lokalizowaną liczbą.

Click to Show or Hide Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

To ma zastąpić konfigurację hideCommentsUnderCountTextFormat.

Liczba jest aktualizowana na żywo wraz z wątkiem komentarzy. Przycisk nie jest wyświetlany, jeśli nie ma żadnych komentarzy.

Można to włączyć bez kodu, tworząc regułę dostosowania i włączając „Kliknij, aby wyświetlić komentarze”:

Włącz Kliknij, aby wyświetlić komentarze

Liczba komentarzy wyświetlana u góry widżetu komentarzy może być dostosowana.

Można to zastąpić dowolnym ciągiem znaków, a wartość [count] zostanie zastąpiona liczbą komentarzy, zlokalizowaną dla użytkownika.

Dostosowywanie tekstu liczby komentarzy

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widżetu:

Dostosowywanie tekstu liczby komentarzy

Kiedy użytkownicy wpisują hashtagi w formie #someexampletag, FastComments automatycznie utworzy ten HashTag i podświetli go w ich komentarzu.

W niektórych przypadkach pożądane jest wyłączenie tej funkcji lub kontrolowanie, jakie hashtagi mogą być używane za pośrednictwem API.

Aby to zrobić, po prostu włącz Disable Automatic #hashtag Creation w interfejsie dostosowywania widgetu.

Wyłączanie automatycznego tworzenia HashTag

Domyślnie FastComments wyświetla dzwonek powiadomień w prawym górnym rogu obszaru komentarzy.

Ten dzwonek zmieni kolor na czerwony i pokaże liczbę powiadomień, które ma użytkownik. Przykładowe powiadomienia to:

• Użytkownik odpowiedział Tobie.
• Użytkownik odpowiedział w wątku, w którym komentowałeś.
• Użytkownik przyznał Twój komentarz.
• Użytkownik odpowiedział na stronę, którą subskrybujesz.

Dzwonek powiadomień zapewnia także mechanizm subskrypcji całej strony.

Jednak możemy całkowicie wyłączyć dzwonek powiadomień:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Można to zrobić również bez kodu. Na stronie dostosowywania widgetu zobacz sekcję „Disable Notification Bell”.

Wyłącz dzwonek powiadomień

Domyślnie FastComments wyświetla profil użytkownika po kliknięciu jego awatara.

Jednak możemy wyłączyć tę funkcjonalność:

Wyłącz profile

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Można to zrobić również bez kodu. Na stronie dostosowywania widgetu, zobacz sekcję „Wyłącz profile”.

Wyłącz profile

Domyślnie FastComments wyświetla zakładkę „Komentarze profilowe” na profilach użytkowników, umożliwiając odwiedzającym pozostawianie komentarzy na profilu danej osoby.

Jednak możemy wyłączyć tę zakładkę:

Disable Profile Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileComments": true

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widgetu zobacz sekcję „Wyłącz komentarze profilowe”.

Wyłącz komentarze profilowe

Domyślnie FastComments wyświetla zakładkę „Direct Messages” w profilach użytkowników, umożliwiając odwiedzającym wysyłanie bezpośrednich wiadomości do użytkownika.

Jednak możemy wyłączyć tę zakładkę:

Wyłącz bezpośrednie wiadomości w profilu

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileDirectMessages": true

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widgetu zobacz sekcję „Disable Direct Messages”.

Wyłącz bezpośrednie wiadomości w profilu

Domyślnie FastComments wyświetla komunikat o sukcesie po dodaniu komentarza. Można go wyłączyć w następujący sposób:

Wyłącz komunikat o sukcesie

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Można to zrobić również bez kodu. Na stronie dostosowywania widgetu:

Wyłącz komunikat o sukcesie

Domyślnie widżet komentarzy FastComments ustawi gif rating na pg.

Dostępne opcje to g, pg, pg-13 i r.

Można to ustawić w kodzie lub za pomocą interfejsu UI. W kodzie możemy to zrobić w następujący sposób:

Ustawienie oceny GIF

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

W interfejsie UI znajdziesz to pod Gif Picker Rating, o ile opcja Disable Image Uploads? nie jest zaznaczona.

Ustawianie oceny GIF

Domyślnie widżet komentarzy FastComments ma moderację treści obrazów wyłączoną off.

Dostępne opcje to off, low, medium i high.

W interfejsie dostosowywania widżetu znajdziesz to pod Image Content Moderation Level, o ile nie jest zaznaczone Disable Image Uploads?.

Ustawianie poziomu moderacji treści obrazów

Domyślnie FastComments wyświetla opcje głosowania jako strzałki w górę i w dół, umożliwiając użytkownikom przyznanie głosu pozytywnego lub negatywnego do komentarza.

Jednakże możliwe jest zmienienie stylu paska głosowania. Obecne opcje to domyślne przyciski Góra/Dół lub użycie mechanizmu głosowania w stylu serca.

Używamy flagi voteStyle w następujący sposób:

Włącz przycisk serca

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Zdecydowanie zalecamy wykonanie tego bez kodu, ponieważ włącza to również walidacje po stronie serwera. Na stronie dostosowywania widgetu zobacz sekcję „Vote Style”.

Zmień styl głosowania

Głosowanie można również wyłączyć, zobacz Disable Voting powyżej opcji stylu.

Domyślnie FastComments pozwala użytkownikom usuwać ich komentarze.

Jednak możliwe jest zapobieżenie temu.

Na stronie dostosowywania widgetu zobacz opcję "Disable Deleting".

Wyłączanie usuwania komentarzy

• To wpływa tylko na zwykłych komentujących, a nie na moderatorów ani administratorów, którzy nadal będą mogli usuwać.
• To również wpłynie na integracje API, gdy przekazywany jest contextUserId.

Domyślnie FastComments pozwala użytkownikom edytować ich komentarze.

Jednak można to uniemożliwić.

Na stronie dostosowywania widgetu zobacz opcję „Wyłącz edycję”.

Wyłącz edycję komentarzy

• To dotyczy tylko zwykłych komentatorów, a nie moderatorów ani administratorów, którzy nadal będą mogli edytować.
• Będzie to również wpływać na integracje API, gdy przekazywany jest contextUserId.

Domyślnie rozmiar strony FastComments wynosi 30. Obejmuje to odpowiedzi w wątkach.

Rozmiar strony można dostosować w Widget Configuration UI w różnych rozmiarach od 10 do 200.

Zauważ, że zmiana rozmiaru strony wymaga przeliczenia wszystkich wątków komentarzy w Twoim koncie. Może to potrwać kilka minut.

Nie można tego skonfigurować w widżecie po stronie klienta, ponieważ strony są obliczane po stronie serwera.

Przykładowa konfiguracja jest pokazana poniżej:

Niestandardowe rozmiary stron

Rozmiary stron można dostosować globalnie, lub per-domena, lub per-strona, tworząc różne reguły dostosowywania.

Będzie to miało wpływ na wszystkich klientów, integracje i frameworki, które możesz używać do wyświetlania komentarzy za pośrednictwem naszej platformy.

Domyślnie FastComments wyświetla nazwę użytkownika tak, jak została wprowadzona, lub jak została przekazana nam przez SSO.

Jednakże może być pożądane ukrycie lub wyświetlenie nazwy użytkownika w inny sposób. Na przykład, jeśli nazwa użytkownika to Allen Rex, może chcesz wyświetlać tylko „Allen R.”.

Można to zrobić bez kodu w interfejsie dostosowywania widgetu, w ustawieniu o nazwie Commenter Name Format:

Zmień format nazwy

Dostępne formaty są:

• Capitalize (wyświetla przykładowego użytkownika jako Example User)
• Last Initial (wyświetla Example User jako Example U.)
• All Initials (wyświetla Example User jako E. U.)
• Show "Anonymous"

Efekt zmiany jest natychmiastowy. Użytkownicy nadal zobaczą swoją pełną nazwę użytkownika na górze obszaru komentarza, dla siebie, ale ich komentarze będą wyświetlać zmodyfikowaną nazwę użytkownika.

Nazwy użytkowników są maskowane po stronie serwera w celu ochrony użytkowników.

Domyślnie FastComments zezwala na przesyłanie obrazów. Można to wyłączyć, ustawiając flagę noImageUploads na true.

Wyłączanie przesyłania obrazów

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu:

Wyłączanie przesyłania obrazów

By default FastComments does not allow iframes in comments. When you enable media embeds, commenters can paste the embed code (the <iframe> snippet) from trusted providers like YouTube, Vimeo, SoundCloud, and Spotify, and it will render inline in the comment.

For security, this is not a client-side widget config flag. It is a server-side setting, validated when each comment is saved, so it cannot be turned on from the page. Only iframes pointing at a built-in list of trusted providers are allowed. Any other iframe is removed.

This is done without code, on the widget customization page:

Zezwalaj na osadzanie mediów

Adding Your Own Providers

If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "Additional Embed Domains" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.

Both the plain comment box and the WYSIWYG editor support pasting an embed. In the WYSIWYG editor the embed is inserted as a removable block.

Domyślnie w widżecie komentarzy nie wyświetlany jest pasek wyszukiwania.

Jednak możemy to włączyć, ustawiając flagę enableSearch na true:

Włączanie wyszukiwania

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widżetu zobacz opcję „Enable Search Box”.

Włącz pole wyszukiwania

Możemy włączyć obsługę spoilerów, ustawiając flagę enableSpoilers na true:

Enabling Spoilers

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Można to zrobić również bez kodu. Na stronie dostosowywania widgetu, zobacz opcję "Enable Spoilers".

Włącz Spoilery

Gdy tekst jest zaznaczony, a widoczny przycisk SPOILER zostanie kliknięty, tekst zostanie zamaskowany, dopóki użytkownik nie najedzie na niego myszką. W trybie ciemnym robimy to samo, używając innych kolorów lepiej pasujących do trybu ciemnego.

Jest to również kompatybilne z edytorem WYSIWYG.

Domyślnie FastComments nie śledzi, kto oglądał każdy komentarz ani nie dostarcza żadnych statystyk na ten temat.

Jednak możemy włączyć tę funkcję, a system zacznie śledzić, gdy każdy użytkownik przewija do komentarza.

Gdy to nastąpi, licznik obok ikony oka wyświetlanej przy każdym komentarzu zostanie zwiększony. Licznik jest aktualizowany na żywo i skracany zgodnie z ustawieniami regionalnymi użytkownika.

Możemy to włączyć, ustawiając flagę enableViewCounts na true:

Włączanie liczby wyświetleń komentarzy

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu:

Włączanie liczby wyświetleń komentarzy

Śledzimy identyfikator użytkownika* który obejrzał komentarz, tak aby przy ponownym obejrzeniu komentarza licznik się nie zwiększał. Jeśli obejrzysz komentarz ponownie po dwóch latach, licznik zwiększy się bardziej.

• Uwaga: lub anonimowy identyfikator sesji, lub adres IP użytkownika jako wartość skrócona.

Domyślnie komentarze na żywo są włączone. Oznacza to, że jeśli jakiekolwiek komentarze zostaną dodane, usunięte, edytowane lub przypięte, zmiany powinny pojawić się u wszystkich użytkowników przeglądających wątek komentarzy w tym samym czasie.

Jednak domyślnie nowe komentarze będą wyświetlane pod dynamicznie pokazywanym przyciskiem z tekstem podobnym do "Show 2 New Comments".

Jeśli nowe komentarze są odpowiedziami bezpośrednio do strony, przycisk pojawi się na górze wątku komentarzy. Jeśli są odpowiedziami do konkretnego komentarza, przycisk pojawi się pod tym komentarzem.

Ma to na celu zapobieżenie ciągłej zmianie rozmiaru strony dla użytkownika, co mogłoby powodować frustrację przy próbie chwycenia paska przewijania.

W niektórych przypadkach, takich jak licytacje na żywo czy wydarzenia online, takie zachowanie nie jest pożądane – możesz chcieć, aby widżet komentarzy działał bardziej jak "chat" box, gdzie nowe komentarze "show right away".

Stąd nazwa flagi, która włącza tę funkcję: showLiveRightAway.

Możemy ją włączyć w następujący sposób:

Pokaż komentarze na żywo od razu

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie personalizacji widżetu:

Pokaż komentarze na żywo od razu

Domyślnie FastComments ma włączone komentarze na żywo.

Oznacza to, że każdy oglądający wątek komentarzy powinien widzieć tę samą treść.

Na przykład, jeśli zostanie dodany komentarz, powinien się on wyświetlić. Jeśli komentarz zostanie edytowany lub usunięty, to te komentarze będą edytowane lub usuwane dla wszystkich oglądających wątek. To samo dotyczy głosów i wszystkich działań moderacyjnych.

Jednak możemy to wyłączyć:

Disable Live Commenting

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Można to również zrobić bez kodu. Na stronie dostosowywania widgetu, zobacz sekcję „Disable Live Commenting”.

Wyłącz komentarze na żywo

Domyślnie FastComments sortuje komentarze według kierunku sortowania „Najbardziej istotne”.

Sortowanie „Najbardziej istotne” uwzględnia czas pozostawienia komentarza oraz liczbę głosów przy sortowaniu.

Użytkownik może następnie zmienić kierunek sortowania na najstarsze lub najnowsze najpierw w interfejsie widżetu komentarzy.

Możemy jednak zmienić domyślne ustawienie na dowolne z trzech. Na przykład, jeśli chcesz wyświetlać najstarsze komentarze jako pierwsze:

Zmiana domyślnego sortowania na najstarsze najpierw

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

Ustawiamy wartość defaultSortDirection na „OF”, aby ustawić kierunek na „OF”.

Aby ustawić kierunek sortowania najnowsze najpierw, wykonujemy następujące kroki:

Zmiana domyślnego sortowania na najnowsze najpierw

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

Prawidłowe wartości dla defaultSortDirection to:

• MR: "Najbardziej aktualne"
• NF: "Najnowsze najpierw"
• OF: "Najstarsze najpierw"

Można to zrobić również bez kodu. Na stronie dostosowywania widżetu, zobacz sekcję „Domyślny kierunek sortowania”.

Zmiana domyślnego kierunku sortowania

Należy zauważyć, że komentarze na każdej stronie dla każdego kierunku sortowania są wstępnie obliczane, więc wszystkie kierunki sortowania mają taką samą wydajność.

Domyślnie obszar wprowadzania komentarza jest przed wątkiem komentarzy. Jednak ustawiając ten parametr konfiguracyjny na true, możemy przenieść go po.

Przenoszenie pola odpowiedzi na dół

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu:

Przenoszenie pola odpowiedzi na dół

Maksymalna liczba znaków, które można wprowadzić w polu wprowadzania komentarza, może być ograniczona przy użyciu parametru maxCommentCharacterLength.

Domyślnie wynosi 2000.

Elementy takie jak adresy URL obrazów nie są uwzględniane przy określaniu długości.

Ogranicz długość komentarza

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu:

Ogranicz długość komentarza

Domyślnie FastComments pozwala użytkownikowi wprowadzić komentarz o dowolnej liczbie linii, aż do domyślnego limitu znaków.

Jednak może być pożądane ograniczenie użytkownika do wprowadzania tylko jednej linii tekstu. Przykładowe przypadki użycia to licytacje online lub czat na żywo, do których FastComments może być używany.

Włączamy flagę useSingleLineCommentInput w następujący sposób:

Włącz wprowadzanie komentarza w jednej linii

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Można to zrobić również bez kodu. Na stronie dostosowywania widgetu zobacz sekcję „Włącz wprowadzanie komentarza w jednej linii”.

Włącz wprowadzanie komentarza w jednej linii

Należy zauważyć, że komentarze na każdej stronie dla każdego kierunku sortowania są wstępnie obliczane, więc wszystkie kierunki sortowania mają taką samą wydajność.

Domyślnie każdy użytkownik może dodać maksymalnie 5 komentarzy w ciągu jednej minuty.

Jest to śledzone za pomocą identyfikatora użytkownika, anonimowego identyfikatora użytkownika oraz adresu IP (zaszyfrowanego).

Można to dostosować bez kodu, na stronie dostosowywania widżetu:

Ograniczanie liczby komentarzy na użytkownika

Zauważ, że jeśli używasz API tworzenia komentarzy, możesz chcieć przekazać oryginalny adres ip użytkownika w żądaniu do naszego backendu, aby limitowanie było stosowane per użytkownika, a nie globalnie dla Twojego konta.

FastComments umożliwia wymóg akceptacji Warunków świadczenia usług przez komentujących po raz pierwszy przed wysłaniem komentarza.

Po włączeniu:

• Użytkownicy anonimowi zobaczą pole wyboru TOS przy każdym komentarzu
• Użytkownicy uwierzytelnieni zobaczą pole wyboru tylko przy swoim pierwszym komentarzu lub gdy zaktualizujesz swoje TOS

Konfiguracja

Przejdź do strony dostosowywania widżetu i włącz pole wyboru „Wymagaj akceptacji Warunków świadczenia usług”. Po włączeniu zobaczysz następujące opcje:

Opcje Warunków świadczenia usług

• Tryb tekstu TOS: Domyślnie pole wyboru wyświetla „Zgadzam się z Warunkami świadczenia usług i Polityką prywatności” z odnośnikami do obu dokumentów. Wybierz „Dostosuj tekst dla każdego języka”, aby podać własny tekst dla każdego języka.
• Data ostatniej aktualizacji TOS: Gdy aktualizujesz swoje Warunki świadczenia usług, ustaw tę datę. Użytkownicy, którzy zaakceptowali je przed tą datą, będą musieli zaakceptować ponownie.

Jak to działa

• Znacznik czasu akceptacji TOS jest przechowywany dla każdego użytkownika i każdego komentarza
• Gdy użytkownik akceptuje TOS, data jest zapisywana w jego profilu użytkownika (per-tenant)
• Jeśli ustawisz datę „Ostatniej aktualizacji”, która jest późniejsza niż data akceptacji użytkownika, będzie on musiał ponownie zaakceptować
• Dla anonimowych użytkowników, których nie można śledzić, pole wyboru pojawia się przy każdym wysyłaniu komentarza

FastComments Secure SSO używa szyfrowania HMAC-SHA256 jako mechanizmu implementacji SSO. Najpierw omówimy ogólną architekturę, podamy przykłady i szczegółowe kroki.

Istnieje także dokumentacja dotycząca migracji od innych dostawców z podobnymi mechanizmami SSO oraz różnic.

Przepływ wygląda następująco:

Secure SSO Flow

Ponieważ Secure SSO wymaga pracy full-stack, kompletne działające przykłady kodu w Java/Spring, NodeJS/Express oraz czystym PHP są obecnie dostępne na GitHubie.

Chociaż w przykładzie NodeJS używamy ExpressJS, a w przykładzie Java — Spring, to w tych środowiskach nie są wymagane żadne dodatkowe frameworki/biblioteki do wdrożenia FastComments SSO — wystarczają natywne pakiety kryptograficzne.

Nie musisz tworzyć żadnych nowych endpointów API przy użyciu FastComments SSO. Po prostu zaszyfruj informacje o użytkowniku za pomocą swojego klucza tajnego i przekaż ładunek do widżetu komentarzy.

Pobierz swój tajny klucz API

Twój tajny klucz API można pobrać z tej strony. Możesz też znaleźć tę stronę, przechodząc do My Account, klikając kafelek API/SSO, a następnie klikając "Get API Secret Key".

Parametry widżetu komentarzy

Dokumentacja wysokiego poziomu API dla widżetu komentarzy jest dostępna tutaj.

Przejdźmy do bardziej szczegółowego omówienia, co oznaczają te parametry.

Widżet komentarzy przyjmuje obiekt konfiguracji — już przekazujesz go, jeśli używasz FastComments do przekazania identyfikatora klienta (nazywanego tenantId).

Aby włączyć SSO, przekaż nowy obiekt "sso", który musi zawierać następujące parametry. Wartości powinny być generowane po stronie serwera.

• userDataJSONBase64: Dane użytkownika w formacie JSON, które następnie są kodowane Base64.
• verificationHash: HMAC-SHA256 hash utworzony z UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Znacznik czasu epoki, w milisekundach. Nie może być z przyszłości ani starszy niż dwa dni.
• loginURL: URL, który widżet komentarzy może wyświetlić, aby zalogować użytkownika.
• logoutURL: URL, który widżet komentarzy może wyświetlić, aby wylogować użytkownika.
• loginCallback: Gdy jest dostarczone zamiast login URL, funkcja, którą widżet komentarzy wywoła po kliknięciu przycisku logowania.
• logoutCallback: Gdy jest dostarczone zamiast logout URL, funkcja, którą widżet komentarzy wywoła po kliknięciu przycisku wylogowania.

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1787115343223.0,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout",

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

Obiekt użytkownika

Obiekt użytkownika

Copy

1

2interface SSOUser {

3 /** Wymagane. Maks. 1k znaków. **/

4 id: string;

5 /** Wymagane. Maks. 1k znaków. Uwaga: musi być unikalne. **/

6 email: string;

7 /** Wymagane. Maks. 1k znaków. Uwaga: nazwa użytkownika nie może być adresem e-mail. Nie musi być unikalna. **/

8 username: string;

9 /** Opcjonalne. Maks. 3k znaków dla URL-i. Domyślnie pobierane z Gravatar na podstawie e-maila. Obsługuje obrazy zakodowane w base64, w takim przypadku limit to 50k znaków. **/

10 avatar?: string;

11 /** Opcjonalne. Domyślnie false. **/

12 optedInNotifications?: boolean;

13 /** Opcjonalne. Domyślnie false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Opcjonalne. Maks. 100 znaków. Ta etykieta będzie wyświetlana obok ich nazwy. Domyślnie Administrator/Moderator, gdy ma zastosowanie. **/

16 displayLabel?: string;

17 /** Opcjonalne. Maks. 500 znaków. To będzie wyświetlane zamiast nazwy użytkownika. **/

18 displayName?: string;

19 /** Opcjonalne. Maks. 2k znaków. Nazwa użytkownika będzie linkować do tego adresu. **/

20 websiteUrl?: string;

21 /** Opcjonalne. Do 100 grup na użytkownika. Id grupy nie może być dłuższe niż 50 znaków. **/

22 groupIds?: string[];

23 /** Opcjonalne. Oznacza użytkownika jako administratora. **/

24 isAdmin?: boolean;

25 /** Opcjonalne. Oznacza użytkownika jako moderatora. **/

26 isModerator?: boolean;

27 /** Opcjonalne, domyślnie true. Ustaw na false, aby włączyć kartę „aktywność” w profilu użytkownika. **/

28 isProfileActivityPrivate?: boolean;

29 /** Opcjonalne, domyślnie false. Ustaw na true, aby wyłączyć komentarze w profilu. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Opcjonalne, domyślnie false. Ustaw na true, aby wyłączyć wiadomości bezpośrednie do tego użytkownika. **/

32 isProfileDMDisabled?: boolean;

33 /** Opcjonalna konfiguracja odznak użytkownika. **/

34 badgeConfig?: {

35 /** Tablica globalnych identyfikatorów odznak do przypisania. Ograniczenie do 30 odznak. Kolejność jest zachowana. **/

36 badgeIds: string[];

37 /** Tablica identyfikatorów odznak przypisanych do bieżącej strony (urlId). Wyświetlane tylko na przypisanej stronie. **/

38 pageBadgeIds?: string[];

39 /** Jeśli true, zastępuje istniejące wyświetlane odznaki. Globalne i przypisane do strony są nadpisywane niezależnie. **/

40 override?: boolean;

41 /** Jeśli true, aktualizuje właściwości wyświetlania odznak z konfiguracji najemcy. **/

42 update?: boolean;

43 };

44}

45

Moderatorzy i administratorzy

Dla adminów i moderatorów przekaż odpowiednio flagi isAdmin lub isModerator w obiekcie SSOUser.

Powiadomienia

Aby włączyć lub wyłączyć powiadomienia, ustaw wartość optedInNotifications na true lub false odpowiednio. Przy pierwszym załadowaniu strony przez użytkownika z tą wartością w ładunku SSO jego ustawienia powiadomień zostaną zaktualizowane.

Dodatkowo, jeśli chcesz, aby użytkownicy otrzymywali e-maile z powiadomieniami o aktywności na stronach, na które się zapisali (zamiast tylko powiadomień w aplikacji), ustaw optedInSubscriptionNotifications na true.

Użytkownicy VIP i specjalne etykiety

Możesz wyświetlić specjalną etykietę obok nazwy użytkownika, używając opcjonalnego pola "displayLabel".

Niezalogowani użytkownicy

Aby przedstawić użytkownika niezalogowanego, po prostu nie wypełniaj userDataJSONBase64, verificationHash ani timestamp. Podaj loginURL.

Tacy użytkownicy nie będą mogli komentować; zamiast tego zostanie im pokazany komunikat logowania (wiadomość, link lub przycisk, w zależności od konfiguracji).

Bezpośrednie przykłady serializacji i hashowania danych użytkownika

Więcej szczegółów i przykładów tutaj (js), tutaj (java) i tutaj (php).

Rozumiemy, że każda integracja może być skomplikowanym i bolesnym procesem. Nie wahaj się skontaktować ze swoim przedstawicielem lub skorzystać ze strony wsparcia.

FastComments SSO (szczegóły tutaj) zapewnia Twoim użytkownikom możliwość komentowania bez konieczności logowania się na inną platformę.

Jednak samo to nie zabezpiecza wątków komentarzy, ponieważ domyślnie dane komentarzy są publicznie dostępne – każdy, kto może zobaczyć stronę, może zobaczyć komentarze.

Zmieniając ustawienie, możemy ograniczyć pobieranie komentarzy, chyba że zrobi to administrator lub ważny użytkownik SSO.

No-Code Setup

Możemy zapobiec przeglądaniu i interakcjom z naszymi wątkami komentarzy, gdy SSO jest skonfigurowane, tworząc regułę dostosowywania.

Podczas tego, wyszukaj SSO, a znajdziesz tę opcję:

Wymagaj SSO, aby wyświetlać komentarze

Włącz ją i zapisz regułę dostosowywania.

Only Protect a Certain Domain or Page

Aby chronić tylko określoną domenę lub stronę, po prostu skonfigurujemy regułę dostosowywania, aby to zrobić.

U góry interfejsu dostosowywania znajdziemy dwa pola wejściowe: Domain i URL ID.

Aby chronić tylko konkretną domenę, wprowadź tę domenę w polu „domain”.

Aby chronić konkretną stronę, wprowadź URL strony w polu „URL ID”. Jeśli masz własną integrację z FastComments, możesz wprowadzić tutaj rodzaj identyfikatora zamiast URL.

Security Levels

Wymagając SSO, będziesz chciał zdecydować, czy wymagasz Simple SSO czy Secure SSO. Jeśli wymagasz Simple SSO, oba są dozwolone, ale jeśli wymagasz Secure SSO, treść musi być pobierana z ładunkiem Secure SSO, który jest haszowany przy użyciu Twojego klucza API, aby mogła być wyświetlona.

Opcja poziomu bezpieczeństwa pojawi się po wybraniu „Require SSO To View Comments”.

Protection Beyond Reading

Włączenie tej opcji zabezpieczy stronę lub domenę przed komentowaniem, chyba że użytkownik jest zalogowany przez SSO.

Gotchas

Użytkownicy, którzy utworzyli komentarze przed integracją SSO, nie będą mogli ich zobaczyć, chyba że zalogują się poprzez Twoją integrację SSO.

Domyślnie FastComments wymaga podania adresu e‑mail przy komentowaniu. Nie musi to być prawidłowy e‑mail, jednak dopóki użytkownik nie kliknie linku wysłanego do niego, jego komentarz będzie wyświetlany z etykietą „Niezweryfikowany komentarz”.

Możemy jednak usunąć wymóg podania e‑maila. Pole wprowadzania e‑maila nadal będzie widoczne, ale nie będzie już wymagane.

Można to skonfigurować w interfejsie dostosowywania widgetu:

Włączanie anonimowych komentarzy

FastComments można skonfigurować tak, aby usuwał niezweryfikowane komentarze po określonej liczbie dni. Pomaga to w walce ze spamem.

Domyślnie nie robi tego.

Można to skonfigurować lub wyłączyć za pomocą strony Ustawienia moderacji.

Ustawienia moderacji

Kiedy użytkownicy komentują i nie są zalogowani, zostaną poproszeni o podanie swojego adresu e‑mail.

Spowoduje to utworzenie „niezweryfikowanej sesji” dla tego użytkownika i poprosimy go o zweryfikowanie tej sesji za pomocą e‑maila.

Dla niektórych witryn lub aplikacji pożądane jest, aby nie pytać użytkownika o jego e‑mail podczas komentowania lub głosowania.

Włączenie anonimowych komentarzy sprawia, że pole wprowadzania e‑maila jest opcjonalne. Możemy jednak wyłączyć je całkowicie. Najpierw włącz anonimowe komentarze, a następnie pojawi się opcja wyłączenia pól wprowadzania e‑maila.

Wyłącz pola e‑mail

Po włączeniu tej opcji pola e‑mail nie będą wyświetlane w żadnym z naszych produktów do komentowania.

Zauważ, że przy tej konfiguracji wszystkie komentarze będą niezweryfikowane, chyba że użytkownik utworzy konto i zaloguje się na https://fastcomments.com.

Możesz rozważyć wyłączenie etykiety niezweryfikowanego.

Domyślnie FastComments wyświetli etykietę „Niezweryfikowany komentarz” dla komentarzy pozostawionych przez użytkownika, który ma niezweryfikowaną sesję przeglądarki. Więcej informacji o niezweryfikowanych komentarzach znajdziesz tutaj.

Wyłącz etykietę niezweryfikowanego komentarza

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

Dodatkowo tę funkcję można wykorzystać, bez pisania kodu, w interfejsie UI dostosowywania:

Wyłącz etykietę niezweryfikowanego komentarza

Kiedy użytkownicy próbują zagłosować na komentarz i nie są zalogowani, zostaną poproszeni o podanie swojej nazwy użytkownika i adresu e‑mail.

Możemy usunąć to wymaganie, umożliwiając każdemu głosowanie na komentarz bez podawania jakichkolwiek informacji.

Zezwól na anonimowe głosy

Kiedy użytkownicy komentują lub głosują i nie są zalogowani, zostaną poproszeni o podanie swojego adresu e‑mail oraz nazwy użytkownika.

W przypadku anonimowych komentarzy czasami pożądane jest określenie domyślnej nazwy użytkownika, aby zmniejszyć tarcia przy komentowaniu. Można to zrobić w interfejsie dostosowywania. Najpierw należy włączyć anonimowe komentowanie.

Ustawianie domyślnej nazwy użytkownika

Domyślnie FastComments wyświetli widżet komentarzy w ustawieniach regionalnych określonych przez system i przeglądarkę użytkownika.

Gdy użytkownik komentuje lub loguje się, aktualizujemy jego ostatnio używane ustawienia regionalne i używamy ich również do wysyłania e‑maili.

Ma to wpływ na to, jak widżet komentarzy jest tłumaczony dla użytkownika. Ustawienia regionalne składają się z języka i regionu użytkownika, więc ich konfiguracja zazwyczaj zmieni język wyświetlanego tekstu.

Via The UI

Można to określić za pomocą interfejsu dostosowywania widżetu. Zobacz opcję „Ustawienia regionalne / Język”:

Zmiana ustawień regionalnych / języka

Via Code

Można to nadpisać wybranymi ustawieniami regionalnymi.

Ręczne definiowanie ustawień regionalnych użytkownika

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Supported Languages and Locale Codes

Pełną listę obsługiwanych języków i odpowiadających im kodów regionalnych znajdziesz tutaj.

SSO Note

Jeśli używasz SSO, możesz chcieć przekazać ustawienia regionalne użytkownika w obiekcie użytkownika, aby e‑maile i inne elementy były prawidłowo lokalizowane dla niego.

Domyślnie FastComments nie ogranicza języków używanych w komentarzach.

Może być pożądane ograniczenie języków, które społeczność używa.

Można to skonfigurować bez kodu, na stronie dostosowywania widgetu:

Dozwolone języki

System przetworzy ich komentarz, określi jego język, a następnie dopasuje go do listy dozwolonych.

Jeśli komentarz zostanie napisany w języku, który nie jest dozwolony, wyświetlony zostanie zlokalizowany komunikat o błędzie.

Komentowanie może być zablokowane, aby nie można było zostawiać nowych komentarzy ani głosów, poprzez ustawienie flagi readonly na true.

Komentarze nie będą również mogły być edytowane ani usuwane.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Można to dostosować bez kodu, na stronie dostosowywania widgetu, dla całej domeny lub strony:

Ustawianie wątku komentarzy w tryb tylko do odczytu

Update!

Od listopada 2022 r. wątki mogą być blokowane lub odblokowywane na żywo przez administratorów i moderatorów za pomocą menu z trzema kropkami nad obszarem odpowiedzi.

Spowoduje to zapobieganie nowym komentarzom, jednocześnie umożliwiając głosowanie oraz pozwalając użytkownikom usuwać ich komentarze, jeśli zechcą, podczas gdy readonly nie pozwala na te czynności.

Odpowiada to polu isClosed w API Page.

Domyślnie FastComments zezwala na linkowanie do dowolnej zewnętrznej witryny.

Można to ograniczyć do określonej listy witryn lub domen. Próba opublikowania linku do witryny lub domeny, które nie znajdują się na zdefiniowanej liście, spowoduje wyświetlenie błędu użytkownikowi.

To sprawdzanie jest stosowane tylko w widżecie komentarzy i API. Importy nie są objęte.

Można to zrobić bez kodu, na stronie dostosowywania widżetu:

Ogranicz domeny linków zewnętrznych

Domyślnie FastComments poprosi użytkownika jedynie o komentarz, nazwę użytkownika i adres e‑mail.

Jednak w niektórych sytuacjach możesz chcieć, aby użytkownik podał link do swojego bloga lub strony internetowej.

Możemy włączyć wyświetlanie dodatkowego pola wejściowego, aby podać adres URL strony użytkownika, ustawiając flagę enableCommenterLinks na true:

Enabling Commenter Links

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Gdy podany zostanie ten adres URL, konto użytkownika zostanie zaktualizowane, a wszystkie jego nazwy użytkownika we wszystkich przeszłych i przyszłych komentarzach będą odnośnikami do tego URL.

Można to dostosować bez kodu, na stronie dostosowywania widgetu:

Włączanie linków komentującego

Lista identyfikatorów wygenerowanych z strony Moderation Groups.

Gdy zostanie określone, komentarze pozostawione przy użyciu określonej konfiguracji będą zawierały ten sam zestaw moderationGroupIds.

Jeśli Moderator ma jedną lub więcej zdefiniowanych Moderation Groups defined, będą widzieć tylko komentarze na stronie Moderate Comments powiązane ze swoją grupą (grupami).

Określ grupy moderacji

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

Do uwierzytelniania FastComments zależy od włączonych w przeglądarce ciasteczek stron trzecich. Bez nich użytkownicy zawsze będą musieli podać swój e‑mail, aby skomentować (chyba że pole wprowadzania e‑maila jest ukryte), a ich komentarze będą zawsze wyświetlane jako niezweryfikowane (domyślnie).

Aby obejść ten problem, możesz włączyć obejście ciasteczek stron trzecich.

Gdy to ustawienie jest włączone, spowoduje wyświetlenie małego popupu, który pokazuje komunikat informujący, że użytkownik jest logowany. Ten popup pokazuje się za każdym razem, gdy użytkownik wchodzi w interakcję z widżetem komentarzy; na przykład, gdy zostawia komentarz.

Możemy to zrobić w kodzie, ustawiając flagę enableThirdPartyCookieBypass na true:

Włączanie obejścia ciasteczek stron trzecich

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

Możemy również ustawić to za pomocą UI Dostosowywania Widżetu, w sekcji Enable Third-Party Cookie Popup:

Włączanie obejścia ciasteczek stron trzecich

Domyślnie użytkownicy mogą usuwać własne komentarze. Ponadto usunięcie ich komentarza automatycznie usuwa wszystkie komentarze podrzędne i przejściowe w wątku. To zachowanie jest również aktywne.

Możesz ograniczyć to na następujące sposoby:

• Zamiast tego anonimizuj usunięty komentarz (ustaw nazwę i tekst na [deleted] lub własną wartość).
• Nie zezwalaj na usuwanie komentarzy, gdy istnieją odpowiedzi. Wyświetlany jest konfigurowalny komunikat o błędzie.
• Ogranicz usuwanie, gdy komentarz ma odpowiedzi, wyłącznie do administratorów i moderatorów.

Można to skonfigurować w sekcji Comment Thread Deletion w interfejsie dostosowywania widgetu.

Dostosuj zachowanie usuwania przy odpowiedziach

Domyślnie FastComments wyświetla odznaki użytkowników tylko przy ich komentarzach w wątku komentarzy.

Jednak możemy wyświetlić odznaki użytkowników obok ich imienia nad formularzem komentarza, włączając tę funkcję na stronie dostosowywania widgetu:

Opcja wyświetlania odznak w pasku górnym

Spowoduje to wyświetlenie odznak użytkownika obok jego imienia w obszarze paska górnego, co sprawi, że jego osiągnięcia i status będą bardziej widoczne podczas pisania komentarza.

Uwaga: ta funkcja musi być włączona w interfejsie dostosowywania widgetu, aby działała. Opcjonalnie możesz ustawić flagę showBadgesInTopBar na false w konfiguracji kodu, aby selektywnie wyłączyć ją, nawet gdy jest włączona na poziomie serwera:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10

Domyślnie FastComments nie wyświetla listy użytkowników na stronie.

Możesz wyświetlić listę osób, które aktualnie przeglądają stronę, obok widżetu komentarzy. Lista aktualizuje się na żywo, gdy użytkownicy dołączają i odchodzą, oraz pokazuje ich imię, awatar i wskaźnik online.

Istnieją trzy opcje układu:

• 1 - Góra: poziomy rząd nakładających się awatarów wyświetlanych nad komentarzami.
• 2 - Lewo: pasek boczny z nazwiskami i kropkami online wyświetlany po lewej stronie widżetu.
• 3 - Prawo: ten sam pasek boczny wyświetlany po prawej stronie widżetu.

Ustaw flagę usersListLocation, aby włączyć tę funkcję:

Pokaż listę użytkowników po prawej

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3

8}];

9</script>

10

Domyślnie lista wyświetla tylko użytkowników aktualnie online. Aby również uwzględnić osoby, które komentowały stronę w przeszłości (ale nie przeglądają jej w tej chwili), ustaw usersListIncludeOffline na true:

Uwzględnij wcześniejszych komentujących

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

Poprzedni komentujący są wyświetlani bez zielonej kropki online, aby było jasne, kto jest obecny w tej chwili.

Użytkownicy z prywatnymi profilami są wyświetlani z ogólnym awatarem i etykietą „Prywatny profil”, aby liczba pozostała dokładna bez ujawniania tożsamości.

Można to również skonfigurować bez kodu. Na stronie dostosowywania widżetu zobacz opcję „Lokalizacja listy użytkowników”. Gdy lokalizacja jest ustawiona na cokolwiek oprócz Wyłącz, pojawia się pole wyboru „Uwzględnij wcześniejszych komentujących” pod nią.

Ustawienia listy użytkowników

Do 500 aktywnych użytkowników, lista może być opóźniona o do 30 sekund.