Персонализиране и конфигурация

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

Дефиниране на персонализиран 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

Едно нещо, което често ще споменаваме в този документ, е Widget Customization UI.

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

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

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

Поле URL ID в страницата за персонализиране на уиджета

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

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

Внимание

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

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

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

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

Област за въвеждане на персонализиран CSS

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

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

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

Подаване на персонализиран CSS

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

Това обаче има ограничения:

1. Има ограничение колко персонализиран CSS може да бъде подаден, преди нашите сървъри да отхвърлят заявката, поради размера на хедърите.
2. Трябва да управлявате персонализирания CSS в своята инфраструктура и система за изграждане. Това може да е предимство, а не недостатък.
3. Има допълнителни разходи за изпращане на персонализирания CSS по мрежата два пъти в този случай, тъй като той трябва да бъде изпратен до нашите сървъри, а след това обратно в съдържанието на iframe. За повечето размери на данните обаче това не се забелязва.
4. Честа оптимизация е минифицирането на CSS, за да се намали размерът му по мрежата, но с този подход ще трябва да се погрижите за това сами.
5. Вашият персонализиран CSS няма да бъде тестван, когато правим промени.

Външни CSS файлове

Можете да укажете на уиджета да извлече външен файл, като използвате @import!

Препоръчително е да поставите @import в правило за персонализиране. По този начин, ако някога се наложи да направим промяна в уиджета за коментари, можем да използваме нашите инструменти за автоматизация, за да проверим вашата конфигурация. Например, бихте създали правило за персонализиране в интерфейса за персонализиране на уиджета, щракнете Advanced и въведете в Custom CSS:

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

В код - Не се препоръчва

Можете също да заредите външен CSS файл чрез свойството customCSS:

Външен CSS файл

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

Не забравяйте обаче, че вашият CSS няма да може да бъде тестван от нас, ако направите това.

Стилизиране на модала за потребителски профил

Модалите за потребителски профил също могат да бъдат стилизирани с персонализиран CSS. За да се гарантира обаче, че персонализираното стилизиране се прилага към потребителските профили, всички CSS селектори трябва да имат префикс .user-profile. Без този префикс персонализираното стилизиране ще бъде игнорирано за модалите на потребителски профил.

Например:

CSS за потребителски профил

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Обратна съвместимост

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

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

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

За клиентите с акаунти 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 целият текст в уиджет‑а за коментари е персонализируем.

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

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

Персонализиран текст

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, и да зададем замяна.

Персонализиран текст

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

Това обхваща текста на самия уиджет. За да преведете коментарите, които вашите посетители пишат, вижте Comment Translation.

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

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

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

Презаписване на стандартния аватар

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Персонализиране на стандартния аватар

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

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

Скриване на аватари

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

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

Скриване на аватари

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

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

Disabling All Default Styles

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

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

Деактивиране на цялото стандартно стилизиране

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

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

Скриване на отговорите към коментари от най-горно ниво

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

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

Скриване на отговорите

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

• Видите коментара от най-горно ниво.
• Видите „Show Replies (29)“ под този коментар.

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

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

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

Активиране на WYSIWYG

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

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

Деактивиране на лентата с инструменти

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

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

Деактивиране на лентата с инструменти

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

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

Изключване на блокирането

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

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

Изключване на блокирането

По подразбиране се използват локализирани относителни дати. Например, до наскоро оставен коментар може да видите "11 minutes ago".

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

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

Use Absolute Dates

По подразбиране се използват локализирани относителни дати. Например, до наскоро оставен коментар може да видите "11 minutes ago".

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

Използване и на абсолютни и на относителни дати

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

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

Използване и на абсолютни и на относителни дати

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

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

Указване на HTML за заглавка

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Указване на HTML за заглавка

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

Визуализиране на връзки като текст

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

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

Кликнете, за да покажете коментарите

Бутонът използва различен преведен текст в зависимост от това дали коментарите в момента са показани или не. Ако коментарите са скрити, се използва 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.

Броят се актуализира в реално време с нишката от коментари. Бутонът не се показва, ако няма коментари.

Това може да се активира без код, като се създаде правило за персонализиране и се включи „Кликнете, за да покажете коментарите“:

