FastComments.com
Menu Icon

Idioma 🇧🇷 Português (Brasil)
🇺🇸 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

Primeiros passos

Instalação

Configuração

Configuração

Documentação

Blocos de Widget
Multilíngue
Permissões
Como funciona
Requisitos

Add Comments to Your Drupal Site

Este é o módulo oficial do Drupal para o FastComments.

Um módulo do Drupal que integra o FastComments com o Drupal 10/11, fornecendo blocos de widget, integração com campos de entidade, SSO e permissões granulares.

Repositório

Ver no GitHub

Instalação Internal Link

  1. Coloque este módulo no diretório modules/custom/fastcomments/ do seu site Drupal (ou instale via Composer: composer require drupal/fcom).
  2. Ative o módulo:
    drush en fastcomments
    Ou ative via a interface de administração em Extend (/admin/modules).

Configuração Internal Link

Navegue até Administração > Configuração > Conteúdo > FastComments (/admin/config/content/fastcomments).

Configurações

  • Tenant ID (obrigatório) - Seu Tenant ID do FastComments. Encontre isso em Settings > API/SSO (UE).
  • API Secret - Necessário para SSO Seguro, verificação de webhooks e sincronização de páginas. Encontrado em Settings > API/SSO (UE).
  • Modo SSO - Integração de Single Sign-On:
    • None - Sem SSO, os usuários comentam como convidados ou criam contas FastComments.
    • Simple - Envia informações do usuário do Drupal (nome, email, avatar) para o FastComments sem verificação no servidor.
    • Secure - Usa verificação HMAC-SHA256 para autenticar com segurança usuários do Drupal no FastComments (recomendado).
  • Estilo de Comentário - O tipo de widget a ser exibido:
    • Live Comments - Comentários encadeados em tempo real.
    • Streaming Chat - Interface de chat ao vivo.
    • Collab Chat - Anotação colaborativa por seleção de texto na área principal de conteúdo.
    • Collab Chat + Comments - Tanto collab chat quanto comentários padrão.
  • CDN URL - URL do CDN do FastComments (padrão: https://cdn.fastcomments.com).
  • Site URL - URL do site do FastComments (padrão: https://fastcomments.com).
  • Notificações por email - Enviar um email aos autores do conteúdo quando um novo comentário for postado em seu conteúdo.

Adicionando Comentários a Tipos de Conteúdo

Adicione o campo FastComments aos seus tipos de conteúdo via Estrutura > Tipos de conteúdo > [type] > Gerenciar campos. O campo tem um controle de status e um identificador personalizado opcional por entidade.

Residência de Dados na UE

Para residência de dados na UE, atualize:

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

Blocos de Widget Internal Link

Vários blocos estão disponíveis em Structure > Block layout (/admin/structure/block):

  • FastComments Widget - O principal widget de comentários. Detecta automaticamente a entidade atual. Ignora entidades que já possuem o campo FastComments (para evitar duplicatas).
  • FastComments Live Chat - Chat em streaming em tempo real. Pode ser colocado ao lado do campo de comentários na mesma página.
  • FastComments Collab Chat - Anotação e discussão por seleção de texto.
  • FastComments Image Chat - Anotação baseada em coordenadas em imagens.
  • FastComments Recent Comments - Exibe comentários recentes em todo o seu site. Contagem de comentários configurável.
  • FastComments Top Pages - Mostra as páginas com mais comentários.

Os blocos centrados em conteúdo (Live Chat, Collab Chat, Image Chat) detectam automaticamente a entidade atual e recorrem a um identificador baseado em caminho em páginas que não são entidades.

Multilíngue Internal Link

O módulo passa automaticamente o idioma atual do site Drupal para todos os widgets.

Permissões Internal Link

  • Administrar FastComments - Acesso ao formulário de configurações do FastComments.
  • Visualizar FastComments - Necessário para ver o widget de comentários.
  • Alternar FastComments - Permite que usuários ativem/desativem comentários por entidade através do widget de campo.

Como funciona Internal Link

Quando um usuário visita uma entidade com o campo FastComments habilitado:

  1. O widget JavaScript do FastComments é carregado a partir do CDN.
  2. Se o SSO estiver configurado, a identidade Drupal do usuário é passada para o FastComments.
  3. Um fallback <noscript> fornece comentários renderizados no servidor para usuários sem JavaScript (apenas nos modos Live Comments e Streaming Chat).

Requisitos Internal Link

Precisa de ajuda?

Se você encontrar algum problema ou tiver dúvidas sobre o módulo do Drupal, por favor:

Contribuindo

Contribuições são bem-vindas! Por favor, visite o repositório no GitHub para as diretrizes de contribuição.

Contribuir para este guia