Налаштування та конфігурація

Ви можете помітити, що віджет коментарів можна використовувати з Tenant ID "demo", наприклад:

Demo 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

Це призначено лише для ознайомлення та експериментів з віджетом коментарів. У продакшені ви передаватимете свій Tenant ID ось так:

Defining Your 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

Ваш Tenant ID вже застосовано у фрагменті коду віджета коментарів у вашому обліковому записі.

Ви також можете знайти свій Tenant ID та керувати своїми API-ключами на сторінці облікових даних API.

Відтепер, якщо ви увійшли в FastComments, приклади коду будуть використовувати ваш реальний Tenant ID (якщо ви увійшли на https://fastcomments.com).

При відображенні гілки коментарів або залишенні коментаря FastComments має знати, до якої сторінки, статті чи продукту належать ці коментарі.

Для цього ми використовуємо те, що називаємо «URL ID». Це може бути ідентифікатор, наприклад рядок або число, або URL.

За замовчуванням, якщо ви не вкажете urlId, він буде дорівнювати URL сторінки. Ми беремо поточний URL сторінки та очищаємо його, видаляючи загальні маркетингові параметри або ідентифікатори відстеження.

У випадку інтеграцій сторонніх систем, таких як WordPress, наш плагін зазвичай використовує ідентифікатор, який представляє поточну переглянуту інформацію, як URL ID, наприклад ідентифікатор статті/сторінки.

Визначення власного 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

Одним із елементів, на який ми часто посилаємося в цьому документі, є Інтерфейс налаштування віджета.

Цей інтерфейс можна використовувати для внесення багатьох змін у віджет коментарів без коду.

При створенні правила налаштування ми часто хочемо, щоб воно застосовувалося до всіх сторінок нашого сайту. Однак у деяких випадках ми хочемо налаштувати віджет коментарів на конкретній сторінці, наприклад, застосувати власний стиль або зробити коментарі на цій сторінці анонімними. Ви також можете, наприклад, дозволити живі коментарі з’являтися одразу на деяких сторінках, а на інших приховувати їх під кнопками сповіщень.

Все це можливо за допомогою поля вводу URL ID на цій сторінці, яке виглядає наступним чином:

Введення URL ID на сторінці налаштування віджета

Значення в цьому полі має відповідати параметру urlId, переданому у віджет коментарів. Якщо ви хочете, щоб ваше правило налаштування було незалежним від urlId, залиште це поле порожнім або введіть *.

З 2023 року поле URL ID у налаштуванні віджета також підтримує шаблони! Наприклад, ви можете використати */blog/* для додавання стилю, специфічного для вашого блогу, і */store/* для стилю, специфічного для вашого магазину, використовуючи один і той самий домен.

Gotchas

1. Якщо ваша сторінка має хеш‑параметри (наприклад example.com#page-1) — вони за замовчуванням стануть частиною URL ID.
2. Під час міграцій, наприклад з WordPress на Gatsby, вам можливо доведеться перенести значення коментарів URL ID після первинної міграції. Для цього звертайтеся до нас.

FastComments розроблений для налаштування. Віджет коментування сам працює всередині iframe з міркувань безпеки, тому для застосування користувацького стилю потрібно дотримуватись одного з двох підходів.

Перший, найпростіший підхід, який ми віддаємо перевагу, — це використання сторінки налаштування віджету.

На сторінці налаштування віджету перегляньте розділ «Show Advanced Options», під яким розташована область з міткою «Custom CSS»:

Область вводу Custom CSS

У цьому підході є кілька переваг:

1. Введений CSS мінімізується перед відправкою користувачеві, і форматування зберігається послідовним у інтерфейсі редагування.
2. Ви отримуєте всі переваги інтерфейсу налаштування віджету, наприклад, легко налаштовуючи віджет коментування по-різному для різних сайтів.
3. Коли ми вносимо зміни до віджету коментування, ваші користувацькі стилі будуть протестовані в рамках нашого процесу випуску.

Другий підхід — вказати параметр customCSS у конфігурації віджету, як показано нижче:

Передача користувацького 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

Однак у цьому є обмеження:

1. Існує обмеження на обсяг користувацького CSS, який можна передати, інакше наші сервери відхилять запит через розмір заголовків.
2. Ви повинні керувати користувацьким CSS у вашій інфраструктурі та системі збірки. Це може бути і перевагою, і недоліком.
3. У цьому випадку додається додаткове навантаження на мережу — користувацький CSS надсилається двічі, спочатку на наші сервери, а потім назад у вміст iframe. Однак для більшості розмірів навантаження це непомітно.
4. Поширена оптимізація — мінімізувати CSS, щоб зменшити його розмір у мережі, проте в цьому підході вам доведеться робити це самостійно.
5. Ваш користувацький CSS не буде протестований, коли ми вносимо зміни.

Зовнішні CSS файли

Ви можете вказати віджету завантажувати зовнішній файл за допомогою @import!

Рекомендується розміщувати @import у правилі налаштування. Таким чином, якщо нам доведеться змінити віджет коментування, ми зможемо використати наші інструменти автоматизації для перевірки вашої конфігурації. Наприклад, ви створюєте правило налаштування у UI налаштування віджету, натискаєте Advanced і вводите у Custom CSS:

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

У коді — не рекомендується

Ви також можете завантажити зовнішній CSS файл через властивість customCSS:

Зовнішній 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": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Однак пам'ятайте, що ваш CSS не зможе бути протестований нами, якщо ви це зробите.

Стилізація модального вікна профілю користувача

Модальні вікна профілю користувача також можна стилізувати за допомогою користувацького CSS. Однак, щоб забезпечити застосування користувацького стилю до профілів, усі CSS‑селектори мають мати префікс .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

Сумісність назад

У FastComments ми знаємо, що наші клієнти налаштовують віджет коментування. Це задумано — останнє, чого ми хочемо, це щоб наш продукт створював несумісності дизайну у вашому продукті.

Оскільки це важлива частина нашого продукту, у нас є конвеєр збірки, який дозволяє нам переглядати зміни у віджеті коментування для кожного клієнта перед кожним випуском.

Якщо ми виявимо незначні проблеми, ми оновимо ваш обліковий запис, щоб забезпечити плавний випуск. Якщо ми помітимо серйозні критичні зміни, це дозволяє нам зупинити випуск.

Для клієнтів з тарифними планами Pro або Enterprise дозволено брендування під власний бренд (white labeling). Просто зв'яжіться з нами, і ми із задоволенням допоможемо.

Якщо ви просто хочете видалити наш логотип із віджета коментарів, це автоматично доступно на тарифах Flex та Pro.

Ці тарифи також надають таку саму функціональність для електронних листів, що надсилаються з нашої платформи.

Для сайтів, які дозволяють перемикати темний режим після початкового завантаження сторінки, це трохи складніше.

По-перше, усі поточні версії бібліотеки віджета коментарів (React, Vue) містять приклади перемикання темного режиму у відповідних репозиторіях.

Для VanillaJS віджета нам потрібно зробити трохи більше роботи. По-перше, FastCommentsUI повертає об'єкт з функціями "destroy" і "update".

Ми можемо просто викликати функцію update щоразу, коли хочемо оновити конфігурацію віджета коментарів, як показано нижче. Ось повний робочий приклад перемикання темного режиму з VanillaJS віджетом.

Повний приклад перемикання темного режиму

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

З FastComments весь текст у віджеті коментарів можна налаштувати.

Ви можете перевизначити окремий фрагмент тексту, наприклад кнопку надсилання, або весь текст у всьому віджеті коментарів.

За замовчуванням текст у віджеті коментарів перекладається відповідно до локалі користувача. Однак ми можемо перевизначити текст, якщо впевнені, що наша аудиторія використовує одну й ту ж мову/локаль, наприклад:

Користувацький текст

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

Усі налаштовувані переклади можна знайти тут у вкладці «advanced options».

Проте існує простіший спосіб, через інтерфейс налаштування віджета. У ньому ми можемо просто знайти текст, який відображається у віджеті коментування в локалі EN_US, і вказати заміну.

Користувацький текст

Усі перевизначення перекладів наразі впливають на всі локалі.

Це охоплює лише текст самого віджета. Щоб перекласти коментарі, які залишають ваші відвідувачі, дивіться Comment Translation.

Коли користувач коментує за допомогою FastComments вперше, ми спробуємо отримати його аватар з https://gravatar.com/.

Однак, якщо аватар не знайдено або користувач ніколи не встановлює його у своєму обліковому записі, ми відображаємо статичне зображення аватара за замовчуванням.

Щоб вказати власне статичне зображення аватара, можна використати налаштування defaultAvatarSrc.

Перевизначити аватар за замовчуванням

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

Це також можна зробити без коду. На сторінці налаштування віджета перегляньте розділ «Аватар за замовчуванням».

Налаштування аватара за замовчуванням

Зверніть увагу, що визначення аватара для конкретного користувача, наприклад за допомогою 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 "hideAvatars": true

8}];

9</script>

10

Це можна налаштувати без коду, на сторінці налаштування віджету:

Приховування аватарів

Для великих проєктів кастомного стилювання може бути бажаним почати з чистого листа і не використовувати стилі за замовчуванням.

Усі стилі за замовчуванням можна видалити, встановивши параметр noStyles у значення true, наступним чином:

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

Це можна налаштувати без коду на сторінці налаштування віджету в розділі «Розширені параметри»:

Вимкнення всіх стилів за замовчуванням

За замовчуванням відповіді на коментарі верхнього рівня відображаються.

Це можна налаштувати так, щоб користувачеві доводилося натискати "Show Replies" на коментарях верхнього рівня, щоб побачити дочірні.

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

Це можна налаштувати без коду на сторінці налаштування віджета:

Згортання відповідей

Це налаштування не вплине на кількість початково завантажених коментарів верхнього рівня. Якщо у вас один коментар верхнього рівня і 29 дочірніх, при ввімкненому цьому налаштуванні ви:

• Побачите коментар верхнього рівня.
• Побачите "Show Replies" (29) під цим коментарем.

Якщо ви хочете показати всі коментарі верхнього рівня у поєднанні з цією опцією, встановіть starting page to -1.

За замовчуванням функції форматування в FastComments здійснюються шляхом додавання видимих тегів-якорів, таких як <b></b>, навколо вашого тексту. Натискання на панель інструментів або використання швидких клавіш робить це за вас. Однак деякі спільноти можуть захотіти використовувати форматування без тегів-якорів. Це називається увімкненням редактора WYSIWYG (what you see is what you get). Цей редактор виглядає точно так само, як і стандартний, за винятком того, що він завантажує додатковий код, який дозволяє користувачам робити текст жирним, підкресленим тощо без видимих тегів-якорів.

Увімкнення редагування WYSIWYG

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

Це також можна зробити без коду. На сторінці налаштування віджета перегляньте параметр "Enable Advanced Formatting" option.

Увімкнути WYSIWYG

За замовчуванням FastComments показує панель інструментів під час написання коментаря, щоб надати швидкі клавіші для оформлення тексту та завантаження зображень.

Цю панель інструментів можна вимкнути в коді або за допомогою інтерфейсу налаштувань.

Вимкнення панелі інструментів

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

Це також можна зробити без коду. На сторінці налаштування віджету перегляньте параметр "Disable The Reply Toolbar".

Вимкнення панелі інструментів

За замовчуванням FastComments дозволяє користувачам блокувати інших користувачів. Блокування користувача призведе до маскування їхніх коментарів, запобігає сповіщенням між користувачами тощо.

Можливо, буде бажано вимкнути цю функціональність. Це можна зробити так:

Вимкнути блокування

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

Це також можна зробити без коду, що також забезпечує правильну серверну валідацію, за допомогою інтерфейсу налаштування віджета:

Вимкнути блокування

За замовчуванням використовуються локалізовані відносні дати. Наприклад, поруч із нещодавно залишеним коментарем ви можете бачити "11 хвилин тому".

Можливо, буде необхідно або бажано використовувати абсолютні дати, у цьому випадку ви встановлюєте цей параметр у 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

Це можна налаштувати без коду на сторінці налаштування віджета в розділі Розширені параметри:

Використання абсолютних дат

За замовчуванні використовуються локалізовані відносні дати. Наприклад, поруч із нещодавно залишеним коментарем ви можете бачити "11 хвилин тому".

Можливо, буде необхідно або бажано залишити цей відносний формат дати, але також показати повну дату поруч, у цьому випадку ви встановлюєте цей параметр у true.

Використовувати як абсолютні, так і відносні дати

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

Це можна налаштувати без коду на сторінці налаштування віджету в розділі Додаткові параметри. Спочатку вам потрібно ввімкнути Абсолютні дати, щоб побачити цю опцію в інтерфейсі.

Використовувати як абсолютні, так і відносні дати

Деякий текст, наприклад заголовок або повідомлення, може бути відображений під кількістю коментарів, але над текстом статусу входу.

Ми називаємо це заголовком, і за замовчуванням він прихований.

Вказування 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

Це можна налаштувати без коду на сторінці налаштування віджету в розділі «Розширені параметри»:

Вказування HTML заголовка

За замовчуванням FastComments відображає посилання так: https://exmaple.com — де URL посилання перетворюється на клікабельний HTML‑тег anchor.

Деякі сайти можуть захотіти вимкнути це, наприклад, щоб запобігти шахраям. Ми надаємо цю можливість, встановивши Comment HTML Rendering Option у Links as Text.

Це можна налаштувати без коду на сторінці налаштування віджета, для всього домену або окремої сторінки:

Відображати посилання як текст

За замовчуванням FastComments відображає поле вводу коментаря та гілку коментарів одночасно. Щоб заощадити вертикальний простір, він також приховує інші обов’язкові поля, доки користувач не взаємодіє з віджетом.

Однак віджет коментарів можна сховати за кнопкою, наприклад:

Click to Show Comments

Кнопка використовує різний перекладений текст залежно від того, чи показані коментарі в даний момент. Якщо коментарі приховані, використовується translations.SHOW_COMMENTS_BUTTON_TEXT. Якщо коментарі показані, використовується translations.HIDE_COMMENTS_BUTTON_TEXT. Переклади можуть містити текст [count], який буде замінений локалізованою кількістю.

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

Це призначено для заміни конфігурації hideCommentsUnderCountTextFormat.

Кількість оновлюється в режимі реального часу разом з гілкою коментарів. Кнопка не відображається, якщо немає коментарів.

Це можна ввімкнути без коду, створивши правило налаштування та активувавши "Click to Show Comments":

Enable Click to Show Comments

Кількість коментарів, що відображається у верхній частині віджета коментарів, можна налаштувати.

Це можна замінити будь‑яким рядком, і значення [count] буде замінено на кількість, локалізовану для користувача.

Налаштування тексту кількості коментарів

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

Це можна налаштувати без коду на сторінці налаштування віджета:

Налаштування тексту кількості коментарів

Коли користувачі вводять хештеги у вигляді #someexampletag, FastComments автоматично створює цей HashTag і підсвічує його у їхньому коментарі.

У деяких випадках бажано вимкнути цю функцію або контролювати, які хештеги можна використовувати через API.

Для цього просто увімкніть Disable Automatic #hashtag Creation через інтерфейс налаштування віджету.

Вимкнення автоматичного створення HashTag

За замовчуванням FastComments показує сповіщувальний дзвінок у правому верхньому куті області коментарів.

Цей дзвінок стане червоним і покаже кількість сповіщень, які має користувач. Приклади сповіщень:

• Користувач відповів вам.
• Користувач відповів у темі, в якій ви коментували.
• Користувач поставив вашому коментарю лайк.
• Користувач відповів на сторінку, на яку ви підписалися.

Сповіщувальний дзвінок також забезпечує механізм підписки на всю сторінку.

Проте, ми можемо повністю вимкнути сповіщувальний дзвінок:

Вимкнути сповіщувальний дзвінок

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

Це також можна зробити без коду. На сторінці налаштування віджету, дивіться розділ «Вимкнути сповіщувальний дзвінок».

Вимкнути сповіщувальний дзвінок

За замовчуванням FastComments показує профіль користувача, коли ви клацаєте на його аватар.

Однак ми можемо вимкнути цю функціональність:

Вимкнути профілі

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

Це також можна зробити без коду. На сторінці налаштування віджета, перегляньте розділ "Вимкнути профілі".

Вимкнути профілі

За замовчуванням FastComments показуватиме вкладку "Коментарі профілю" у профілях користувачів, дозволяючи відвідувачам залишати коментарі на чийсь профіль.

Проте ми можемо вимкнути цю вкладку:

Вимкнути коментарі профілю

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

Це також можна зробити без коду. На сторінці налаштування віджету перегляньте розділ "Вимкнути коментарі профілю".

Вимкнути коментарі профілю

За замовчуванням FastComments показує вкладку «Прямі повідомлення» у профілях користувачів, дозволяючи відвідувачам надсилати прямі повідомлення користувачеві.

Проте ми можемо вимкнути цю вкладку:

Disable Profile Direct Messages

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

Це також можна зробити без коду. На сторінці налаштування віджету перегляньте розділ «Вимкнути прямі повідомлення» розділ.

Вимкнути прямі повідомлення у профілі

За замовчуванням FastComments показує повідомлення про успішне надсилання після коментування. Це можна вимкнути наступним чином:

Вимкнути повідомлення про успіх

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

Це також можна зробити без коду. На сторінці налаштування віджету:

Вимкнути повідомлення про успіх

За замовчуванням віджет коментарів FastComments встановлює gif rating у pg.

Доступні варіанти: g, pg, pg-13 та r.

Це можна встановити в коді або через інтерфейс користувача. У коді це можна зробити наступним чином:

Встановити рейтинг 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

У UI ви знайдете це під Gif Picker Rating, доки Disable Image Uploads? не позначено.

Налаштування рейтингу GIF

За замовчуванням у віджеті коментарів FastComments модерація вмісту зображень вимкнена off.

Доступні варіанти: off, low, medium та high.

У інтерфейсі налаштування віджета ви знайдете це під Image Content Moderation Level, доки не встановлено прапорець Disable Image Uploads?.

Налаштування рівня модерації вмісту зображень

За замовчуванням FastComments відображає варіанти голосування у вигляді стрілок вгору та вниз, дозволяючи користувачам підвищувати або знижувати голос коментаря.

Однак можна змінити стиль панелі голосування. Поточні варіанти — це стандартні кнопки Вгору/Вниз або використання механізму голосування у вигляді серця.

Ми використовуємо прапорець voteStyle наступним чином:

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

Ми настійно рекомендуємо робити це без коду, оскільки це також вмикає серверні перевірки. На сторінці налаштування віджету дивіться розділ "Vote Style".

Змінити стиль голосування

Голосування також можна вимкнути, дивіться Disable Voting вище параметрів стилю.

За замовчуванням FastComments дозволяє користувачам видаляти їхні коментарі.

Проте, це можна запобігти.

На сторінці налаштування віджету, перегляньте параметр "Disable Deleting".

Вимкнути видалення коментарів

• Це стосується лише звичайних коментаторів і не стосується модераторів або адміністраторів, які все ще зможуть видаляти.
• Це також вплине на інтеграції API, коли передається contextUserId.

За замовчуванням FastComments дозволяє користувачам редагувати їхні коментарі.

Проте, це можна запобігти.

На сторінці налаштування віджета, перегляньте параметр "Вимкнути редагування".

Вимкнути редагування коментаря

• Це впливає лише на звичайних коментаторів і не на модераторів або адміністраторів, які все ще зможуть редагувати.
• Це також вплине на інтеграції API, коли передається contextUserId.

За замовчуванням розмір сторінки FastComments становить 30. Це включає відповіді в гілках.

Розмір сторінки можна налаштувати в Widget Configuration UI у різних розмірах від 10 до 200.

Зверніть увагу, що зміна розміру сторінки вимагає перерахунку всіх гілок коментарів у вашому обліковому записі. Це може зайняти кілька хвилин.

Це не можна налаштувати у віджеті на стороні клієнта, оскільки сторінки обчислюються на сервері.

Нижче показано приклад конфігурації:

Користувацькі розміри сторінок

Розміри сторінок можна налаштовувати глобально, або для домену, або для окремої сторінки, створюючи різні правила налаштування.

Це вплине на всіх клієнтів, інтеграції та фреймворки, які ви можете використовувати для відображення коментарів через нашу платформу.

За замовчуванням FastComments показує ім'я користувача так, як він його ввів, або так, як воно було передане нам через SSO.

Однак іноді бажано приховати або показати ім'я користувача іншим способом. Наприклад, якщо ім'я користувача — Allen Rex, можливо, ви хочете показувати лише "Allen R.".

Це можна зробити без коду в інтерфейсі налаштування віджета, у параметрі під назвою Commenter Name Format:

Зміна формату імені

Доступні формати:

• Capitalize (приклад користувача відображається як Example User)
• Last Initial (Example User відображається як Example U.)
• All Initials (Example User відображається як E. U.)
• Показувати "Anonymous"

Зміна набуває чинності негайно. Користувачі, як і раніше, бачитимуть своє повне ім'я користувача вгорі області коментарів, для себе, але їхні коментарі показуватимуть змінене ім'я користувача.

Імена користувачів маскуються на стороні сервера для захисту користувачів.

За замовчуванням FastComments дозволяє завантаження зображень. Це можна вимкнути, встановивши прапорець noImageUploads у true.

Вимкнення завантаження зображень

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

Це можна налаштувати без коду на сторінці налаштування віджета:

Вимкнення завантаження зображень

За замовчуванням FastComments не дозволяє iframes у коментарях. Коли ви увімкнете вбудовування медіа, коментатори можуть вставляти код вбудовування (фрагмент <iframe>) від надійних постачальників, таких як YouTube, Vimeo, SoundCloud та Spotify, і він буде відображатися безпосередньо в коментарі.

З міркувань безпеки це не прапорець конфігурації віджета на стороні клієнта. Це налаштування на стороні сервера, яке перевіряється під час збереження кожного коментаря, тому його неможливо увімкнути зі сторінки. Дозволяються лише iframes, що вказують на вбудований список надійних постачальників. Будь-який інший iframe видаляється.

Це робиться без коду, на сторінці налаштування віджета:

Дозволити вбудовування медіа

Додавання власних постачальників

Якщо ви хочете дозволити вбудовування від постачальника, якого немає у вбудованому списку надійних, додайте його ім'я хоста у поле "Additional Embed Domains" на тій самій сторінці. Ці імена хостів дозволяються на додаток до вбудованих постачальників. Збіг є точним, тому вказуйте повне ім'я хоста (наприклад, player.example.com). Все, що ви не вкажете, залишається заблокованим.

Як звичайне поле коментаря, так і WYSIWYG-редактор підтримують вставку вбудовування. У WYSIWYG-редакторі вбудовування вставляється як блок, який можна видалити.

За замовчуванням у віджеті коментарів не відображається поле пошуку.

Однак ми можемо ввімкнути його, встановивши прапорець enableSearch у значення true:

Увімкнення пошуку

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

Це також можна зробити без коду. На сторінці налаштування віджета перегляньте параметр «Увімкнути поле пошуку».

Увімкнути поле пошуку

Ми можемо ввімкнути підтримку спойлерів, встановивши прапорець enableSpoilers у значення true:

Увімкнення спойлерів

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

Це також можна зробити без коду. На сторінці налаштування віджету, перегляньте опцію "Enable Spoilers".

Увімкнути спойлери

Коли текст виділено, і тепер видима кнопка SPOILER натискається, текст буде замасковано, доки користувач не наведеться на нього мишкою. Для темного режиму ми робимо те ж саме, з іншими кольорами, які краще підходять для темного режиму.

Це також сумісно з редактором WYSIWYG.

За замовчуванням FastComments не відстежує, хто переглянув кожен коментар, і не надає жодної статистики щодо цього.

Однак ми можемо ввімкнути цю функцію, і тоді система почне відстежувати, коли кожен користувач прокручує до коментаря.

Коли це відбувається, лічильник поруч із іконкою ока, що показується під кожним коментарем, збільшується. Лічильник оновлюється в режимі реального часу і скорочується відповідно до локалі користувача.

Ми можемо ввімкнути це, встановивши прапорець enableViewCounts у значення true:

Enabling Comment View Counts

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

Це можна налаштувати без коду на сторінці налаштування віджету:

Увімкнення підрахунку переглядів коментарів

Ми відстежуємо ідентифікатор користувача* який переглянув коментар протягом одного тижня, щоб якщо ви переглянете коментар знову протягом цього тижня, лічильник не збільшувався. Якщо ви переглянете коментар знову після закінчення тижня, лічильник збільшиться знову.

• *Примітка: або анонімний ідентифікатор сесії, або IP користувача у вигляді хешованого значення.

За замовчуванням живе коментування ввімкнено. Це означає, що якщо будь‑які коментарі додаються, видаляються, редагуються або закріплюються, зміни мають з’являтися у всіх користувачів, які переглядають гілку коментарів одночасно.

Проте, за замовчуванням нові коментарі будуть відображатися під динамічно показаною кнопкою з текстом, схожим на «Show 2 New Comments».

Якщо нові коментарі є відповідями безпосередньо до сторінки, кнопка буде розташована у верхній частині гілки коментарів. Якщо це відповіді на конкретний коментар, кнопка буде під цим коментарем.

Це робиться, щоб запобігти постійному зміненню розміру сторінки у користувача, що може викликати розчарування під час спроби захопити смугу прокрутки.

Для деяких випадків використання, таких як живі торги або онлайн‑події, це не бажана поведінка — ви можете захотіти, щоб віджет коментування був більше схожим на «chat» box, де нові коментарі «з’являються одразу».

Отже, назва прапорця, який вмикає цю функцію: showLiveRightAway.

Ми можемо ввімкнути його наступним чином:

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

Це можна налаштувати без коду на сторінці налаштування віджета:

Показати живі коментарі одразу

За замовчуванням FastComments матиме ввімкнене живе коментування.

Це означає, що кожен глядач потоку коментарів має бачити один і той самий вміст.

Наприклад, якщо додати коментар, цей коментар має з'явитися. Якщо коментар відредаговано або видалено, то ці коментарі будуть відредаговані або видалені для всіх глядачів потоку. Те ж саме щодо голосувань та всіх дій модерації.

Проте ми можемо це вимкнути:

Вимкнути живе коментування

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

Це також можна зробити без коду. На сторінці налаштування віджету перегляньте розділ "Вимкнути живе коментування".

Вимкнути живе коментування

За замовчуванням FastComments буде сортувати коментарі за напрямком сортування "Most Relevant".

Сортування Most Relevant враховує час залишення коментаря та кількість голосів при сортуванні.

Користувач може потім змінити напрямок сортування на "Oldest" або "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": "OF"

8}];

9</script>

10

Ми встановлюємо значення defaultSortDirection на "OF", щоб задати напрямок "OF".

Для напрямку сортування 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

Допустимі значення для defaultSortDirection є:

• MR: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

Це також можна зробити без коду. На сторінці налаштування віджета, дивіться розділ "Default Sort Direction".

Зміна напрямку сортування за замовчуванням

Зверніть увагу, що коментарі на кожній сторінці для кожного напрямку сортування попередньо обчислюються, тому всі напрямки сортування мають однакову продуктивність.

За замовчуванням область вводу коментаря розташована перед потоком коментарів. Однак, встановивши цей параметр конфігурації в true ми можемо перемістити її після.

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

Це можна налаштувати без коду на сторінці налаштування віджета:

Переміщення поля відповіді в кінець

Максимальна кількість символів, які можна ввести в поле вводу коментаря, може бути обмежена параметром maxCommentCharacterLength.

За замовчуванням це 2000.

Такі речі, як URL‑зображень, не включаються у визначення довжини.

Обмежити довжину коментаря

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

Це можна налаштувати без коду на сторінці налаштування віджета:

Обмежити довжину коментаря

За замовчуванням FastComments дозволяє користувачеві вводити коментар у будь‑якій кількості рядків, до досягнення стандартного ліміту символів.

Однак може бути бажаним обмежити користувача вводом лише одного рядка тексту. Прикладами використання можуть бути онлайн‑аукціони або живий чат, для яких можна використовувати FastComments.

Ми вмикаємо прапорець useSingleLineCommentInput наступним чином:

Увімкнути однорядковий ввід коментаря

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

Це також можна зробити без коду. На сторінці налаштування віджету перегляньте розділ "Увімкнути однорядковий ввід коментаря".

Увімкнути однорядковий ввід коментаря

Зверніть увагу, що коментарі на кожній сторінці для кожного напрямку сортування попередньо обчислюються, тому всі напрямки сортування мають однакову продуктивність.

За замовчуванням кожен користувач може надіслати до 5 comments за одну хвилину.

Це відстежується за ідентифікатором користувача, ідентифікатором анонімного користувача та IP-адресою (хешованою).

Це можна налаштувати без коду на сторінці кастомізації віджета:

Обмеження кількості коментарів на користувача

Зверніть увагу, що якщо ви використовуєте API створення коментарів, можливо, варто передати оригінальну IP-адресу користувача (ip) у запиті до нашого бекенду, щоб обмеження частоти застосовувалося до окремого користувача, а не глобально до вашого облікового запису.

FastComments дозволяє вимагати від користувачів, які залишають коментар вперше, прийняття ваших Умов використання перед надсиланням коментаря.

Коли ця функція увімкнена:

• Анонімні користувачі бачитимуть прапорець TOS щоразу, коли залишають коментар
• Автентифіковані користувачі бачитимуть прапорець лише під час першого коментаря або коли ви оновите свої TOS

Конфігурація

Перейдіть на сторінку налаштування віджета та увімкніть прапорець "Require Terms of Service acceptance". Після увімкнення ви побачите такі параметри:

Параметри Умов використання

• TOS Text Mode: За замовчуванням прапорець відображає текст "I agree to the Terms of Service and Privacy Policy" з посиланнями на обидва документи. Виберіть "Customize text per locale", щоб вказати власний текст для кожної мови.
• TOS Last Updated Date: Коли ви оновлюєте свої Умови використання, встановіть цю дату. Користувачі, які прийняли умови до цієї дати, повинні будуть прийняти їх знову.

Як це працює

• Час прийняття TOS зберігається для кожного користувача та кожного коментаря
• Коли користувач приймає TOS, дата записується в його профіль (для кожного орендаря окремо)
• Якщо ви встановите дату "Last Updated", яка пізніша за дату прийняття користувачем, йому потрібно буде прийняти умови знову
• Для анонімних користувачів, яких неможливо відстежити, прапорець з'являється під час кожного надсилання коментаря

Опитування дозволяють коментаторам прикріплювати питання з 2 до 10 варіантами до коментаря. Кожен на сторінці голосує на місці і бачить, як результати оновлюються в реальному часі.

Опитування вимкнені за замовчуванням. Встановіть прапорець Enable Polls у налаштуваннях налаштування віджету, щоб додати кнопку опитування до панелі інструментів коментаря. Потім з’являться ще два налаштування:

• Хто може створювати опитування: Admins/Moderators Only (за замовчуванням), або Everyone.
• Дозволити анонімні голоси в опитуваннях: коли прапорець знято (за замовчуванням), лише зареєстровані користувачі можуть голосувати.

Увімкнути опитування

Дивіться Посібник з опитувань для отримання інформації про створення, голосування, конфіденційність та сповіщення про опитування.

FastComments Secure SSO використовує шифрування HMAC-SHA256 як механізм реалізації SSO. Спочатку ми розглянемо загальну архітектуру, надамо приклади та детальні кроки.

Також є документація щодо міграції від інших провайдерів зі схожими механізмами SSO та їхніх відмінностей.

Потік виглядає так:

Потік Secure SSO

Оскільки Secure SSO передбачає full-stack розробку, повні робочі приклади коду на Java/Spring, NodeJS/Express та чистому PHP наразі доступні на GitHub.

Хоча ми використовуємо ExpressJS у прикладі для NodeJS та Spring у прикладі для Java, для реалізації FastComments SSO в цих середовищах не потрібні жодні фреймворки/бібліотеки — працюють нативні криптографічні пакети.

Вам не потрібно писати жодних нових API-ендпоінтів з FastComments SSO. Просто зашифруйте інформацію користувача за допомогою вашого секретного ключа та передайте payload віджету коментарів.

Отримайте ваш API Secret Key

Ваш API Secret можна отримати на цій сторінці. Цю сторінку також можна знайти, перейшовши до My Account, натиснувши плитку API/SSO, а потім «Get API Secret Key».

Параметри віджета коментарів

Документація API високого рівня для віджета коментарів доступна тут.

Розглянемо детальніше, що означають ці параметри.

Віджет коментарів приймає об'єкт конфігурації — ви вже передаєте його, якщо використовуєте FastComments для передачі вашого customer id (який називається tenantId).

Щоб увімкнути SSO, передайте новий об'єкт «sso», який повинен мати наступні параметри. Значення повинні генеруватися на сервері.

• userDataJSONBase64: Дані користувача у форматі JSON, які потім кодуються в Base64.
• verificationHash: Хеш HMAC-SHA256, створений з UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Мітка часу Epoch, у мілісекундах. Не повинна бути в майбутньому або більш ніж на два дні в минулому.
• loginURL: URL, який віджет коментарів може показати для входу користувача.
• logoutURL: URL, який віджет коментарів може показати для виходу користувача.
• loginCallback: Якщо надано замість login URL, функція, яку віджет коментарів викличе при натисканні кнопки входу.
• logoutCallback: Якщо надано замість logout URL, функція, яку віджет коментарів викличе при натисканні кнопки виходу.

Клієнтський код Secure SSO

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": 1794130022710.0,

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

Об'єкт User

Об'єкт User містить наступну схему:

Об'єкт User

Copy

1

2interface SSOUser {

3 /** Обов'язково. Максимум 1k символів. **/

4 id: string;

5 /** Обов'язково. Максимум 1k символів. Примітка: Повинен бути унікальним. **/

6 email: string;

7 /** Обов'язково. Максимум 1k символів. Примітка: Ім'я користувача не може бути email. Не обов'язково унікальне. **/

8 username: string;

9 /** Необов'язково. Максимум 3k символів для URL. За замовчуванням береться з gravatar на основі email. Підтримує 64 закодовані зображення, у такому випадку ліміт — 50k символів. **/

10 avatar?: string;

11 /** Необов'язково. За замовчуванням false. **/

12 optedInNotifications?: boolean;

13 /** Необов'язково. За замовчуванням false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Необов'язково. Максимум 100 символів. Ця мітка буде показана поруч з ім'ям. За замовчуванням Administrator/Moderator, якщо застосовно. **/

16 displayLabel?: string;

17 /** Необов'язково. Максимум 500 символів. Це буде показано замість імені користувача. **/

18 displayName?: string;

19 /** Необов'язково. Максимум 2k символів. Ім'я користувача буде посиланням на це. **/

20 websiteUrl?: string;

21 /** Необов'язково. До 100 груп на користувача. Ідентифікатор групи не може бути довшим за 50 символів. **/

22 groupIds?: string[];

23 /** Необов'язково. Позначає користувача як адміністратора. **/

24 isAdmin?: boolean;

25 /** Необов'язково. Позначає користувача як модератора. **/

26 isModerator?: boolean;

27 /** Необов'язково, за замовчуванням true. Встановіть false, щоб увімкнути вкладку «activity» у профілі користувача. **/

28 isProfileActivityPrivate?: boolean;

29 /** Необов'язково, за замовчуванням false. Встановіть true, щоб вимкнути коментарі профілю. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Необов'язково, за замовчуванням false. Встановіть true, щоб вимкнути прямі повідомлення цьому користувачу. **/

32 isProfileDMDisabled?: boolean;

33 /** Необов'язкова конфігурація для значків користувача. **/

34 badgeConfig?: {

35 /** Масив глобальних ідентифікаторів значків для призначення. Обмежено 30 значками. Порядок зберігається. **/

36 badgeIds: string[];

37 /** Масив ідентифікаторів значків, обмежених поточною сторінкою (urlId). Відображаються лише на призначеній сторінці. **/

38 pageBadgeIds?: string[];

39 /** Якщо true, замінює наявні відображені значки. Глобальні та обмежені сторінкою перевизначаються незалежно. **/

40 override?: boolean;

41 /** Якщо true, оновлює властивості відображення значків з конфігурації tenant. **/

42 update?: boolean;

43 };

44}