Включване на показване на коментари при клик

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

Това може да бъде заменено с произволен низ, а стойността [count] ще бъде заменена с броя, локализиран за потребителя.

Персонализиране на текста за брой коментари

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

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

8}];

9</script>

10

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

Персонализиране на текста за брой коментари

Когато потребителите въвеждат хаштагове във формата #someexampletag, FastComments автоматично създава този HashTag и го подчертава в техния коментар.

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

За да направите това, просто активирайте Disable Automatic #hashtag Creation чрез потребителския интерфейс за персонализиране на уиджета.

Деактивиране на автоматично създаване на HashTag

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

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

• Потребителят ви отговори.
• Потребителят отговори в нишка, в която сте коментирали.
• Потребителят гласува вашия коментар.
• Потребителят отговори на страница, към която сте се абонирали.

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

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

Disable Notification Bell

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Това може да се направи и без код. В страницата за персонализиране на уиджет, вижте секцията „Disable Notification Bell“.

Изключване на известията

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

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

Деактивиране на профилите

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Това може да се направи и без код. На страницата за персонализиране на уиджета, вижте раздела „Деактивиране на профилите“.

Деактивиране на профилите

По подразбиране FastComments показва раздел „Profile Comments“ в потребителските профили, позволявайки на посетителите да оставят коментари в профила на някого.

Въпреки това можем да деактивираме този раздел:

Disable Profile 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 "disableProfileComments": true

8}];

9</script>

10

Това може да се направи и без код. На страницата за персонализиране на уиджета, вижте раздела „Disable Profile Comments“.

Disable Profile Comments

По подразбиране FastComments показва раздел „Директни съобщения“ в потребителските профили, позволявайки на посетителите да изпращат директни съобщения до потребител.

Въпреки това можем да деактивираме този раздел:

Disable Profile Direct Messages

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileDirectMessages": true

8}];

9</script>

10

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

Деактивиране на директни съобщения в профила

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

Деактивиране на съобщението за успех

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

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

Деактивиране на съобщението за успех

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

Наличните опции са g, pg, pg-13 и r.

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

Set Gif Rating

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

В UI ще го намерите под Gif Picker Rating, стига Disable Image Uploads? да не е отметнато.

Настройване на Gif Rating

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

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

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

Настройване на нивото на модерация на изображеното съдържание

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

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

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

Активиране на бутон за сърце

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

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

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

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

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

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

В страницата за персонализиране на уиджета, вижте опцията "Disable Deleting".

Деактивиране на изтриване на коментари

• Това засяга само обикновените коментатори и не модератори или администратори, които все още ще могат да изтриват.
• Това също ще засегне API интеграциите, когато се предава contextUserId.

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

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

В страницата за персонализиране на уиджета, вижте опцията "Disable Editing".

Деактивиране на редактирането на коментари

• Това засяга само обикновените коментатори и не модератори или администратори, които все още ще могат да редактират.
• Това също ще засегне API интеграциите, когато се предава contextUserId.

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

Размерът на страницата може да се персонализира в Widget Configuration UI с различни размери, вариращи от 10 до 200.

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

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

Примерна конфигурация е показана по-долу:

Персонализирани размери на страницата

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

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

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

Въпреки това, може да е желателно да се маскира или покаже името на потребителя по различен начин. Например, ако името на потребителя е Allen Rex, може би искате да показвате само „Allen R.“.

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

Промяна на формата на името

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

• Capitalize (показва примерен потребител като Example User)
• Last Initial (показва Example User като Example U.)
• All Initials (показва Example User като E. U.)
• Show "Anonymous"

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

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

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

Деактивиране на качване на изображения

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

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

Деактивиране на качване на изображения

По подразбиране FastComments не позволява iframes в коментарите. Когато активирате вграждането на медия, коментиращите могат да поставят кода за вграждане (фрагмента <iframe>) от доверени доставчици като YouTube, Vimeo, SoundCloud и Spotify, и той ще се визуализира вградено в коментара.

