Plugin di sottoscrizioni per Discourse

[Discourse]

	Riepilogo	Il plugin Discourse Subscriptions consente ai proprietari del sito di vendere abbonamenti ricorrenti e acquisti una tantum che garantiscono l’accesso a un gruppo su un’istanza di Discourse.
	Guida all’installazione	Questo plugin è integrato nel core di Discourse. Non è necessario installare il plugin separatamente.

Poiché si tratta di un plugin official mantenuto dal team di Discourse, le richieste di Support, Contribute > Bug, Contribute > UX e Contribute > Feature possono essere inviate nelle rispettive categorie qui su Meta, taggate con il tag appropriato del plugin. Clicca su un link qui sotto per iniziarne uno.

Supporto Bug UX Funzionalità

Il plugin Discourse Subscriptions ti consente di creare abbonamenti una tantum e ricorrenti che gli utenti possono acquistare per accedere a contenuti riservati. Questo può essere un ottimo modo per finanziare i costi di hosting della tua community.

Funzionalità

Il plugin Discourse Subscriptions supporta le seguenti funzionalità:

• Crea nuovi prodotti e piani dal pannello di amministrazione
• Annulla e rimborsa gli abbonamenti dal pannello di amministrazione
• Crea piani di acquisto una tantum o abbonamenti ricorrenti
• Aggiungi prove gratuite agli abbonamenti ricorrenti
• Supporto SCA/3D Secure
• Aggiungi/rimuovi utenti dai gruppi del piano quando si iscrivono/annullano
• Annulla l’abbonamento dal profilo utente
• Annullamento dell’abbonamento alla fine del periodo di abbonamento
• Supporto opzionale per Stripe Checkout
• Calcolo e raccolta automatica delle imposte sulle vendite
• Gli utenti possono aggiornare la loro carta per singoli abbonamenti

Il pulsante “Iscriviti” situato nella barra di navigazione in alto ti porterà alla pagina di iscrizione /s dove sono elencati gli abbonamenti che hai configurato per il tuo sito:

Una volta che un utente clicca su uno dei pulsanti “Iscriviti” per un piano specifico, si aprirà la pagina di pagamento per quel piano:

Dopo che un utente ha compilato i dettagli di pagamento e l’indirizzo e ha cliccato “Iscriviti”, viene visualizzato un messaggio “Grazie!” e viene reindirizzato alla sua pagina di fatturazione:

L’utente viene anche aggiunto automaticamente a un gruppo a tua scelta, in modo da poter vedere facilmente quali utenti si sono iscritti e fornire contenuti riservati in categorie visibili solo a quel gruppo.

Termini

• Abbonamento - Gli abbonamenti sono un piano di pagamento ricorrente che ti consente di controllare l’accesso ai contenuti della tua community. Quando un abbonamento viene creato o eliminato, un utente viene aggiunto o rimosso dal gruppo di utenti associato al tuo piano di abbonamento. Un abbonamento è composto da un prodotto e da piani.
• Prodotto - Nei termini di Stripe, un prodotto è ciò che stai vendendo. Un prodotto può contenere uno o più piani.
  • Per aggiungere una descrizione al tuo prodotto, aggiungi un campo metadata denominato “description” e utilizzalo invece. Puoi usare il Markdown.
• Piano - Un piano contiene un prezzo, un ciclo ricorrente e si associa a un gruppo a cui gli abbonati ottengono l’accesso.

Fai molta attenzione a mantenere le tue chiavi private di Stripe al sicuro e protette in ogni momento.

Se spegni la tua istanza di Discourse, disinstalli questo plugin o il tuo sito va offline, Stripe continuerà a fatturare i tuoi clienti per il tuo servizio fino all’annullamento dell’abbonamento.

Configurazione

1. Installa e abilita il plugin
2. Configura il Gateway di Pagamento (Stripe)
3. Configura Webhook ed Eventi in Stripe
4. Aggiungi le tue chiavi Stripe (pubblica, segreta, segreto webhook) sotto Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Crea un gruppo per gli abbonati da unirsi tramite l’acquisto
6. Crea un prodotto e un piano sotto Admin > Plugins > Subscriptions
7. Profitto!

Configura il tuo Gateway di Pagamento.

Innanzitutto, avrai bisogno di un account con il gateway di pagamento Stripe. Per iniziare, puoi configurare un account in modalità test e vedere come funziona tutto senza effettuare transazioni reali o dover configurare un conto bancario. Non c’è un interruttore per la modalità test nel plugin; invece, assicurati di utilizzare le tue chiavi di sviluppatore (iniziano con pk_test, sk_test)