45

Модератори та адміністратори

Для адміністраторів та модераторів передайте відповідні прапорці isAdmin або isModerator в об'єкті SSOUser.

Сповіщення

Щоб увімкнути або вимкнути сповіщення, встановіть значення optedInNotifications відповідно на true або false. Перший раз, коли користувач завантажить сторінку з цим значенням у SSO payload, його налаштування сповіщень будуть оновлені.

Крім того, якщо ви хочете, щоб користувачі отримували email-сповіщення про активність на сторінках, на які вони підписалися (на відміну від лише сповіщень у застосунку), встановіть optedInSubscriptionNotifications на true.

VIP-користувачі та спеціальні мітки

Ви можете відобразити спеціальну мітку поруч з ім'ям користувача, використовуючи необов'язкове поле «displayLabel».

Неавтентифіковані користувачі

Щоб представити неавтентифікованого користувача, просто не заповнюйте userDataJSONBase64, verificationHash або timestamp. Надайте loginURL.

Такі користувачі не зможуть коментувати, і замість цього їм буде показано повідомлення про вхід (повідомлення, посилання або кнопка, залежно від конфігурації).

Прямі приклади серіалізації та хешування даних користувача

Більше деталей у вигляді прикладів тут (js), тут (java) та тут (php).

Ми розуміємо, що будь-яка інтеграція може бути складним і болючим процесом. Не соромтеся звертатися до вашого представника або використовувати сторінку підтримки.

