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

W FastComments cały tekst w widżecie komentarzy można dostosować.

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.

Dotyczy to własnego tekstu widżetu. Aby przetłumaczyć komentarze pisane przez Twoich gości, zobacz Comment Translation.

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

Domyślnie FastComments nie zezwala na ramki iframe w komentarzach. Po włączeniu osadzania mediów komentujący mogą wkleić kod osadzania (fragment <iframe>) z zaufanych dostawców, takich jak YouTube, Vimeo, SoundCloud i Spotify, i zostanie on wyrenderowany w komentarzu.

Ze względów bezpieczeństwa nie jest to flaga konfiguracji widżetu po stronie klienta. To ustawienie po stronie serwera, walidowane przy zapisie każdego komentarza, więc nie można go włączyć ze strony. Dozwolone są tylko ramki iframe wskazujące na wbudowaną listę zaufanych dostawców. Każda inna ramka iframe jest usuwana.

Robi się to bez kodu, na stronie dostosowywania widżetu:

Zezwalaj na osadzanie mediów

Dodawanie własnych dostawców

Jeśli chcesz zezwolić na osadzanie od dostawcy, którego nie ma na wbudowanej liście zaufanych, dodaj jego nazwę hosta w polu "Additional Embed Domains" na tej samej stronie. Te nazwy hostów są dozwolone dodatkowo do wbudowanych dostawców. Dopasowanie jest dokładne, więc podaj pełną nazwę hosta (na przykład player.example.com). Wszystko, czego nie wymienisz, pozostaje zablokowane.

Zarówno zwykłe pole komentarza, jak i edytor WYSIWYG obsługują wklejanie osadzenia. W edytorze WYSIWYG osadzenie jest wstawiane jako blok, który można usunąć.

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 obejrzał każdy komentarz ani nie dostarcza żadnych statystyk na ten temat.

Możemy jednak 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 lokalizacją 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 przez tydzień, tak aby przy ponownym obejrzeniu komentarza w tym tygodniu licznik się nie zwiększał. Jeśli obejrzysz komentarz ponownie po upływie tygodnia, licznik zwiększy się ponownie.

• *Uwaga: lub anonimowy identyfikator sesji, albo IP użytkownika jako wartość haszowaną.

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

Ankiety pozwalają komentatorom dołączyć pytanie z 2 do 10 opcji do komentarza. Każdy na stronie głosuje w miejscu i widzi, jak wyniki aktualizują się na żywo.

Ankiety są domyślnie wyłączone. Zaznacz Enable Polls w ustawieniach dostosowywania widgetu, aby dodać przycisk ankiety do paska narzędzi komentarza. Następnie pojawiają się dwa dodatkowe ustawienia:

• Who Can Create Polls: Tylko administratorzy/moderatorzy (domyślnie) lub wszyscy.
• Allow Anonymous Poll Votes: gdy odznaczone (domyślnie), tylko zalogowani użytkownicy mogą głosować.

Włącz ankiety

Zobacz Przewodnik po ankietach, aby dowiedzieć się, jak działają tworzenie, głosowanie, prywatność i powiadomienia o ankietach.

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": 1794130022542.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.

Dzięki Simple SSO możemy przekazać widgetowi komentarzy informacje o użytkowniku, dzięki czemu nie będzie musiał podawać swojej nazwy użytkownika ani adresu e-mail, aby komentować.

Simple SSO możemy skonfigurować w następujący sposób:

Simple SSO

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 "simpleSSO": {

8 "username": "Bob",

9 "email": "bob@example.com",

10 "avatar": "https://example.com/bob.png",

11 "websiteUrl": "https://example.com/profiles/bob",

12 "displayName": "Bob's Name",

13 "displayLabel": "VIP User",

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

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

16 "badgeConfig": {

17 "badgeIds": [

18 "badge-id-1",

19 "badge-id-2"

20 ],

21 "pageBadgeIds": [

22 "badge-id-3"

23 ],

24 "override": false

25 }

26 }

27}];

28</script>

29

Użytkownik zostanie zalogowany, a w tle zostanie utworzony użytkownik SSO. Jeśli użytkownik zostanie pobrany przez API, będzie miał createdFromSimpleSSO ustawione na true.

Uwagi:

