Sie werden vielleicht feststellen, dass das Kommentar-Widget beispielsweise mit einer Tenant ID von "demo" verwendet werden kann:

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

Dies dient nur dazu, das Kommentar-Widget auszuprobieren und damit zu spielen. In der Produktion würden Sie Ihre Tenant ID übergeben, wie folgt:

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

Ihre Tenant ID ist bereits im Kommentar-Widget Code-Snippet in Ihrem Konto eingetragen.

Sie können Ihre Tenant ID auch finden und Ihre API-Schlüssel auf der API-Anmeldeinformationen-Seite verwalten.

Ab diesem Punkt verwenden die Codebeispiele Ihre reale Tenant ID, sofern Sie bei FastComments angemeldet sind (wenn Sie auf https://fastcomments.com eingeloggt sind).

Beim Anzeigen eines Kommentarthreads oder beim Verfassen eines Kommentars muss FastComments wissen, zu welcher Seite, welchem Artikel oder Produkt diese Kommentare gehören.

Dafür verwenden wir etwas, das wir "URL ID" nennen. Dabei handelt es sich entweder um einen Bezeichner, wie eine Zeichenfolge oder eine Zahl, oder um eine URL.

Standardmäßig, wenn Sie das urlId nicht angeben, wird es zur Seiten-URL. Wir nehmen die aktuelle Seiten-URL und bereinigen sie, um häufige Marketing-Parameter oder Tracking-Bezeichner zu entfernen.

Im Falle von Integrationen durch Dritte, wie WordPress, verwendet unser Plugin in der Regel den Bezeichner, der die aktuell betrachtete Information darstellt, als URL ID, zum Beispiel die Artikel-/Seiten-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

Eines der Dinge, auf das wir in diesem Dokument häufig verweisen, ist die Widget-Anpassungsoberfläche.

Diese Oberfläche kann verwendet werden, um viele Änderungen am Kommentar-Widget vorzunehmen, ohne Code zu benutzen.

Beim Erstellen einer Anpassungsregel möchten wir oft, dass sie auf alle Seiten unserer Website angewendet wird. In manchen Fällen möchten wir das Kommentar-Widget jedoch auf einer bestimmten Seite anpassen, entweder um individuelles Styling anzuwenden oder um Kommentare für diese bestimmte Seite anonym zu machen. Sie könnten zum Beispiel auch Live-Kommentare auf einigen Seiten sofort anzeigen lassen, während sie auf anderen Seiten unter Benachrichtigungstasten verborgen werden.

Das alles ist über das URL ID-Eingabefeld auf dieser Seite möglich, das wie folgt aussieht:

URL ID Input in The Widget Customization Page

Der Wert in diesem Feld sollte mit dem urlId-Parameter übereinstimmen, der an das Kommentar-Widget übergeben wird. Wenn Ihre Anpassungsregel urlId-unabhängig sein soll, lassen Sie dieses Feld leer oder geben Sie * ein.

Ab 2023 nimmt das URL ID-Feld in der Widget-Anpassung jetzt auch Muster auf! Zum Beispiel können Sie */blog/* haben, um Styling speziell für Ihren Blog hinzuzufügen, und */store/*, um Styling speziell für Ihren Shop zu haben, während die gleiche Domain verwendet wird.

Fallstricke

1. Wenn Ihre Seite Hash-Parameter hat (wie example.com#page-1) – dies wird standardmäßig Teil der URL ID.
2. Während Migrationen, zum Beispiel von WordPress zu Gatsby, müssen Sie möglicherweise die URL ID-Kommentarwerte nach der anfänglichen Migration übertragen. Kontaktieren Sie uns dafür.

FastComments ist so konzipiert, dass es anpassbar ist. Das Kommentierungs-Widget läuft aus Sicherheitsgründen in einem iframe, daher müssen Sie für benutzerdefiniertes Styling eine von zwei Vorgehensweisen verwenden.

Die erste, einfachste Vorgehensweise – und von uns bevorzugt – ist die Verwendung der widget customization page.

In der Widget-Anpassungsseite sehen Sie den Abschnitt „Erweiterte Optionen anzeigen“ („Show Advanced Options“), unter dem es einen Bereich mit der Bezeichnung „Benutzerdefiniertes CSS“ („Custom CSS“) gibt:

Custom CSS Input Area

Diese Vorgehensweise hat einige Vorteile:

1. Das eingegebene CSS wird vor dem Versand an den Nutzer minimiert, und das Format wird in der Bearbeitungsoberfläche konsistent beibehalten.
2. Sie erhalten alle Vorteile der Widget-Anpassungsoberfläche, zum Beispiel die einfache Möglichkeit, das Kommentierungs-Widget für verschiedene Seiten unterschiedlich anzupassen.
3. Wenn wir Änderungen am Kommentar-Widget vornehmen, wird Ihr benutzerdefiniertes Styling im Rahmen unseres Release-Prozesses getestet.

Die zweite Vorgehensweise besteht darin, den Parameter customCSS in der Widget-Konfiguration anzugeben, wie folgt:

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

Dies hat jedoch Einschränkungen:

1. Es gibt eine Begrenzung dafür, wie viel benutzerdefiniertes CSS übergeben werden kann, bevor unsere Server die Anfrage aufgrund der Header-Größe ablehnen.
2. Sie müssen das benutzerdefinierte CSS in Ihrer Infrastruktur und Ihrem Build-System verwalten. Das kann ebenso ein Vorteil wie ein Nachteil sein.
3. In diesem Anwendungsfall entsteht ein zusätzlicher Overhead, da das benutzerdefinierte CSS zweimal über das Netzwerk gesendet werden muss: einmal an unsere Server und dann wieder in den iframe-Inhalt. Bei den meisten Payload-Größen ist dies jedoch nicht wahrnehmbar.
4. Eine gängige Optimierung besteht darin, das CSS zu minimieren, um dessen Größe im Netzwerk zu reduzieren; bei dieser Vorgehensweise müssen Sie das jedoch selbst übernehmen.
5. Ihr benutzerdefiniertes CSS wird bei unseren Änderungen nicht getestet.

Externe CSS-Dateien

Sie können dem Widget mitteilen, eine externe Datei zu laden, indem Sie @import verwenden!

Es wird empfohlen, das @import in eine Anpassungsregel zu setzen. Auf diese Weise können wir, falls wir jemals Änderungen am Kommentar-Widget vornehmen müssen, unsere Automatisierungstools verwenden, um Ihre Konfiguration zu überprüfen. Sie würden also zum Beispiel eine Anpassungsregel in der Widget-Anpassungsoberfläche erstellen, auf Advanced klicken und im Feld Custom CSS eingeben:

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

Im Code - Nicht empfohlen

Sie können eine externe CSS-Datei auch über die Eigenschaft customCSS laden:

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

Beachten Sie jedoch, dass Ihr CSS in diesem Fall von uns nicht getestet werden kann.

Styling des Benutzerprofil-Modals

Benutzerprofil-Modals können ebenfalls mit benutzerdefiniertem CSS gestaltet werden. Damit das benutzerdefinierte Styling jedoch auf Benutzerprofile angewendet wird, müssen alle CSS-Selektoren mit .user-profile vorangestellt sein. Ohne dieses Präfix wird benutzerdefiniertes Styling für Benutzerprofil-Modals ignoriert.

Zum Beispiel:

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

Abwärtskompatibilität

Bei FastComments wissen wir, dass unsere Kunden das Kommentierungs-Widget anpassen. Das ist beabsichtigt – das Letzte, was wir wollen, ist, dass unser Produkt Design-Inkonsistenzen in Ihrem Produkt verursacht.

Da dies ein wichtiger Bestandteil unseres Produkts ist, verfügen wir über eine Build-Pipeline, die es uns ermöglicht, Änderungen am Kommentar-Widget pro Kunde bei jedem Release zu prüfen.

Wenn wir kleinere Probleme feststellen, werden wir Ihr Konto aktualisieren, um einen reibungslosen Release sicherzustellen. Wenn wir schwerwiegende, inkompatible Änderungen feststellen, erlaubt uns das, den Release zu stoppen.

Für Kunden mit Pro- oder Enterprise-Konten ist White-Labeling erlaubt. Kontaktieren Sie uns und wir helfen Ihnen gerne.

Wenn Sie lediglich unser Logo aus dem Kommentar-Widget entfernen möchten, ist dies in den Flex- und Pro-Plänen automatisch aktiviert.

Diese Pläne bieten außerdem dieselbe Funktionalität für E-Mails, die von unserer Plattform gesendet werden.

Für Websites, die das Umschalten des Dunkelmodus nach dem initialen Laden der Seite erlauben, ist dies etwas komplizierter.

Zunächst enthalten alle aktuellen Versionen der Comment-Widget-Bibliothek (React, Vue) Beispiele zum Umschalten des Dunkelmodus in ihren jeweiligen Repositories.

Für das VanillaJS-Widget müssen wir etwas mehr Arbeit leisten. Die FastCommentsUI gibt zunächst ein Objekt mit den Funktionen "destroy" und "update" zurück.

Wir können einfach die Funktion update aufrufen, jedes Mal wenn wir die Konfiguration des Kommentar-Widgets aktualisieren möchten, wie folgt. Hier ist ein voll funktionsfähiges Beispiel zum Umschalten des Dunkelmodus mit dem VanillaJS-Widget.

Vollständiges Beispiel: Umschalten des Dunkelmodus

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

Mit FastComments ist sämtlicher Text im Kommentar-Widget anpassbar.

Sie können einen einzelnen Textbaustein überschreiben, z. B. die Absenden-Schaltfläche, oder den gesamten Text des Kommentar-Widgets.

Standardmäßig wird der Text im Kommentar-Widget basierend auf der Locale des Nutzers übersetzt. Wir können den Text jedoch überschreiben, wenn wir sicher sind, dass unsere Benutzerbasis dieselbe Locale/Sprache verwendet, zum Beispiel:

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

Alle anpassbaren Übersetzungen finden Sie hier unter der "erweiterten Optionen" Registerkarte.

Es gibt jedoch einen einfacheren Weg über die Widget-Anpassungsoberfläche. Dort können wir einfach den Text finden, der im Kommentar-Widget in der EN_US-Locale angezeigt wird, und einen Ersatz angeben.

Custom Text

Alle Überschreibungen von Übersetzungen wirken sich derzeit auf alle Locales aus.

Wenn ein Benutzer zum ersten Mal mit FastComments kommentiert, versuchen wir, sein Avatar von http://gravatar.com/ abzurufen.

Wenn wir jedoch kein Avatarbild finden oder der Benutzer nie eines in seinem Konto einstellt, zeigen wir ein statisches Standard-Avatarbild an.

Um ein eigenes statisches Avatarbild anzugeben, können wir die Einstellung defaultAvatarSrc verwenden.

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Anpassung des Widgets siehe den Abschnitt "Default Avatar".

Customizing The Default Avatar

Beachten Sie, dass die Festlegung des Avatars für einen bestimmten Benutzer, z. B. bei SSO, in einem eigenen Abschnitt behandelt wird.

Avatare können vollständig aus dem Kommentar-Widget entfernt werden, auch wenn Benutzer ihren eigenen Avatar festgelegt haben.

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

Ohne Code kann dies auf der Seite zur Anpassung des Widgets konfiguriert werden:

Hiding Avatars

Bei größeren kundenspezifischen Styling-Projekten kann es wünschenswert sein, mit einer sauberen Basis zu beginnen und die Standardformatierung überhaupt nicht zu verwenden.

Alle Standardstile können entfernt werden, indem der noStyles-Parameter auf true gesetzt wird, wie folgt:

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

Dies kann ohne Code auf der Seite zur Widget-Anpassung unter Erweiterte Optionen angepasst werden:

Disabling All Default Styles

Standardmäßig werden Antworten auf Top-Level-Kommentare angezeigt.

Dies kann so konfiguriert werden, dass der Nutzer auf den Top-Level-Kommentaren auf "Antworten anzeigen" klicken muss, um die untergeordneten Kommentare zu sehen.

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

Dies kann ohne Code auf der Seite zur Anpassung des Widgets konfiguriert werden:

Collapse Replies

Diese Einstellung wirkt sich nicht auf die Anzahl der anfänglich geladenen Top-Level-Kommentare aus. Wenn Sie einen Top-Level-Kommentar und 29 Unterkommentare haben, sehen Sie bei aktivierter Einstellung:

• Sehen Sie den Top-Level-Kommentar.
• Unter diesem Kommentar sehen Sie "Antworten anzeigen (29)".

Wenn Sie alle Top-Level-Kommentare in Kombination mit dieser Option anzeigen möchten, setzen Sie Anfangsseite auf -1.

Standardmäßig erfolgt die Formatierung in FastComments durch das Hinzufügen sichtbarer Anker-Tags wie <b></b> um Ihren Text. Ein Klick auf die Symbolleiste oder die Verwendung von Tastenkombinationen erledigt das für Sie. Manche Communities möchten jedoch optional Formatierung ohne Anker-Tags verwenden. Das WYSIWYG (Was Sie sehen, ist, was Sie bekommen) Editor genannt. Dieser Editor sieht genau gleich aus wie der Standardeditor, lädt jedoch einige zusätzliche Code-Bestandteile, die es Benutzern ermöglichen, ihren Text fett, unterstrichen usw. zu formatieren, ohne sichtbare Anker-Tags.

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

Dies kann auch ohne Code durchgeführt werden. Auf der Seite zur Anpassung des Widgets finden Sie die Option "Erweiterte Formatierung aktivieren".

Enable WYSIWYG

Standardmäßig zeigt FastComments beim Schreiben eines Kommentars eine Symbolleiste an, die Schnellzugriffe zum Formatieren von Text und zum Hochladen von Bildern bietet.

Diese Symbolleiste kann im Code oder über die Anpassungs-UI deaktiviert werden.

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Widget-Anpassung finden Sie die Option "Antwort-Symbolleiste deaktivieren".

Disabling The Toolbar

Standardmäßig erlaubt FastComments Nutzern, andere Nutzer zu blockieren. Wenn ein Nutzer blockiert wird, werden seine Kommentare ausgeblendet, Benachrichtigungen zwischen den Nutzern verhindert und so weiter.

Es kann wünschenswert sein, diese Funktionalität zu deaktivieren. Das kann wie folgt gemacht werden:

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

Dies kann auch ohne Code über die UI zur Widget-Anpassung vorgenommen werden, wodurch zudem eine ordnungsgemäße serverseitige Validierung aktiviert wird:

Disable Blocking

Standardmäßig werden lokalisierte relative Datumsangaben verwendet. Zum Beispiel sehen Sie neben einem kürzlich abgegebenen Kommentar möglicherweise "vor 11 Minuten".

Es kann erforderlich oder gewünscht sein, absolute Datumsangaben zu verwenden; in diesem Fall setzen Sie diesen Parameter auf true.

Absolute Datumsangaben verwenden

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

Dies kann ohne Programmieraufwand auf der Seite zur Anpassung des Widgets unter Erweiterten Optionen konfiguriert werden:

Absolute Datumsangaben verwenden

Standardmäßig werden lokalisierte relative Datumsangaben verwendet. Zum Beispiel sehen Sie neben einem kürzlich abgegebenen Kommentar möglicherweise "vor 11 Minuten".

Es kann notwendig oder wünschenswert sein, dieses relative Datumsformat beizubehalten und zugleich das vollständige Datum daneben anzuzeigen; in diesem Fall setzen Sie diesen Parameter auf 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

Dies kann ohne Code auf der Seite zur Anpassung des Widgets unter Advanced Options angepasst werden. Sie müssen zunächst Absolute Dates aktivieren, um diese Option in der UI zu sehen.

Use Both Absolute and Relative Dates

Einige Texte, wie eine Kopfzeile oder eine Nachricht, können unterhalb der Kommentaranzahl, aber oberhalb des Anmeldestatus angezeigt werden.

Wir nennen dies die Kopfzeile, und standardmäßig ist sie ausgeblendet.

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

Dies kann ohne Code auf der Seite zur Widget-Anpassung unter Erweiterte Optionen angepasst werden:

Specifying Header HTML

Standardmäßig rendert FastComments Links so: https://exmaple.com - wobei die Link-URL zu einem anklickbaren HTML-Anker-Tag wird.

Einige Sites möchten dies möglicherweise deaktivieren, zum Beispiel um Betrüger abzuschrecken. Wir stellen dies bereit, indem Sie die Comment HTML Rendering Option auf Links as Text setzen.

Dies kann ohne Code auf der Widget-Anpassungsseite für eine gesamte Domain oder Seite angepasst werden:

Render Links as Text

Standardmäßig rendert FastComments gleichzeitig das Kommentareingabefeld und den Kommentar-Thread. Um etwas vertikalen Platz zu sparen, versteckt es außerdem alle anderen erforderlichen Felder, bis mit dem Widget interagiert wird.

Click to Show Comments

Die Schaltfläche verwendet je nachdem, ob die Kommentare derzeit angezeigt werden oder nicht, unterschiedlichen übersetzten Text. Wenn die Kommentare ausgeblendet sind, verwendet sie translations.SHOW_COMMENTS_BUTTON_TEXT. Wenn die Kommentare angezeigt werden, verwendet sie translations.HIDE_COMMENTS_BUTTON_TEXT. Die Übersetzungen können den Text [count] enthalten, der durch die lokalisierte Anzahl ersetzt wird.

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

Dies ist dafür vorgesehen, die Konfiguration hideCommentsUnderCountTextFormat zu ersetzen.

Die Anzahl wird zusammen mit dem Kommentar-Thread live aktualisiert. Die Schaltfläche wird nicht angezeigt, wenn keine Kommentare vorhanden sind.

Dies kann ohne Code aktiviert werden, indem eine Anpassungsregel erstellt und "Klicken, um Kommentare anzuzeigen" aktiviert wird:

Enable Click to Show Comments

Die oben im Kommentar-Widget angezeigte Kommentaranzahl kann angepasst werden.

Dies kann durch beliebigen Text ersetzt werden, und der Wert [count] wird durch die Anzahl ersetzt, für den Benutzer lokalisiert.

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

Dies kann ohne Code auf der Seite zur Anpassung des Widgets vorgenommen werden:

Customizing The Comment Count Text

Wenn Benutzer Hashtags eingeben, in der Form von #someexampletag, erstellt FastComments automatisch diesen HashTag und hebt ihn in ihrem Kommentar hervor.

In manchen Fällen ist es wünschenswert, diese Funktion zu deaktivieren oder zu steuern, welche Hashtags über die API verwendet werden können.

Dazu aktivieren Sie einfach Disable Automatic #hashtag Creation über die Widget-Anpassungs-Benutzeroberfläche.

Disabling Automatic HashTag Creation

Standardmäßig zeigt FastComments in der oberen rechten Ecke des Kommentarbereichs eine Benachrichtigungsglocke an.

Diese Glocke wird rot und zeigt die Anzahl der Benachrichtigungen des Nutzers an. Beispiele für Benachrichtigungen sind:

• Ein Benutzer hat Ihnen geantwortet.
• Ein Benutzer hat in einem Thread geantwortet, in dem Sie kommentiert haben.
• Ein Benutzer hat Ihren Kommentar positiv bewertet.
• Ein Benutzer hat auf einer Seite geantwortet, die Sie abonniert haben.

Die Benachrichtigungsglocke bietet auch eine Möglichkeit, eine gesamte Seite zu abonnieren.

Wir können die Benachrichtigungsglocke jedoch vollständig deaktivieren:

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Anpassung des Widgets finden Sie den Abschnitt "Disable Notification Bell".

Disable Notification Bell

Standardmäßig zeigt FastComments das Profil des Benutzers an, wenn Sie auf dessen Avatar klicken.

Sie können diese Funktionalität jedoch deaktivieren:

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

Dies kann auch ohne Code durchgeführt werden. Auf der Seite zur Anpassung des Widgets finden Sie den Abschnitt "Profile deaktivieren".

Disable Profiles

Standardmäßig zeigt FastComments nach dem Kommentieren eine Erfolgsmeldung an. Dies kann wie folgt deaktiviert werden:

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Anpassung des Widgets:

Disable Success Message

Standardmäßig setzt das FastComments-Kommentar-Widget eine gif rating von pg.

Verfügbare Optionen sind g, pg, pg-13 und r.

Dies kann im Code oder über die UI eingestellt werden. Im Code können wir es wie folgt tun:

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

In der UI finden Sie dies unter Gif Picker Rating, sofern Disable Image Uploads? nicht aktiviert ist.

Setting The Gif Rating

Standardmäßig ist die Bildinhaltsmoderation im FastComments-Kommentar-Widget auf off gestellt.

Verfügbare Optionen sind off, low, medium und high.

In der Benutzeroberfläche zur Widget-Anpassung finden Sie diese Einstellung unter Image Content Moderation Level, sofern Disable Image Uploads? nicht aktiviert ist.

Setting The Image Content Moderation Level

Standardmäßig rendert FastComments die Abstimmungsoptionen als Auf- und Abwärtspfeile, sodass Benutzer einen Kommentar entweder hoch- oder runterstimmen können.

Es ist jedoch möglich, den Stil der Abstimmungsleiste zu ändern. Die aktuellen Optionen sind die standardmäßigen Auf-/Ab-Tasten oder ein Herzstil für die Abstimmung.

Wir verwenden das Flag voteStyle wie folgt:

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

Wir empfehlen dringend, dies ohne Code zu tun, da dadurch auch serverseitige Validierungen aktiviert werden. Auf der Seite zur Widget-Anpassung finden Sie den Abschnitt „Vote Style“.

Change Voting Style

Abstimmungen können auch deaktiviert werden, siehe Disable Voting oberhalb der Stiloptionen.

Standardmäßig erlaubt FastComments Benutzern, ihre Kommentare zu löschen.

Es ist jedoch möglich, dies zu verhindern.

Auf der Seite zur Anpassung des Widgets finden Sie die Option "Löschen deaktivieren".

Disable Comment Deleting

• Dies betrifft nur normale Kommentatoren und nicht Moderatoren oder Administratoren, die weiterhin löschen können.
• Dies wirkt sich auch auf API-Integrationen aus, wenn contextUserId übergeben wird.

Standardmäßig erlaubt FastComments Benutzern, ihre Kommentare zu bearbeiten.

Es ist jedoch möglich, dies zu verhindern.

Auf der Seite zur Anpassung des Widgets siehe die Option "Bearbeitung deaktivieren".

Disable Comment Editing

• Dies betrifft nur normale Kommentierende und nicht Moderatoren oder Administratoren, die weiterhin bearbeiten können.
• Dies wirkt sich auch auf API-Integrationen aus, wenn contextUserId übergeben wird.

Standardmäßig beträgt die FastComments-Seitengröße 30. Dies schließt Antworten in Threads ein.

Die Seitengröße kann in der Widget-Konfigurationsoberfläche in unterschiedlichen Größen von 10 bis 200 angepasst werden.

Beachten Sie, dass das Ändern der Seitengröße eine Neuberechnung aller Kommentar-Threads in Ihrem Konto erfordert. Dies kann ein paar Minuten dauern.

Dies kann nicht im Client-seitigen Widget konfiguriert werden, da Seiten serverseitig berechnet werden.

Ein Beispiel für die Konfiguration wird unten gezeigt:

Custom Page Sizes

Die Seitengrößen können global, pro Domain oder pro Seite angepasst werden, indem Sie unterschiedliche Anpassungsregeln erstellen.

Dies wirkt sich auf alle Clients, Integrationen und Frameworks aus, die Sie möglicherweise verwenden, um Kommentare über unsere Plattform anzuzeigen.

Standardmäßig zeigt FastComments den Namen des Benutzers so an, wie er ihn eingegeben hat, oder wie er uns über SSO übermittelt wurde.

Es kann jedoch wünschenswert sein, den Namen des Benutzers zu maskieren oder anders anzuzeigen. Zum Beispiel, wenn der Name des Benutzers Allen Rex ist, möchten Sie vielleicht nur "Allen R." anzeigen.

Dies kann ohne Code in der Widget-Anpassungsoberfläche, unter der Einstellung Commenter Name Format, durchgeführt werden:

Change Name Format

Die verfügbaren Formate sind:

• Großschreibung (zeigt Beispielbenutzer als Beispielbenutzer an)
• Letzter Anfangsbuchstabe (zeigt Beispielbenutzer als Beispiel B. an)
• Alle Initialen (zeigt Beispielbenutzer als B. B. an)
• "Anonym" anzeigen

Die Änderung wirkt sofort. Benutzer sehen ihren vollständigen Benutzernamen weiterhin oben im Kommentarbereich für sich selbst, aber in ihren Kommentaren wird der modifizierte Benutzername angezeigt.

Benutzernamen werden serverseitig maskiert, um die Nutzer zu schützen.

Standardmäßig erlaubt FastComments das Hochladen von Bildern. Dies kann deaktiviert werden, indem das Flag noImageUploads auf true gesetzt wird.

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

Dies kann ohne Code auf der Seite zur Widget-Anpassung angepasst werden:

Disabling Image Uploads

Standardmäßig wird im Kommentar-Widget kein Suchfeld angezeigt.

Wir können dies jedoch aktivieren, indem wir das Flag enableSearch auf true setzen:

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Anpassung des Widgets sehen Sie die Option „Enable Search Box“.

Enable Search Box

Wir können die Spoiler-Unterstützung aktivieren, indem wir das Flag enableSpoilers auf true setzen:

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

Dies kann auch ohne Code gemacht werden. Auf der Seite zur Anpassung des Widgets finden Sie die Option "Spoiler aktivieren".

Enable Spoilers

Wenn Text markiert ist und der nun sichtbare SPOILER-Button angeklickt wird, wird der Text verborgen, bis der Benutzer mit der Maus darüber fährt. Im Dunkelmodus machen wir dasselbe, mit anderen Farben, die besser zum Dunkelmodus passen.

Dies ist auch mit dem WYSIWYG-Editor kompatibel.

Standardmäßig verfolgt FastComments nicht, wer jeden Kommentar angesehen hat, und stellt dazu keine Statistiken bereit.

Wir können diese Funktion jedoch aktivieren, und das System beginnt dann zu erfassen, wenn jeder Benutzer zu einem Kommentar scrollt.

In diesem Fall wird neben einem Augensymbol an jedem Kommentar eine Zählung erhöht. Die Zählung wird live aktualisiert und entsprechend der Lokalisierung des Benutzers abgekürzt.

Wir können dies aktivieren, indem wir das Flag enableViewCounts auf true setzen:

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

Dies kann ohne Code auf der Widget-Anpassungsseite angepasst werden:

Enabling Comment View Counts

Wir erfassen die Benutzer-ID*, die den Kommentar angesehen hat, damit beim erneuten Anzeigen des Kommentars die Zählung nicht erhöht wird. Wenn Sie den Kommentar jedoch erst nach zwei Jahren erneut ansehen, wird die Zählung wieder erhöht.

• *Hinweis: oder die anonyme Sitzungs-ID, oder die IP des Benutzers als gehashter Wert.

Standardmäßig ist Live-Kommentierung aktiviert. Das bedeutet, dass wenn Kommentare hinzugefügt, gelöscht, bearbeitet oder angepinnt werden, die Änderungen allen Nutzern, die denselben Kommentar-Thread ansehen, gleichzeitig angezeigt werden sollten.

Standardmäßig erscheinen diese neuen Kommentare jedoch unter einer dynamisch eingeblendeten Schaltfläche mit einem Text ähnlich wie „Zeige 2 neue Kommentare“.

Wenn die neuen Kommentare direkte Antworten auf die Seite sind, wird die Schaltfläche oben im Kommentar-Thread angezeigt. Wenn sie Antworten auf einen bestimmten Kommentar sind, wird die Schaltfläche unter diesem Kommentar angezeigt.

Dies verhindert, dass sich die Seitengröße ständig für den Nutzer ändert, was beim Versuch, die Bildlaufleiste zu greifen, zu Frustration führen kann.

Für einige Anwendungsfälle, wie Live-Auktionen oder Online-Events, ist dieses Verhalten nicht erwünscht – hier möchte man möglicherweise, dass das Kommentar-Widget eher wie ein „Chat“-Feld funktioniert, in dem neue Kommentare „sofort angezeigt werden“.

Daher der Name der Flag, die diese Funktion aktiviert: showLiveRightAway.

Wir können es wie folgt aktivieren:

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

Dies kann ohne Code auf der Seite zur Widget-Anpassung angepasst werden:

Show Live Comments Right Away

Standardmäßig ist bei FastComments das Live-Kommentieren aktiviert.

Das bedeutet, dass jeder Betrachter des Kommentarthreads denselben Inhalt sehen sollte.

Zum Beispiel: Wenn ein Kommentar hinzugefügt wird, sollte dieser Kommentar angezeigt werden. Wird ein Kommentar bearbeitet oder entfernt, werden diese Änderungen für alle Betrachter des Threads übernommen. Gleiches gilt für Stimmen und alle Moderationsaktionen.

Wir können dies jedoch deaktivieren:

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Anpassung des Widgets finden Sie den Abschnitt "Disable Live Commenting".

Disable Live Commenting

Standardmäßig sortiert FastComments Kommentare nach der Sortierreihenfolge "Am relevantesten".

Die Sortierung "Am relevantesten" berücksichtigt für die Sortierung den Zeitpunkt, zu dem der Kommentar abgegeben wurde, und die Anzahl der Stimmen.

Der Benutzer kann dann in der Benutzeroberfläche des Kommentar-Widgets die Sortierreihenfolge entweder auf Älteste oder Neueste zuerst ändern.

Wir können das Standardverhalten jedoch auf eine der drei Optionen ändern. Wenn Sie beispielsweise die ältesten Kommentare zuerst anzeigen möchten:

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

Wir setzen den Wert von defaultSortDirection auf "OF", um die Sortierreihenfolge auf "OF" festzulegen.

Für die Sortierreihenfolge Neueste zuerst würden wir Folgendes tun:

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

Gültige Werte für defaultSortDirection sind:

• MR: "Am neuesten"
• NF: "Neueste zuerst"
• OF: "Älteste zuerst"

Dies kann auch ohne Code durchgeführt werden. Auf der Seite zur Anpassung des Widgets siehe den Abschnitt "Default Sort Direction".

Changing The Default Sort Direction

Beachten Sie, dass die Kommentare auf jeder Seite für jede Sortierreihenfolge vorab berechnet werden, sodass alle Sortierreihenfolgen die gleiche Leistung haben.

Standardmäßig befindet sich der Kommentar-Eingabebereich vor dem Kommentar-Thread. Allerdings können wir durch Setzen dieses Konfigurationsparameters auf true ihn nach verschieben.

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

Dies kann ohne Code auf der Seite zur Widget-Anpassung angepasst werden:

Moving The Reply Box to The Bottom

Die maximale Anzahl von Zeichen, die im Kommentarfeld eingegeben werden dürfen, kann durch den Parameter maxCommentCharacterLength begrenzt werden.

Der Standardwert beträgt 2000.

Elemente wie Bild-URLs werden nicht in die Längenberechnung einbezogen.

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

Dies kann ohne Code auf der Widget-Anpassungsseite konfiguriert werden:

Limit Comment Length

Standardmäßig erlaubt FastComments dem Benutzer, einen Kommentar mit so vielen Zeilen einzugeben, wie er möchte, bis zum standardmäßigen Zeichenlimit.

Es kann jedoch wünschenswert sein, den Benutzer darauf zu beschränken, nur eine einzige Textzeile einzugeben. Beispiele für Anwendungsfälle sind Online-Auktionen oder Live-Chat, für die FastComments verwendet werden kann.

Wir aktivieren das Flag useSingleLineCommentInput wie folgt:

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

Dies kann auch ohne Code erfolgen. Auf der Seite zur Anpassung des Widgets finden Sie den Abschnitt "Enable Single-Line Comment Input".

Enable Single-Line Comment Input

Beachten Sie, dass die Kommentare auf jeder Seite für jede Sortierrichtung vorab berechnet werden, sodass alle Sortierrichtungen die gleiche Leistung haben.

Standardmäßig kann jeder Benutzer bis zu 5 comments in derselben Minute absenden.

Dies wird anhand von user id, anon user id und ip address (hashed) nachverfolgt.

Dies kann ohne Code auf der Seite zur Widget-Anpassung angepasst werden:

Limiting Comment Volume Per User

Beachte, dass, wenn du die comment creation API verwendest, du möglicherweise die ursprüngliche ip address des Benutzers in der Anfrage an unser backend übergeben möchtest, damit rate limiting angewendet wird pro Benutzer und nicht global für dein Konto.

FastComments Secure SSO verwendet HMAC-SHA256-Verschlüsselung als Mechanismus zur Implementierung von SSO. Zuerst gehen wir die Gesamtarchitektur durch, liefern Beispiele und detaillierte Schritte.

Es gibt auch einige Dokumentationen zur Migration von anderen Anbietern mit ähnlichen SSO-Mechanismen und den Unterschieden.

Der Ablauf sieht folgendermaßen aus:

Secure SSO Flow

Da Secure SSO Full-Stack-Entwicklung beinhaltet, befinden sich vollständige funktionierende Codebeispiele in Java/Spring, NodeJS/Express und reinem PHP derzeit auf GitHub.

Obwohl wir ExpressJS im NodeJS-Beispiel und Spring im Java-Beispiel verwenden, sind in diesen Laufzeitumgebungen keine zusätzlichen Frameworks/Bibliotheken erforderlich, um FastComments SSO zu implementieren – die nativen Crypto-Pakete reichen aus.

Sie müssen keine neuen API-Endpunkte mit FastComments SSO schreiben. Verschlüsseln Sie einfach die Benutzerinformationen mit Ihrem geheimen Schlüssel und übergeben Sie die Nutzlast an das Kommentar-Widget.

API-Geheimschlüssel abrufen

Ihr API-Geheimschlüssel kann von dieser Seite abgerufen werden. Sie finden diese Seite auch, indem Sie zu Mein Konto gehen, die Kachel API/SSO anklicken und dann auf "Get API Secret Key" klicken.

Parameter des Kommentar-Widgets

Hochstufige API-Dokumentation für das Kommentar-Widget finden Sie hier.

Lassen Sie uns näher erläutern, was diese Parameter bedeuten.

Das Kommentar-Widget nimmt ein Konfigurationsobjekt entgegen – dieses übergeben Sie bereits, wenn Sie FastComments verwenden, um Ihre Mandanten-ID (tenantId) zu übergeben.

Um SSO zu aktivieren, übergeben Sie ein neues "sso"-Objekt, das die folgenden Parameter enthalten muss. Die Werte sollten serverseitig erzeugt werden.

• userDataJSONBase64: Die Benutzerdaten im JSON-Format, die anschließend Base64-codiert werden.
• verificationHash: Der HMAC-SHA256-Hash, erstellt aus UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Epoch-Zeitstempel, in Millisekunden. Darf nicht in der Zukunft liegen oder mehr als zwei Tage in der Vergangenheit.
• loginURL: Eine URL, die das Kommentar-Widget anzeigen kann, um den Benutzer anzumelden.
• logoutURL: Eine URL, die das Kommentar-Widget anzeigen kann, um den Benutzer abzumelden.
• loginCallback: Wenn anstelle der loginURL bereitgestellt, eine Funktion, die das Kommentar-Widget aufruft, wenn auf die Login-Schaltfläche geklickt wird.
• logoutCallback: Wenn anstelle der logoutURL bereitgestellt, eine Funktion, die das Kommentar-Widget aufruft, wenn auf die Logout-Schaltfläche geklickt wird.

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

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

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

13 }

14}];

15</script>

16

Das Benutzerobjekt

The User object contains the following schema:

Das Benutzerobjekt

Copy

1

2interface SSOUser {

3 /** Erforderlich. Max. 1k Zeichen. **/

4 id: string;

5 /** Erforderlich. Max. 1k Zeichen. Hinweis: Muss eindeutig sein. **/

6 email: string;

7 /** Erforderlich. Max. 1k Zeichen. Hinweis: Der Benutzername darf keine E-Mail-Adresse sein. Muss nicht eindeutig sein. **/

8 username: string;

9 /** Optional. Max. 3k Zeichen für URLs. Standardmäßig wird das Gravatar-Bild basierend auf der E-Mail verwendet. Unterstützt Base64-codierte Bilder; in diesem Fall beträgt das Limit 50k Zeichen. **/

10 avatar?: string;

11 /** Optional. Standardmäßig false. **/

12 optedInNotifications?: boolean;

13 /** Optional. Standardmäßig false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Optional. Max. 100 Zeichen. Dieses Label wird neben dem Namen angezeigt. Standardmäßig Administrator/Moderator, wenn zutreffend. **/

16 displayLabel?: string;

17 /** Optional. Max. 500 Zeichen. Dies wird anstelle des Benutzernamens angezeigt. **/

18 displayName?: string;

19 /** Optional. Max. 2k Zeichen. Der Name des Benutzers verlinkt darauf. **/

20 websiteUrl?: string;

21 /** Optional. Bis zu 100 Gruppen pro Benutzer. Eine Gruppen-ID darf nicht länger als 50 Zeichen sein. **/

22 groupIds?: string[];

23 /** Optional. Kennzeichnet den Benutzer als Administrator. **/

24 isAdmin?: boolean;

25 /** Optional. Kennzeichnet den Benutzer als Moderator. **/

26 isModerator?: boolean;

27 /** Optional, Standard: true. Auf false setzen, um den "activity"-Tab im Profil des Benutzers zu aktivieren. **/

28 isProfileActivityPrivate?: boolean;

29 /** Optional, Standard: false. Auf true setzen, um Profilkommentare zu deaktivieren. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Optional, Standard: false. Auf true setzen, um Direktnachrichten an diesen Benutzer zu deaktivieren. **/

32 isProfileDMDisabled?: boolean;

33}