Configura Webhook ed Eventi nel tuo account Stripe

I Webhook sono necessari per far funzionare completamente l’annullamento degli abbonamenti. Assicurati di averli configurati correttamente.

Una volta che hai un account su Stripe, dovrai dire a Stripe l’indirizzo del tuo sito web in modo che possa notificarti su determinate transazioni. Puoi inserirlo nel tuo dashboard di Stripe sotto Endpoints > URL.

Indirizzo Webhook: [tuo indirizzo server]/s/hooks – dove [tuo indirizzo server] è l’URL della tua installazione di Discourse.

Dovrai anche dire a Stripe quali eventi dovrebbe notificarti tramite l’URL del webhook.

Attualmente, Discourse Subscriptions risponde ai seguenti eventi:

• customer.subscription.deleted
• customer.subscription.updated
• checkout.session.completed

Aggiungi le chiavi API e Webhook di Stripe alle impostazioni del tuo plugin

Stripe deve essere autorizzato a comunicare con il tuo sito web. Per fare questo, pubblica una coppia di chiavi API private e pubbliche e un segno di crittografia per i tuoi webhook.

Per autorizzare i webhook, aggiungi le chiavi API e il segreto webhook da Stripe alla tua pagina delle impostazioni (sotto Sviluppatori).

L’aggiunta di chiavi di produzione renderà i pagamenti effettivi. Se prevedi di testare, assicurati di passare alla modalità View test data e ottenere le chiavi pk_test e sk_test sotto Sviluppatori.

Nelle impostazioni del tuo account Stripe, vedi:

• https://dashboard.stripe.com/apikeys
• https://dashboard.stripe.com/webhooks

Aggiungi queste chiavi sotto le impostazioni appropriate in Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Configura i tuoi Gruppi Utente in Discourse

Quando un utente si iscrive con successo alla tua applicazione Discourse, dopo che la transazione della carta di credito è stata elaborata, viene aggiunto a un Gruppo Utente. Assegnando utenti a un Gruppo Utente, puoi gestire a cosa hanno accesso i tuoi utenti sul tuo sito web. I gruppi utente sono una funzionalità principale di Discourse e questo plugin non fa nulla con loro se non aggiungere e rimuovere utenti dal gruppo che hai associato al tuo Piano.

Crea uno o più prodotti con piani.

Sotto Admin > Plugins > Subscriptions, clicca per aggiungere un nuovo Prodotto. Una volta salvato un prodotto, puoi aggiungere piani ad esso. Tieni presente che i prezzi e gli intervalli di fatturazione dei piani non possono essere modificati una volta creati. Questo è per evitare confusione nella gestione degli abbonamenti.

Se dai un’occhiata al tuo Dashboard Stripe, vedrai che tutti quei prodotti e piani sono elencati. Discourse Subscriptions non li crea localmente. Vengono creati in Stripe.

Testing

Testa con questi numeri di carta di credito:

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (nessuna autenticazione richiesta)
• 4000 0027 6000 3184 (autenticazione richiesta)

Per altri numeri di carta di test: Test card numbers | Stripe Documentation

Visita /s e inserisci alcune transazioni di test.

Passaggio alla Produzione

Una volta pronto per andare in produzione, cambia le tue chiavi API e segreto webhook in chiavi di produzione. Dovrai creare nuovi prodotti e piani in modalità live.

Tieni presente che se non configuri correttamente i webhook di Stripe e i pagamenti ricorrenti non vengono elaborati per qualsiasi motivo (carta di credito scaduta, ecc.), gli utenti avranno comunque accesso al gruppo. Per far sì che Stripe annulli automaticamente gli abbonamenti, assicurati di impostare le tue impostazioni Gestisci pagamenti falliti simili all’immagine sottostante e configura i webhook come descritto sopra.

Aggiornamento Info Pagamento

Gli utenti possono aggiornare la carta utilizzata per singoli abbonamenti visitando la pagina di fatturazione e cliccando il pulsante di modifica accanto all’abbonamento, il che aprirà questa schermata:

Stripe Checkout con Stripe Pricing Tables

Puoi anche optare per sostituire le pagine del prodotto e del checkout del Plugin di Abbonamento e invece utilizzare Stripe Checkout con Stripe Pricing Tables.

Nel tuo Dashboard Stripe:

