Configurar la integración de Patreon con Discourse

[Discourse]

Esta guía explica cómo configurar y adaptar la integración de Patreon con su foro de Discourse, incluyendo la sincronización de usuarios, la gestión de grupos y el control de acceso.

Nivel de usuario requerido: Administrador

Requiere que el plugin de Discourse Patreon esté instalado

Resumen

Esta guía cubre:

• Configuración de las credenciales de la API de Patreon
• Configuración del plugin de Discourse Patreon
• Sincronización de usuarios de Patreon con grupos de Discourse
• Gestión de la configuración de grupos de Patrocinadores
• Configuración de webhooks para actualizaciones en tiempo real
• Restricción del acceso al sitio solo para los patrocinadores de Patreon

Solo se sincronizarán con los grupos de Discourse los miembros que hayan pagado una membresía de nivel. Los usuarios gratuitos y los usuarios con prueba gratuita de 7 días no se sincronizarán.

Creación de credenciales de Patreon

1. Vaya a la página de Clientes y claves de API de Patreon
2. Haga clic en “Crear Cliente”

3. Rellene el formulario con estos detalles:

• Nombre de la aplicación (App Name)
• Descripción (Description)
• Categoría de la aplicación (App Category)
• Autor (Author)
• Dominio de la empresa (Company Domain): discourse.example.com
• URL de la política de privacidad (Privacy Policy URL): https://discourse.example.com/privacy
• URL de los términos de servicio (Terms of Service URL): https://discourse.example.com/tos
• URI de redirección (Redirect URIs): https://discourse.example.com/auth/patreon/callback
• Versión de la API del cliente (Client API Version): Establecer en 1

El plugin utiliza actualmente endpoints de la API v1 de Patreon internamente, por lo que la Versión de la API del Cliente debe establecerse en 1. Si se establece en 2, se producirán errores de autenticación porque los clientes solo v2 no pueden acceder a los endpoints v1. Tenga en cuenta que Patreon ha anunciado que la API v1 será descontinuada en el futuro.

4. Haga clic en “Crear Cliente”
5. Guarde sus credenciales para el siguiente paso

Configuración del plugin de Discourse

1. Navegue a su panel de Administrador → Configuración del sitio
2. Escriba Patreon en la barra de búsqueda.
3. Copie y pegue lo siguiente desde su Cliente de Patreon a Discourse:

• patreon client id (ID de cliente de Patreon)
• patreon client secret (Secreto de cliente de Patreon)
• patreon creator access token (Token de acceso del creador de Patreon)
• patreon creator refresh token (Token de actualización del creador de Patreon)

Configuraciones opcionales:

• Habilite las indicaciones de donación marcando patreon donation prompt enabled (indicación de donación de Patreon habilitada) y configurando su URL de campaña
• Habilite el inicio de sesión de Patreon configurando su patreon creator discourse username (nombre de usuario de Discourse del creador de Patreon) y marcando patreon login enabled (inicio de sesión de Patreon habilitado)
• Marque patreon enabled (Patreon habilitado) para activar el plugin

Sincronización de datos de Patreon

1. Visite https://discourse.example.com/admin/plugins/patreon
2. Haga clic en “Actualizar Datos de Patreon y Sincronizar Grupos”

Una sincronización exitosa mostrará un mensaje de confirmación:

Vinculación de niveles de Patreon a grupos de Discourse

1. Seleccione un grupo de Discourse del menú desplegable Grupo
2. Elija un nivel de recompensa de Patreon del menú desplegable Recompensas
3. Haga clic en el icono Guardar

Después de vincular los grupos, haga clic en “Actualizar Datos de Patreon y Sincronizar Grupos” de nuevo para sincronizar los usuarios existentes.

Personalización del grupo de Patrocinadores

El grupo de Patrocinadores predeterminado incluye:

• Etiqueta de avatar (Avatar flair)
• Insignia de Patrocinador (Patron badge)

Para personalizar estos:

1. Visite la página del grupo de Patrocinadores
2. Haga clic en la pestaña “Administrar” (Manage)
3. Ajuste la configuración de la etiqueta y la descripción del grupo

Configuración de webhooks (opcional)

Para habilitar la sincronización en tiempo real:

1. Visite Plataforma | Aplicaciones | Patreon
2. Cree un webhook apuntando a https://discourse.example.com/patreon/webhook

3. Habilite estos desencadenadores:

• Crear compromiso (Create Pledge) (pledges:create o members:pledge:create)
• Actualizar compromiso (Update Pledge) (pledges:update o members:pledge:update)
• Eliminar compromiso (Delete Pledge) (pledges:delete o members:pledge:delete)

4. Copie el secreto del webhook en su configuración del sitio patreon webhook secret (secreto del webhook de Patreon)

Restricción del acceso al sitio a los patrocinadores de Patreon

Para limitar el acceso al sitio a los usuarios de Patreon:

1. Asegúrese de que el inicio de sesión de Patreon esté funcionando
2. Deshabilite estas configuraciones:

• enable local logins (habilitar inicios de sesión locales)
• enable local logins via email (habilitar inicios de sesión locales por correo electrónico)

Para restringir el acceso solo a sus patrocinadores de Patreon:

1. Configure los ajustes de seguridad de las categorías
2. Vincule categorías a los grupos conectados a Patreon

Solución de problemas

Habilite el registro detallado activando la configuración patreon verbose log (registro detallado de Patreon). Acceda a los registros en https://discourse.example.com/logs.

Recursos adicionales

• Discourse Patreon
• Comprensión de grupos y permisos de categorías
• Clientes y claves de API de Patreon