• Adres e-mail jest unikalnym identyfikatorem dla Simple SSO.
• Podanie adresu e-mail w Simple SSO nie jest wymagane, jednak domyślnie komentarze użytkownika będą wyświetlane jako "Niezweryfikowane". Jeśli nie podano adresu e-mail, użytkownik nie może zostać w pełni uwierzytelniony.
• NOWOŚĆ Od stycznia 2022: nazwy użytkowników nie muszą być unikalne w całym fastcomments.com
• Simple SSO może automatycznie tworzyć i aktualizować użytkowników SSO, jeśli podano adres e-mail, a użytkownik nie został pierwotnie utworzony przez Secure SSO. Jeśli payload Simple SSO wskazuje użytkownika utworzonego przez Secure SSO lub API, ten użytkownik pozostaje nietknięty, a odwiedzający otrzymuje osobnego użytkownika.
• Możesz określić odznaki dla użytkownika za pomocą właściwości badgeConfig. Tablica badgeIds zawiera identyfikatory globalnych odznak do przypisania użytkownikowi. Tablica pageBadgeIds zawiera identyfikatory odznak ograniczonych do bieżącej strony (urlId) — te odznaki są wyświetlane tylko na stronie, na której zostały przypisane. Jeśli override jest ustawione na true, zastąpi istniejące wyświetlane odznaki (globalne i ograniczone do strony są nadpisywane niezależnie); jeśli false, odznaki zostaną dodane do istniejących.

Ustawienia Simple SSO

Simple SSO jest zawsze dostępne. Dwa ustawienia kontrolują, jak bardzo FastComments mu ufa. Możesz je znaleźć, wyszukując SSO w regule dostosowywania. Oba są domyślnie wyłączone i obowiązują niezależnie od tego, czy opcja "Require SSO To View Comments" jest włączona.

Konta, które już używały Simple SSO przed dodaniem tych ustawień, mają oba włączone, więc nic się dla nich nie zmieniło.

Stosuje się tylko reguła dostosowywania najlepiej dopasowana do danej strony, więc jeśli masz więcej niż jedną regułę, ustaw je w każdej z nich. Nowa reguła zaczyna z nimi włączonymi, jeśli którakolwiek z Twoich innych reguł ma je włączone.

Automatyczna weryfikacja komentarzy przez Simple SSO

Gdy to ustawienie jest włączone, komentarze od użytkowników Simple SSO są od razu weryfikowane.

Gdy jest wyłączone, komentarze od użytkowników Simple SSO wyświetlają się jako "Niezweryfikowane", dopóki użytkownik nie kliknie linku, który wysyłamy e-mailem na adres z payloadu Simple SSO. Jeśli automatycznie zatwierdzasz tylko zweryfikowane komentarze, one również czekają na ten link. Jeśli w payloadzie nie ma adresu e-mail, komentarz pozostaje niezweryfikowany.

To ustawienie dotyczy tylko komentarzy. Głosy od użytkowników Simple SSO są zawsze liczone od razu.

Zezwalaj na administratorów Simple SSO

Gdy to ustawienie jest włączone, użytkownik Simple SSO może być administratorem lub moderatorem Twojego konta:

• Użytkownik Simple SSO, który ma uprawnienia administratora lub moderatora, je zachowuje.
• Użytkownik Simple SSO z tym samym adresem e-mail co jeden z Twoich administratorów lub moderatorów przejmuje ich uprawnienia.

Gdy to ustawienie jest wyłączone, Simple SSO nie nadaje tych uprawnień. Payload Simple SSO wskazujący użytkownika, który je posiada, otrzymuje osobnego użytkownika bez uprawnień, a oryginalny użytkownik pozostaje nietknięty.

Payloady Simple SSO nie są podpisane, więc gdy to ustawienie jest włączone, każdy, kto zna adres e-mail administratora lub jego identyfikator użytkownika, może działać w jego imieniu. Jeśli ma to znaczenie dla Twojej witryny, pozostaw to ustawienie wyłączone i użyj Secure SSO dla swoich administratorów.

Użytkowników utworzonych przez Secure SSO lub API nie można osiągnąć przez Simple SSO, niezależnie od tego, czy to ustawienie jest włączone.

