You may notice that the comment widget can be used with a Tenant ID of "demo", for example:

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

This is only meant to try out and play with the comment widget. In production, you would pass your Tenant ID, like so:

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

Your Tenant ID can be found already applied on the comment widget фрагменті коду у вашому акаунті.

You can also find your Tenant ID and manage your API keys на сторінці облікових даних API.

From this point on, if you are logged into FastComments, the code examples will use your real Tenant ID (if you are logged in on https://fastcomments.com).

When rendering a comment thread, or leaving a comment, FastComments needs to know what page, or article, or product those comments belong to.

To do this, we use something we call the "URL ID". It's either an identifier, like a string or a number, or a URL.

By default, if you do not specify the urlId, it will become the page URL. We will take the current page URL, and clean it to remove any common marketing parameters or tracking identifiers.

In the case of third party integrations, like WordPress, our plugin will usually use the identifier that represents the current information being viewed as the URL ID, for example the article/page 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

One thing that we'll often reference in this document is the Widget Customization UI.

This UI can be used to make many changes to the comment widget without using code.

When creating a customization rule, we'll often want it to apply to all pages to our site. However, in some cases we want to customize the comment widget on a particular page, either to apply custom styling, or maybe make comments for that particular page anonymous. You could also, for example, have live comments appear right away on some pages, while hiding them under notification buttons on others.

This is all possible via the URL ID input field on this page, which looks like as follows:

URL ID Input in The Widget Customization Page

The value in this field should match the urlId parameter passed into the comment widget. If you want your customization rule to be urlId agnostic, leave this field empty or enter *.

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. If your page has hash parameters (like example.com#page-1) - this will become part of the URL ID, by default.
2. During migrations, for example from WordPress to Gatsby, you may have to migrate the URL ID comment values after the initial migration. For that, reach out to us.

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

Первый, самый простой способ, и тот, который мы предпочитаем — использовать страницу настройки виджета.

В разделе настройки виджета найдите «Показать расширенные параметры», в котором есть область с названием «Пользовательский 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

Вы можете заставить виджет подтянуть внешний файл, используя @import!

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

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

In Code - Not Recommended

Также можно загрузить внешний CSS-файл через свойство customCSS:

External CSS File

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

Однако помните, что в этом случае ваш CSS не сможет быть протестирован нами.

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 мы знаем, что наши клиенты настраивают виджет комментариев. Это сделано намеренно — последнее, чего мы хотим, чтобы наш продукт вызывал несоответствия в дизайне вашего продукта.

Поскольку это важная часть нашего продукта, у нас есть сборочный конвейер, который позволяет нам проверять изменения виджета комментариев для каждого клиента при каждом релизе.

Если мы обнаружим незначительные проблемы, мы обновим вашу учётную запись, чтобы обеспечить плавный релиз. Если мы увидим серьёзные несовместимости, это позволит нам приостановить релиз.

Для клиентов с тарифами Pro или Enterprise разрешено использование white-label (удаление фирменной символики). Просто свяжитесь с нами, и мы будем рады помочь.

Если вы просто хотите убрать наш логотип из виджета комментариев, это автоматически доступно на тарифах 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)» под этим комментарием.

Если вы хотите показать все комментарии верхнего уровня в сочетании с этой опцией, установите starting page to -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 отображает панель инструментов при написании комментария, чтобы предоставить ярлыки для оформления текста и загрузки изображений.

Эту панель инструментов можно отключить в коде или через интерфейс настройки.

Disabling The Toolbar

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Это также можно сделать без кода. На странице настройки виджета выберите опцию "Отключить панель ответов".

Disabling The Toolbar

По умолчанию 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

Это можно настроить без кода, на странице настройки виджета, в разделе «Дополнительные параметры». Сначала вам нужно будет включить «Абсолютные даты», чтобы увидеть эту опцию в интерфейсе.

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 anchor tag.

Некоторые сайты могут захотеть отключить это, например, чтобы отпугнуть мошенников. Мы предоставляем эту возможность, установив 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.

Количество обновляется в реальном времени вместе с потоком комментариев. Кнопка не показывается, если комментариев нет.

Это можно включить без кода, создав правило кастомизации и включив "Click to Show Comments":

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

По умолчанию 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.

Это можно задать в коде или через UI. В коде мы можем сделать это следующим образом:

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

В UI это находится в разделе 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

• Это влияет только на обычных комментаторов (Commenters), а не на модераторов или администраторов — они по-прежнему смогут удалять.
• Это также влияет на интеграции API в случаях, когда передаётся contextUserId.

По умолчанию FastComments позволяет пользователям редактировать свои комментарии.

Однако это можно запретить.

На странице настройки виджета найдите опцию «Отключить редактирование».

Disable Comment Editing

• Это влияет только на обычных комментаторов и не затрагивает модераторов или администраторов, которые по-прежнему смогут редактировать.
• Это также повлияет на интеграции через API, когда передаётся contextUserId.

По умолчанию размер страницы FastComments — 30. Это включает ответы в ветках.

Размер страницы можно настроить в интерфейсе настройки виджета в диапазоне от 10 до 200.

Обратите внимание, что изменение размера страницы требует перерасчёта всех веток комментариев в вашей учётной записи. Это может занять несколько минут.

Это нельзя настроить в клиентском виджете, поскольку страницы вычисляются на стороне сервера.

Пример конфигурации показан ниже:

Custom Page Sizes

Размеры страниц можно настраивать глобально, по домену или по странице, создавая разные правила настройки.

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

По умолчанию 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.

Отключение загрузки изображений

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

Это можно настроить без кода, на странице настройки виджета:

Отключение загрузки изображений

По умолчанию в виджете комментариев поле поиска не отображается.

Однако его можно включить, установив флаг 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

Когда текст выделен, и нажата теперь видимая кнопка 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 пользователя*, который просматривал комментарий, поэтому при повторном просмотре комментария счётчик не увеличивается. Если вы просмотрите комментарий снова через два года, счётчик увеличится снова.

• *Примечание: или анонимный идентификатор сессии, или 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 включены живые комментарии.

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

Например, если комментарий добавлен, этот комментарий появится. Если комментарий отредактирован или удалён, то эти изменения будут видны всем пользователям ветки. То же самое относится к голосам и всем действиям модерации.

Однако это можно отключить:

Disable Live Commenting

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Это также можно сделать без кода. На странице настройки виджета смотрите раздел «Disable Live Commenting».

Disable Live Commenting

По умолчанию FastComments сортирует комментарии по направлению сортировки "Most Relevant".

Сортировка "Most Relevant" учитывает время оставления комментария и количество голосов при определении порядка.

Пользователь затем может изменить направление сортировки на «Старые сначала» или «Новые сначала» в интерфейсе виджета комментариев.

Однако мы можем изменить значение по умолчанию на любое из трёх. Например, если вы хотите показывать сначала самые старые комментарии:

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

Для сортировки с сначала новыми комментариями, мы сделали бы следующее:

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 адресу (в хэшированном виде).

Это можно настроить без кода на странице настройки виджета:

Limiting Comment Volume Per User

Обратите внимание, что если вы используете comment creation API, возможно, стоит передать исходный ip адрес пользователя в запросе к нашему бэкенду, чтобы rate limiting применялся к пользователю, а не глобально ко всему вашему аккаунту.

FastComments Secure SSO использует HMAC-SHA256 в качестве механизма для реализации SSO. Сначала мы рассмотрим общую архитектуру, приведём примеры и детальные шаги.

Также есть документация по миграции с других провайдеров с похожими SSO-механизмами и описаны различия.

Поток выглядит следующим образом:

Secure SSO Flow

Поскольку Secure SSO включает full-stack разработку, рабочие примеры кода на Java/Spring, NodeJS/Express и чистом PHP в данный момент находятся на GitHub.

Хотя в примере NodeJS мы используем ExpressJS, а в примере Java — Spring, в этих рантаймах не требуются какие-либо фреймворки/библиотеки для реализации FastComments SSO — работают встроенные криптопакеты.

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

Получение вашего секретного ключа API

Ваш API Secret можно получить на этой странице. Эту страницу также можно найти, перейдя в 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: При передаче вместо 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": 1768890093961,

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

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

13 }

