Add Live Commenting to Drupal Sites
Início Rápido 
Esta é a versão 'muito longo; não li' das instruções do Drupal.
- Instale o módulo com
composer require drupal/fcom, ou coloque-o emmodules/custom/fastcomments/. - Ative-o com
drush en fastcomments, ou pela interface de administração em/admin/modules. - Vá para
Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments). - Insira seu Tenant ID e API Secret em Settings > API/SSO (EU).
- Adicione o campo
FastCommentsa qualquer tipo de conteúdo viaStructure > Content types > [type] > Manage fields.
O módulo está publicado em drupal.org/project/fcom.
Instalação
O módulo FastComments para Drupal substitui os comentários nativos do Drupal por um sistema de comentários em tempo real, rápido. O módulo está publicado no drupal.org e funciona com Drupal 10 e 11.
Existem duas maneiras de instalá-lo.
Instalar com Composer
composer require drupal/fcom
drush en fastcommentsInstalar manualmente
Faça o download do módulo em drupal.org/project/fcom e coloque-o no diretório modules/custom/fastcomments/ do seu site. Em seguida, habilite-o com drush en fastcomments, ou pela interface de administração em Extend (/admin/modules).
Observação! O módulo depende apenas do core do Drupal (user e field). Não são necessários outros módulos do Drupal ou bibliotecas.
Uma vez que o módulo for habilitado, vá para a seção Configuration para configurar seu Tenant ID e API Secret.
Configuração
Todas as configurações ficam em Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Obrigatório
- Tenant ID - Seu Tenant ID do FastComments. Encontre isto em Configurações > API/SSO (UE).
- API Secret - Necessário para SSO Seguro, verificação de webhooks e sincronização de páginas. Encontrado em Configurações > API/SSO (UE).
Estilo de Comentários
Escolha o widget que corresponde à forma como você quer que as pessoas conversem em seu site.
- Live Comments - Comentários encadeados em tempo real.
- Streaming Chat - Interface de chat ao vivo, ideal para eventos e transmissões ao vivo.
- Collab Chat - Anotação por seleção de texto na área principal do conteúdo. Os visitantes destacam texto e iniciam uma discussão no contexto.
- Collab Chat + Comments - Tanto collab chat quanto comentários padrão na mesma página.
Modo SSO
- Nenhum - Sem SSO. Usuários comentam como convidados ou criam uma conta FastComments.
- Simples - Transmite informações do usuário Drupal (name, email, avatar) para FastComments sem verificação do lado do servidor.
- Seguro - Usa HMAC-SHA256 para verificar usuários do Drupal com FastComments. Recomendado quando você tem um API Secret configurado.
Consulte a seção Single Sign-On (SSO) para detalhes.
Outras Configurações
- CDN URL - Padrão:
https://cdn.fastcomments.com. - Site URL - Padrão:
https://fastcomments.com. - Notificações por e-mail - Envia um e-mail ao autor do conteúdo quando um novo comentário é postado em seu conteúdo.
Para residência de dados na UE, consulte a seção EU Data Residency.
Blocos de Widget
O módulo fornece vários blocos que você pode colocar a partir de Structure > Block layout (/admin/structure/block).
- FastComments Widget - O widget principal de comentários. Detecta automaticamente a entidade atual. Ele ignorará entidades que já tenham o FastComments field anexado, então você não verá widgets duplicados na mesma página.
- FastComments Live Chat - Chat de 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. Os visitantes clicam em uma imagem para deixar comentários vinculados a locais específicos.
- FastComments Recent Comments - Exibe comentários recentes em todo o seu site. A contagem é configurável no bloco.
- FastComments Top Pages - Mostra as páginas do seu site 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 correspondem a uma entidade. Isso significa que eles funcionam em páginas de taxonomia, views e rotas personalizadas sem qualquer configuração adicional.
Campos do tipo de conteúdo
Para a maioria dos sites, a maneira mais fácil de adicionar comentários é anexar o campo FastComments aos seus tipos de conteúdo. Vá para Structure > Content types > [type] > Manage fields e adicione o campo.
Cada entidade que tiver o campo recebe:
- Um alternador de status para que os editores possam ativar ou desativar os comentários por entidade.
- Um identificador personalizado opcional para que você possa usar um ID estável que não está vinculado ao caminho da entidade do Drupal.
O bloco principal FastComments Widget reconhece esse campo e ignorará entidades que já o tenham anexado. Assim, você pode misturar comentários por entidade com o bloco sem ver o widget duas vezes na mesma página.
Login Único (SSO)
FastComments integra-se ao sistema de usuários do Drupal através de SSO, ou single-sign-on. Seus usuários fazem login no seu site Drupal, e o módulo transmite automaticamente sua identidade ao FastComments. Sem contas extras para criar, sem sincronização inicial para executar.
O módulo oferece três modos de SSO, configurados em Administration > Configuration > Content > FastComments.
Nenhum
Sem SSO. Os usuários comentam como convidados ou criam uma conta FastComments. Use isto se seu site for público e você não precisar vincular comentários a usuários do Drupal.
Simples
Envia o nome, e-mail e avatar do usuário do Drupal para o FastComments sem verificação no servidor. Não é necessário um API Secret. Bom para sites internos ou de baixo risco.
Seguro (recomendado)
Usa HMAC-SHA256 para verificar cada identidade de usuário com o FastComments. Este é o modo recomendado quando você tem um API Secret configurado, e é o único modo que evita que um visitante se passe por outro usuário.
A identidade do usuário é enviada ao FastComments cada vez que um usuário visualiza um tópico de comentários. Não há sincronização inicial ou contínua que precise ser executada.
(Optional) Adicione seus administradores a Users & Administrators e moderadores a Comment Moderators para melhorar a experiência deles e habilitar o rastreamento de estatísticas para moderadores.
Para uma visão mais detalhada de como o SSO funciona, veja a seção SSO da documentação de personalizações.
Permissões
O módulo adiciona três permissões do Drupal que você pode atribuir por função em People > Permissions.
- Administer FastComments - Acesso ao formulário de configurações do FastComments em
/admin/config/content/fastcomments. - View FastComments - Necessária para ver o widget de comentários. Sem essa permissão o widget não é renderizado.
- Toggle FastComments - Permite que usuários ativem ou desativem comentários por entidade usando o widget de campo.
Por padrão, somente usuários com a permissão administer site configuration podem alterar as configurações do FastComments. Conceda View FastComments a usuários anônimos e autenticados se você quiser que os visitantes vejam o widget.
Multilíngue
O módulo passa automaticamente o idioma atual do site Drupal para cada widget do FastComments. Se o seu site Drupal estiver configurado para múltiplos idiomas, a interface de comentários será exibida no idioma correspondente sem nenhuma configuração adicional.
Isso se aplica a todos os tipos de widget: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, e Top Pages.
Residência de Dados na UE
Se a sua conta FastComments estiver hospedada na UE, atualize duas configurações em Administration > Configuration > Content > FastComments:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
Você também deve obter seu Tenant ID e API Secret no painel da UE em eu.fastcomments.com/auth/my-account/api em vez do painel padrão dos EUA. Todo o restante do módulo funciona da mesma forma.
Personalização
O FastComments foi projetado para ser personalizado para se adequar ao seu site.
Se você deseja adicionar estilos personalizados ou ajustar a configuração, Consulte nossa Documentação de Personalização para saber como.
Requisitos
- Drupal 10 ou 11
- PHP 8.1 ou mais recente
- Uma conta FastComments
O módulo não requer nenhum outro módulo do Drupal ou bibliotecas de terceiros. Ele depende apenas do núcleo do Drupal (user, field).
Um fallback <noscript> fornece comentários renderizados no servidor para visitantes sem JavaScript, para que o Live Comments e o Streaming Chat ainda funcionem em navegadores com scripts desativados.