FastComments SSO (szczegóły tutaj) umożliwia Twoim użytkownikom komentowanie bez konieczności logowania się na innej platformie.

Jednak samo to nie zabezpiecza Twoich wątków komentarzy, ponieważ domyślnie dane komentarzy są publicznie dostępnymi informacjami - każdy, kto może wyświetlić stronę, może zobaczyć komentarze.

Zmieniając jedno ustawienie, możemy ograniczyć pobieranie komentarzy tak, aby było to możliwe tylko dla administratora lub ważnego użytkownika SSO.

Konfiguracja bez kodu

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

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

Wymagaj SSO do wyświetlania komentarzy

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

Ochrona tylko określonej domeny lub strony

Aby chronić tylko określoną domenę lub stronę, po prostu skonfigurujemy w tym celu regułę dostosowania.

Na górze interfejsu dostosowania znajdziemy dwa pola: Domain i URL ID.

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

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

Poziomy zabezpieczeń

Przy wymaganiu SSO musisz zdecydować, czy wymagasz Simple SSO czy Secure SSO. Jeśli wymagasz Simple SSO, to oba są dozwolone, ale jeśli wymagasz Secure SSO, to treść musi zostać pobrana z ładunkiem Secure SSO zaszyfrowanym Twoim kluczem API, aby mogła zostać wyświetlona.

Opcja poziomu zabezpieczeń pojawi się po wybraniu "Wymagaj SSO do wyświetlania komentarzy" i działa tylko wtedy, gdy ta opcja jest włączona.

Ustawienia Automatyczna weryfikacja komentarzy przez Simple SSO i Zezwalaj administratorom Simple SSO są osobne i obowiązują niezależnie od tego, czy ta opcja jest włączona.

Ochrona wykraczająca poza odczyt

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

Pułapki

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 wymaga podania adresu e‑mail przy komentowaniu. Nie musi to być prawidłowy adres e‑mail, jednak dopóki użytkownik nie kliknie linku wysłanego do niego,
jego komentarz będzie wyświetlał 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

Nazwa użytkownika jest nadal wymagana. Aby usunąć ten krok, możesz
ustawić domyślną nazwę użytkownika, którą będą dzielić wszyscy, lub pozwolić FastComments
wygenerować unikalną nazwę użytkownika dla każdego odwiedzającego.

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

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

W przypadku anonimowego komentowania czasami pożądane jest zdefiniowanie domyślnej nazwy użytkownika, aby zmniejszyć tarcie przy komentowaniu. Można to zrobić w interfejsie Customization. Najpierw musi być włączone Anonymous Commenting.

Ustawianie domyślnej nazwy użytkownika

Udostępnianie domyślnej nazwy użytkownika

Domyślna nazwa użytkownika to wspólna nazwa wyświetlana, a nie tożsamość. Odwiedzający, który zachowa domyślną nazwę i poda swój adres e-mail, otrzyma własne konto, z domyślną nazwą widoczną jako jego publiczna nazwa. Dowolna liczba odwiedzających może zachować tę samą domyślną nazwę, więc „Anonymous" nigdy nie zostanie zgłoszone jako już zajęte.

Nazwy użytkownika wpisywane samodzielnie przez odwiedzającego nadal muszą być unikalne.

Jeśli wolisz, aby każdy odwiedzający otrzymał unikalną nazwę bez konieczności jej wymyślania, zobacz Automatyczne generowanie nazw użytkowników.

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

Dla niektórych stron proszenie odwiedzającego o wymyślenie unikalnej nazwy użytkownika jest barierą, szczególnie na urządzeniach mobilnych. FastComments może wygenerować neutralną nazwę użytkownika dla każdego nowego odwiedzającego i wstępnie ją wypełnić w polu nazwy użytkownika, np. BraveOtter4172.

Odwiedzający może zostawić ją bez zmian lub zastąpić ją nazwą według własnego wyboru.

Można to włączyć z interfejsu Customization, w ustawieniu o nazwie Generate Usernames Automatically:

Generate Usernames Automatically

Jak to działa

