FastComments.com
Menu Icon

Sprog 🇩🇰 Dansk
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

Kort fortalt

Hurtig start

Drupal-installation

Installation
Konfiguration
Widget-blokke
Felter for indholdstyper
Single Sign-On (SSO)
Tilladelser
Flersproget
EU-dataopbevaring
Tilpasning
Krav

Add Live Commenting to Drupal Sites

Hurtig start Internal Link

Dette er "for langt; gad ikke læse"-versionen af Drupal-instruktionerne.

  1. Installer modulet med composer require drupal/fcom, eller læg det i modules/custom/fastcomments/.
  2. Aktivér det med drush en fastcomments, eller fra admin-UI'en på /admin/modules.
  3. Gå til Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Indtast dit Tenant ID og API Secret fra Indstillinger > API/SSO (EU).
  5. Tilføj feltet FastComments til enhver indholdstype via Structure > Content types > [type] > Manage fields.

Modulet er udgivet på drupal.org/project/fcom.

Installation Internal Link

FastComments Drupal-modulet erstatter Drupals indbyggede kommentarer med et hurtigt kommentarsystem i realtid. Modulet er udgivet på drupal.org og fungerer med Drupal 10 og 11.

Der er to måder at installere det på.

Installér med Composer

composer require drupal/fcom
drush en fastcomments

Installer manuelt

Hent modulet fra drupal.org/project/fcom og placer det i din sites modules/custom/fastcomments/-mappe. Aktivér det derefter med drush en fastcomments, eller fra admin-UI'en under Extend (/admin/modules).

Bemærk! Modulet afhænger kun af Drupal-kernen (user og field). Der er ingen andre Drupal-moduler eller biblioteker påkrævet.

Når modulet er aktiveret, gå til Configuration-sektionen for at konfigurere din Tenant ID og API Secret.

Konfiguration Internal Link

Alle indstillinger findes under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Påkrævet

  • Tenant ID - Din FastComments Tenant ID. Find den under Settings > API/SSO (EU).
  • API Secret - Påkrævet for Secure SSO, webhook-verificering og side-synkronisering. Findes under Settings > API/SSO (EU).

Kommentarstil

Vælg den widget, der matcher, hvordan du ønsker, at folk skal kommunikere på dit site.

  • Live Comments - Trådede kommentarer i realtid.
  • Streaming Chat - Live chat-interface, godt til events og livestreams.
  • Collab Chat - Annotation ved tekstmarkering i hovedindholdsområdet. Besøgende fremhæver tekst og starter en diskussion i kontekst.
  • Collab Chat + Comments - Både collab chat og standardkommentarer på samme side.

SSO-tilstand

  • None - Ingen SSO. Brugere kommenterer som gæster eller opretter en FastComments-konto.
  • Simple - Sender Drupal-brugeroplysninger (navn, e-mail, avatar) til FastComments uden server-side verifikation.
  • Secure - Bruger HMAC-SHA256 til at verificere Drupal-brugere med FastComments. Anbefales, når du har konfigureret en API Secret.

Se afsnittet Single Sign-On (SSO) for detaljer.

Andre indstillinger

  • CDN URL - Som standard er https://cdn.fastcomments.com.
  • Site URL - Som standard er https://fastcomments.com.
  • Email notifications - Send en e-mail til indholdsforfatteren, når der postes en ny kommentar på deres indhold.

For EU-dataresidens, se afsnittet EU Data Residency.

Widget-blokke Internal Link

Modulet leveres med flere blokke, som du kan placere fra Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Den primære kommenterings-widget. Registrerer automatisk den aktuelle entitet. Den springer over entiteter, der allerede har FastComments-feltet vedhæftet, så du ikke får vist duplikerede widgets på samme side.
  • FastComments Live Chat - Realtime-streaming chat. Kan placeres sammen med kommentarfeltet på samme side.
  • FastComments Collab Chat - Annotering og diskussion baseret på tekstmarkering.
  • FastComments Image Chat - Koordinatbaseret annotering på billeder. Besøgende klikker på et billede for at efterlade kommentarer knyttet til specifikke positioner.
  • FastComments Recent Comments - Viser nylige kommentarer på dit websted. Antallet kan konfigureres i blokken.
  • FastComments Top Pages - Viser de sider på dit websted med flest kommentarer.

De indholdscentrerede blokke (Live Chat, Collab Chat, Image Chat) registrerer automatisk den aktuelle entitet og falder tilbage til en sti-baseret identifikator på sider uden en entitet. Det betyder, at de fungerer på taksonomisider, visninger og brugerdefinerede ruter uden yderligere konfiguration.

Felter for indholdstyper Internal Link

