|||
| Resumen | Discourse Newsletter Integration añade servicios personalizables de suscripción a boletines informativos a tu instancia.
| Enlace al Repositorio | https://github.com/discourse/discourse-newsletter-integration
| Guía de Instalación | Cómo instalar plugins en Discourse
Características 
Los administradores pueden configurar un boletín global que se sincronizará con una lista de correo en el proveedor de boletines.
Los usuarios pueden suscribirse al boletín desde un banner del sitio
Una vez que se descarta el banner, no volverá a aparecer para el usuario.
Se añade una casilla de verificación a la página de preferencias del usuario (/my/preferences/emails), lo que permite a los usuarios cambiar su suscripción al boletín en cualquier momento.
Los suscriptores se añaden o eliminan de la lista de correo vinculada en el proveedor de boletines a través de su API cuando los usuarios se suscriben o cancelan la suscripción.
El plugin sincroniza el estado de suscripción entre Discourse y el proveedor de boletines.
Actualmente, el plugin soporta Mailchimp como proveedor de boletines y solo un boletín global para todos los usuarios. Se planea el soporte para proveedores adicionales y boletines limitados a grupos en futuras versiones.
Guía de Configuración 
Para habilitar el plugin, puedes usar el interruptor en tu página /admin/plugins, o marcando la configuración de administrador discourse newsletter integration enabled. También puedes acceder a la configuración del plugin desde esta página:
![]()
Personalizar texto en el Banner y la Configuración del Usuario
Los usuarios verán un banner sobre el boletín, que les permitirá suscribirse o descartarlo. Este banner se puede personalizar para adaptarse mejor a las necesidades de tu foro, y solo será visible si se configuran todos los ajustes relacionados con el plugin. Una vez descartado, el usuario no lo volverá a ver, pero podrá optar por suscribirse desde su página de preferencias.
Puedes personalizar el texto del banner de suscripción desde el panel de administración. Aquí están las etiquetas personalizables para el banner:
js.discourse_newsletter_integration.banner.headingjs.discourse_newsletter_integration.banner.descriptionjs.discourse_newsletter_integration.banner.subscribe
js.discourse_newsletter_integration.banner.manage_preferencesjs.discourse_newsletter_integration.banner.thank_youjs.discourse_newsletter_integration.banner.added_to_newsletter
También puedes personalizar el nombre de tu boletín en lo que cada usuario ve en su página de preferencias:
js.discourse_newsletter_integration.preferences.section_headjs.discourse_newsletter_integration.preferences.checkbox_description
Integración con Mailchimp
Hay tres configuraciones del sitio de Discourse relacionadas con la integración con Mailchimp:
| Nombre | Descripción |
|---|---|
| discourse newsletter integration mailchimp api key | Clave API para tu cuenta de Mailchimp. |
| discourse newsletter integration mailchimp list id | El ID de tu Audiencia de Mailchimp con la que deseas sincronizar Discourse. |
| discourse newsletter integration mailchimp server prefix | La parte del subdominio de la URL que ves cuando inicias sesión en tu cuenta de Mailchimp, por ejemplo, us14 y us19. |
discourse newsletter integration mailchimp api key
Para generar una clave API, sigue estos pasos:
- Navega a la sección API Keys de tu cuenta.
- Haz clic en Create New Key.
- Nombra tu clave.
- Haz clic en Generate Key.
- Haz clic en Copy Key to Clipboard. Guarda tu clave en un lugar seguro.
- Haz clic en Done.
Acerca de las claves API | Mailchimp
discourse newsletter integration mailchimp list id
Cada audiencia de Mailchimp tiene un ID de audiencia único (a veces llamado ID de lista) que las integraciones, plugins y widgets pueden requerir para conectarse y transferir datos de suscriptores. El ID de audiencia es generado por el sistema de Mailchimp cuando se crea la audiencia y no se puede cambiar.
Para encontrar tu ID de audiencia, sigue estos pasos:
- Navega a Audience
- Selecciona la Audiencia que deseas
- Haz clic en el menú desplegable Settings y elige Audience name and defaults.
- En la sección Audience ID, verás una cadena de letras y números. Este es tu ID de audiencia.
Encuentra tu ID de Audiencia | Mailchimp
discourse newsletter integration mailchimp server prefix
Inicia sesión en tu cuenta de Mailchimp y mira la URL en tu navegador. Verás algo como https://us19.admin.mailchimp.com/; la parte us19 es el prefijo del servidor. Ten en cuenta que tu valor específico puede ser diferente.
Problemas conocidos
Este plugin tiene funcionalidad básica y funciona bien, pero aquí hay algunos problemas conocidos que abordaremos en el futuro:
Cambio de cuentas de Mailchimp
Después de configurar la integración con Mailchimp y establecer audiencias para un boletín, si cambias a una nueva cuenta (a través de la configuración del sitio), las audiencias no se sincronizarán con la nueva cuenta.
¿Alojado por nosotros? Este plugin está disponible en nuestro plan Enterprise.





