Disqus
Integra el sistema de comentarios de terceros Disqus para reemplazar o mejorar los comentarios nativos de Drupal con una plataforma de discusión potente y rica en funciones.
disqus
Instalar
composer require 'drupal/disqus:^2.0'
Overview
El módulo Disqus proporciona una integración perfecta con la plataforma de comentarios Disqus, permitiendo a los administradores del sitio reemplazar el sistema de comentarios nativo de Drupal con las robustas funciones de discusión de Disqus. Disqus ofrece comentarios en tiempo real, integración con redes sociales, herramientas de moderación y filtrado de spam, todo gestionado a través de la interfaz web de Disqus.
El módulo implementa una arquitectura basada en campos, permitiendo habilitar los comentarios de Disqus en cualquier tipo de entidad con campos (nodes, usuarios, entidades personalizadas). Esto proporciona un control granular sobre qué tipos de contenido soportan comentarios de Disqus. Además, el módulo proporciona múltiples bloques de visualización para mostrar la participación de la comunidad, incluyendo widgets de comentarios recientes, hilos populares y principales comentaristas.
Las funciones avanzadas incluyen integración de Single Sign-On (SSO) para una autenticación fluida entre Drupal y Disqus, seguimiento de eventos de Google Analytics para nuevos comentarios, notificaciones por correo electrónico a los autores de contenido cuando se publican nuevos comentarios, e integración completa de API para sincronizar actualizaciones y eliminaciones de hilos entre Drupal y Disqus. El módulo también soporta migración desde instalaciones de Drupal 7 y migración bidireccional de comentarios entre Drupal y Disqus.
Features
- Comentarios de Disqus basados en campos que pueden añadirse a cualquier tipo de entidad de contenido (nodes, usuarios, entidades personalizadas)
- Incrustación de comentarios en tiempo real con carga basada en JavaScript para un rendimiento óptimo
- Integración de Single Sign-On (SSO) que permite a los usuarios comentar con sus credenciales de Drupal en Disqus
- Cuatro bloques configurables: Widget Combinado, Hilos Populares, Comentarios Recientes y Principales Comentaristas
- Integración con Views que proporciona un manejador de campo de Contador de Comentarios de Disqus para mostrar conteos de comentarios en Views
- Seguimiento de eventos de Google Analytics para nuevos comentarios (requiere el módulo Google Analytics)
- Notificaciones por correo electrónico a los autores de contenido cuando se publican nuevos comentarios en su contenido
- Integración de API para actualizar automáticamente los hilos de Disqus cuando cambian los títulos o URLs de las entidades
- Cierre o eliminación configurable de hilos cuando se eliminan entidades
- Soporte completo de migración desde configuraciones de Disqus de Drupal 7 e instancias de campos
- Capacidad de importación de comentarios desde Disqus a Drupal usando la API de Migrate
- Capacidad de exportación de comentarios desde Drupal a Disqus usando la API de Migrate
- Soporte de localización para anular el idioma de Disqus con el idioma actual del sitio
- Herencia de credenciales de usuario para prellenar el formulario de invitado de Disqus con la información del usuario conectado
- Callbacks de JavaScript personalizables para extender el comportamiento de Disqus
- Alternativa noscript para usuarios con JavaScript deshabilitado
Use Cases
Reemplazar comentarios nativos con Disqus
Los administradores de sitios que buscan reemplazar el sistema de comentarios nativo de Drupal pueden añadir un campo de comentario de Disqus a sus tipos de contenido. Esto proporciona filtrado de spam, opciones de inicio de sesión social, comentarios en tiempo real y moderación centralizada a través de la interfaz web de Disqus, sin gestionar la infraestructura de comentarios en el servidor de Drupal.
Mostrar widgets de participación en la barra lateral
Usa los bloques de Disqus para mostrar la actividad de la comunidad en las regiones de barra lateral o pie de página de tu sitio. El bloque 'Comentarios recientes' muestra las últimas discusiones, 'Hilos populares' destaca el contenido en tendencia, y 'Principales comentaristas' reconoce a los miembros activos de la comunidad, todo fomentando la participación de los visitantes.
Autenticación unificada con SSO
Las organizaciones que requieren que los usuarios usen sus credenciales de Drupal para comentar pueden habilitar Single Sign-On. Los usuarios que hacen clic en 'Iniciar sesión' en Disqus son redirigidos al formulario de inicio de sesión de Drupal, y tras la autenticación, pueden comentar inmediatamente sin crear una cuenta separada de Disqus.
Rastrear participación de comentarios en Analytics
Los equipos de marketing que quieren entender la participación de los usuarios pueden habilitar el seguimiento de Google Analytics. Cada nuevo comentario activa un evento 'Disqus/Comment' en GA, permitiendo analizar qué contenido genera más discusión y los patrones de interacción de los usuarios.
Migrar desde una instalación de Disqus en Drupal 7
Los sitios que actualizan desde Drupal 7 pueden usar las rutas de migración incluidas para transferir automáticamente configuraciones de Disqus, configuraciones de campos y ajustes de visualización de entidades a Drupal 9/10/11, manteniendo la continuidad de su sistema de comentarios.
Importar comentarios existentes de Disqus a Drupal
Los sitios que transicionan fuera de Disqus pueden usar la migración de importación de comentarios para obtener todos los comentarios de Disqus y crearlos como comentarios nativos de Drupal, preservando el historial de discusiones en la base de datos de Drupal.
Notificaciones de autor para nuevos comentarios
Los creadores de contenido que quieren mantenerse informados sobre las discusiones en sus artículos pueden beneficiarse de la función de notificación por correo electrónico. Cuando está habilitada, los autores reciben un correo electrónico cada vez que alguien comenta en su contenido, permitiendo respuestas oportunas y participación comunitaria.
Tips
- Añade el campo de Disqus a los tipos de contenido antes de crear contenido para asegurar una inicialización correcta del hilo.
- Usa identificadores de hilo personalizados cuando migres contenido entre entornos para mantener la continuidad de los comentarios.
- Coloca los bloques de Disqus estratégicamente para fomentar la participación sin sobrecargar el diseño de la página.
- Configura SSO temprano si planeas usarlo; cambiarlo después puede causar desajustes en las cuentas de usuario.
- Prueba tu integración de Disqus en un entorno de desarrollo antes de desplegar a producción.
- Considera habilitar el soporte de localización para sitios multilingües para mejorar la experiencia del usuario.
- Usa la integración con Views para mostrar conteos de comentarios en listados de contenido y fomentar la discusión.
Technical Details
Admin Pages 1
/admin/config/services/disqus
Configura los ajustes de integración de Disqus incluyendo tu shortname, opciones de comportamiento, credenciales de API y configuración de Single Sign-On.
Permisos 4
Hooks 1
hook_disqus_user_data_alter
Modifica los datos de usuario preparados para usar con Single Sign-On de Disqus. Permite a los módulos personalizar la información de usuario enviada a Disqus.
Troubleshooting 6
Verifica que el shortname de Disqus esté correctamente configurado en /admin/config/services/disqus. Comprueba que el usuario tenga el permiso 'view disqus comments'. Asegúrate de que JavaScript esté habilitado en el navegador y que ningún bloqueador de anuncios esté interfiriendo con los scripts de disqus.com.
Los conteos de comentarios requieren que el JavaScript de Disqus se cargue correctamente. La visualización del conteo también depende de usar el identificador de hilo correcto. Verifica que tu shortname sea correcto y revisa la consola del navegador para errores de JavaScript.
Asegúrate de que los bindings de la API PHP de Disqus estén instalados via Composer. Verifica que tus claves de API (clave pública, clave secreta, token de acceso de usuario) estén correctamente introducidas. Comprueba que tu aplicación de Disqus tenga los permisos requeridos en disqus.com/api/applications/.
SSO requiere que tanto la clave pública como la clave secreta estén configuradas. Asegúrate de que 'Usar Single Sign-On' esté habilitado en los ajustes avanzados. El usuario debe tener permiso para iniciar sesión en Drupal. Comprueba que la configuración de SSO en los ajustes de tu aplicación de Disqus coincida con tu sitio.
Habilita 'Actualizar hilos' en la sección de ajustes de API. Esto requiere que la clase DisqusAPI esté disponible y un token de acceso de usuario válido. Revisa los registros de Drupal para mensajes de error de API.
Esta función requiere una clave secreta válida para acceso a la API. Habilita 'Notificar a los autores de nuevos comentarios' en los ajustes de comportamiento. La entidad de contenido debe implementar EntityOwnerInterface. Revisa la configuración del sistema de correo de Drupal y los registros.
Security Notes 5
- Las claves de API (especialmente la clave secreta y el token de acceso de usuario) deben mantenerse confidenciales. Nunca las expongas en código del lado del cliente o control de versiones.
- El endpoint de notificación de nuevos comentarios incluye protección contra inundación para prevenir abuso, pero considera limitación de velocidad adicional para sitios de alto tráfico.
- La autenticación SSO usa firma HMAC-SHA1 para verificar las credenciales de usuario entre Drupal y Disqus.
- El módulo respeta el sistema de permisos de Drupal; asegúrate de que 'view disqus comments' solo se otorgue a roles apropiados.
- Cuando uses la migración de importación de comentarios, valida que los comentarios se originen de tu foro legítimo de Disqus.