34

Moderatoren und Administratoren

Für Admins und Moderatoren übergeben Sie die jeweiligen Flags isAdmin bzw. isModerator im SSOUser-Objekt.

Benachrichtigungen

Um Benachrichtigungen zu aktivieren oder zu deaktivieren, setzen Sie den Wert von optedInNotifications jeweils auf true oder false. Beim ersten Laden der Seite durch den Benutzer mit diesem Wert in der SSO-Nutzlast werden seine Benachrichtigungseinstellungen aktualisiert.

Wenn Benutzer zudem E-Mail-Benachrichtigungen für Aktivitäten auf Seiten erhalten sollen, für die sie sich angemeldet haben (anstatt nur In-App-Benachrichtigungen), setzen Sie optedInSubscriptionNotifications auf true.

VIP-Benutzer & spezielle Labels

Sie können ein spezielles Label neben dem Namen des Benutzers anzeigen, indem Sie das optionale Feld "displayLabel" verwenden.

Nicht authentifizierte Benutzer

Um einen nicht authentifizierten Benutzer darzustellen, füllen Sie einfach weder userDataJSONBase64, verificationHash noch timestamp aus. Geben Sie eine loginURL an.

Diese Benutzer können nicht kommentieren und erhalten stattdessen eine Login-Nachricht (Nachricht, Link oder Schaltfläche, je nach Konfiguration).

