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 zostawiania komentarza, FastComments musi wiedzieć, do jakiej strony, artykułu lub produktu należą te komentarze.

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

Domyślnie, jeśli nie określisz urlId, stanie się on adresem URL strony. Weźmiemy bieżący adres URL strony i oczyścimy go, aby usunąć wszelkie typowe parametry marketingowe lub identyfikatory śledzące.

W przypadku integracji zewnętrznych, takich jak WordPress, nasza wtyczka zwykle użyje identyfikatora, który reprezentuje aktualnie wyświetlane informacje jako URL ID, na przykład id artykułu/strony.

Defining a Custom 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ą z rzeczy, do których często będziemy się odnosić w tym dokumencie, jest Interfejs dostosowywania widżetu.

Ten interfejs można wykorzystać do wprowadzenia wielu zmian w widżecie komentarzy bez użycia kodu.

Tworząc regułę dostosowywania, często będziemy chcieli, aby dotyczyła wszystkich stron naszej witryny. Jednak w niektórych przypadkach chcemy spersonalizować widżet komentarzy na konkretnej stronie — na przykład zastosować niestandardowe style lub sprawić, że komentarze dla tej strony będą anonimowe. Możesz również, na przykład, sprawić, że komentarze na żywo pojawiają się od razu na niektórych stronach, podczas gdy na innych są ukryte pod przyciskami powiadomień.

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

URL ID Input in The Widget Customization Page

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

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

Pułapki

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

FastComments został zaprojektowany z myślą o możliwościach dostosowywania. Sam widget komentarzy działa wewnątrz iframe ze względów bezpieczeństwa, więc aby zastosować niestandardowe style, musisz postępować według jednego z dwóch podejść.

Pierwsze, najłatwiejsze podejście i przez nas preferowane, to skorzystanie ze strony dostosowywania widgetu.

W stronie dostosowywania widgetu zobacz sekcję "Show Advanced Options", pod którą znajduje się obszar oznaczony jako "Custom CSS":

Custom CSS Input Area

To podejście ma pewne zalety:

1. Wprowadzony CSS jest minifikowany przed wysłaniem do użytkownika, a formatowanie pozostaje spójne w interfejsie edycji.
2. Otrzymujesz wszystkie korzyści z interfejsu personalizacji widgetu, na przykład łatwe dostosowywanie widgetu komentarzy w różny sposób dla różnych witryn.
3. Gdy wprowadzimy zmiany w widgetcie komentarzy, Twoje niestandardowe style zostaną przetestowane w ramach naszego procesu wydawniczego.

Drugie podejście 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 to ograniczenia:

1. Istnieje limit ilości niestandardowego CSS, który można przesłać, 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ć zaletą, a nie wadą.
3. W tym przypadku istnieje dodatkowy narzut polegający na wysyłaniu niestandardowego CSS przez sieć dwukrotnie, ponieważ musi on zostać wysłany do naszych serwerów, a następnie zwrócony w zawartości iframe. Jednak dla większości rozmiarów danych przesyłanych nie jest to zauważalne.
4. Częstą optymalizacją jest minifikacja CSS, aby zmniejszyć jego rozmiar przesyłany przez sieć — przy tym podejściu musisz się tym jednak zająć samodzielnie.
5. Twój niestandardowy CSS nie będzie przez nas testowany przy wprowadzaniu zmian.

Zewnętrzne pliki CSS

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

Zaleca się umieszczenie @import w regule dostosowującej. W ten sposób, jeśli kiedykolwiek będziemy musieli wprowadzić zmianę w widgetcie komentarzy, możemy użyć naszych narzędzi automatyzacji do weryfikacji Twojej konfiguracji. Na przykład utworzyłbyś regułę dostosowania w interfejsie personalizacji widgetu, kliknął Advanced i wpisał w Custom CSS:

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

W kodzie - niezalecane

Możesz też załadować zewnętrzny plik CSS za pomocą właściwości 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

Pamiętaj jednak, że jeśli to zrobisz, Twój CSS nie będzie przez nas testowany.

Stylowanie modala profilu użytkownika