От съображения за сигурност това не е флаг в конфигурацията на уиджета от страна на клиента. Това е настройка от страна на сървъра, валидирана при запазването на всеки коментар, така че не може да бъде включена от страницата. Позволени са само iframes, сочещи към вграден списък с доверени доставчици. Всеки друг iframe се премахва.

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

Разрешаване на вграждане на медия

Добавяне на собствени доставчици

Ако искате да разрешите вграждания от доставчик, който не е в вградения списък с доверени, добавете неговото име на хост в полето "Additional Embed Domains" на същата страница. Тези имена на хостове са позволени в допълнение към вградените доставчици. Съвпадението е точно, така че включете пълното име на хост (например player.example.com). Всичко, което не сте посочили, остава блокирано.

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

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

Въпреки това можем да го включим, като зададем флага enableSearch на true:

Активиране на търсене

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Това може да се направи и без код. На страницата за персонализиране на уиджета, вижте опцията „Enable Search Box“.

Включи полето за търсене

Можем да активираме поддръжката на спойлери, като зададем флага enableSpoilers на true:

Включване на спойлери

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Това може да се направи и без код. На страницата за персонализиране на уиджета, вижте опцията „Enable Spoilers“.

Включване на спойлери

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

Това също е съвместимо с WYSIWYG редактора.

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

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

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

Можем да активираме това, като зададем флага enableViewCounts на true:

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

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

Активиране на броячи за прегледи на коментари

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

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

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

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

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

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

За някои случаи на употреба, като живи наддавания или онлайн събития, това не е желаното поведение – може да искате уиджетът за коментари да бъде по‑подобен на „чат“, където новите коментари „се показват веднага“.

Следователно, името на флага, който активира тази функция: showLiveRightAway.

Можем да го включим по следния начин:

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

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

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

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

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

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

Например, ако се добави коментар, този коментар трябва да се покаже. Ако коментарът бъде редактиран или премахнат, тогава тези коментари ще бъдат редактирани или премахнати за всички зрители на нишката. Същото важи за гласовете и всички модераторски действия.

Въпреки това, можем да изключим това:

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 ще сортира коментарите по посоката за сортиране "Най-относими".

Сортирането "Най-относими" взема предвид времето, в което е оставен коментарът, и броя гласове при сортирането.

Потребителят може след това да промени посоката за сортиране на Oldest или Newest First в потребителския интерфейс на уиджета за коментари.

Въпреки това можем да променим подразбиращата се стойност на която и да е от трите. Например, ако искате да покажете най-старите коментари първо:

Промяна на подразбиращото се сортиране към най-старите първо

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

Задаваме стойността на defaultSortDirection на "OF", за да зададем посоката на "OF".

За посоката за сортиране "Newest First", ще направим следното:

Промяна на подразбиращото се сортиране към най-новите първо

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

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

• MR: "Най-скорошен"
• NF: "Най-нови първо"
• OF: "Най-стари първо"

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

Промяна на подразбиращата се посока за сортиране

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

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

Moving The Reply Box to The Bottom

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

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

Преместване на полето за отговор към дъното

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

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

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

Ограничаване дължината на коментара

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

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

Ограничаване дължината на коментара

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

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

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

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 коментара в същата минута.

Това се проследява по потребителски идентификатор, идентификатор на анонимен потребител и IP адрес (хеширан).

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

Ограничаване на обема на коментарите на потребител

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

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

Когато е активирано:

• Анонимните потребители ще виждат квадратче за Условията за ползване всеки път, когато коментират
• Удостоверените потребители ще виждат квадратчето само при първия си коментар или когато обновите вашите Условия за ползване

Конфигурация

Придвижете се до страницата за персонализиране на уиджета и активирайте квадратчето "Require Terms of Service acceptance". След активиране ще видите следните опции:

Опции за Условия за ползване

• TOS Text Mode: По подразбиране квадратчето показва "I agree to the Terms of Service and Privacy Policy" с връзки към двата документа. Изберете "Customize text per locale", за да предоставите собствен текст за всеки език.
• TOS Last Updated Date: Когато обновите вашите Условия за ползване, задайте тази дата. Потребителите, приели преди тази дата, ще трябва да приемат отново.

Как работи