14}];

15</script>

16

Объект пользователя

The User object contains the following schema:

Объект пользователя

Copy

1

2interface SSOUser {

3 /** Обязательно. Максимум 1k символов. **/

4 id: string;

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

6 email: string;

7 /** Обязательно. Максимум 1k символов. Примечание: username не может быть 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 символов. Имя пользователя будет ссылаться на этот URL. **/

20 websiteUrl?: string;

21 /** Необязательно. До 100 групп на пользователя. ID группы не может быть длиннее 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

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

Для админов и модераторов передайте соответствующие флаги isAdmin или isModerator в объекте SSOUser.

Уведомления

Чтобы включить или отключить уведомления, установите значение optedInNotifications в true или false соответственно. При первом загрузке страницы пользователем с этим значением в SSO-пейлоаде его настройки уведомлений будут обновлены.

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

VIP-пользователи и специальные метки

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

Неаутентифицированные пользователи

Чтобы представить неаутентифицированного пользователя, просто не заполняйте userDataJSONBase64, verificationHash или timestamp. Предоставьте loginURL.

Эти пользователи не смогут комментировать; им будет показано сообщение о входе (сообщение, ссылка или кнопка, в зависимости от конфигурации).

Прямые примеры сериализации и хеширования данных пользователя

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

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

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

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

Изменив настройку, мы можем запретить получение комментариев, если это не делает администратор или действительный пользователь SSO.

Настройка без кода

Если SSO настроен, мы можем предотвратить просмотр и взаимодействие с ветками комментариев, создав правило настройки.

При этом найдите SSO, и вы увидите этот вариант:

Require SSO To View Comments

Включите её и сохраните правило настройки.

Защита только определённого домена или страницы

Чтобы защитить только определённый домен или страницу, мы просто настроим правило настройки соответствующим образом.

В верхней части интерфейса настройки вы найдёте два поля: Domain и URL ID.

Чтобы защитить конкретный домен, введите соответствующий домен в поле "domain".

Чтобы защитить отдельную страницу, введите URL страницы в поле "URL ID". Если у вас есть собственная интеграция с FastComments, вы можете ввести здесь тип идентификатора вместо URL.

Уровни безопасности

При включении требования SSO вам нужно решить, требуется ли Simple SSO или Secure SSO. Если требуется Simple SSO, разрешены оба варианта; если же требуется Secure SSO, то содержимое должно быть получено с использованием Secure SSO payload, хешированного вашим API key, чтобы его можно было просмотреть.

Параметр уровня безопасности появится, когда вы выберете "Требовать SSO для просмотра комментариев".

Защита помимо просмотра

Включение этой опции защитит страницу или домен от возможности оставлять комментарии, если пользователь не вошёл через SSO.

Подводные камни

Пользователи, которые оставляли комментарии до интеграции SSO, не смогут их видеть, пока не войдут через вашу SSO-интеграцию.

По умолчанию FastComments требует адрес электронной почты для комментирования. Он не обязательно должен быть действительным, однако до тех пор, пока пользователь не перейдёт по ссылке, отправленной ему, его комментарий будет отображаться с меткой "Непроверенный комментарий".

Однако мы можем убрать требование электронной почты. Поле ввода электронной почты по-прежнему будет отображаться, но больше не будет обязательным.

Это можно настроить через интерфейс настройки виджета:

Enabling Anonymous Comments

FastComments можно настроить на удаление неподтверждённых комментариев через заданное количество дней. Это помогает бороться со спамом.

По умолчанию этого не происходит.

Это можно настроить или отключить на странице Настройки модерации.

Moderation Settings

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

Это создаст для этого пользователя "неверифицированную сессию", и мы попросим его подтвердить эту сессию по электронной почте.

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

Включение анонимных комментариев делает поле ввода электронной почты необязательным. Однако мы можем полностью его отключить. Сначала включите анонимные комментарии, затем появится опция отключения полей ввода электронной почты.

Disable Email Inputs

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

Обратите внимание, что с этой конфигурацией все комментарии будут непроверенными, если пользователь не создаст аккаунт и не войдёт на https://fastcomments.com.

Вы можете рассмотреть возможность отключения метки «Непроверенный».

По умолчанию FastComments будет показывать метку "Unverified Comment" для комментариев, оставленных для пользователя, у которого есть непроверенная сессия браузера. Подробнее о непроверенных комментариях см. здесь.

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

Кроме того, эту функцию можно использовать, не написав ни строчки кода, в интерфейсе Customization UI:

Disable The Unverified Label

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

Мы можем убрать это требование, позволяя любому голосовать за комментарий, не оставляя никакой информации.

Allow Anonymous Votes

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

В случае анонимных комментариев иногда бывает полезно задать имя пользователя по умолчанию, чтобы снизить трение при комментировании. Это можно сделать через интерфейс настройки. Сначала должна быть включена функция анонимных комментариев.

Setting The Default Username

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

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

Это влияет на то, как виджет комментариев переводится для пользователя. Локаль состоит из языка и региона пользователя, поэтому настройка локали будет обычно изменять язык, используемый для отображения текста пользователю.

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

Это можно задать с помощью интерфейса настройки виджета. См. опцию "Локаль / Язык":

Changing The Locale / Language

Через код

Это можно переопределить, указав нужную локаль.

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, возможно, вы захотите передать локаль пользователя в объекте user, чтобы электронные письма и другие элементы были корректно локализованы для пользователя.

По умолчанию FastComments не ограничивает языки, используемые для комментариев.

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

Это можно настроить без кода на странице настройки виджета:

Allowed Languages

Система проанализирует комментарий, определит его язык и сравнит его со списком разрешённых языков.

Если комментарий написан на языке, который не разрешён, будет показано локализованное сообщение об ошибке.

Комментирование можно заблокировать так, чтобы новые комментарии или голоса не могли быть оставлены, установив флаг readonly в 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 "readonly": true

8}];

9</script>

10

Это можно настроить без кода, на странице настройки виджета, для всего домена или отдельной страницы:

Сделать ветку комментариев только для чтения

Обновление!

Начиная с ноября 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 требует, чтобы в вашем браузере были включены сторонние cookies. Без них пользователям всегда придётся оставлять свой адрес электронной почты, чтобы комментировать (если поле ввода email не скрыто), а их комментарии по умолчанию будут отображаться как неподтверждённые.

Чтобы обойти это, вы можете включить обход блокировки сторонних cookies.

Когда эта опция включена, будет появляться небольшое всплывающее окно с сообщением о входе пользователя в систему. Это всплывающее окно появляется каждый раз, когда пользователь взаимодействует с виджетом комментариев; например, когда он оставляет комментарий.

Это можно сделать в коде, установив флаг 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

Также это можно настроить через интерфейс настройки виджета (Widget Customization UI), в разделе 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