Direkte Beispiele zum Serialisieren und Hashen von Benutzerdaten

Mehr Details als Beispiele finden Sie hier (js), hier (java) und hier (php).

Wir verstehen, dass jede Integration ein komplizierter und schwieriger Prozess sein kann. Zögern Sie nicht, sich an Ihren Ansprechpartner zu wenden oder die Support-Seite zu nutzen.

FastComments SSO (weitere Details) bietet Ihren Nutzern eine Möglichkeit, Kommentare zu schreiben, ohne sich bei einer anderen Plattform anmelden zu müssen.

Allein dadurch sind Ihre Kommentarthreads jedoch nicht gesichert, da standardmäßig Kommentardaten öffentlich zugänglich sind - jeder, der die Seite sehen kann, kann auch die Kommentare sehen.

Durch Ändern einer Einstellung können wir verhindern, dass Kommentare abgerufen werden, es sei denn, der Abruf erfolgt durch einen Administrator oder einen gültigen SSO-Benutzer.

Einrichtung ohne Code

Wir können das Anzeigen und Interagieren mit unseren Kommentarthreads, wenn SSO eingerichtet ist, verhindern, indem wir eine Anpassungsregel erstellen.

Suchen Sie dabei nach SSO, und Sie finden diese Option:

Require SSO To View Comments

