Configurar integração Patreon com Discourse

[Discourse]

Este guia explica como configurar e personalizar a integração do Patreon com seu fórum Discourse, incluindo sincronização de usuários, gerenciamento de grupos e controle de acesso.

Nível de usuário necessário: Administrador

Requer que o plugin Discourse Patreon esteja instalado

Sumário

Este guia cobre:

• Configuração das credenciais da API do Patreon
• Configuração do plugin Discourse Patreon
• Sincronização de usuários do Patreon com grupos do Discourse
• Gerenciamento das configurações dos grupos de Patronos
• Configuração de webhooks para atualizações em tempo real
• Restrição de acesso ao site apenas para apoiadores do Patreon

Apenas membros que apoiam com uma assinatura de nível serão sincronizados com os grupos do Discourse. Usuários gratuitos e usuários em teste gratuito de 7 dias não serão sincronizados.

Criação de credenciais do Patreon

1. Vá para a página de Clientes e Chaves de API do Patreon
2. Clique em “Create Client” (Criar Cliente)

3. Preencha o formulário com estes detalhes:

• App Name (Nome do Aplicativo)
• Description (Descrição)
• App Category (Categoria do Aplicativo)
• Author (Autor)
• Company Domain (Domínio da Empresa): discourse.example.com
• Privacy Policy URL (URL da Política de Privacidade): https://discourse.example.com/privacy
• Terms of Service URL (URL dos Termos de Serviço): https://discourse.example.com/tos
• Redirect URIs (URIs de Redirecionamento): https://discourse.example.com/auth/patreon/callback
• Client API Version (Versão da API do Cliente): Defina como 1

O plugin atualmente usa endpoints da API v1 do Patreon internamente, portanto, a Versão da API do Cliente deve ser definida como 1. Definir como 2 causará erros de autenticação, pois clientes somente v2 não podem acessar endpoints v1. Observe que o Patreon anunciou que a API v1 será descontinuada no futuro.

4. Clique em “Create Client” (Criar Cliente)
5. Salve suas credenciais para a próxima etapa

Configurando o plugin Discourse

1. Navegue até seu painel Administrador → Configurações do Site
2. Digite Patreon na barra de pesquisa.
3. Copie e cole o seguinte do seu Cliente Patreon para o Discourse:

• patreon client id (ID do cliente patreon)
• patreon client secret (Segredo do cliente patreon)
• patreon creator access token (Token de acesso do criador patreon)
• patreon creator refresh token (Token de atualização do criador patreon)

Configurações opcionais:

• Habilite os prompts de doação marcando patreon donation prompt enabled (prompt de doação patreon habilitado) e definindo sua URL da campanha
• Habilite o login pelo Patreon definindo seu patreon creator discourse username (nome de usuário do criador patreon no discourse) e marcando patreon login enabled (login patreon habilitado)
• Marque patreon enabled (patreon habilitado) para ativar o plugin

Sincronizando dados do Patreon

1. Visite https://discourse.example.com/admin/plugins/patreon
2. Clique em “Update Patreon Data & Sync Groups” (Atualizar Dados do Patreon e Sincronizar Grupos)

Uma sincronização bem-sucedida exibirá uma mensagem de confirmação:

Vinculando níveis do Patreon a grupos do Discourse

1. Selecione um grupo do Discourse no menu suspenso Group (Grupo)
2. Escolha um nível de recompensa do Patreon no menu suspenso Rewards (Recompensas)
3. Clique no ícone Salvar

Após vincular os grupos, clique em “Update Patreon Data & Sync Groups” (Atualizar Dados do Patreon e Sincronizar Grupos) novamente para sincronizar os usuários existentes.

Personalização do grupo de Patronos

O grupo padrão de Patronos inclui:

• Flair de avatar
• Selo de Patrono

Para personalizar estes:

1. Visite a página do grupo Patrono
2. Clique na aba “Manage” (Gerenciar)
3. Ajuste as configurações de flair e descrição do grupo

Configurando webhooks (opcional)

Para habilitar a sincronização em tempo real:

1. Visite Platform | Applications | Patreon
2. Crie um webhook apontando para https://discourse.example.com/patreon/webhook

3. Habilite estes gatilhos:

• Criar Assinatura (pledges:create ou members:pledge:create)
• Atualizar Assinatura (pledges:update ou members:pledge:update)
• Excluir Assinatura (pledges:delete ou members:pledge:delete)

4. Copie o segredo do webhook para sua configuração de site patreon webhook secret (segredo do webhook patreon)

Restringindo o acesso ao site a apoiadores do Patreon

Para limitar o acesso ao site a usuários do Patreon:

1. Certifique-se de que o login do Patreon esteja funcionando
2. Desabilite estas configurações:

• enable local logins (habilitar logins locais)
• enable local logins via email (habilitar logins locais por e-mail)

Para restringir o acesso apenas aos seus apoiadores do Patreon:

1. Configure as configurações de segurança de categoria
2. Vincule categorias aos grupos conectados ao Patreon

Solução de problemas

Habilite o registro detalhado ativando a configuração patreon verbose log (registro detalhado patreon). Acesse os logs em https://discourse.example.com/logs.

Recursos adicionais

• Discourse Patreon
• Entendendo grupos e permissões de categoria
• Clientes e Chaves de API do Patreon