• Każda wygenerowana nazwa jest unikalna. Jest sprawdzana względem istniejących kont i zarezerwowana dla sesji przeglądarki danego odwiedzającego, więc dwóm odwiedzającym nie zostanie zaproponowana ta sama nazwa.
• Nazwa jest generowana tylko dla odwiedzających, którzy jeszcze jej nie mają. Zalogowani użytkownicy, użytkownicy SSO oraz odwiedzający, którzy już komentowali, zachowują swoją istniejącą nazwę.
• Działa z komentowaniem anonimowym lub bez niego (anonymous commenting). Przy wyłączonym komentowaniu anonimowym odwiedzający nadal podaje swój adres e-mail, ale nie musi już wymyślać nazwy użytkownika.
• Powracający odwiedzający, który poda adres e-mail używany wcześniej, zostanie dopasowany do swojego istniejącego konta i zachowa nazwę z tego konta.
• Jeśli ustawiona jest również opcja Default Username, wygenerowana nazwa ma pierwszeństwo.

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

Gdy użytkownik komentuje lub się loguje, aktualizujemy jego ostatnio używane locale i używamy go również do wysyłania e-maili.

Wpływa to na to, jak widżet komentarzy jest tłumaczony dla użytkownika. Locale składa się z języka i regionu użytkownika, więc skonfigurowanie locale zazwyczaj zmieni język używany do wyświetlania tekstu użytkownikowi.

Za pomocą interfejsu użytkownika

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

Zmiana Locale / Języka

Za pomocą kodu

Można to nadpisać żądanym locale.

Ręczne definiowanie locale 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

Obsługiwane języki i kody locale

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

Uwaga dotycząca SSO

Jeśli korzystasz z SSO, możesz chcieć przekazać locale użytkownika w obiekcie użytkownika, aby e-maile i inne rzeczy były dla niego poprawnie zlokalizowane.

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.

Domyślnie FastComments tłumaczy własny interfejs widżetu (przyciski, etykiety, komunikaty o błędach) na język widza, ale komentarze są wyświetlane dokładnie tak, jak zostały napisane.

Tłumaczenie komentarzy dodaje tłumaczenie samych komentarzy, dzięki czemu społeczność pisząca w więcej niż jednym języku może czytać każdy komentarz w swoim języku.

Istnieją dwa tryby:

• Automatyczny: komentarze napisane w języku innym niż język widżetu są wyświetlane przetłumaczone. Linia „Przetłumaczono z hiszpańskiego” pojawia się pod komentarzem z linkiem Pokaż oryginał, który przełącza między tłumaczeniem a nieprzetłumaczonym tekstem.
• Ręczny: każdy komentarz otrzymuje link Tłumacz. Kliknięcie go tłumaczy dany komentarz na język widza, z tym samym przełącznikiem Pokaż oryginał po tłumaczeniu. Komentarze, które już są w języku widza, informują o tym zamiast tego.

Językiem docelowym jest język widżetu: ustawienie Lokalizacja / Język w tej samej regule dostosowywania, jeśli jest ustawione, w przeciwnym razie język przeglądarki odwiedzającego. Od odwiedzającego nie jest nic wymagane, nie potrzebuje konta, rozszerzenia ani dodatkowego oprogramowania, i działa tak samo w osadzonym widżecie oraz na samodzielnych stronach komentarzy.

To jest włączane per reguła dostosowywania, więc może mieć zastosowanie do całej witryny, jednej domeny lub pojedynczej strony. Domyślnie jest wyłączone.

Tłumaczenie komentarzy

Tłumaczenie jest ustawieniem po stronie serwera. Przekazanie commentTranslation w konfiguracji JavaScript widżetu nie włącza go; robi to reguła.

Każdy komentarz jest tłumaczony co najwyżej raz na język docelowy i wynik jest przechowywany razem z komentarzem, więc komentarz odczytany przez tysiąc hiszpańskojęzycznych użytkowników jest tłumaczony raz. Jeśli autor lub moderator edytuje komentarz, przechowywane tłumaczenie jest odrzucane i komentarz jest tłumaczony ponownie przy następnym wyświetleniu. Przetłumaczony tekst przechodzi tę samą sanitację i zasady linkowania co oryginalny komentarz. Komentarze, które są zbyt długie lub których język nie może zostać wykryty, są wyświetlane nieprzetłumaczone.

Użycie jest rozliczane jako tokeny LLM w tej samej stawce co Agenci AI i pojawia się w tym samym miejscu w szczegółach rozliczeń.

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.