Aktivieren Sie sie und speichern Sie die Anpassungsregel.

Nur eine bestimmte Domain oder Seite schützen

Um nur eine bestimmte Domain oder Seite zu schützen, konfigurieren wir einfach die Anpassungsregel entsprechend.

Oben in der Anpassungsoberfläche finden wir zwei Eingabefelder, Domain und URL ID.

Um nur eine bestimmte Domain zu schützen, geben Sie die betreffende Domain in das Feld "domain" ein.

Um eine bestimmte Seite zu schützen, geben Sie eine Seiten-URL in das Feld "URL ID" ein. Wenn Sie eine benutzerdefinierte Integration mit FastComments haben, können Sie hier stattdessen eine Art von ID eingeben.

Sicherheitsstufen

Wenn SSO erforderlich ist, müssen Sie entscheiden, ob Sie Simple SSO oder Secure SSO verlangen. Wenn Sie Simple SSO verlangen, sind beide zulässig; wenn Sie Secure SSO verlangen, muss der Inhalt mit einer Secure SSO-Payload abgerufen werden, die mit Ihrem API key gehasht wurde, damit er angezeigt werden kann.

Die Option für das Sicherheitslevel erscheint, wenn Sie "Require SSO To View Comments" auswählen.

Schutz über das Lesen hinaus