Modalne okna profili użytkowników również można stylować za pomocą niestandardowego CSS. Jednak aby zapewnić zastosowanie niestandardowego stylowania do profili użytkowników, wszystkie selektory CSS muszą być poprzedzone prefiksem .user-profile. Bez tego prefiksu niestandardowe style będą ignorowane dla modalnych okien 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

Kompatybilność wsteczna

W FastComments wiemy, że nasi klienci dostosowują widget komentarzy. To jest zamierzone — ostatnią rzeczą, jakiej chcemy, jest powodowanie niezgodności w projekcie Twojego produktu.

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

Jeśli znajdziemy drobne problemy, zaktualizujemy Twoje konto, aby zapewnić płynność wydania. Jeśli zauważymy poważne zmiany łamiące kompatybilność, pozwala 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

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

Możesz nadpisać pojedynczy element tekstu, na przykład przycisk wysyłania, lub cały tekst w całym widżecie komentarzy.

Domyślnie tekst w widżecie komentarzy jest tłumaczony na podstawie ustawień regionalnych użytkownika. Możemy jednak nadpisać tekst, jeśli jesteśmy pewni że nasza baza użytkowników używa tego samego regionu/języka, na przykład:

Custom Text

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 w zakładce "zaawansowane opcje".

Istnieje jednak prostszy sposób, przez interfejs dostosowywania widżetu. Tam możemy po prostu znaleźć tekst, który pokazuje się w widżecie komentarzy w lokalizacji EN_US i określić zamiennik.

Custom Text

Wszystkie nadpisania tłumaczeń obecnie dotyczą wszystkich lokalizacji.

Gdy użytkownik po raz pierwszy komentuje za pomocą FastComments, spróbujemy pobrać jego awatar z http://gravatar.com/.

Jeśli jednak nie znajdziemy awatara lub użytkownik nigdy go nie ustawił w swoim koncie, wyświetlamy statyczny domyślny obraz awatara.

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

Override The Default Avatar

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 użycia kodu. Na stronie dostosowywania widżetu zobacz sekcję "Domyślny Avatar".

Customizing The Default Avatar

Należy pamiętać, że definiowanie awatara dla konkretnego użytkownika, na przykład w przypadku SSO, jest omówione w osobnej sekcji.

Awatary można całkowicie usunąć z widżetu komentarzy, nawet jeśli użytkownicy ustawili 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 użycia kodu, na stronie dostosowywania widżetu:

Ukrywanie awatarów

W przypadku większych projektów z niestandardowym stylem może być pożądane rozpoczęcie od zera i całkowite zrezygnowanie z domyślnych stylów.

Wszystkie domyślne style 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 użycia kodu, na stronie dostosowywania widgetu, w sekcji Opcje zaawansowane:

Disabling All Default Styles

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

Można to skonfigurować tak, aby użytkownik musiał kliknąć "Pokaż odpowiedzi" przy 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

To można dostosować bez użycia kodu, na stronie personalizacji widżetu:

Collapse Replies

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, po włączeniu tego ustawienia zobaczysz:

• Zobacz komentarz najwyższego poziomu.
• Zobacz "Pokaż odpowiedzi (29)" pod tym komentarzem.

Jeśli chcesz wyświetlić wszystkie komentarze najwyższego poziomu w połączeniu z tą opcją, ustaw stronę początkową na -1.

Domyślnie funkcje formatowania w FastComments są realizowane przez dodawanie widocznych znaczników kotwic, takich jak <b></b>, wokół twojego tekstu. Kliknięcie paska narzędzi lub użycie skrótów wykonuje to za Ciebie. Jednak niektóre społeczności mogą chcieć włączyć korzystanie z formatowania bez widocznych znaczników kotwic. Nazywa się to włączeniem edytora WYSIWYG (co widzisz, to dostajesz). Ten edytor wygląda dokładnie tak samo jak domyślny, z wyjątkiem tego, że ładuje pewien dodatkowy kod, który pozwala użytkownikom pogrubiać, podkreślać itp. tekst bez widocznych znacznikó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ę "Włącz zaawansowane formatowanie".

Enable WYSIWYG

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

This toolbar can be disabled in code or with the Customization UI.

Disabling The Toolbar

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

