Може да забележите, че коментарният widget може да се използва с 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

Това е само за опитване и игра с коментарния widget. В продукция трябва да подадете вашия 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 може да бъде намерен вече приложен в коментарния widget фрагмент от кода в акаунта ви.

Също така можете да намерите вашия Tenant ID и да управлявате вашите API ключове на страницата с API идентификационни данни.

Оттук нататък, ако сте влезли в FastComments, примерите с код ще използват вашия реален Tenant ID (ако сте влезли на https://fastcomments.com).

Когато се рендерира нишка с коментари или се оставя коментар, FastComments трябва да знае към коя страница, статия или продукт принадлежат тези коментари.

За това използваме това, което наричаме "URL ID". То е или идентификатор, като низ или число, или URL.

По подразбиране, ако не посочите urlId, той ще стане URL на страницата. Ние ще вземем текущия URL на страницата и ще го почистим, за да премахнем общи маркетингови параметри или проследяващи идентификатори.

В случаите на интеграции от трети страни, като WordPress, нашият плъгин обикновено ще използва идентификатора, който представлява в момента разглежданата информация, като URL ID, например id на статията/страницата.

Defining a Custom URL ID

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

Едно нещо, към което често ще се отнасяме в този документ, е Потребителският интерфейс за персонализиране на уиджета.

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

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

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

URL ID Input in The Widget Customization Page

Стойността в това поле трябва да съвпада с параметъра urlId, подаван към уиджета за коментари. Ако искате вашето правило за персонализиране да е независимо от urlId, оставете това поле празно или въведете *.

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

Подводни камъни

1. Ако вашата страница има hash параметри (като example.com#page-1) - това по подразбиране ще стане част от URL ID.
2. По време на миграции, например от WordPress към Gatsby, може да се наложи да мигрирате стойностите на URL ID за коментари след първоначалната миграция. За това се свържете с нас.

FastComments е проектиран да бъде персонализиран. Същинският widget за коментари работи вътре в iframe по съображения за сигурност, така че за да приложите персонализирано стилизиране трябва да следвате един от двата подхода.

Първият, най-лесният подход и предпочитан от нас, е да използвате widget customization page.

В страницата за персонализиране на widget-а вижте секцията "Show Advanced Options", под която има област с етикет "Custom CSS":

Custom CSS Input Area

Този подход има няколко предимства:

1. Въведеният CSS се минифицира преди да бъде изпратен до потребителя и форматирането се запазва консистентно в UI за редактиране.
2. Получавате всички предимства на потребителския интерфейс за персонализиране на widget-а, например лесно персонализиране на widget-а за коментари различно за различни сайтове.
3. Когато правим промени по widget-а за коментари, вашето персонализирано стилизиране ще бъде тествано като част от нашия процес на издаване.

Вторият подход е да зададете параметъра customCSS в конфигурацията на widget-а, както следва:

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. Съществува ограничение колко много custom CSS може да бъде подаден, преди нашите сървъри да отхвърлят заявката, поради размера на header-ите.
2. Трябва да управлявате custom CSS във вашата инфраструктура и в системата за билд. Това може да е предимство, а не недостатък.
3. Има допълнителен разход за изпращане на custom CSS през мрежата дважди в този случай, тъй като трябва да бъде изпратен към нашите сървъри и след това върнат в съдържанието на iframe-а. Въпреки това за повечето размери на payload това не е забележимо.
4. Честа оптимизация е минифициране на CSS, за да се намали размерът му по мрежата, но при този подход ще трябва вие да се погрижите за това.
5. Вашият custom CSS няма да бъде тестван когато правим промени.

External CSS Files

Можете да накарате widget-а да зареди външен файл като използвате @import!

Препоръчително е да поставите @import в правило за персонализиране. По този начин, ако някога трябва да направим промяна в widget-а за коментари, можем да използваме нашите автоматизирани инструменти за да проверим вашата конфигурация. Така например, бихте създали правило за персонализиране в UI-то за персонализиране на widget-а, щракнете 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

Модалите с потребителски профили също могат да бъдат стилизирани с custom 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 знаем, че нашите клиенти персонализират widget-а за коментари. Това е по дизайн - последното нещо, което искаме, е нашият продукт да предизвиква дизайнерски несъответствия във вашия продукт.

Тъй като това е важна част от нашия продукт, имаме билд pipeline, който ни позволява да преглеждаме промените по widget-а за коментари, за всеки клиент, при всяко издание.

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

За клиентите с акаунти Pro или Enterprise е разрешено използване на white-label (премахване на нашето брандиране). Просто свържете се с нас и ще се радваме да помогнем.

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

Тези планове също така предоставят същата функционалност за имейли, изпращани от нашата платформа.

За сайтове, които позволяват превключване на тъмен режим след първоначалното зареждане на страницата, това е малко по-сложно.

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

Можете да замените един елемент от текста, като бутона за изпращане, или целия текст във въпросния уиджeт за коментари.

По подразбиране текстът в уиджета за коментари се превежда въз основа на локала на потребителя. Въпреки това можем да пренапишем текста, ако сме уверени че нашата база потребители използва един и същ локал/език, например:

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

Всички персонализирани преводи могат да бъдат намерени тук под раздела "разширени опции".

Има обаче по-лесен начин, чрез UI за персонализиране на уиджета. Там просто можем да намерим текста, който се показва в уиджета за коментари в локала EN_US, и да зададем замяна.

Custom Text

В момента всички замествания на преводи засягат всички локали.

Когато потребител публикува коментар с FastComments за първи път, ще се опитаме да изтеглим техния аватар от http://gravatar.com/.

Ако обаче не намерим аватар, или потребителят никога не е задавал такъв в своя профил, показваме статично изображение по подразбиране като аватар.

За да посочите собствено статично изображение за аватар, може да използвате настройката defaultAvatarSrc.

Override The Default Avatar

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

Това може да се направи и без код. В страницата за персонализиране на уиджета вижте секцията "Аватар по подразбиране".

Customizing The Default Avatar

Обърнете внимание, че задаването на аватар за конкретен потребител, например при SSO, е разгледано в отделна секция.

Аватарите могат да бъдат напълно премахнати от коментарния уиджет, дори ако потребителите са задали свои собствени аватари.

Hiding Avatars

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Това може да се персонализира без код, на страницата за персонализиране на уиджета:

Hiding Avatars

За по-големи проекти за персонализиране на стила може да е желателно да започнете от нулата и изобщо да не използвате подразбиращите се стилове.

Цялото подразбиращо се стилизиране може да бъде премахнато, като зададете параметъра noStyles на true, както следва:

Disabling All Default Styles

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

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

Disabling All Default Styles

По подразбиране отговорите на коментарите от най-горно ниво се показват.

Това може да се конфигурира така, че потребителят да трябва да кликне върху "Покажи отговорите" при коментарите от най-горно ниво, за да види децата.

Collapse Replies to Top Level Comments

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Това може да се персонализира без код, на страницата за персонализиране на уиджета:

Collapse Replies

Тази настройка няма да повлияе на броя на първоначално заредените коментари от най-горно ниво. Ако имате един коментар от най-горно ниво и 29 отговора, с включена тази настройка вие ще:

• Ще видите коментара от най-горно ниво.
• Ще видите "Покажи отговорите (29)" под този коментар.

Ако желаете да показвате всички коментари от най-горно ниво в комбинация с тази опция, задайте началната страница на -1.

По подразбиране функционалностите за форматиране в FastComments се извършват чрез добавяне на видими маркерни тагове като <b></b> около вашия текст. Кликването върху лентата с инструменти или използването на клавишни комбинации прави това вместо вас. Въпреки това, някои общности може да искат да изберат използване на форматиране без видими маркерни тагове. Това се нарича активиране на WYSIWYG (каквото виждате, това получавате) редактора. Този редактор изглежда точно като стандартния, с изключение че зарежда допълнителен код, който позволява на потребителите да удебеляват, подчертават и т.н. своя текст без видими маркерни тагове.

Enabling WYSIWYG Editing

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Това може да се направи и без код. В страницата за персонализиране на уиджета вижте опцията "Разреши разширено форматиране".

Enable WYSIWYG

По подразбиране FastComments ще показва лента с инструменти, когато се пише коментар, за да осигури преки пътища за форматиране на текста и качване на изображения.

Тази лента с инструменти може да бъде деактивирана чрез код или чрез потребителския интерфейс за персонализиране.

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

Това може да бъде персонализирано без код, на страницата за персонализиране на джаджата, в секцията Разширени опции. Първо ще трябва да активирате Absolute Dates, за да видите тази опция в потребителския интерфейс.

Use Both Absolute and Relative Dates

Някакъв текст, като заглавие или съобщение, може да се показва под броя на коментарите, но над текста за статуса на влизане.

Наричаме това заглавие и по подразбиране то е скрито.

Specifying Header HTML

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Specifying Header HTML

По подразбиране FastComments ще визуализира връзки по този начин: https://exmaple.com - където URL адресът на връзката става кликаем HTML елемент .

Показване на връзки като текст

По подразбиране 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".

Disable Notification Bell

По подразбиране FastComments ще показва профила на потребителя, когато кликнете върху аватара им.

Въпреки това, можем да деактивираме тази функционалност:

Disable Profiles

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Това може да се направи и без код. На страницата за персонализиране на джаджата вижте секцията "Деактивиране на профили".

Disable Profiles

По подразбиране FastComments ще покаже съобщение за успех след публикуване на коментар. Това може да бъде деактивирано по следния начин:

Disable Success Message

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Това може да се направи и без код. В страницата за персонализиране на уиджета:

Disable Success Message

По подразбиране коментарният виджет на FastComments ще зададе gif rating на pg.

Достъпните опции са g, pg, pg-13 и r.

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

Set Gif Rating

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

В потребителския интерфейс това се намира под Gif Picker Rating, стига опцията Disable Image Uploads? да не е отметната.

Setting The Gif Rating

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

Наличните опции са off, low, medium и high.

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

Setting The Image Content Moderation Level

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

Възможно е обаче да се промени стилът на лентата за гласуване. Настоящите опции са по подразбиране бутоните Нагоре/Надолу или използване на механизъм за гласуване със сърце.

Използваме флага voteStyle по следния начин:

Enable Heart Button

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Препоръчваме силно да го направите без код, тъй като това също активира валидации на сървърната страна. На страницата за персонализиране на джаджата вижте секцията "Стил на гласуване".

Change Voting Style

Гласуването може да бъде деактивирано, вижте Disable Voting по-горе при опциите за стил.

По подразбиране FastComments позволява на потребителите да изтриват коментарите си.

Въпреки това е възможно това да бъде предотвратено.

В страницата за персонализиране на уиджета вижте опцията "Изключване на изтриването".

Disable Comment Deleting

• Това засяга само обикновените 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

Наличните формати са:

• Capitalize (показва Example User като Example User)
• Инициал на фамилията (показва Example User като Example U.)
• Всички инициали (показва Example User като E. U.)
• Показване като "Анонимен"

Промяната влиза в сила незабавно. Потребителите ще продължат да виждат пълното си потребителско име в горната част на зоната за коментари, само за себе си, но в коментарите им ще се показва модифицираното потребителско име.

Потребителските имена се маскират на сървърната страна, за да се защитят потребителите.

По подразбиране 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

Можем да активираме поддръжката на спойлери, като зададем флага 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

Ние следим идентификатора на потребителя*, който е прегледал коментара, така че ако прегледате коментара отново, той да не се увеличава. Ако прегледате коментара отново след две години, броячът ще се увеличи отново.

• *Забележка: или anon session id, или потребителския IP като хеширана стойност.

По подразбиране активността в секцията за коментари в реално време е включена. Това означава, че ако се добавят, изтриват, редактират или прикрепят коментари, промените трябва да се появят за всички потребители, които преглеждат нишката с коментари по едно и също време.

Въпреки това, по подразбиране тези нови коментари ще се появят под динамично показан бутон с текст, подобен на "Show 2 New Comments".

Ако новите коментари са отговори директно на страницата, бутонът ще се покаже в горната част на нишката с коментари. Ако са отговори на конкретен коментар, бутонът ще се покаже под този коментар.

Това е, за да се предотврати постоянното променяне на размера на страницата за потребителя, което може да причинява раздразнение при опит да хване лентата за превъртане.

За някои случаи на използване, като живо наддаване или онлайн събития, това не е желаното поведение - може да искате уиджитът за коментари да бъде по-скоро като чат прозорец, където новите коментари "show right away".

Hence, the name of the flag that enables that feature: showLiveRightAway.

We can turn it on as follows:

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

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

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

За посоката на сортиране newest-first, бихме направили следното:

Changing The Default Sort To Newest First

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

Валидните стойности за defaultSortDirection са:

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

Това може да се направи и без код. В страницата за персонализиране на уиджета вижте секцията "Default Sort Direction".

Changing The Default Sort Direction

Имайте предвид, че коментарите на всяка страница за всяка посока на сортиране са предварително пресметнати, така че всички посоки на сортиране имат една и съща производителност.

По подразбиране полето за въвеждане на коментар е преди нишката с коментари. Въпреки това, като зададем този конфигурационен параметър на true, можем да го преместим след нея.

Moving The Reply Box to The Bottom

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Това може да се персонализира без код, на страницата за персонализиране на уиджета:

Moving The Reply Box to The Bottom

Максималният брой символи, които могат да бъдат въведени в полето за коментар, може да бъде ограничен чрез параметъра maxCommentCharacterLength.

По подразбиране е 2000.

Елементи като URL адреси на изображения не се включват при определянето на дължината.

Limit Comment Length

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Това може да се персонализира без код, на страницата за персонализиране на уиджета:

Limit Comment Length

По подразбиране FastComments позволява на потребителя да въведе коментар с толкова редове, колкото желае, до зададения по подразбиране лимит на символите.

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

Активираме флага useSingleLineCommentInput по следния начин:

Enable Single-Line Comment Input

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Това може да се направи и без код. В страницата за персонализиране на джаджата вижте секцията "Активиране на едноредово въвеждане на коментари".

Enable Single-Line Comment Input

Обърнете внимание, че коментарите на всяка страница за всяка посока на сортиране са предварително изчислени, така че всички посоки на сортиране имат еднаква производителност.

По подразбиране всеки потребител може да изпрати до 5 comments в същата минута.

Това се проследява по user id, anon user id, and ip address (hashed).

Това може да се персонализира без код, на страницата за персонализиране на widget-а:

Limiting Comment Volume Per User

Имайте предвид, че ако използвате API за създаване на коментари, може да искате да предадете оригиналния ip адрес на потребителя в заявката към нашия бекенд, така че ограничаването по честота да се прилага на потребител, а не глобално за вашия акаунт.

FastComments Secure SSO използва HMAC-SHA256 криптиране като механизъм за реализиране на SSO. Първо ще разгледаме цялостната архитектура, ще дадем примери и подробни стъпки.

Има и документация относно мигриране от други доставчици с подобни SSO механизми и разликите.

Потокът изглежда по следния начин:

Поток на Secure SSO

Тъй като Secure SSO включва full-stack разработка, пълни работещи примери на код в Java/Spring, NodeJS/Express и чист PHP в момента са в GitHub.

Въпреки че използваме ExpressJS в примера за NodeJS и Spring в Java примера, в тези среди не са необходими допълнителни фреймуърки/библиотеки, за да се реализира FastComments SSO - нативните крипто пакети работят.

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

Get Your API Secret Key

Вашият API Secret може да бъде извлечен от тази страница. Можете да намерите тази страница и като отидете в My Account, кликнете върху плочката API/SSO и след това кликнете "Get API Secret Key".

Comment Widget Parameters

Документация на високо ниво за API на коментарния widget може да бъде намерена тук.

Нека разгледаме по-подробно какво означават тези параметри.

Коментарният widget приема обект за конфигурация - вие вече подавате това, ако използвате FastComments, за да предадете своя customer id (наречен tenantId).

За да активирате SSO, подайте нов обект "sso", който трябва да има следните параметри. Стойностите трябва да бъдат генерирани от сървърната страна.

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

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

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

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

13 }

14}];