Wenn Sie diese Option aktivieren, wird die Seite bzw. Domain vor Kommentaren geschützt, es sei denn, der Benutzer ist über SSO angemeldet.

Fallstricke

Alle Benutzer, die Kommentare vor Ihrer SSO-Integration erstellt haben, können diese nicht sehen, sofern sie sich nicht über Ihre SSO-Integration anmelden.

Standardmäßig verlangt FastComments eine E-Mail-Adresse, um zu kommentieren. Es muss sich dabei nicht um eine gültige E-Mail-Adresse handeln, jedoch wird der Kommentar bis zu dem Zeitpunkt, an dem der Nutzer auf einen an ihn gesendeten Link klickt, sein Kommentar mit dem Label "Unbestätigter Kommentar" versehen.

Wir können jedoch die E-Mail-Anforderung entfernen. Das E-Mail-Eingabefeld wird weiterhin angezeigt, ist aber nicht mehr erforderlich.

Dies lässt sich über die Benutzeroberfläche zur Anpassung des Widgets konfigurieren:

Enabling Anonymous Comments

FastComments kann so konfiguriert werden, dass nicht verifizierte Kommentare nach einer gewünschten Anzahl von Tagen entfernt werden. Dies hilft, Spam zu bekämpfen.

Standardmäßig ist dies nicht aktiviert.