To można również zrobić bez użycia kodu. Na stronie dostosowywania widżetu zobacz opcję "Wyłącz pasek narzędzi odpowiedzi".

Disabling The Toolbar

Domyślnie FastComments pozwala użytkownikom blokować innych użytkowników. Zablokowanie użytkownika spowoduje, że jego komentarze będą ukryte, zapobiegnie wysyłaniu powiadomień między tymi użytkownikami i tak dalej.

Może zaistnieć potrzeba wyłączenia tej funkcjonalności. Można to zrobić w następujący sposób:

Disable Blocking

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 użycia kodu, co dodatkowo umożliwia poprawną walidację po stronie serwera, za pomocą interfejsu dostosowywania widżetu:

Disable Blocking

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

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

Use Absolute 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 "absoluteDates": true

8}];

9</script>

10

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

Use Absolute Dates

Domyślnie używane są zlokalizowane daty względne. Na przykład obok niedawno dodanego komentarza możesz zobaczyć "11 minutes ago".

Może być konieczne lub pożądane zachowanie tego formatu daty względnej, a 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 użycia kodu, na stronie dostosowywania widżetu, w sekcji Zaawansowane opcje. Najpierw musisz włączyć Daty absolutne, aby zobaczyć tę opcję w interfejsie użytkownika.

Use Both Absolute and Relative Dates

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

Nazywamy to nagłówkiem, który jest domyślnie 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 użycia kodu, na stronie dostosowywania widżetu, w Opcjach zaawansowanych:

Specifying Header HTML

Domyślnie FastComments będzie renderować linki w ten sposób: https://exmaple.com - gdzie adres URL linku staje się klikalnym elementem kotwicy HTML.

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

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

Render Links as Text

Domyślnie FastComments renderuje pole wprowadzania komentarza i wątek komentarzy jednocześnie. Aby zaoszczędzić trochę pionowej przestrzeni, ukrywa także wszelkie inne wymagane pola, dopóki nie nastąpi interakcja z widgetem.

Jednak widget komentarzy można ukryć za przyciskiem, na przykład:

Click to Show Comments

Przycisk używa różnych przetłumaczonych tekstów w zależności od tego, czy komentarze są aktualnie widoczne, czy nie. Jeśli komentarze są ukryte, używa translations.SHOW_COMMENTS_BUTTON_TEXT. Jeśli komentarze są widoczne, używa translations.HIDE_COMMENTS_BUTTON_TEXT. Tłumaczenia mogą zawierać tekst [count], który zostanie zastąpiony przez zlokalizowaną 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 zostało zaprojektowane, aby 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.

Funkcję tę można włączyć bez użycia kodu, tworząc regułę dostosowywania i włączając "Kliknij, aby wyświetlić komentarze":

Enable Click to Show Comments

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

Można ją zastąpić dowolnym ciągiem tekstowym, a wartość [count] zostanie zastąpiona faktyczną liczbą, zlokalizowaną dla użytkownika.

Customizing The Comment Count Text

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 użycia kodu, na stronie dostosowywania widżetu:

Customizing The Comment Count Text

Kiedy użytkownicy wpisują hashtagi, w formie #someexampletag, FastComments automatycznie utworzy ten HashTag i wyróżni go w ich komentarzu.

W niektórych przypadkach pożądane jest wyłączenie tej funkcji lub kontrola, które hashtagi mogą być używane za pomocą API.

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

Disabling Automatic HashTag Creation

Domyślnie FastComments pokaże ikonę dzwonka powiadomień w prawym górnym rogu obszaru komentarzy.

Ten dzwonek zmieni kolor na czerwony i pokaże liczbę powiadomień użytkownika. Przykładowe powiadomienia to:

• Użytkownik odpowiedział Ci.
• Użytkownik odpowiedział w wątku, w którym skomentowałeś(-aś).
• Użytkownik zagłosował pozytywnie na Twój komentarz.
• Użytkownik odpowiedział na stronie, którą subskrybujesz.

Dzwonek powiadomień umożliwia również subskrybowanie całej strony.

Można jednak 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

To można również zrobić bez użycia kodu. Na stronie dostosowywania widżetu zobacz sekcję "Wyłącz dzwonek powiadomień".