За допомогою Simple SSO ми можемо передати віджету коментування інформацію про користувача, щоб йому не потрібно було вводити ім'я користувача чи email для коментування.

Ми можемо налаштувати Simple SSO так:

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

Користувач буде авторизований, і в фоновому режимі буде створено SSO-користувача. Користувач матиме createdFromSimpleSSO зі значенням true, якщо його отримано через API.

Примітки:

• Email є унікальним ідентифікатором для Simple SSO.
• Надання email у Simple SSO не є обов'язковим, однак за замовчуванням коментарі такого користувача відображатимуться як "Unverified" (неперевірений). Якщо email не вказано, користувач не може бути повністю автентифікований.
• НОВЕ З січня 2022 року: імена користувачів не обов'язково мають бути унікальними в межах усієї fastcomments.com
• Simple SSO може автоматично створювати та оновлювати SSO-користувачів, якщо вказано email, і користувач не був спочатку створений через Secure SSO. Якщо payload Simple SSO вказує на користувача, створеного через Secure SSO або API, цей користувач залишається недоторканим, а відвідувач отримує окремого користувача.
• Ви можете вказати бейджі для користувача за допомогою властивості badgeConfig. Масив badgeIds містить ID глобальних бейджів, які асоціюються з користувачем. Масив pageBadgeIds містить ID бейджів, обмежених поточною сторінкою (urlId) — ці бейджі відображаються лише на сторінці, де вони були призначені. Якщо override має значення true, це замінить існуючі відображувані бейджі (глобальні та обмежені сторінкою перевизначаються незалежно); якщо false, бейджі будуть додані до існуючих.