Dies kann über die Moderationseinstellungen-Seite konfiguriert oder deaktiviert werden.

Moderation Settings

Wenn Benutzer kommentieren und nicht eingeloggt sind, werden sie gebeten, ihre E-Mail anzugeben.

Dies wird eine "unverifizierte Sitzung" für diesen Benutzer erstellen, und wir werden ihn per E-Mail auffordern, diese Sitzung zu verifizieren.

Für einige Websites oder Anwendungen ist es wünschenswert, den Benutzer beim Kommentieren oder Abstimmen nicht nach seiner E-Mail zu fragen.

Das Aktivieren anonymen Kommentierens macht das E-Mail-Eingabefeld optional. Wir können es jedoch komplett deaktivieren. Aktivieren Sie zuerst anonymes Kommentieren, und dann erscheint die Option, die E-Mail-Eingabefelder zu deaktivieren.

Disable Email Inputs

Ist dies aktiviert, werden die E-Mail-Felder in allen unseren Kommentarsystemen überhaupt nicht angezeigt.

Beachten Sie, dass mit dieser Konfiguration alle Kommentare unverifiziert sind, es sei denn, der Benutzer erstellt ein Konto und meldet sich bei https://fastcomments.com an.

Sie sollten in Erwägung ziehen, das „Unverified“-Label zu deaktivieren.