Disable Notification Bell

Domyślnie FastComments pokaże profil użytkownika, gdy klikniesz jego awatar.

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

Disable Profiles

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 również zrobić bez kodu. Na stronie dostosowywania widgetu zobacz sekcję "Wyłącz profile".

Disable Profiles

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

Disable Success Message

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 również zrobić bez użycia kodu. Na stronie dostosowywania widżetu:

Disable Success Message

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ą UI. W kodzie możemy to zrobić w następujący sposób:

Set Gif Rating

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 UI znajdziesz to pod Gif Picker Rating, o ile Disable Image Uploads? nie jest zaznaczone.

Setting The Gif Rating

Domyślnie widżet komentarzy FastComments ma moderowanie zawartości obrazów ustawione na off.

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

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

Setting The Image Content Moderation Level

Domyślnie FastComments wyświetla opcje głosowania jako strzałki w górę i w dół, umożliwiając użytkownikom oddanie głosu za lub przeciw komentarzowi.

Jednak można zmienić styl paska narzędzi głosowania. Obecne opcje to domyślne przyciski W górę/W dół lub użycie mechanizmu głosowania w stylu serca.

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

Enable Heart Button

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 zrobienie tego bez kodu, ponieważ włącza to również walidacje po stronie serwera. Na stronie dostosowywania widżetu zobacz sekcję "Vote Style".

Change Voting Style

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żna temu zapobiec.

Na stronie dostosowywania widżetu zobacz opcję "Disable Deleting".

Disable Comment Deleting

• To dotyczy tylko zwykłych komentujących, a nie moderatorów ani administratorów, którzy nadal będą mogli usuwać.
• To będzie miało również wpływ na integracje API w przypadku przekazania contextUserId.

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

Jednak można temu zapobiec.

Na stronie dostosowywania widżetu zobacz opcję "Wyłącz edycję".

Disable Comment Editing

• To dotyczy tylko zwykłych komentujących, a nie moderatorów ani administratorów, którzy nadal będą mogli edytować.
• To będzie miało również wpływ na integracje API, gdy zostanie przekazane contextUserId.

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

Rozmiar strony można dostosować w Interfejsie konfiguracji widżetu w różnych rozmiarach od 10 do 200.

Zwróć uwagę, ż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 przedstawiona jest poniżej:

Custom Page Sizes

Rozmiary stron można dostosować globalnie, dla domeny lub dla konkretnej strony, tworząc różne reguły dostosowań.

To wpłynie na wszystkich klientów, integracje i frameworki, których możesz używać do wyświetlania komentarzy za pomocą naszej platformy.

Domyślnie FastComments pokaże nazwę użytkownika tak, jak ją wprowadził, lub tak, jak została przekazana przez SSO.

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

Można to zrobić bez kodu w Widget Customization UI, w ustawieniu o nazwie Commenter Name Format:

Change Name Format

Dostępne formaty to:

• Capitalize (wyświetla Example User jako Example User)
• Last Initial (wyświetla Example User jako Example U.)
• All Initials (wyświetla Example User jako E. U.)
• Pokaż "Anonim"

Efekt tej zmiany jest natychmiastowy. Użytkownicy nadal będą widzieć swoją pełną nazwę użytkownika na górze obszaru komentarzy, dla siebie, ale ich komentarze będą pokazywać zmodyfikowaną nazwę użytkownika.

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

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

Disabling Image Uploads

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 pisania kodu, na stronie personalizacji widgetu:

Disabling Image Uploads

Domyślnie w widżecie komentarzy nie jest wyświetlane pole wyszukiwania.

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

Enabling Search

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 także zrobić bez użycia kodu. Na stronie personalizacji widżetu zobacz opcję "Enable Search Box".

Enable Search Box

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 również zrobić bez kodu. Na stronie dostosowywania widżetu zobacz opcję "Włącz spoilery".

Enable Spoilers

Gdy tekst jest zaznaczony, a teraz widoczny przycisk SPOILER zostanie kliknięty, tekst zostanie zamaskowany aż do momentu, gdy użytkownik najedzie na niego kursorem. W trybie ciemnym robimy to samo, używając innych kolorów, które lepiej pasują do trybu ciemnego.