15</script>

16

Потребителски обект

Потребителски обект

Copy

1

2interface SSOUser {

3 /** Задължително. Максимум 1k символа. **/

4 id: string;

5 /** Задължително. Максимум 1k символа. Забележка: Трябва да е уникален. **/

6 email: string;

7 /** Задължително. Максимум 1k символа. Забележка: Потребителското име не може да бъде имейл. Не е необходимо да е уникално. **/

8 username: string;

9 /** По избор. Максимум 3k символа за URL адреси. По подразбиране идва от gravatar базиран на имейл. Поддържа Base64-кодирани изображения, в този случай ограничението е 50k символа. **/

10 avatar?: string;

11 /** По избор. По подразбиране false. **/

12 optedInNotifications?: boolean;

13 /** По избор. По подразбиране false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** По избор. Максимум 100 символа. Този етикет ще се покаже до името им. По подразбиране е Administrator/Moderator, когато е приложимо. **/

16 displayLabel?: string;

17 /** По избор. Максимум 500 символа. Това ще се покаже вместо потребителското име. **/

18 displayName?: string;

19 /** По избор. Максимум 2k символа. Името на потребителя ще води към този линк. **/

20 websiteUrl?: string;

21 /** По избор. До 100 групи на потребител. Идентификатор на група не може да бъде по-дълъг от 50 символа. **/

22 groupIds?: string[];

23 /** По избор. Означава потребителя като администратор. **/

24 isAdmin?: boolean;

25 /** По избор. Означава потребителя като модератор. **/

26 isModerator?: boolean;

27 /** По избор, по подразбиране true. Задайте на false, за да разрешите раздела "activity" в профила на потребителя. **/

28 isProfileActivityPrivate?: boolean;

29 /** По избор, по подразбиране false. Задайте на true, за да деактивирате коментарите в профила. **/

30 isProfileCommentsPrivate?: boolean;

31 /** По избор, по подразбиране false. Задайте на true, за да деактивирате директните съобщения до този потребител. **/

32 isProfileDMDisabled?: boolean;

33}