Standardmäßig zeigt FastComments ein "Unbestätigter Kommentar" Label für Kommentare an, die für einen Nutzer hinterlassen wurden, der eine nicht verifizierte Browsersitzung hat. Mehr zum unbestätigten Kommentieren lesen Sie hier.

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

Zusätzlich kann diese Funktion ohne Programmieraufwand in der Customization UI verwendet werden:

Disable The Unverified Label

Wenn Benutzer versuchen, für einen Kommentar abzustimmen und nicht angemeldet sind, werden sie aufgefordert, ihren Benutzernamen und ihre E-Mail anzugeben.

Wir können diese Anforderung entfernen, sodass jeder für einen Kommentar abstimmen kann, ohne irgendwelche Informationen zu hinterlassen.

Allow Anonymous Votes

Wenn Benutzer kommentieren oder abstimmen und nicht eingeloggt sind, werden sie aufgefordert, ihre E-Mail-Adresse und ihren Benutzernamen anzugeben.

Im Fall von anonymen Kommentaren ist es manchmal wünschenswert, einen Standard-Benutzernamen festzulegen, um die Hürde beim Kommentieren zu verringern. Dies kann über die Anpassungs-Benutzeroberfläche vorgenommen werden. Anonymes Kommentieren muss zuerst aktiviert sein.

Setting The Default Username

Standardmäßig zeigt FastComments das Kommentar-Widget in der vom System und Browser des Benutzers bestimmten Locale an.

Wenn ein Benutzer kommentiert oder sich einloggt, aktualisieren wir seine zuletzt verwendete Locale und verwenden diese auch zum Versenden von E-Mails.

Dies beeinflusst, wie das Kommentier-Widget für den Benutzer übersetzt wird. Locale setzt sich aus der Sprache und der Region des Benutzers zusammen, daher ändert das Konfigurieren der Locale in der Regel die Sprache, die zur Anzeige von Text für den Benutzer verwendet wird.

Über die Benutzeroberfläche

Dies kann über die UI zur Anpassung des Widgets festgelegt werden. Siehe die Option "Locale / Language":