1. Dopo aver creato i prodotti su Discourse, vai a Products > Product catalog
2. Clicca sul prodotto che desideri includere nella tabella dei prezzi
3. Clicca Edit product
4. More Options e inserisci quanto segue sotto Metadata:
   • Key: group_name
   • Value: Il nome del gruppo su Discourse (es. trust_level_0)
5. Clicca Update product per salvare

Assicurati che il nome del gruppo corrisponda al gruppo selezionato sotto User_Groups su Discourse

Crea la tua tabella dei prezzi Stripe

1. Vai a Products > Pricing tables
2. Crea una nuova tabella e aggiungi i prodotti che hai appena creato
3. Dopo aver pubblicato la tabella, copia l’ID della tabella dei prezzi trovato nel codice di incorporamento (inizia con prctbl_...)
4. Incolla l’ID della tabella dei prezzi nel tuo discourse_subscriptions_pricing_table_id e abilita l’impostazione della tabella dei prezzi degli abbonamenti.
5. Clicca sulle spunte verdi per salvare entrambe le impostazioni.

Passo consigliato:

Quando si configura la Pricing Table all’interno di Stripe, si consiglia di collegare l’utente al tuo sito dopo il completamento del checkout, altrimenti rimarranno su una pagina di conferma di Stripe senza un link di ritorno al tuo sito.

Il reindirizzamento a https://<your-site>/my/billing/subscriptions è una buona scelta per gli abbonamenti. Per i pagamenti una tantum potresti collegarti direttamente a https://<your-site>/my/billing/payments.

Raccolta Automatica delle Imposte

Per abilitare la Raccolta Automatica delle Imposte, controlla la casella dell’impostazione del sito discourse_subscriptions_enable_automatic_tax.

Se lo abiliti, ma non hai configurato correttamente la tua istanza Stripe per raccogliere le imposte, gli utenti potrebbero vedere questo popup dopo aver completato il processo di checkout:

C’è questa guida per maggiori informazioni, ma non dovrebbe esserci molto da fare poiché il plugin sta ora passando il parametro automatic_tax[enabled]=true appropriato (step 5).

Assicurati di configurare anche le tue registrazioni (step 4):

Ecco un esempio di transazione del plugin Discourse Subscription in Stripe che mostra che l’imposta è stata raccolta automaticamente:

Impostazioni

Nome	Descrizione
discourse subscriptions enabled	Abilita il plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Mostra il pulsante di iscrizione nella navigazione primaria
discourse subscriptions public key	Chiave Pubblicabile Stripe
discourse subscriptions secret key	Chiave Segreta Stripe
discourse subscriptions webhook secret	Segreto Webhook Stripe
discourse subscriptions currency	Codice Valuta Predefinito. Questo può essere sovrascritto quando si crea un piano di abbonamento.
discourse subscriptions campaign enabled	Abilita un banner di campagna per promuovere il supporto finanziario a questa community.
discourse subscriptions campaign goal	L’obiettivo numerico per la tua campagna di supporto (abbonati o importo raccolto).
discourse subscriptions campaign type	Seleziona il tipo di campagna da eseguire (abbonati o importo mensile raccolto).
discourse subscriptions campaign banner location	Seleziona la posizione del banner di campagna (in alto o nella barra laterale).
discourse subscriptions campaign banner bg image	Carica un’immagine personalizzata da usare come sfondo sul banner di campagna.
discourse subscriptions campaign banner shadow color	Seleziona il colore dell’ombra del banner di campagna.
discourse subscriptions campaign show contributors	Mostra le avatar degli acquisti più recenti di prodotti di abbonamento.
discourse subscriptions campaign product	L’ID prodotto Stripe da inviare ai sostenitori quando cliccano il pulsante sulla campagna. Se questa impostazione è vuota, i sostenitori verranno reindirizzati alla pagina principale dei prodotti.
discourse subscriptions campaign grant	Concede all’utente un mese gratuito di abbonamenti
discourse subscriptions pricing table id	L’ID della tabella dei prezzi Stripe dal codice di incorporamento
discourse subscriptions pricing table enabled	Abilita l’uso della tabella dei prezzi Stripe e sostituisce la pagina di iscrizione esistente
discourse_subscriptions_enable_automatic_tax	Attiva se l’imposta sulle vendite verrà raccolta. Richiede alcune impostazioni in Stripe.
discourse_subscriptions_enable_verbose_logging	Abilita un logging più verboso per aiutare nel debug. Per favore non lasciarlo abilitato permanentemente in produzione.

Ospitato da noi? Questo plugin è disponibile sui nostri piani di hosting Pro, Business ed Enterprise Subscriptions | Discourse - Civilized Discussion