Jest to również zgodne z edytorem WYSIWYG.

Domyślnie FastComments nie śledzi, kto obejrzał dany komentarz ani nie dostarcza żadnych statystyk w tym zakresie.

Możemy jednak włączyć tę funkcję — wówczas system zacznie śledzić, gdy użytkownik przewinie do komentarza.

Kiedy to nastąpi, licznik obok ikony oka 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 liczników 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 personalizacji widżetu:

Włączanie liczników wyświetleń komentarzy

Śledzimy user id* osoby, która obejrzała komentarz, dzięki czemu ponowne obejrzenie komentarza przez tę samą osobę nie zwiększa licznika. Jeśli komentarz zostanie obejrzany ponownie po upływie dwóch lat, licznik zostanie ponownie zwiększony.

• *Uwaga: albo anon session id, albo user's IP jako wartość haszowana.

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

Jednak domyślnie nowe komentarze pojawią się pod dynamicznie wyświetlanym przyciskiem z tekstem podobnym do "Pokaż 2 nowe komentarze".

Jeżeli nowe komentarze są odpowiedziami bezpośrednio do strony, przycisk pojawi się u góry wątku komentarzy. Jeśli są odpowiedziami na konkretny komentarz, przycisk pojawi się pod tym komentarzem.

Ma to zapobiec ciągłej zmianie rozmiaru strony dla użytkownika, co może powodować frustrację przy próbie chwycenia paska przewijania.

W niektórych przypadkach użycia, takich jak licytacje na żywo, lub wydarzenia online, takie zachowanie nie jest pożądane - możesz chcieć, aby widżet komentarzy był bardziej jak pole "chat", gdzie nowe komentarze "pokazują się od razu".

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

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

Show Live Comments Right Away

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:

Show Live Comments Right Away

Domyślnie w FastComments komentowanie na żywo jest włączone.

Oznacza to, że każdy widz wątku komentarzy powinien widzieć tę samą zawartość.

Na przykład, jeśli komentarz zostanie dodany, ten komentarz powinien się pojawić. Jeśli komentarz zostanie edytowany lub usunięty, to komentarze te zostaną edytowane lub usunięte dla wszystkich widzów wątku. To samo dotyczy głosów i wszystkich działań moderacyjnych.

Jednakże 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

To można też zrobić bez użycia kodu. Na stronie dostosowywania widżetu zobacz sekcję "Disable Live Commenting".

Disable Live Commenting

Domyślnie FastComments sortuje komentarze według kierunku sortowania „Most Relevant”.

Sortowanie „Most Relevant” bierze pod uwagę czas dodania komentarza oraz liczbę głosów przy ustalaniu kolejności.

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

Możemy jednak ustawić domyślny kierunek na dowolny z tych trzech. Na przykład, jeśli chcesz pokazywać najpierw najstarsze komentarze:

Changing The Default Sort To Oldest First

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 na najnowsze najpierw, zrobimy następująco:

Changing The Default Sort To Newest First

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: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

Można to także zrobić bez użycia kodu. Na stronie dostosowywania widżetu zobacz sekcję „Domyślny kierunek sortowania”.

Changing The Default Sort Direction

Zauważ, ż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 pole wpisywania komentarza znajduje się przed wątkiem komentarzy. Jednak ustawiając ten parametr konfiguracji na true możemy przenieść je po.

Moving The Reply Box to The Bottom

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 widżetu:

Moving The Reply Box to The Bottom

Maksymalna liczba znaków, które można wprowadzić w polu komentarza, może być ograniczona przez parametr maxCommentCharacterLength.

Wartość domyślna to 2000.

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

Limit Comment Length

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 użycia kodu, na stronie dostosowywania widżetu:

Limit Comment Length

Domyślnie FastComments pozwala użytkownikowi wpisać komentarz składający się z dowolnej liczby wierszy, aż do domyślnego limitu znaków.

Jednakże może być pożądane ograniczenie użytkownika do wpisania tylko jednej linii tekstu. Przykładowe zastosowania to aukcje online lub czat na żywo, do których FastComments może być użyty.

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