Налаштування Simple SSO

Simple SSO завжди доступний. Два налаштування визначають, наскільки FastComments довіряє йому. Їх можна знайти, виконавши пошук за SSO у правилі кастомізації. Обидва за замовчуванням вимкнені, і вони застосовуються незалежно від того, чи увімкнено "Require SSO To View Comments".

Для акаунтів, які вже використовували Simple SSO на момент додавання цих налаштувань, обидва були увімкнені, тому для них нічого не змінилося.

Застосовується лише те правило кастомізації, яке найкраще відповідає сторінці, тому якщо у вас кілька правил, встановіть ці налаштування в кожному з них. Нове правило починається з увімкненими налаштуваннями, якщо вони увімкнені хоча б в одному з ваших інших правил.

Автоматична перевірка коментарів через Simple SSO

Коли це увімкнено, коментарі від користувачів Simple SSO перевіряються одразу.

Коли це вимкнено, коментарі від користувачів Simple SSO відображаються як "Unverified" (неперевірений), доки користувач не перейде за посиланням, яке ми надішлемо на email із payload Simple SSO. Якщо ви автоматично схвалюєте лише перевірені коментарі, вони також чекатимуть на це посилання. Якщо в payload немає email, коментар залишається неперевіреним.

Це налаштування впливає лише на коментарі. Голоси від користувачів Simple SSO завжди враховуються одразу.