Changing The Locale / Language

Über Code

Dies kann mit einer gewünschten Locale überschrieben werden.

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

Unterstützte Sprachen und Locale-Codes

Hier finden Sie die vollständige Liste der unterstützten Sprachen und der entsprechenden Locale-Codes.

SSO-Hinweis

Wenn Sie SSO verwenden, sollten Sie die Locale des Benutzers im Benutzerobjekt übergeben, damit E-Mails und andere Inhalte korrekt für ihn lokalisiert werden.

Standardmäßig begrenzt FastComments die für Kommentare verwendeten Sprachen nicht.

Es kann wünschenswert sein, die Sprachen einer Community einzuschränken.

Dies lässt sich ohne Programmieraufwand auf der Seite für die Anpassung des Widgets konfigurieren:

Allowed Languages

Das System analysiert den Kommentar, bestimmt dessen Sprache und vergleicht sie mit der Liste erlaubter Sprachen.

Wenn der Kommentar in einer nicht erlaubten Sprache verfasst ist, wird eine lokalisierte Fehlermeldung angezeigt.

Das Kommentieren kann gesperrt werden, sodass durch Setzen des readonly-Flags auf true keine neuen Kommentare oder Stimmen abgegeben werden können.

Kommentare können dann außerdem nicht bearbeitet oder gelöscht werden.

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

Dies kann ohne Code auf der Seite zur Widget-Anpassung für eine gesamte Domain oder eine einzelne Seite angepasst werden:

Making The Comment Thread Readonly

Aktualisierung!

Seit November 2022 können Threads von Administratoren und Moderatoren über das Drei-Punkte-Menü oberhalb des Antwortbereichs in Echtzeit gesperrt oder entsperrt werden.

Dies verhindert neue Kommentare, erlaubt jedoch weiterhin Abstimmungen und ermöglicht es Benutzern, ihre Kommentare bei Bedarf zu löschen, während readonly diese Dinge nicht zulässt.

Dies entspricht dem Feld isClosed in der Page-API.

Standardmäßig erlaubt FastComments Links zu beliebigen externen Websites.

Dies kann eingeschränkt werden, sodass stattdessen eine gewünschte Liste von Websites oder Domains verwendet wird. Der Versuch, einen Link zu einer Website oder Domain, die nicht in der definierten Liste enthalten ist, führt dazu, dass dem Benutzer ein Fehler angezeigt wird.

Diese Validierung gilt nur für das Kommentar-Widget und die API. Importe sind nicht betroffen.

Dies wird ohne Code auf der Seite zur Anpassung des Widgets durchgeführt:

Restrict External Link Domains

Standardmäßig fragt FastComments den Benutzer nur nach seinem Kommentar, seinem Benutzernamen und seiner E-Mail-Adresse.

In einigen Situationen möchten Sie jedoch, dass der Benutzer einen Link zu seinem eigenen Blog oder seiner Website hinterlässt.

Wir können das Anzeigen eines zusätzlichen Eingabefeldes zur Angabe der Website-URL des Benutzers aktivieren, indem wir das Flag enableCommenterLinks auf true setzen:

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

Wenn diese URL angegeben wird, wird das Benutzerkonto des Nutzers aktualisiert und der Benutzername in allen bisherigen und zukünftigen Kommentaren mit dieser URL verlinkt.

Dies lässt sich ohne Code auf der Seite zur Anpassung des Widgets konfigurieren:

Enabling Commenter Links

Eine Liste von IDs, die von der Seite Moderationsgruppen generiert werden.

Wenn angegeben, enthalten Kommentare, die mit der angegebenen Konfiguration hinterlassen werden, denselben Satz von moderationGroupIds.

Wenn ein Moderator eine oder mehrere Moderationsgruppen definiert hat, werden sie nur Kommentare auf der Seite Moderate Comments sehen, die mit ihrer Gruppe(n) verknüpft sind.

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

Für die Authentifizierung ist FastComments darauf angewiesen, dass Cookies von Drittanbietern in Ihrem Browser aktiviert sind. Ohne diese müssen Nutzer immer ihre E-Mail-Adresse angeben, um zu kommentieren (es sei denn, das E-Mail-Eingabefeld ist ausgeblendet), und ihre Kommentare werden standardmäßig immer als nicht verifiziert angezeigt.

Um dies zu umgehen, können Sie die Umgehung für Cookies von Drittanbietern aktivieren.

Wenn diese Einstellung aktiviert ist, wird ein kleines Popup angezeigt, das eine Meldung anzeigt, dass der Nutzer angemeldet wird. Dieses Popup erscheint, sobald der Nutzer mit dem Kommentar-Widget interagiert; zum Beispiel, wenn er einen Kommentar abgibt.

Dies kann im Code erfolgen, indem die Flagge enableThirdPartyCookieBypass auf true gesetzt wird:

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

Alternativ können Sie dies auch über die Widget-Anpassungsoberfläche unter Enable Third-Party Cookie Popup einrichten:

Enabling Third-Party Cookie Bypass

Standardmäßig können Benutzer ihre eigenen Kommentare löschen. Außerdem löscht das Entfernen ihres Kommentars automatisch alle untergeordneten und transiente Kommentare im Thread. Dieses Verhalten gilt auch live.

Sie können dies auf folgende Weise einschränken:

• Stattdessen den gelöschten Kommentar anonymisieren (Name und Text auf [deleted] oder einen benutzerdefinierten Wert setzen).
• Das Löschen von Kommentaren nicht erlauben, wenn es Antworten gibt. Es wird eine anpassbare Fehlermeldung angezeigt.
• Das Löschen von Kommentaren mit Antworten nur auf Administratoren und Moderatoren beschränken.

Dies kann über den Abschnitt Comment Thread Deletion in der Benutzeroberfläche zur Widget-Anpassung konfiguriert werden.

Customize Delete Behavior for Replies

Standardmäßig zeigt FastComments Benutzerauszeichnungen nur an ihren Kommentaren innerhalb des Kommentar-Threads an.

Allerdings können wir Benutzerauszeichnungen neben ihrem Namen oberhalb des Kommentarfelds anzeigen, indem wir diese Funktion auf der Seite zur Anpassung des Widgets aktivieren:

Show Badges in Top Bar Option

Dadurch werden die Abzeichen des Benutzers neben seinem Namen im oberen Bereich angezeigt, wodurch seine Erfolge und sein Status beim Verfassen eines Kommentars stärker hervorgehoben werden.

Hinweis: Diese Funktion muss in der UI zur Anpassung des Widgets aktiviert sein, damit sie funktioniert. Optional können Sie das Flag showBadgesInTopBar in Ihrer Code-Konfiguration auf false setzen, um es selektiv zu deaktivieren, selbst wenn es auf Serverebene eingeschaltet ist:

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