Configura l'integrazione di Patreon con Discourse

[Discourse]

Questa guida spiega come configurare e predisporre l’integrazione di Patreon con il tuo forum Discourse, inclusa la sincronizzazione degli utenti, la gestione dei gruppi e il controllo degli accessi.

Livello utente richiesto: Amministratore

Richiede l’installazione del plugin Discourse Patreon

Riepilogo

Questa guida copre:

• Configurazione delle credenziali API di Patreon
• Configurazione del plugin Discourse Patreon
• Sincronizzazione degli utenti Patreon con i gruppi Discourse
• Gestione delle impostazioni dei gruppi Patron
• Configurazione degli webhook per gli aggiornamenti in tempo reale
• Limitazione dell’accesso al sito ai sostenitori di Patreon

Verranno sincronizzati nei gruppi Discourse solo i membri che hanno sottoscritto un livello di abbonamento a pagamento. Gli utenti gratuiti e gli utenti con la prova gratuita di 7 giorni non verranno sincronizzati.

Creazione delle credenziali Patreon

1. Vai alla pagina Clienti e chiavi API di Patreon
2. Fai clic su “Create Client” (Crea client)

3. Compila il modulo con questi dettagli:

• App Name (Nome app)
• Description (Descrizione)
• App Category (Categoria app)
• Author (Autore)
• Company Domain (Dominio aziendale): discourse.example.com
• Privacy Policy URL (URL Informativa sulla privacy): https://discourse.example.com/privacy
• Terms of Service URL (URL Termini di servizio): https://discourse.example.com/tos
• Redirect URIs (URI di reindirizzamento): https://discourse.example.com/auth/patreon/callback
• Client API Version (Versione API client): Impostare su 1

Il plugin utilizza attualmente endpoint API v1 internamente, pertanto la Versione API client deve essere impostata su 1. Impostandola su 2 si verificheranno errori di autenticazione poiché i client solo v2 non possono accedere agli endpoint v1. Si noti che Patreon ha annunciato che l’API v1 sarà deprecata in futuro.

4. Fai clic su “Create Client” (Crea client)
5. Salva le credenziali per il passaggio successivo

Configurazione del plugin Discourse

1. Vai al pannello Admin → Site Settings (Impostazioni sito)
2. Inserisci Patreon nella barra di ricerca.
3. Copia e incolla quanto segue dal tuo Client Patreon a Discourse:

• patreon client id
• patreon client secret
• patreon creator access token
• patreon creator refresh token

Impostazioni opzionali:

• Abilita i prompt di donazione spuntando patreon donation prompt enabled e impostando l’URL della tua campagna
• Abilita l’accesso con Patreon impostando il tuo patreon creator discourse username e spuntando patreon login enabled
• Spunta patreon enabled per attivare il plugin

Sincronizzazione dei dati Patreon

1. Visita https://discourse.example.com/admin/plugins/patreon
2. Fai clic su “Update Patreon Data & Sync Groups” (Aggiorna dati Patreon e sincronizza gruppi)

Una sincronizzazione riuscita visualizzerà un messaggio di conferma:

Collegamento dei livelli Patreon ai gruppi Discourse

1. Seleziona un gruppo Discourse dal menu a discesa Gruppo
2. Scegli un livello di ricompensa Patreon dal menu a discesa Rewards (Ricompense)
3. Fai clic sull’icona Salva

Dopo aver collegato i gruppi, fai clic nuovamente su “Update Patreon Data & Sync Groups” per sincronizzare gli utenti esistenti.

Personalizzazione del gruppo Patron

Il gruppo Patron predefinito include:

• Flair avatar
• Badge Patron

Per personalizzare questi elementi:

1. Visita la pagina del gruppo Patron
2. Fai clic sulla scheda “Manage” (Gestisci)
3. Regola le impostazioni di flair e descrizione del gruppo

Configurazione degli webhook (opzionale)

Per abilitare la sincronizzazione in tempo reale:

1. Visita Platform | Applications | Patreon
2. Crea un webhook che punti a https://discourse.example.com/patreon/webhook

3. Abilita questi trigger:

• Create Pledge (pledges:create o members:pledge:create)
• Update Pledge (pledges:update o members:pledge:update)
• Delete Pledge (pledges:delete o members:pledge:delete)

4. Copia il segreto webhook nelle tue impostazioni del sito patreon webhook secret

Limitazione dell’accesso al sito ai sostenitori Patreon

Per limitare l’accesso al sito agli utenti Patreon:

1. Assicurati che l’accesso con Patreon funzioni
2. Disabilita queste impostazioni:

• enable local logins (abilita accessi locali)
• enable local logins via email (abilita accessi locali tramite email)

Per limitare l’accesso solo ai tuoi sostenitori Patreon:

1. Configura le impostazioni di sicurezza delle categorie
2. Collega le categorie ai gruppi collegati a Patreon

Risoluzione dei problemi

Abilita la registrazione dettagliata attivando l’impostazione patreon verbose log. Accedi ai log su https://discourse.example.com/logs.

Risorse aggiuntive

• Discourse Patreon
• Understanding groups and category permissions (Comprensione dei gruppi e delle autorizzazioni di categoria)
• Patreon Clients & API Keys