Enable Single-Line Comment Input

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 również zrobić bez kodu. Na stronie dostosowywania widżetu zobacz sekcję "Włącz jednolinijkowe pole komentarza".

Enable Single-Line Comment Input

Należy pamiętać, ż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 przesłać do 5 comments w tej samej minucie.

To jest śledzone na podstawie user id, anon user id i ip address (hashed).

Można to dostosować bez użycia kodu, na stronie konfiguracji widgetu:

Limiting Comment Volume Per User

Uwaga: jeśli używasz comment creation API, możesz chcieć przekazać oryginalny adres ip użytkownika w żądaniu do naszego backendu, aby rate limiting był stosowany per user, a nie globalnie dla twojego konta.

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

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

Przepływ wygląda tak:

Bezpieczny przepływ SSO

Ponieważ Secure SSO obejmuje rozwój full-stack, pełne działające przykłady kodu w Java/Spring, NodeJS/Express i czystym PHP są obecnie na GitHub.

Chociaż w przykładzie NodeJS używamy ExpressJS, a w przykładzie Java używamy Spring, w tych środowiskach uruchomieniowych nie są wymagane żadne frameworki/biblioteki do implementacji FastComments SSO — działają natywne pakiety kryptograficzne.

Nie musisz tworzyć żadnych nowych punktów końcowych API przy użyciu FastComments SSO. Po prostu zaszyfruj informacje użytkownika za pomocą swojego klucza sekretnego i przekaż ładunek do widgetu komentarzy.

Pobierz swój tajny klucz API

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

Parametry widgetu komentarzy

Wysokopoziomowa dokumentacja API dla widgetu komentarzy jest dostępna tutaj.

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

Widget komentarzy przyjmuje obiekt konfiguracyjny — przekazujesz go już, 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 w Base64.
• verificationHash: HMAC-SHA256 hash utworzony z UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Znacznik czasu epoch w milisekundach. Nie może być w przyszłości ani starszy niż dwa dni wstecz.
• loginURL: URL, który widget komentarzy może wyświetlić, aby zalogować użytkownika.
• logoutURL: URL, który widget komentarzy może wyświetlić, aby wylogować użytkownika.
• loginCallback: Gdy jest podany zamiast loginURL, funkcja, którą widget komentarzy wywoła po kliknięciu przycisku logowania.
• logoutCallback: Gdy jest podany zamiast logoutURL, funkcja, którą widget 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": 1768890093578,

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

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

13 }

14}];

15</script>

16

The User Object

The User object contains the following schema:

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ć unikalny. **/

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 prowadzić do tego adresu. **/

20 websiteUrl?: string;

21 /** Opcjonalne. Do 100 grup na użytkownika. ID grupy nie może mieć więcej 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ę "activity" 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ć wysyłanie prywatnych wiadomości do tego użytkownika. **/

32 isProfileDMDisabled?: boolean;

33}

34

Moderatorzy i administratorzy

Dla administratoró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. 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 (w przeciwieństwie do samych powiadomień w aplikacji), ustaw optedInSubscriptionNotifications na true.

Użytkownicy VIP i specjalne etykiety

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

Niezalogowani użytkownicy

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

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

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

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

Rozumiemy, że każda integracja może być skomplikowana i uciążliwa. 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ę do innej platformy.

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

Zmieniając ustawienie, możemy zabronić pobierania komentarzy, chyba że robi to administrator lub prawidłowy użytkownik SSO.

Konfiguracja bez kodu

Możemy uniemożliwić przeglądanie i interakcję z naszymi wątkami komentarzy, gdy SSO jest skonfigurowane, tworząc regułę dostosowywania.

When doing so, search for SSO, and you will find this option:

Require SSO To View Comments

Włącz tę opcję i zapisz regułę dostosowywania.

Ochrona wybranej domeny lub strony

Aby chronić tylko określoną Domain lub Page, po prostu skonfigurujemy regułę dostosowywania tak, aby to robiła.

Na górze interfejsu dostosowywania znajdziemy dwa pola wejściowe, Domain i URL ID.

Aby chronić konkretną domenę, wpisz daną domenę w pole "domain".

Aby chronić konkretną stronę, wpisz adres URL strony w polu "URL ID". Jeśli masz niestandardową integrację z FastComments, możesz zamiast URL wpisać tutaj inny typ identyfikatora.