34

Moderators and Administrators

За админи и модератори, подайте съответните флагове isAdmin или isModerator в обекта SSOUser.

Notifications

За да включите или изключите известията, задайте стойността на optedInNotifications на true или false съответно. Първият път когато потребителят зареди страницата с тази стойност в SSO payload-а, настройките му за известия ще бъдат обновени.

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

VIP Users & Special Labels

Можете да покажете специален етикет до името на потребителя, като използвате опционалното поле "displayLabel".

Unauthenticated users

За да представите непотребител (unauthenticated user), просто не попълвайте 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

Активирайте опцията и запазете правилото за персонализиране.

Защитa само на определен домейн или страница

За да защитите само определен Domain или Page, просто ще конфигурираме правилото за персонализиране да го прави.

В горната част на интерфейса за персонализиране ще намерите два полета, Domain и URL ID.

За да защитите конкретен домейн, въведете домейна в съответното "domain" поле.

За да защитите конкретна страница, въведете URL на страницата в полето "URL ID". Ако имате персонализирана интеграция с FastComments, може да въведете тип ID тук вместо 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

Когато потребителите коментират и не са влезли в системата, ще им бъде поискано да предоставят имейл.

Това ще създаде "unverified session" за този потребител и ние ще поискаме от тях да потвърдят тази сесия чрез имейл.

