Plugin per abbonamenti 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 è integrato nel nucleo di Discourse. Non è necessario installare il plugin separatamente.

Poiché si tratta di un plugin #ufficiale mantenuto dal team di Discourse, le richieste di #supporto, bug, ux e #feature possono essere avanzate nelle rispettive categorie qui su Meta, taggate con l’etichetta appropriata del plugin. Clicca su un link qui sotto per avviarne uno.

Supporto Bug UX Funzionalità

Il plugin Discourse Subscriptions 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 automatico delle tasse di vendita e raccolta
• Gli utenti possono aggiornare la propria carta per abbonamenti individuali

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

Una volta che un utente fa clic 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 fatto clic su “Iscriviti”, viene visualizzato un messaggio “Grazie!” e viene reindirizzato alla sua pagina di fatturazione:

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

Termini

• Abbonamento - Gli abbonamenti sono un piano di pagamento ricorrente che 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 chiamato “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 dovessi spegnere la tua istanza di Discourse, disinstallare questo plugin o se 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 per i tuoi abbonati da unirsi tramite 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à di test e vedere come funziona tutto senza effettuare transazioni reali o dover configurare un conto bancario. Non c’è un interruttore per la modalità di 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 farlo, pubblica una coppia di chiavi API private e pubbliche e un segno 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 renderà i pagamenti effettivi. Se hai intenzione di testare, assicurati di passare alla modalità View test data e di 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 con la carta di credito è stata elaborata, viene aggiunto a un Gruppo Utente. Assegnando gli utenti a un Gruppo Utente, puoi gestire a cosa i tuoi utenti hanno accesso sul tuo sito web. I gruppi utente sono una funzionalità fondamentale 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, fai clic su aggiungi un nuovo Prodotto. Una volta che hai 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 Stripe Dashboard, 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 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 il 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 non riusciti simili all’immagine sottostante e di configurare i webhook come descritto sopra.

Aggiorna le Informazioni di Pagamento

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

Stripe Checkout con Stripe Pricing Tables

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

Nel tuo Stripe Dashboard:

1. Dopo aver creato i prodotti su Discourse, vai a Products > Product catalog
2. Fai clic sul prodotto che desideri includere nella tabella dei prezzi
3. Fai clic su 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. Fai clic su 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 nel tuo discourse_subscriptions_pricing_table_id e abilita l’impostazione della tabella dei prezzi degli abbonamenti.
5. Fai clic sui segni di spunta 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 per tornare 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 Tasse

Per abilitare la Raccolta Automatica delle Tasse, spunta 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 tasse, 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 le tasse sono state raccolte automaticamente:

Impostazioni

Nome	Descrizione
discourse subscriptions enabled	Abilita il plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Mostra il pulsante di iscrizione nella navigazione principale
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 sostegno 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 fanno clic sul pulsante nella 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 le tasse di vendita verranno raccolte. Richiede alcune configurazioni in Stripe.
discourse_subscriptions_enable_verbose_logging	Abilita un logging più dettagliato per aiutare nel debug. Per favore non lasciare abilitato permanentemente in produzione.

Hosted by us? Questo plugin è disponibile sui nostri piani di hosting Pro, Business ed Enterprise Subscriptions | Discourse - Civilized Discussion