For de fleste websteder er den nemmeste måde at tilføje kommentarer at vedhæfte FastComments-feltet til dine indholdstyper. Gå til Structure > Content types > [type] > Manage fields og tilføj feltet.

Hver entitet, der har feltet, får:

  • En status-omskifter, så redaktører kan slå kommentarer til og fra for hver entitet.
  • En valgfri tilpasset identifikator, så du kan bruge et stabilt ID, der ikke er bundet til Drupal-entitetsstien.

Den primære FastComments Widget blok kender til dette felt, og vil springe entiteter over, som allerede har det vedhæftet. På den måde kan du blande kommentarer pr. entitet med blokken uden at se widget'en to gange på samme side.

Single Sign-On (SSO) Internal Link

FastComments integreres med Drupals brugersystem via SSO, eller single-sign-on. Dine brugere logger ind på dit Drupal-websted, og modulet videresender deres identitet til FastComments automatisk. Ingen ekstra konti at oprette, ingen indledende synkronisering der skal køres.

Modulet understøtter tre SSO-tilstande, indstilles under Administration > Configuration > Content > FastComments.

Ingen

Ingen SSO. Brugere kommenterer som gæster eller opretter en FastComments-konto. Brug dette, hvis dit websted er offentligt, og du ikke behøver at knytte kommentarer til Drupal-brugere.

Simpel

Videregiver Drupal-brugerens navn, e-mail og avatar til FastComments uden serverside-verifikation. Intet API Secret nødvendigt. Godt til interne eller lavrisiko-websteder.

Sikker (anbefalet)

Bruger HMAC-SHA256 til at verificere hver brugeridentitet med FastComments. Dette er den tilstand, du skal vælge, når du har konfigureret et API Secret, og det er den eneste tilstand, der forhindrer en besøgende i at udgive sig for en anden bruger.

Brugerens identitet videregives til FastComments hver gang en bruger ser en kommentartråd. Der er ingen indledende eller løbende synkronisering, der skal køre.

(Valgfrit) Tilføj dine administratorer til Brugere & Administratorer og moderatorer til Kommentar-moderatorer for at forbedre deres oplevelse og aktivere statistiksporing for moderatorer.

For en dybere gennemgang af, hvordan SSO fungerer, se SSO-afsnittet i tilpasningsdokumentationen.

Tilladelser Internal Link

Modulet tilføjer tre Drupal-tilladelser, som du kan tildele pr. rolle under People > Permissions.

  • Administer FastComments - Adgang til FastComments-indstillingsformularen på /admin/config/content/fastcomments.
  • View FastComments - Påkrævet for at se kommenteringswidgetten. Uden denne tilladelse gengives widget'en ikke.
  • Toggle FastComments - Giver brugere mulighed for at aktivere eller deaktivere kommentarer for hver enhed ved hjælp af feltets widget.

Som standard kan kun brugere med tilladelsen administer site configuration ændre FastComments-indstillingerne. Giv View FastComments til anonyme og autentificerede brugere, hvis du vil have, at besøgende skal kunne se widget'en.

Flersproget Internal Link

Modulet sender automatisk det aktuelle Drupal-websteds sprog til hver FastComments-widget. Hvis dit Drupal-websted er konfigureret til flere sprog, vil kommenteringsgrænsefladen blive vist på det tilsvarende sprog uden yderligere konfiguration.

Dette gælder for alle widgettyper: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, og Top Pages.

EU-dataopbevaring Internal Link

Hvis din FastComments-konto er hostet i EU, opdater to indstillinger under Administration > Configuration > Content > FastComments:

  • CDN URL - https://cdn-eu.fastcomments.com
  • Site URL - https://eu.fastcomments.com

Du bør også hente din Tenant ID og API Secret fra EU-dashboardet på eu.fastcomments.com/auth/my-account/api i stedet for standard US-dashboardet. Alt andet i modulet fungerer på samme måde.

Tilpasning Internal Link

FastComments er designet til at kunne tilpasses, så det passer til din hjemmeside.

Hvis du vil tilføje brugerdefineret styling eller justere konfigurationen, Se vores dokumentation om tilpasning og konfiguration for at lære hvordan.

Krav Internal Link

  • Drupal 10 eller 11
  • PHP 8.1 eller nyere
  • En konto hos FastComments

Modulet kræver ingen andre Drupal-moduler eller tredjepartsbiblioteker. Det afhænger kun af Drupal-kerne (user, field).

Et <noscript>-fallback leverer server-renderede kommentarer til besøgende uden JavaScript, så Live Comments og Streaming Chat stadig fungerer i browsere med scripting deaktiveret.

Bidrag til denne guide