• Времевият печат на приемането на TOS се съхранява за всеки потребител и всеки коментар
• Когато потребител приеме TOS, датата се записва в неговия потребителски профил (на ниво tenant)
• Ако зададете дата "Last Updated", която е след датата на приемане на потребителя, той ще трябва да приеме отново
• За анонимни потребители, които не могат да бъдат проследявани, квадратчето се показва при всяко изпращане на коментар

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

Анкетите са изключени по подразбиране. Поставете отметка на Enable Polls в настройките за персонализиране на уиджета, за да добавите бутон за анкета към лентата с инструменти за коментари. След това се появяват още две настройки:

• Who Can Create Polls: Само администратори/модератори (по подразбиране), или всички.
• Allow Anonymous Poll Votes: когато не е отметнато (по подразбиране), само влезли потребители могат да гласуват.

Включване на анкети

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

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

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

Процесът изглежда така:

Secure SSO Flow

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

Макар че използваме ExpressJS в примера за NodeJS и Spring в примера за Java, няма необходими framework-и/библиотеки в тези среди за имплементиране на FastComments SSO - вградените crypto пакети работят.

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

Получете вашия API Secret Key

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

Параметри на коментарния уиджет

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

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

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

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

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

Клиентски код за Secure SSO

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

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

Обектът User

Обектът User съдържа следната схема:

Обектът User

Copy

1

2interface SSOUser {

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

4 id: string;

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

6 email: string;

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

8 username: string;

9 /** По избор. Максимум 3k символа за URL адреси. По подразбиране е от gravatar на базата на имейла. Поддържа 64 кодирани изображения, в този случай лимитът е 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 badgeConfig?: {

35 /** Масив от глобални ID-та на значки за присвояване. Ограничено до 30 значки. Редът се зачита. **/

36 badgeIds: string[];

37 /** Масив от ID-та на значки, обхванати от текущата страница (urlId). Показват се само на присвоената страница. **/

38 pageBadgeIds?: string[];

39 /** Ако е true, заменя съществуващите показвани значки. Глобалните и обхванатите от страница се презаписват независимо. **/

40 override?: boolean;

41 /** Ако е true, обновява свойствата за показване на значките от конфигурацията на tenant. **/

42 update?: boolean;

43 };

44}

45

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

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

Известия

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

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

VIP потребители и специални етикети

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

Неудентифицирани потребители

За да представите неудентифициран потребител, просто не попълвайте userDataJSONBase64, verificationHash или timestamp. Предоставете loginURL.

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

Директни примери за сериализация и хеширане на потребителски данни

Повече подробности като примери тук (js), тук (java) и тук (php).

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

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

Можем да конфигурираме Simple SSO по следния начин:

Просто SSO

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "simpleSSO": {

8 "username": "Bob",

9 "email": "bob@example.com",

10 "avatar": "https://example.com/bob.png",

11 "websiteUrl": "https://example.com/profiles/bob",

12 "displayName": "Bob's Name",

13 "displayLabel": "VIP User",

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

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

16 "badgeConfig": {

17 "badgeIds": [

18 "badge-id-1",

19 "badge-id-2"

20 ],

21 "pageBadgeIds": [

22 "badge-id-3"

23 ],

24 "override": false

25 }

26 }

27}];

28</script>

29

Потребителят ще бъде влязъл и ще създаде SSO потребител зад кулисите. Потребителят ще има createdFromSimpleSSO, зададено на true, ако е получен от API.

Бележки:

• Имейлът е уникалният идентификатор за Simple SSO.
• Предоставянето на имейл с Simple SSO не е задължително, но по подразбиране техните коментари ще се показват като „Непроверени“. Ако не е предоставен имейл, потребителят не може да бъде напълно удостоверен.
• НОВО От януари 2022 г.: Потребителските имена не трябва да бъдат уникални за целия fastcomments.com
• Simple SSO може автоматично да създава и актуализира SSO потребители, ако е предоставен имейл и потребителят не е бил създаден първоначално от Secure SSO. Ако Simple SSO полезният товар назове потребител, създаден от Secure SSO или API, този потребител остава непроменен и посетителят получава отделен потребител.
• Можете да зададете значки за потребителя чрез свойството badgeConfig. Масивът badgeIds съдържа идентификаторите на глобалните значки, които да се асоциират с потребителя. Масивът pageBadgeIds съдържа идентификатори на значки, ограничени до текущата страница (urlId) — тези значки се показват само на страницата, където са зададени. Ако override е зададено на true, ще замени съществуващите показани значки (глобалните и страничните се заменят независимо); ако е false, ще се добави към съществуващите значки.

