Add Live Commenting to Drupal Sites
Inicio rápido 
Esta es la versión 'TL;DR' de las instrucciones de Drupal.
- Instala el módulo con
composer require drupal/fcom, o colócalo enmodules/custom/fastcomments/. - Actívalo con
drush en fastcomments, o desde la interfaz de administración en/admin/modules. - Ve a
Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments). - Introduce tu Tenant ID y API Secret desde Settings > API/SSO (EU).
- Añade el campo
FastCommentsa cualquier tipo de contenido a través deStructure > Content types > [type] > Manage fields.
El módulo está publicado en drupal.org/project/fcom.
Instalación
El módulo FastComments para Drupal reemplaza los comentarios integrados de Drupal por un sistema de comentarios en tiempo real y rápido. El módulo está publicado en drupal.org y es compatible con Drupal 10 y 11.
Hay dos formas de instalarlo.
Install with Composer
composer require drupal/fcom
drush en fastcommentsInstall manually
Descargue el módulo desde drupal.org/project/fcom y colóquelo en el directorio modules/custom/fastcomments/ de su sitio. Luego actívelo con drush en fastcomments, o desde la interfaz de administración en Extend (/admin/modules).
¡Nota! El módulo solo depende del núcleo de Drupal (user y field). No se requieren otros módulos o bibliotecas de Drupal.
Una vez habilitado el módulo, diríjase a la sección Configuration para configurar su Tenant ID y API Secret.
Configuración
All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Requerido
- Tenant ID - Su FastComments Tenant ID. Se encuentra en Settings > API/SSO (EU).
- API Secret - Requerido para Secure SSO, verificación de webhooks y sincronización de páginas. Se encuentra en Settings > API/SSO (EU).
Estilo de comentarios
Elija el widget que coincida con la forma en que desea que la gente converse en su sitio.
- Live Comments - Comentarios en hilo en tiempo real.
- Streaming Chat - Interfaz de chat en directo, ideal para eventos y transmisiones en vivo.
- Collab Chat - Anotación mediante selección de texto en el área de contenido principal. Los visitantes resaltan texto y comienzan una discusión en contexto.
- Collab Chat + Comments - Tanto collab chat como comentarios estándar en la misma página.
Modo SSO
- None - Sin SSO. Los usuarios comentan como invitados o crean una cuenta de FastComments.
- Simple - Pasa la información del usuario de Drupal (name, email, avatar) a FastComments sin verificación del lado del servidor.
- Secure - Utiliza HMAC-SHA256 para verificar usuarios de Drupal con FastComments. Recomendado cuando tenga configurado un API Secret.
Consulte la sección Single Sign-On (SSO) para más detalles.
Otras configuraciones
- CDN URL - Por defecto
https://cdn.fastcomments.com. - Site URL - Por defecto
https://fastcomments.com. - Email notifications - Enviar un correo electrónico al autor del contenido cuando se publique un nuevo comentario en su contenido.
Para la residencia de datos en la UE, consulte la sección EU Data Residency.
Bloques de widgets
El módulo incluye varios bloques que puedes colocar desde Structure > Block layout (/admin/structure/block).
- FastComments Widget - El widget principal de comentarios. Detecta automáticamente la entidad actual. Omitirá las entidades que ya tengan el campo FastComments adjunto, por lo que no verás widgets duplicados en la misma página.
- FastComments Live Chat - Chat de transmisión en tiempo real. Se puede colocar junto al campo de comentarios en la misma página.
- FastComments Collab Chat - Anotación y discusión por selección de texto.
- FastComments Image Chat - Anotación basada en coordenadas sobre imágenes. Los visitantes hacen clic en una imagen para dejar comentarios vinculados a ubicaciones específicas.
- FastComments Recent Comments - Muestra los comentarios recientes en todo tu sitio. El recuento es configurable en el bloque.
- FastComments Top Pages - Muestra las páginas de tu sitio con más comentarios.
Los bloques centrados en el contenido (Live Chat, Collab Chat, Image Chat) detectan automáticamente la entidad actual y, en páginas que no son de entidad, recurren a un identificador basado en la ruta. Esto significa que funcionan en páginas de taxonomía, vistas y rutas personalizadas sin configuración adicional.
Campos del tipo de contenido
Para la mayoría de los sitios, la forma más sencilla de añadir comentarios es adjuntar el campo FastComments a sus tipos de contenido. Vaya a Structure > Content types > [type] > Manage fields y añada el campo.
Cada entidad que tenga el campo obtiene:
- Un conmutador de estado para que los editores puedan activar o desactivar los comentarios por entidad.
- Un identificador personalizado opcional para que pueda usar un ID estable que no esté vinculado a la ruta de la entidad de Drupal.
El bloque principal FastComments Widget reconoce este campo y omitirá las entidades que ya lo tengan adjunto. De este modo, puede combinar comentarios por entidad con el bloque sin ver el widget dos veces en la misma página.
Inicio de sesión único (SSO)
FastComments se integra con el sistema de usuarios de Drupal mediante SSO, o inicio de sesión único. Tus usuarios inician sesión en tu sitio Drupal, y el módulo pasa su identidad a FastComments automáticamente. No hay cuentas adicionales que crear, ni sincronización inicial que ejecutar.
El módulo admite tres modos de SSO, configurables en Administration > Configuration > Content > FastComments.
Ninguno
Sin SSO. Los usuarios comentan como invitados o crean una cuenta de FastComments. Úsalo si tu sitio es público y no necesitas vincular los comentarios a los usuarios de Drupal.
Simple
Pasa el nombre, correo electrónico y avatar del usuario de Drupal a FastComments sin verificación del lado del servidor. No se necesita API Secret. Adecuado para sitios internos o de bajo riesgo.
Seguro (recomendado)
Utiliza HMAC-SHA256 para verificar cada identidad de usuario con FastComments. Este es el modo que debes usar cuando tienes un API Secret configurado, y es el único modo que evita que un visitante suplante a otro usuario.
La identidad del usuario se envía a FastComments cada vez que un usuario visualiza un hilo de comentarios. No hay ninguna sincronización inicial ni continua que deba ejecutarse.
(Opcional) Añade a tus administradores en Usuarios y Administradores y a los moderadores en Moderadores de comentarios para mejorar su experiencia y habilitar el seguimiento de estadísticas para moderadores.
Para entender más a fondo cómo funciona SSO, consulta la sección SSO de la documentación de personalización.
Permisos
El módulo añade tres permisos de Drupal que puede asignar por rol en People > Permissions.
- Administer FastComments - Acceso al formulario de configuración de FastComments en
/admin/config/content/fastcomments. - View FastComments - Requerido para ver el widget de comentarios. Sin este permiso, el widget no se renderiza.
- Toggle FastComments - Permite a los usuarios habilitar o deshabilitar los comentarios por entidad mediante el widget de campo.
Por defecto, solo los usuarios con el permiso administer site configuration pueden cambiar la configuración de FastComments. Conceda View FastComments a usuarios anónimos y autenticados si desea que los visitantes vean el widget.
Multilingüe
El módulo pasa automáticamente el idioma actual del sitio Drupal a cada widget de FastComments. Si su sitio Drupal está configurado para varios idiomas, la interfaz de comentarios se mostrará en el idioma correspondiente sin ninguna configuración adicional.
Esto se aplica a todos los tipos de widgets: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments y Top Pages.
Residencia de datos en la UE
Si su cuenta de FastComments está alojada en la UE, actualice dos ajustes en Administration > Configuration > Content > FastComments:
- URL del CDN -
https://cdn-eu.fastcomments.com - URL del sitio -
https://eu.fastcomments.com
También deberá obtener su Tenant ID y API Secret desde el panel de la UE en eu.fastcomments.com/auth/my-account/api en lugar del panel predeterminado de EE. UU. Todo lo demás en el módulo funciona igual.
Personalización
FastComments está diseñado para personalizarse y adaptarse a su sitio.
Si desea añadir estilos personalizados o ajustar la configuración, Consulte nuestra documentación de personalización para saber cómo.
Requisitos
- Drupal 10 o 11
- PHP 8.1 o superior
- Una cuenta de FastComments
El módulo no requiere ningún otro módulo de Drupal ni bibliotecas de terceros. Solo depende del núcleo de Drupal (user, field).
Un fallback <noscript> proporciona comentarios renderizados por el servidor para visitantes sin JavaScript, por lo que Live Comments y Streaming Chat siguen funcionando en navegadores con scripting desactivado.