За някои сайтове или приложения е желателно да не се иска имейл от потребителя при коментиране или гласуване.

Активирането на анонимно коментиране прави полето за имейл по избор. Въпреки това, можем да го изключим напълно. Първо, активирайте анонимното коментиране, след което ще се появи опцията за деактивиране на полетата за въвеждане на имейл.

Disable Email Inputs

С включена тази опция, полетата за имейл няма да се показват изобщо във всичките ни продукти за коментиране.

Обърнете внимание, че с тази конфигурация всички коментари ще бъдат unverified, освен ако потребителят не създаде акаунт и не се впише в https://fastcomments.com.

Може да помислите за деактивиране на етикета "unverified".

По подразбиране FastComments ще показва етикет "Непотвърден коментар" за коментари, които са оставени за потребител, който има непотвърдена сесия в браузъра. Прочетете повече за непотвърденото коментиране тук.

Disable The Unverified Label

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

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

Disable The Unverified Label

Когато потребителите се опитат да гласуват за коментар и не са влезли в профила си, ще им бъде поискано да предоставят своето потребителско име и имейл.

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

Allow Anonymous Votes

Когато потребителите коментират или гласуват и не са влезли в профила си, ще им бъде поискано да предоставят своя имейл и потребителско име.

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

Setting The Default Username