Настройки за Simple SSO

Simple SSO винаги е достъпен. Две настройки контролират колко FastComments му се доверява. Можете да ги намерите, като потърсите SSO в правило за персонализиране. И двете са изключени по подразбиране и се прилагат независимо дали „Изисквай SSO за преглед на коментари“ е включено.

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

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

Автоматично проверяване на коментари чрез Simple SSO

Когато това е включено, коментарите от Simple SSO потребители се проверяват веднага.

Когато това е изключено, коментарите от Simple SSO потребители се показват като „Непроверени“, докато потребителят не кликне върху връзка, която изпращаме на имейл адреса в Simple SSO полезния товар. Ако автоматично одобрявате само проверени коментари, те също чакат тази връзка. Ако в полезния товар няма имейл, коментарът остава непроверен.

Тази настройка засяга само коментарите. Гласовете от Simple SSO потребители винаги се броят веднага.

Позволяване на Simple SSO администратори

Когато това е включено, Simple SSO потребител може да бъде администратор или модератор на вашия акаунт:

• Simple SSO потребител, който има администраторски или модераторски права, ги запазва.
• Simple SSO потребител със същия имейл като един от вашите администратори или модератори получава техните права.

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

Simple SSO полезните товари не са подписани, затова когато това е включено, всеки, който знае имейла или потребителското ID на администратор, може да се представя за него. Ако това е важно за вашия сайт, оставете това изключено и използвайте Secure SSO за вашите администратори.

Потребители, създадени от Secure SSO или API, не могат да бъдат достъпени от Simple SSO, независимо дали това е включено.

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

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

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

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

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

Когато го направите, потърсете SSO и ще откриете тази опция:

Изискване на SSO за преглед на коментари

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

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

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

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

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

За да защитите конкретна страница, въведете URL на страницата в полето „URL ID“. Ако имате персонализирана интеграция с FastComments, тук можете да въведете тип идентификатор вместо URL.

Нива на сигурност

Когато изисквате SSO, ще трябва да решите дали искате Simple SSO или Secure SSO. Ако изберете Simple SSO, и двете са разрешени, но ако изберете Secure SSO, съдържанието трябва да се извлича със Secure SSO полезен товар, хеширан с вашия API ключ, за да бъде видяно.

Опцията за ниво на сигурност ще се появи, когато изберете „Изискване на SSO за преглед на коментари“, и ще влезе в сила само докато тази опция е активирана.

Настройките Автоматична проверка на коментари чрез Simple SSO и разрешаване на Simple SSO администратори са отделни и се прилагат независимо дали тази опция е включена.

Защита надхвърляща четенето

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

Капани

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

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

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

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

Активиране на анонимни коментари

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

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

По подразбиране, не го прави.

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

Настройки за модериране

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

Това ще създаде „непотвърдена сесия“ за този потребител и ще ги помолим да потвърдят сесията чрез имейл.

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

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

Деактивиране на полетата за имейл

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

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

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

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

Деактивиране на етикета за непроверен коментар

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

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

Деактивиране на етикета за непроверен коментар

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

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

Разрешаване на анонимни гласове

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

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

Задаване на подразбиращото се потребителско име

Споделяне на подразбиращото се потребителско име

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

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

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

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

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

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

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

Автоматично генериране на потребителски имена

Как се държи

• Всяко генерирано име е уникално. То се проверява срещу съществуващите акаунти и се резервира за браузърната сесия на този посетител, така че двама посетители не получават едно и също име.
• Името се генерира само за посетители, които все още нямат такова. Влезли потребители, SSO потребители и посетители, които вече са коментирали, запазват съществуващото си име.
• Работи със или без анонимно коментиране. При изключено анонимно коментиране посетителят все още въвежда своя имейл, но вече не трябва да измисля потребителско име.
• Връщащ се посетител, който въведе имейл, който е използвал преди, се съпоставя със съществуващия си акаунт и запазва името от този акаунт.
• Ако е зададено и Default Username, генерираното име има предимство.

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

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

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