Poziomy zabezpieczeń

Decydując się na wymaganie SSO, będziesz chciał zdecydować, czy wymagasz Simple SSO czy Secure SSO. Jeśli wymagasz Simple SSO, obie metody są dozwolone, ale jeśli wymagasz Secure SSO, to zawartość musi być pobrana z Secure SSO payload zahaszowanym Twoim API key, aby mogła być wyświetlona.

Opcja poziomu zabezpieczeń pojawi się, gdy wybierzesz "Require SSO To View Comments".

Ochrona wykraczająca poza odczyt

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

Uwaga

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

Domyślnie FastComments będzie wymagać adresu e-mail, aby komentować. Nie musi to być prawidłowy adres e-mail, jednak dopóki użytkownik nie kliknie wysłanego do niego linku, jego komentarz będzie oznaczony etykietą "Niezweryfikowany komentarz".

Możemy jednak usunąć wymóg podawania adresu e-mail. Pole do wprowadzania adresu e-mail nadal będzie wyświetlane, ale nie będzie już wymagane.

Można to skonfigurować w interfejsie dostosowywania widżetu:

Enabling Anonymous Comments

FastComments można skonfigurować tak, aby usuwał niezweryfikowane komentarze po określonej liczbie dni. To pomaga zwalczać spam.

Domyślnie tego nie robi.

Można to skonfigurować lub wyłączyć na stronie Ustawienia moderacji.

Moderation Settings

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

Spowoduje to utworzenie dla tego użytkownika "unverified session", a my poprosimy go o zweryfikowanie tej sesji za pomocą e-maila.

W przypadku niektórych witryn lub aplikacji pożądane jest, aby nie prosić użytkownika o adres e-mail podczas komentowania lub głosowania.

Włączenie anonimowego komentowania sprawia, że pole wprowadzania adresu e-mail staje się opcjonalne. Jednak można je całkowicie wyłączyć. Najpierw włącz anonimowe komentowanie, a następnie pojawi się opcja wyłączenia pól wprowadzania adresu e-mail.

Disable Email Inputs

Po włączeniu tej opcji pola e-mail nie będą w ogóle wyświetlane we wszystkich naszych produktach komentowania.

Zauważ, że przy takiej 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 „niezweryfikowane”.

Domyślnie FastComments pokaże etykietę "Niezweryfikowany komentarz" dla komentarzy, które zostały zostawione dla użytkownika, który ma niezweryfikowaną sesję przeglądarki. Więcej informacji o komentowaniu bez weryfikacji znajdziesz tutaj.

Disable The Unverified Label

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 zastosować bez pisania kodu w interfejsie personalizacji:

Disable The Unverified Label

Gdy 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ąć ten wymóg, pozwalając każdemu głosować na komentarz bez podawania jakichkolwiek informacji.

Allow Anonymous Votes

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

W przypadku anonimowego komentowania czasami warto zdefiniować domyślną nazwę użytkownika, aby zmniejszyć bariery przy komentowaniu. Można to zrobić w interfejsie personalizacji. Anonimowe komentowanie musi być najpierw włączone.

Setting The Default Username

Domyślnie FastComments wyświetla widżet komentarzy w lokalizacji (locale) określonej przez system i przeglądarkę użytkownika.

Gdy użytkownik doda komentarz lub się zaloguje, aktualizujemy jego ostatnio używaną lokalizację i wykorzystujemy ją również do wysyłania e‑maili.

Ma to wpływ na sposób, w jaki widżet komentarzy jest tłumaczony dla użytkownika. Locale składa się z języka i regionu użytkownika, więc skonfigurowanie locale\nzazwyczaj zmieni język używany do wyświetlania tekstu.

Via The UI

Można to zdefiniować za pomocą interfejsu dostosowywania widżetu. Zobacz opcję "Locale / Language":

Changing The Locale / Language

Via Code

Można to nadpisać, ustawiając żądane locale.

Manually Defining the User's Locale

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 locale znajdziesz tutaj.

SSO Note

Jeśli używasz SSO, warto przekazać locale użytkownika w obiekcie użytkownika, aby e‑maile i inne treści były dla użytkownika poprawnie zlokalizowane.

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

