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

Defining a Custom URL ID

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

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

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

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

URL ID Input in The Widget Customization Page

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

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

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

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

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

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

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

Custom CSS Input Area

Цей підхід має кілька переваг:

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

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

Passing Custom CSS

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

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

External CSS Files

You can tell the widget to fetch an external file by using @import!

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

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

In Code - Not Recommended

You can also load an external CSS file via the customCSS property:

External CSS File

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

However, remember that your CSS won't be able to be tested by us if you do this.

User Profile Modal Styling

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

For example:

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

Backwards Compatibility

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

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

If we find minor issues, we will update your account to ensure our release goes smoothly. If we see major breaking changes, this allows us to halt the release.

Для клієнтів з тарифними планами 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 увесь текст у віджеті коментарів налаштовується.

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

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

Custom Text

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

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

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

Custom Text

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

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

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

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

Override The Default Avatar

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Customizing The Default Avatar

Зверніть увагу, що визначення аватара для конкретного користувача, наприклад при SSO, описано в окремому розділі.

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

Hiding Avatars

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

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

Hiding Avatars

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

Усі стилі за замовчуванням можна видалити, встановивши параметр 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

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

Disabling All Default Styles

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

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

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

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

Collapse Replies

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

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

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

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

Enabling WYSIWYG Editing

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

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

Enable 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

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

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

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

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

Disable Blocking

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

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

Disable Blocking

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

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

Use Absolute Dates

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

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

Use Both Absolute and Relative Dates

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

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

Use Both Absolute and Relative Dates

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

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

Specifying Header HTML

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Specifying Header HTML

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

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

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

Render 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.

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

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

Enable Click to Show Comments

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

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

Customizing The Comment Count Text

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Customizing The Comment Count Text

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

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

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

Disabling Automatic HashTag Creation

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

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

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

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

Однак можна повністю вимкнути іконку дзвінка сповіщень:

Disable Notification Bell

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

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

Disable Notification Bell

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

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

Disable Profiles

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

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

Disable Profiles

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

Disable Success Message

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

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

Disable Success Message

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

Доступні опції: g, pg, pg-13 та r.

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

Set Gif Rating

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

В інтерфейсі це знаходиться в розділі Gif Picker Rating, якщо не встановлено прапорець Disable Image Uploads?.

Setting The Gif Rating

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

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

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

Setting The Image Content Moderation Level

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

Ми настійно радимо зробити це без коду, оскільки це також включає серверні валідації. На сторінці налаштування віджета див. розділ «Стиль голосування».

Change Voting Style

Голосування також можна вимкнути — див. Disable Voting вище за опціями стилю.

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

Однак це можна заборонити.

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

Disable Comment Deleting

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

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

Проте це можна заборонити.

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

Disable Comment Editing

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

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

Розмір сторінки можна налаштувати в інтерфейсі налаштування віджета на різні значення від 10 до 200.

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

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

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

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

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

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

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

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

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

Change Name Format

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

• Капіталізація (відображає Example User як Example User)
• Ініціал прізвища (відображає Example User як Example U.)
• Усі ініціали (відображає Example User як E. U.)
• Показувати "Anonymous"

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

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

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

Disabling Image Uploads

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

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

Disabling Image Uploads

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

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

Enabling Search

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

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

Enable Search Box

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

Enabling Spoilers

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

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

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

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

Enabling Comment View Counts

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

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

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

Однак за замовчуванням ці нові коментарі з'являються під динамічно показаною кнопкою з текстом, подібним до "Показати 2 нові коментарі".

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

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

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

Отже, назва прапорця, що вмикає цю функцію: 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

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

Show Live Comments Right Away

За замовчуванням у 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» у інтерфейсі віджета коментарів.

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

Changing The Default Sort To Oldest First

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

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

Для напрямку сортування «Newest First» ми зробили б таке:

Changing The Default Sort To Newest First

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

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

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

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

Changing The 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

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

Moving The Reply Box to The Bottom

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

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

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

Limit Comment Length

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

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

Limit Comment Length

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

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

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

Enable Single-Line Comment Input

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

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

Enable Single-Line Comment Input

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

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

Це відстежується за user id, anon user id, та ip address (hashed).

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

Limiting Comment Volume Per User

Зверніть увагу, що якщо ви використовуєте comment creation API, можливо, варто передати оригінальну ip адресу користувача в запиті до нашого backend, щоб rate limiting застосовувався per user і не глобально до вашого акаунту.

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

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

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

Потік Secure SSO

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

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

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

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

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

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

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

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

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

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

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

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

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

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

13 }

14}];

15</script>

16

The User Object

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

Copy

1

2interface SSOUser {

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

4 id: string;

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

6 email: string;

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

8 username: string;

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

10 avatar?: string;

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

12 optedInNotifications?: boolean;

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

14 optedInSubscriptionNotifications?: boolean;

15 /** Необов'язково. Максимум 100 символів. Ця мітка буде показана поруч із їхнім ім'ям. За замовчуванням — Адміністратор/Модератор, коли застосовується. **/

16 displayLabel?: string;

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

18 displayName?: string;

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

20 websiteUrl?: string;

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

22 groupIds?: string[];

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

24 isAdmin?: boolean;

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

26 isModerator?: boolean;

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

28 isProfileActivityPrivate?: boolean;

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

30 isProfileCommentsPrivate?: boolean;

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

32 isProfileDMDisabled?: boolean;

33}

34

Moderators and Administrators

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

Notifications

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

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

VIP Users & Special Labels

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

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

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

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

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

Додаткові деталі та приклади доступні тут (js), тут (java) та тут (php).

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

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

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

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

No-Code Setup

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

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

Require SSO To View Comments

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

Only Protect a Certain Domain or Page

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

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

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

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

Security Levels

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

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

Protection Beyond Reading

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

Gotchas

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

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

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

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

Enabling Anonymous Comments

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

За замовчуванням цього не відбувається.

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

Moderation Settings

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

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

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

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

Disable Email Inputs

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

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

Можливо, ви захочете розглянути відключення позначки «непідтверджено».

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

Disable The Unverified Label

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

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

Disable The Unverified Label

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

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

Allow Anonymous Votes

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

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

Setting The Default Username

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

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

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

Через інтерфейс

Це можна задати за допомогою інструментів налаштування віджета. Див. опцію "Locale / Language":

Changing The Locale / Language

Через код

Це можна перевизначити, вказавши бажаний locale.

Manually Defining the User's Locale

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

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

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

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

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

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

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

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

Allowed Languages

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

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

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

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

Making The Comment Thread Readonly

Оновлення!

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

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

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

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

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

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

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

Restrict External Link Domains

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

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

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

Enabling Commenter Links

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

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

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

Enabling Commenter Links

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

Коли вказано, коментарі, залишені з використанням цієї конфігурації, міститимуть той самий набір 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:

Enabling Third-Party Cookie Bypass

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

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

Enabling Third-Party Cookie Bypass

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

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

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

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

Customize Delete Behavior for Replies

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