По подразбиране FastComments ще рендерира уиджета за коментари в локала, определен от системата и браузъра на потребителя.

Когато потребител коментира или влезе в системата, ние актуализираме последно използвания от него локал и го използваме и за изпращане на имейли.

Това влияе на начина, по който уиджета за коментари се превежда за потребителя. Локалът се състои от езика и региона на потребителя, така че конфигурирането на локала обикновено ще промени езика, използван за показване на текста на потребителя.

Чрез потребителския интерфейс

Това може да бъде зададено чрез потребителския интерфейс за персонализиране на уиджета. Вижте опцията "Locale / Language":

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

По подразбиране FastComments не ограничава езиците, използвани за коментиране.

Може да е желателно да се ограничат езиците, които използва общността.

Това може да се конфигурира без код, на страницата за персонализиране на уиджета:

Allowed Languages

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

Ако коментарът е написан на език, който не е разрешен, се показва локализирано съобщение за грешка.

Коментарите могат да бъдат заключени, така че да не могат да се оставят нови коментари или гласове, като се зададе флагът readonly на true.

Коментарите също така няма да могат да бъдат редактирани или изтрити.

Making The Comment Thread Readonly

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Това може да се персонализира без код, на страницата за персонализиране на джаджата, за цял домейн или страница:

Making The Comment Thread Readonly