Дозвіл адміністраторів Simple SSO

Коли це увімкнено, користувач Simple SSO може бути адміністратором або модератором вашого акаунта:

• Користувач Simple SSO, який має права адміністратора або модератора, зберігає їх.
• Користувач Simple SSO з таким самим email, як один із ваших адміністраторів або модераторів, отримує їхні права.

Коли це вимкнено, Simple SSO не надає цих прав. Якщо payload Simple SSO вказує на користувача, який їх має, буде створено окремого користувача без прав, а оригінальний користувач залишається недоторканим.

Payload Simple SSO не підписані, тому коли це увімкнено, будь-хто, хто знає email або ID користувача адміністратора, може діяти від його імені. Якщо це важливо для вашого сайту, залиште це вимкненим і використовуйте Secure SSO для ваших адміністраторів.

Користувачі, створені через Secure SSO або API, недосяжні для Simple SSO, незалежно від того, чи це увімкнено.

FastComments SSO (деталі тут) надає вашим користувачам можливість коментувати без необхідності входити на іншу платформу.

Однак саме по собі це не захищає ваші гілки коментарів, оскільки за замовчуванням дані коментарів є загальнодоступною інформацією — будь-хто, хто може переглядати сторінку, може переглядати й коментарі.

Змінивши один параметр, ми можемо обмежити отримання коментарів, дозволивши це лише адміністраторам або дійсним користувачам SSO.

