Возможно, вы заметите, что виджет комментариев можно использовать с 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, например идентификатор статьи/страницы.

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

Первый, самый простой подход, и предпочтительный для нас, — использовать widget customization page.

На странице настройки виджета найдите раздел "Show Advanced Options", в котором есть область с надписью "Custom CSS":

Custom CSS Input Area

У этого подхода есть несколько преимуществ:

1. Введённый CSS минифицируется перед отправкой пользователю, и форматирование сохраняется единообразным в интерфейсе редактирования.
2. Вы получаете все преимущества UI настройки виджета, например простую возможность по-разному настраивать виджет комментариев для разных сайтов.
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 в правило кастомизации. Таким образом, если нам когда-либо потребуется внести изменение в виджет комментариев, мы сможем использовать наши автоматизированные инструменты для проверки вашей настройки. Например, вы можете создать правило кастомизации в UI настройки виджета, нажать 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. Без этого префикса пользовательские стили будут игнорироваться для модальных окон профиля пользователя.

Например:

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

Если вы просто хотите удалить наш логотип из виджета комментариев, это автоматически включено в тарифах Flex и Pro.

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

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

Во-первых, во всех текущих версиях библиотеки Comment widget (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

This can also be done without code. In the widget customization page, see the "Включить расширенное форматирование" option.

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-ссылкой.

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

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

Однако можно изменить стиль панели голосования. Текущие варианты — стандартные кнопки Up/Down или механизм голосования в стиле Heart.

Мы используем флаг voteStyle следующим образом:

Enable Heart Button

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Мы настоятельно рекомендуем делать это без кода, так как это также включает серверную валидацию. На странице настройки виджета смотрите раздел "Vote Style".

Change Voting Style

Голосование также можно отключить, см. Disable Voting выше параметров стиля.

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

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

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

Disable Comment Deleting

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

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

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

На странице настройки виджета найдите опцию "Disable Editing".

Disable Comment Editing

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

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

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

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

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

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

Custom Page Sizes

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

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

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

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

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

Когда текст выделен, и становится видна кнопка 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

Мы отслеживаем user id* который просматривал комментарий, поэтому при повторном просмотре комментарий не увеличивает счетчик. Если вы просмотрите комментарий снова спустя два года, счетчик увеличится.

• *Примечание: или anon session 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

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

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

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: "Самые недавние"
• NF: "Сначала новые"
• OF: "Сначала самые старые"

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

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

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

The flow looks like this:

Поток Secure SSO

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

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

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

Получение вашего API Secret Key

Ваш 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: При передаче вместо 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": 1768890093834,

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 /** Обязательно. Макс. 1k символов. **/

4 id: string;

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

6 email: string;

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

8 username: string;

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

10 avatar?: string;

11 /** Необязательно. По умолчанию false. **/

12 optedInNotifications?: boolean;

13 /** Необязательно. По умолчанию false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Необязательно. Макс. 100 символов. Эта метка будет отображаться рядом с именем. По умолчанию — Администратор/Модератор, если применимо. **/

16 displayLabel?: string;

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

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

Moderators and Administrators

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

Notifications

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

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

VIP Users & Special Labels

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

Unauthenticated users

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

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

Direct Examples for Serializing and Hashing User Data

Более подробные примеры доступны здесь (js), здесь (java) и здесь (php).

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

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

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

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

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

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

При этом найдите SSO — вы увидите эту опцию:

Require SSO To View Comments

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

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

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

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

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

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

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

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

Параметр уровня безопасности появится, когда вы выберете "Require SSO To View Comments".

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

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

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

Пользователи, создавшие комментарии до интеграции 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

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

Disable The Unverified Label

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

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

Разрешить анонимные голоса

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

В случае анонимного комментирования иногда целесообразно задать имя пользователя по умолчанию, чтобы снизить трение при комментировании. Это можно сделать из Customization UI. Anonymous Commenting must be enabled first.

Setting The Default Username

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

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

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

Via The UI

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

Changing The Locale / Language

Via Code

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

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

Supported Languages and Locale Codes

Полный список поддерживаемых языков и соответствующих кодов локалей можно найти здесь.

SSO Note

Если вы используете SSO, возможно, стоит передавать локаль пользователя в объекте 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:

Включение ссылок комментаторов

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

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

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

Включение ссылок комментаторов

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

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

Если у Moderator определена одна или несколько Групп модерации, они будут видеть только комментарии на странице Moderate Comments, связанные с их группой(ами).

Specify Moderation Groups

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

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

Чтобы обойти это, можно включить обход сторонних 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