Актуализация!

От ноември 2022 г. нишките могат да бъдат заключвани или отключвани в реално време от администратори и модератори чрез менюто с три точки над полето за отговор.

Това ще предотврати публикуването на нови коментари, като все пак позволява гласуване и дава възможност на потребителите да изтриват своите коментари, ако желаят, докато readonly не позволява това.

Това съответства на полето isClosed в API на Page.

По подразбиране FastComments позволява добавяне на връзки към всеки външен сайт.

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

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

Това се прави без код, на страницата за персонализиране на уиджета:

Restrict External Link Domains

По подразбиране FastComments ще поиска от потребителя само техния коментар, потребителско име и имейл.

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

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

Enabling Commenter Links

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Когато такъв URL бъде предоставен, акаунтът на потребителя ще бъде актуализиран и всички негови потребителски имена във всички минали и бъдещи коментари ще бъдат с връзка към този URL.

Това може да бъде персонализирано без код, на страницата за персонализиране на уиджета:

Enabling Commenter Links

Списък с идентификатори, генерирани от страницата Групи за модерация.

Когато е посочено, коментарите, оставени с използване на посочената конфигурация, ще съдържат същия набор от moderationGroupIds.

Ако един Moderator има дефинирани една или повече Групи за модерация, те ще виждат само коментарите в страницата Moderate Comments, свързани с техните групи.

Specify Moderation Groups

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

За удостоверяване FastComments разчита на това бисквитките от трети страни да са разрешени в браузъра ви. Без тях, потребителите винаги ще трябва да оставят своя имейл, за да коментират (освен ако полето за имейл не е скрито), и техните коментари винаги ще се показват като неверифицирани (по подразбиране).

За да заобиколите това, можете да активирате заобикалянето на бисквитките от трети страни.

Когато тази настройка е активирана, ще се появи малък изскачащ прозорец, който показва съобщение, че потребителят се вписва. Този изскачащ прозорец се появява всеки път, когато потребителят взаимодейства с компонента за коментари; например, ако остави коментар.

Можем да направим това в кода, като зададем флага 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 в UI за персонализиране на джаджата.

Customize Delete Behavior for Replies

По подразбиране FastComments ще показва значките на потребителите само върху техните коментари в рамките на нишката с коментари.

Въпреки това можем да показваме значките на потребителите до тяхното име над формата за коментар, като активираме тази функция в страницата за персонализиране на джаджата:

Show Badges in Top Bar Option

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

Обърнете внимание, че тази функция трябва да бъде активирана в UI за персонализиране на джаджата, за да работи. По желание можете да зададете флага 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