Чрез UI

Това може да се зададе чрез UI за персонализиране на уиджета. Вижте опцията „Locale / Language“:

Промяна на Locale / Language

Чрез код

Това може да бъде заменено с желан локал.

Ръчно задаване на локала на потребителя

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Поддържани езици и кодове на локали

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

Забележка за SSO

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

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

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

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

Разрешени езици

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

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

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

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

Има два режима:

• Автоматично: коментари, написани на език, различен от езика на уиджета, се показват преведени. Под коментара се появява ред „Преведено от испански“ с връзка Покажи оригинал, която превключва между превода и непреведения текст.
• Ръчно: всеки коментар получава връзка Преведи. При кликване превежда този конкретен коментар на езика на зрителя, след което се появява същият превключвател Покажи оригинал. Коментари, които вече са на езика на зрителя, показват, че са така.

Целевият език е езикът на уиджета: настройката Locale / Language в същото правило за персонализиране, ако е зададена, иначе езикът на браузъра на посетителя. Не се изисква нищо от посетителя – без акаунт, разширение или допълнителен софтуер, и работи по същия начин в вградените уиджети и на отделни страници с коментари.

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

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

Преводът е настройка от страна на сървъра. Предаване на commentTranslation в JavaScript конфигурацията на уиджета не го активира; правилото го прави.

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

Използването се таксува като LLM токени със същата ставка като AI Agents и се появява на същото място във вашите данни за фактуриране.

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

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

Направете нишката за коментари само за четене

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

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

Направете нишката за коментари само за четене

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

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

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

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

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

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

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

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

Ограничаване на външни домейни за връзки

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

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

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

Можем да направим това в кода, като зададем флага enableThirdPartyCookieBypass на 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 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

Можем също да настроим това чрез UI за персонализиране на уиджета, под Enable Third-Party Cookie Popup:

Включване на заобикаляне на бисквитки от трети страни

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

Можете да ограничите това по следните начини:

• Вместо това анонимизирайте изтрития коментар (задайте име и текст като [deleted] или персонализирана стойност).
• Не позволявайте изтриване на коментари, когато има отговори. Показва се персонализирано съобщение за грешка.
• Ограничете изтриването, когато коментар има отговори, само за администратори и модератори.

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

Персонализиране на поведението при изтриване за отговори

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

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

Опция за показване на значки в горната лента

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

Обърнете внимание, че тази функция трябва да бъде активирана в потребителския интерфейс за персонализиране на уиджета, за да работи. Можете по избор да зададете флага showBadgesInTopBar на false във вашата конфигурация на кода, за да я изключите избирателно, дори когато е включена на ниво сървър:

Disable Show Badges in Top Bar

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10

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

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

Има три варианта за оформление:

• 1 - Горен: хоризонтален ред от припокриващи се аватари, изобразени над коментарите.
• 2 - Ляво: странична лента с имена и онлайн точки, изобразени отляво на уиджета.
• 3 - Дясно: същата странична лента, изобразена отдясно на уиджета.

Задайте флага usersListLocation, за да активирате функцията:

Show Users List on the Right

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3

8}];

9</script>

10

По подразбиране списъкът показва само потребителите, които са онлайн в момента. За да включите и хора, които са коментирали страницата в миналото (но в момента не я преглеждат), задайте usersListIncludeOffline на true:

Include Past Commenters

Copy Run

1

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

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

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

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

Потребителите с частни профили се показват с общ аватар и етикет "Private Profile", за да се запази точният брой без разкриване на идентичностите.

Това може да се конфигурира и без код. На страницата за персонализиране на уиджета, вижте опцията "Users List Location". Когато местоположението е зададено на нещо различно от Off, се появява отметка "Include past commenters" под нея.

Настройки на списъка с потребители

До 500 живи потребители, списъкът е с до 30 секунди закъснение.