Może być pożądane ograniczenie języków używanych przez społeczność.

Można to skonfigurować bez użycia kodu, na stronie dostosowywania widżetu:

Allowed Languages

System przeanalizuje ich komentarz i określi jego język, a następnie porówna go z listą dozwolonych języków.

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

Komentowanie można zablokować, tak aby nie można było zostawiać nowych komentarzy ani głosów, ustawiając flagę readonly na true.

Komentarze również nie będą 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 widżetu, dla całej domeny lub pojedynczej strony:

Making The Comment Thread Readonly

Aktualizacja!

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

To uniemożliwi dodawanie nowych komentarzy, jednocześnie umożliwiając głosowanie oraz pozwalając użytkownikom usunąć swoje komentarze, jeśli chcą, natomiast readonly tego nie pozwala.

To odpowiada polu isClosed w API Page.

Domyślnie FastComments pozwala na umieszczanie linków do dowolnych zewnętrznych stron.

Można to ograniczyć do określonej listy stron lub domen. Próba opublikowania linku do strony lub domeny, której nie ma na zdefiniowanej liście, spowoduje wyświetlenie użytkownikowi komunikatu o błędzie.

Ta walidacja dotyczy tylko widżetu komentarzy i API. Importy nie są objęte.

To odbywa się bez kodu, na stronie dostosowywania widżetu:

Restrict External Link Domains

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

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

Możemy włączyć wyświetlanie dodatkowego pola do wprowadzenia adresu 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

Po podaniu tego adresu URL konto użytkownika zostanie zaktualizowane, a nazwa użytkownika we wszystkich wcześniejszych i przyszłych komentarzach będzie prowadzić do tego adresu URL.

To można dostosować bez użycia kodu, na stronie dostosowywania widżetu:

Enabling Commenter Links

Lista identyfikatorów wygenerowanych na stronie Grupy moderacji.

Jeśli zostanie określone, komentarze dodane przy użyciu tej konfiguracji będą zawierać ten sam zestaw moderationGroupIds.

Jeśli Moderator ma zdefiniowaną jedną lub więcej [Grupy moderacji], zobaczy on tylko komentarze na stronie Moderate Comments powiązane z jego grupą(ami).

Specify Moderation Groups

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

W celu uwierzytelniania FastComments wymaga włączenia cookies stron trzecich w Twojej przeglądarce. Bez nich użytkownicy zawsze będą musieli zostawić swój adres e‑mail, aby skomentować (chyba że pole adresu e‑mail jest ukryte), a ich komentarze będą zawsze wyświetlane jako niezweryfikowane (domyślnie).

Aby to obejść, możesz włączyć mechanizm obejścia cookies stron trzecich.

Po włączeniu tego ustawienia pojawi się małe okienko popup informujące, że użytkownik jest logowany. To okienko pojawia się zawsze, 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:

Enabling Third-Party Cookie Bypass

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 to także skonfigurować przez interfejs dostosowywania widżetu, w sekcji Enable Third-Party Cookie Popup:

Enabling Third-Party Cookie Bypass

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

Możesz ograniczyć to w następujący sposób:

• Zamiast tego zanonimizuj usunięty komentarz (ustaw name i text na [deleted] lub wartość niestandardową).
• Nie pozwalaj na usuwanie komentarzy, gdy istnieją odpowiedzi. Wyświetlany jest konfigurowalny komunikat o błędzie.
• Ogranicz możliwość usuwania komentarzy z odpowiedziami tylko do administratorów i moderatorów.

To można skonfigurować w sekcji Comment Thread Deletion w interfejsie dostosowywania widżetu.

Customize Delete Behavior for Replies

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

Możemy jednak wyświetlić odznaki użytkowników obok ich nazwy nad formularzem komentarza, włączając tę funkcję na stronie dostosowywania widżetu:

Show Badges in Top Bar Option

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

Uwaga: ta funkcja musi być włączona w interfejsie dostosowywania widżetu, aby działała. Opcjonalnie możesz ustawić flagę showBadgesInTopBar na false w konfiguracji kodu, aby selektywnie ją wyłączyć 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