Налаштування без коду

Ми можемо заборонити перегляд та взаємодію з нашими гілками коментарів, коли налаштовано SSO, створивши правило кастомізації.

При цьому знайдіть SSO, і ви побачите цю опцію:

Вимагати SSO для перегляду коментарів

Увімкніть її та збережіть правило кастомізації.

Захист лише певного домену або сторінки

Щоб захистити лише певний домен або сторінку, ми просто налаштуємо правило кастомізації відповідним чином.

У верхній частині інтерфейсу кастомізації ми знайдемо два поля: Domain та URL ID.

Щоб захистити лише певний домен, введіть відповідний домен у поле "domain".

Щоб захистити певну сторінку, введіть URL сторінки в поле "URL ID". Якщо у вас є власна інтеграція з FastComments, ви можете ввести тут тип ID замість URL.

Рівні безпеки

Вимагаючи SSO, вам потрібно вирішити, чи вимагаєте ви Simple SSO або Secure SSO. Якщо ви вимагаєте Simple SSO, то дозволені обидва варіанти, але якщо ви вимагаєте Secure SSO, то вміст має бути отримано з Secure SSO payload, хешованим вашим API-ключем, щоб його можна було переглянути.

Опція рівня безпеки з'явиться, коли ви виберете "Require SSO To View Comments", і діє лише поки ця опція увімкнена.

Налаштування Auto Verify Comments via Simple SSO та Allow Simple SSO Admins є окремими та застосовуються незалежно від того, чи увімкнена ця опція.

Захист понад читання

Увімкнення цієї опції захистить сторінку або домен від коментування, якщо користувач не увійшов через SSO.

Підводні камені

Будь-які користувачі, які створили коментарі до вашої інтеграції SSO, не зможуть їх побачити, якщо не увійдуть через вашу інтеграцію SSO.

За замовчуванням FastComments вимагатиме електронну пошту для коментування. Вона не обов’язково має бути дійсною, проте доки користувач не натисне на надіслане йому посилання, його коментар буде позначений міткою «Неперевірений коментар».

