Plugin per le sottoscrizioni Discourse

[Discourse]

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

Poiché si tratta di un plugin #ufficiale mantenuto dal team di Discourse, le richieste di #supporto, segnalazioni di bug, problemi di ux e nuove #funzionalità possono essere inviate nelle rispettive categorie su Meta, etichettando con il tag del plugin appropriato. Clicca su uno dei link qui sotto per aprirne uno.

Supporto Bug UX Funzionalità

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

Funzionalità

Il plugin Discourse Subscriptions supporta le seguenti funzionalità:

• Creare nuovi prodotti e piani dal pannello di amministrazione
• Annullare e rimborsare abbonamenti dal pannello di amministrazione
• Creare piani di acquisto una tantum o abbonamenti ricorrenti
• Aggiungere prove gratuite agli abbonamenti ricorrenti
• Supporto SCA/3D Secure
• Aggiungere/rimuovere utenti dai gruppi dei piani quando si abbonano/annullano
• Annullare l’abbonamento dal profilo utente
• Annullamento dell’abbonamento alla fine del periodo di abbonamento
• Supporto opzionale per Stripe Checkout
• Calcolo e riscossione automatica delle tasse sulle vendite
• Gli utenti possono aggiornare la propria carta per singoli abbonamenti

Il pulsante “Iscriviti” situato nella barra di navigazione superiore ti porterà alla pagina Iscriviti /s, dove vengono elencati gli abbonamenti configurati per il tuo sito:

Una volta che un utente clicca sul pulsante “Iscriviti” per un piano specifico, si aprirà la pagina di pagamento per quel piano:

Dopo che un utente ha compilato i propri dati di pagamento e l’indirizzo e ha cliccato su “Iscriviti”, gli viene mostrata 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 facilmente vedere quali utenti si sono abbonati e fornire contenuti protetti nelle categorie visibili solo a quel gruppo.

Termini

• Abbonamento - Gli abbonamenti sono piani di pagamento ricorrenti che ti consentono di controllare l’accesso ai contenuti sulla tua community. Quando un abbonamento viene creato o eliminato, un utente viene aggiunto o rimosso dal gruppo utenti associato al tuo piano di abbonamento. Un abbonamento è composto da un prodotto e da piani.
• Prodotto - Un prodotto, secondo i termini di Stripe, è ciò che stai vendendo. Un prodotto può contenere uno o più piani.
  • Per aggiungere una descrizione al tuo prodotto, aggiungi un campo metadati denominato “description” e utilizza quello. Puoi usare Markdown.
• Piano - Un piano contiene un prezzo, un ciclo ricorrente ed è associato a un gruppo al quale gli abbonati ottengono l’accesso.

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

Se dovessi spegnere la tua istanza di Discourse, disinstallare questo plugin o il tuo sito andasse offline, Stripe continuerà a fatturare i tuoi clienti per il tuo servizio fino a quando l’abbonamento non verrà annullato.

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 a cui gli abbonati possono unirsi tramite acquisto
6. Crea un prodotto e un piano sotto Admin > Plugins > Subscriptions
7. Guadagna!

Configura il tuo Gateway di Pagamento.

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

Configura Webhook ed Eventi nel tuo account Stripe

I Webhook sono necessari per far funzionare completamente le cancellazioni 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 nella dashboard di Stripe sotto Endpoints > URL.

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

Dovrai anche dire a Stripe quali eventi deve 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 segreto di firma 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 effettuerà pagamenti reali. 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 nelle impostazioni appropriate in Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Configura i tuoi Gruppi Utenti in Discourse

Quando un utente si abbona con successo alla tua applicazione Discourse, dopo che la transazione con la carta di credito è stata elaborata, viene aggiunto a un Gruppo Utenti. Assegnando gli utenti a un Gruppo Utenti, puoi gestire a cosa gli utenti hanno accesso sul tuo sito web. I gruppi utenti sono una funzionalità fondamentale di Discourse e questo plugin non fa altro che aggiungere e rimuovere utenti dal gruppo associato al tuo Piano.

Crea uno o più prodotti con piani.

Sotto Admin > Plugins > Subscriptions, clicca su Aggiungi 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 alla tua Dashboard Stripe, vedrai che tutti quei prodotti e piani sono elencati. Discourse Subscriptions non li crea localmente. Vengono creati in Stripe.

Test

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 prova: Test card numbers | Stripe Documentation

Visita /s e inserisci alcune transazioni di prova.

Passare alla Produzione

Quando sei pronto per passare alla produzione, modifica le tue chiavi API e il segreto webhook con le 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 ancora 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.

Aggiorna le Informazioni di Pagamento

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

Stripe Checkout con Stripe Pricing Tables

Puoi anche scegliere di sostituire le pagine dei prodotti e di checkout del Plugin Abbonamenti e utilizzare invece Stripe Checkout con Stripe Pricing Tables.

Nella tua Dashboard Stripe:

1. Dopo aver creato i prodotti su Discourse, vai su 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 (ad esempio, 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 su 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 in 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 configuri la Tabella dei Prezzi 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.

Reindirizzare a https://<tuosito>/my/billing/subscriptions è una buona scelta per gli abbonamenti. Per pagamenti una tantum, potresti collegarti direttamente a https://<tuosito>/my/billing/payments.

Riscossione Automatica delle Tasse

Per abilitare la Riscossione Automatica delle Tasse, spunta la casella dell’impostazione del sito per discourse_subscriptions_enable_automatic_tax.

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

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

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

Ecco un esempio di transazione del plugin Discourse Subscription in Stripe che mostra che le tasse sono state riscosse automaticamente:

Impostazioni

Nome	Descrizione
discourse subscriptions enabled	Abilita il plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Mostra il pulsante Iscriviti nella navigazione principale
discourse subscriptions public key	Chiave Pubblicabile di Stripe
discourse subscriptions secret key	Chiave Segreta di Stripe
discourse subscriptions webhook secret	Segreto Webhook di 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 di 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 della campagna (in alto o nella barra laterale).
discourse subscriptions campaign banner bg image	Carica un’immagine personalizzata da utilizzare come sfondo sul banner della campagna.
discourse subscriptions campaign banner shadow color	Seleziona il colore dell’ombra del banner della campagna.
discourse subscriptions campaign show contributors	Mostra gli avatar degli acquisti più recenti di prodotti in abbonamento.
discourse subscriptions campaign product	L’ID prodotto di Stripe da inviare ai sostenitori quando cliccano sul pulsante nella campagna. Se questa impostazione è vuota, i sostenitori saranno reindirizzati alla pagina principale dei prodotti.
discourse subscriptions campaign grant	Concede all’utente un mese gratuito di abbonamento
discourse subscriptions pricing table id	L’ID della tabella dei prezzi di Stripe dal codice di incorporamento
discourse subscriptions pricing table enabled	Abilita l’uso della tabella dei prezzi di Stripe e sostituisce la pagina Iscriviti esistente
discourse_subscriptions_enable_automatic_tax	Attiva se la tassa sulle vendite deve essere riscossa. Richiede alcune configurazioni in Stripe.
discourse_subscriptions_enable_verbose_logging	Abilita un logging più dettagliato per aiutare nel debug. Non lasciare abilitato permanentemente in produzione.

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