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

Ви можете помітити, що віджет коментарів можна використовувати з 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

Усі налаштовувані переклади можна знайти тут під вкладкою "розширені параметри".

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

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

Всі заміни перекладів наразі впливають на всі локалі.

Коли користувач коментує за допомогою 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.

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

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

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

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

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

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

By default, FastComments will show the user's name as they entered it, or how it was passed to us via SSO.

However, it may be desirable to mask or show the user's name in a different way. For example, if the user's name is Allen Rex, maybe you want to only show "Allen R.".

This can be done without code in the Widget Customization UI, under the setting called Commenter Name Format:

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

The available formats are:

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

The effect of changing this is immediate. User's will still see their full username at the top of the comment area, for themselves, but their comments will show the modified username.

Usernames are masked server-side to protect users.

За замовчуванням 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

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

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

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

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

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

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

Додавання власних провайдерів

If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "Додаткові домени вбудовування" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.

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

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

Однак ми можемо ввімкнути його, встановивши прапорець 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:

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

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

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

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

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

By default, each user can submit up to 5 comments in the same minute.

This is tracked by user id, anon user id, and ip address (hashed).

This can be customized without code, on the widget customization page:

Limiting Comment Volume Per User

Note that if you're using the comment creation API may want to pass the user's original ip address in the request to our backend so rate limiting is applied до користувача і не глобально до вашого облікового запису.

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

Коли увімкнено:

• Анонімні користувачі побачать чекбокс Умов обслуговування щоразу, коли вони коментують
• Авторизовані користувачі побачать чекбокс лише у своєму першому коментарі або коли ви оновлюєте ваші Умови обслуговування

Configuration

Перейдіть на сторінку налаштування віджету та увімкніть чекбокс «Вимагати прийняття Умов обслуговування». Після увімкнення ви побачите наступні параметри:

Параметри Умов обслуговування

• Режим тексту Умов: За замовчуванням чекбокс відображає «I agree to the Terms of Service and Privacy Policy» з посиланнями на обидва документи. Виберіть «Customize text per locale», щоб надати власний текст для кожної мови.
• Дата останнього оновлення Умов: Коли ви оновлюєте ваші Умови обслуговування, встановіть цю дату. Користувачі, які прийняли їх до цієї дати, будуть змушені прийняти їх знову.

How It Works

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

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

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

The flow looks like this:

Потік Secure SSO

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

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

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

Отримайте свій секретний ключ API

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

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

High-level API documentation for the comment widget can be found here.

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

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

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

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

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

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

Об'єкт користувача

Об'єкт користувача

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 символів. Це відображатиметься замість username. **/

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 /** Масив глобальних ID значків для призначення. Обмеження — 30 значків. Порядок зберігається. **/

36 badgeIds: string[];

37 /** Масив ID значків, прив'язаних до поточної сторінки (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-пейлоуді, його налаштування сповіщень будуть оновлені.

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

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

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

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

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

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

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

Більше деталей та прикладів можна знайти тут (js), тут (java) та тут (php).

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

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

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

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

No-Code Setup

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

Під час цього пошукайте SSO, і ви знайдете цю опцію:

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

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

Only Protect a Certain Domain or Page

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

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

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

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

Security Levels

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

Опція рівня безпеки з’явиться, коли ви виберете «Require SSO To View Comments».

Protection Beyond Reading

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

Gotchas

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

За замовчуванням 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

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

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

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

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

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

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

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

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

За замовчуванням 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 не обмежує мови, які використовуються для коментування.

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

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

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

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

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

Коментування можна заблокувати, щоб не залишати нових коментарів або голосів, встановивши прапорець 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 секунд.