Однак ми можемо прибрати вимогу електронної пошти. Поле вводу електронної пошти все ще буде відображатися, але більше не буде обов’язковим.

Це можна налаштувати через інтерфейс налаштування віджету:

Увімкнення анонімних коментарів

Ім'я користувача все ще потрібне. Щоб прибрати цей крок, ви можете встановити ім'я користувача за замовчуванням яке спільне для всіх, або дозволити FastComments згенерувати унікальне ім'я користувача для кожного відвідувача.

FastComments можна налаштувати так, щоб видаляти неперевірені коментарі після заданої кількості днів. Це допомагає боротися зі спамом.

За замовчуванням це не робиться.

Це можна налаштувати або вимкнути через сторінку Налаштування модерації.

Налаштування модерації

Коли користувачі залишають коментарі і не ввійшли в систему, їх попросять вказати свою електронну пошту.

Це створить «непідтверджену сесію» для цього користувача, і ми попросимо його підтвердити цю сесію через електронну пошту.

Для деяких сайтів або застосунків бажано не запитувати у користувача його електронну пошту під час коментування чи голосування.

Увімкнення анонімних коментарів робить поле вводу електронної пошти необов’язковим. Однак його можна повністю вимкнути. Спочатку увімкніть анонімні коментарі, і тоді з’явиться опція вимкнення полів вводу електронної пошти.

Вимкнути поля електронної пошти

При ввімкненому цьому параметрі поля електронної пошти взагалі не будуть відображатися у всіх наших продуктах для коментування.

Зверніть увагу, що з такою конфігурацією всі коментарі будуть непідтвердженими, якщо користувач не створить обліковий запис і не ввійде на https://fastcomments.com.

Ви можете розглянути можливість вимкнення мітки непідтверджено.

За замовчуванням FastComments показуватиме мітку «Неперевірений коментар» для коментарів, залишених користувачем, у якого неперевірена браузерна сесія. Дізнайтеся більше про неперевірені коментарі тут.

Вимкнути мітку неперевіреного коментаря

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

Крім того, цю функцію можна використовувати без написання коду в інтерфейсі налаштувань:

Вимкнути мітку неперевіреного коментаря

Коли користувачі намагаються проголосувати за коментар, і вони не ввійшли в систему, їх просять вказати ім'я користувача та електронну пошту.

Ми можемо прибрати цю вимогу, дозволяючи будь-кому голосувати за коментар, не залишаючи жодної інформації.

Дозволити анонімні голосування

Коли користувачі коментують або голосують, і вони не авторизовані, їх попросять вказати електронну пошту та ім'я користувача.

У разі анонімного коментування іноді бажано визначити ім'я користувача за замовчуванням, щоб зменшити перешкоди під час коментування. Це можна зробити через інтерфейс налаштування. Спочатку має бути увімкнено анонімне коментування.

Налаштування імені користувача за замовчуванням

Спільне використання імені користувача за замовчуванням

Ім'я користувача за замовчуванням — це спільне відображуване ім'я, а не ідентичність. Відвідувач, який залишає ім'я за замовчуванням і вводить свою електронну пошту, отримує власний обліковий запис, де ім'я за замовчуванням відображається як його публічне ім'я. Будь-яка кількість відвідувачів може залишити те саме ім'я за замовчуванням, тому "Anonymous" ніколи не повідомляється як уже зайняте.

Імена користувачів, які відвідувач вводить самостійно, все одно мають бути унікальними.

Якщо ви бажаєте, щоб кожен відвідувач отримував окреме ім'я без необхідності його вигадувати, див. Генерувати імена користувачів автоматично.

Коли користувачі коментують або голосують, не будучи авторизованими, їм буде запропоновано вказати свою електронну пошту та ім'я користувача.

Для деяких сайтів прохання до відвідувача придумати унікальне ім'я користувача є перешкодою, особливо на мобільних пристроях. FastComments може генерувати нейтральне ім'я користувача для кожного нового відвідувача та попередньо заповнювати ним поле імені користувача, наприклад BraveOtter4172.

Відвідувач може залишити його як є або замінити на ім'я на свій розсуд.

Це можна увімкнути в інтерфейсі налаштування Customization, у параметрі під назвою Generate Usernames Automatically:

Автоматична генерація імен користувачів

Як це працює

• Кожне згенероване ім'я є унікальним. Воно перевіряється на відповідність наявним обліковим записам і резервується за сеансом браузера цього відвідувача, тому двом відвідувачам не пропонується однакове ім'я.
• Ім'я генерується лише для відвідувачів, у яких його ще немає. Авторизовані користувачі, користувачі SSO та відвідувачі, які вже коментували, зберігають своє наявне ім'я.
• Це працює як з анонімним коментуванням, так і без нього. Якщо анонімне коментування вимкнено, відвідувач все одно вводить свою електронну пошту, але більше не має вигадувати ім'я користувача.
• Повторний відвідувач, який вводить електронну пошту, яку він використовував раніше, зіставляється зі своїм наявним обліковим записом і зберігає ім'я цього облікового запису.
• Якщо також встановлено Default Username, згенероване ім'я має пріоритет.

За замовчуванням FastComments буде відображати віджет коментарів у локалі, визначеній системою та браузером користувача.

Коли користувач залишає коментар або входить у систему, ми оновлюємо його останню використану локаль і також використовуємо її для надсилання електронних листів.

Це впливає на те, як віджет коментування перекладається для користувача. Локаль складається з мови та регіону користувача, тому налаштування локалі зазвичай змінює мову, якою відображається текст для користувача.

Через інтерфейс користувача

Це можна визначити за допомогою інтерфейсу налаштування віджета. Дивіться параметр «Locale / Language»:

Зміна локалі / мови

Через код

Це можна перевизначити бажаною локаллю.

Вручну визначення локалі користувача

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

Підтримувані мови та коди локалі

Ви можете знайти повний список підтримуваних мов та відповідних кодів локалі тут.

Примітка щодо SSO

Якщо ви використовуєте SSO, можливо, ви захочете передати локаль користувача у об’єкті користувача, щоб електронні листи та інші елементи були правильно локалізовані для нього.

За замовчуванням FastComments не обмежує мови, які використовуються для коментування.

Можливо, буде бажано обмежити мови, які використовує спільнота.

Це можна налаштувати без коду на сторінці налаштування віджета:

Дозволені мови

Система проаналізує їхній коментар, визначить його мову та порівняє її зі списком дозволених.

Якщо коментар написано мовою, яка не дозволена, буде показано локалізоване повідомлення про помилку.

За замовчуванням FastComments перекладає інтерфейс віджета (кнопки, мітки, повідомлення про помилки) на мову глядача, але коментарі відображаються точно так, як їх було написано.

Переклад коментарів додає переклад самих коментарів, тому спільнота, яка пише більш ніж однією мовою, може читати кожен коментар на своїй мові.

Існує два режими:

• Automatic: коментарі, написані мовою, відмінною від мови віджета, відображаються перекладеними. Під коментарем з'являється рядок «Перекладено з іспанської» з посиланням Показати оригінал, яке перемикає між перекладом і неперекладеним текстом.
• Manual: кожен коментар отримує посилання Перекласти. Натискання на нього перекладає цей коментар на мову глядача, після чого з'являється той самий перемикач Показати оригінал. Коментарі, які вже написані мовою глядача, повідомляють про це замість цього.

Цільова мова — це мова віджета: налаштування Локаль / Мова у тому ж правилі налаштування, якщо воно встановлене, інакше — мова браузера відвідувача. Відвідувачу нічого не потрібно, жодного облікового запису, розширення чи додаткового програмного забезпечення, і це працює однаково в вбудованому віджеті та на окремих сторінках коментарів.

Це вмикається для кожного правила налаштування, тому може застосовуватись до всього вашого сайту, одного домену або окремої сторінки. За замовчуванням вимкнено.

Переклад коментарів

Переклад — це налаштування на боці сервера. Передача commentTranslation у JavaScript‑конфігурації віджета не вмикає його; це робить правило.

Кожен коментар перекладається не більше одного разу для кожної цільової мови, і результат зберігається разом з коментарем, тому коментар, прочитаний тисячею іспаномовних, перекладається один раз. Якщо автор або модератор редагує коментар, збережений переклад відкидається, і коментар перекладається знову при наступному перегляді. Перекладений текст проходить ту ж санітизацію та правила посилань, що й оригінальний коментар. Коментарі, які занадто довгі, або мову яких не вдається визначити, відображаються без перекладу.

Використання оплачується у вигляді токенів LLM за тією ж ставкою, що і AI Агенти, і відображається в тому ж розділі вашої платіжної інформації.

Коментування можна заблокувати, щоб не залишати нових коментарів або голосів, встановивши прапорець readonly у значення true.

Коментарі також не можна буде редагувати або видаляти.

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

Це можна налаштувати без коду на сторінці налаштування віджету для всього домену або окремої сторінки:

Зробити гілку коментарів лише для читання

Update!

Станом на листопад 2022 року, гілки можна блокувати або розблоковувати в реальному часі адміністраторами та модераторами через меню з трьома крапками над областю відповіді.

Це запобігатиме появі нових коментарів, при цьому залишатиметься можливість голосування та дозволятиме користувачам видаляти свої коментарі за потреби, чого не дозволяє readonly.

Це відповідає полю isClosed у API Page.

За замовчуванням FastComments дозволяє посилання на будь‑який зовнішній сайт.

Це можна обмежити бажаним списком сайтів або доменів. Спроба опублікувати посилання на сайт або домен, який не входить у визначений список, призведе до показу помилки користувачеві.

Ця перевірка застосовується лише до віджета коментарів та API. Імпорти не підлягають впливу.

Це здійснюється без коду, на сторінці налаштування віджета:

Обмежити домени зовнішніх посилань

За замовчуванням FastComments запитує у користувача лише їхній коментар, ім'я користувача та електронну пошту.

Однак у деяких ситуаціях ви можете захотіти, щоб користувач залишив посилання на свій блог або веб‑сайт.

Ми можемо ввімкнути показ додаткового поля вводу для залишення URL веб‑сайту користувача, встановивши прапорець enableCommenterLinks у true:

Увімкнення посилань коментатора

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

Коли вказаний URL надається, обліковий запис користувача буде оновлено, і всі їхні імена користувачів у всіх минулих та майбутніх коментарях будуть посиланнями на цей URL.

Це можна налаштувати без коду на сторінці налаштування віджету:

Увімкнення посилань коментатора

Список ідентифікаторів, згенерованих на сторінці Групи модерації.

Коли вказано, коментарі, залишені з використанням цієї конфігурації, міститимуть той самий набір moderationGroupIds.

Якщо у Moderator визначено одну або кілька Групи модерації, вони бачитимуть лише коментарі на сторінці Moderate Comments, пов'язані з їхньою групою(групами).

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

Для автентифікації FastComments залежить від увімкнених у вашому браузері сторонніх файлів cookie. Без них користувачі завжди будуть змушені залишати свою електронну пошту, щоб залишити коментар (якщо поле вводу електронної пошти не приховано), і їхні коментарі завжди будуть позначені як неперевірені (за замовчуванням).

Щоб обійти це, ви можете ввімкнути обход сторонніх файлів cookie.

Коли це налаштування ввімкнено, воно викликає невелике спливаюче вікно, яке показує повідомлення про те, що користувач входить у систему. Це спливаюче вікно з’являється щоразу, коли користувач взаємодіє з віджетом коментарів; наприклад, коли залишає коментар.

Ми можемо зробити це в коді, встановивши прапорець enableThirdPartyCookieBypass у значення true:

Увімкнення обходу сторонніх файлів cookie

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

Ми також можемо налаштувати це через інтерфейс налаштування віджету, у розділі Enable Third-Party Cookie Popup:

Увімкнення обходу сторонніх файлів cookie

За замовчуванням користувачі можуть видаляти свої власні коментарі. Крім того, видалення їхнього коментаря автоматично видаляє всі дочірні та тимчасові коментарі в темі. Ця поведінка також активна.

Ви можете обмежити це наступними способами:

• Натомість анонімізуйте видалений коментар (встановіть ім'я та текст у [deleted] або інше значення).
• Не дозволяйте видаляти коментарі, коли є відповіді. Показується налаштовуване повідомлення про помилку.
• Обмежте видалення коментаря з відповідями лише адміністраторами та модераторами.

Це можна налаштувати в розділі Comment Thread Deletion у UI налаштування віджету.

Налаштування поведінки видалення для відповідей

За замовчуванням FastComments відображає значки користувачів лише у їхніх коментарях у межах потоку коментарів.

Проте ми можемо показати значки користувачів поруч із їхнім ім'ям над формою коментаря, увімкнувши цю функцію на сторінці налаштування віджету:

Show Badges in Top Bar Option

Це відобразить значки користувача поруч із його ім'ям у верхній панелі, роблячи його досягнення та статус більш помітними під час написання коментаря.

Зверніть увагу, що ця функція повинна бути увімкнена в інтерфейсі налаштування віджету, щоб працювати. Ви можете за бажанням встановити прапорець showBadgesInTopBar у значення false у вашій конфігурації коду, щоб вибірково вимкнути його, навіть якщо він увімкнений на рівні сервера:

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

За замовчуванням FastComments не показує список користувачів на сторінці.

Ви можете відобразити список людей, які зараз переглядають сторінку, поряд з віджетом коментарів. Список оновлюється в реальному часі, коли користувачі приєднуються та виходять, і показує їх ім'я, аватар та індикатор онлайн.

Існує три варіанти розташування:

• 1 - Верх: горизонтальний ряд накладаються аватарок, розташований над коментарями.
• 2 - Ліво: бічна панель з іменами та онлайн‑точками, розташована ліворуч від віджета.
• 3 - Право: та сама бічна панель, розташована праворуч від віджета.

Встановіть прапорець usersListLocation, щоб увімкнути функцію:

Show Users List on the Right

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

За замовчуванням список показує лише користувачів, які зараз онлайн. Щоб також включити людей, які раніше коментували сторінку (але зараз її не переглядають), встановіть usersListIncludeOffline у true:

Include Past Commenters

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

Колишні коментатори відображаються без зеленого онлайн‑крапки, щоб було зрозуміло, хто присутній зараз.

Користувачі з приватними профілями відображаються загальним аватаром і міткою "Приватний профіль", щоб підрахунок залишався точним без розкриття особистих даних.

Це також можна налаштувати без коду. На сторінці налаштування віджета перегляньте параметр "Users List Location". Коли розташування встановлено не в "Вимкнено", під ним з'являється прапорець "Include past commenters".

Налаштування списку користувачів

За останні 500 живих користувачів список може відставати до 30 секунд.