A Discourse plugin that allows payments and subscription management via Stripe.
Go to file
Rimian Perkins 75f5ec4393 fix missing radix on parseInt 2019-11-19 10:21:05 +11:00
app fix null delete subscription error 2019-11-14 12:07:24 +11:00
assets fix missing radix on parseInt 2019-11-19 10:21:05 +11:00
config style the product page a bit 2019-11-14 11:13:12 +11:00
db/migrate remove payments 2019-11-07 15:19:48 +11:00
lib/discourse_patrons controller spec runs 2019-09-11 18:32:09 +10:00
spec fix null delete subscription error 2019-11-14 12:07:24 +11:00
test/javascripts problematic test 2019-11-13 08:36:38 +11:00
.eslintrc appease eslint 2019-08-27 20:18:02 +10:00
.gitignore update .gitignore 2017-10-08 23:18:22 +01:00
.ruby-version upgrade ruby 2019-08-25 11:51:06 +10:00
.travis.yml enable discourse-plugin-ci 2019-08-27 19:52:25 +10:00
LICENSE Initial commit 2017-01-30 10:52:35 +11:00
README.md typos 2019-11-19 10:12:40 +11:00
jsapp add success handler 2019-09-12 07:43:27 +10:00
plugin.rb fix missing radix on parseInt 2019-11-19 10:21:05 +11:00

README.md

Discourse Patrons

Build Status

Accept payments from visitors to your Discourse application. Integrates with Stripe.

This is a newer version of https://github.com/rimian/discourse-donations.

Installation

What are Subscriptions?

There are two core components to make subscriptions work for your Discourse application. These are Products and Plans.

A Product describes what the user gets when they subscribe. It has a name and description and is associated with a Discourse user group.

A Plan is how you charge your users for the Product. Plans have rates, billing intervals and trial periods. A Product may have multiple Plans. For example: a yearly and a monthly Plan. You can't change plans much once they are created but you can archive them and create new ones.

Together, Products and Plans make up subscriptions.

How to set up your Discourse app for subscriptions.

Set up your payment gateway.

Firstly, you'll need an account with the Stripe payment gateway. This is how you manage your transactions.

When you get a moment, take a look at Stripe's documentation. But for now, you can set up an account in test mode and see how it all works without making any real transactions. Then, if you're happy with how everything works, you can start taking real transactions. See below for test credit card numbers.

Set up your User Groups in Discourse

When a user successfully subscribes to your Discourse application, after their credit card transation has been processed, they are added to a User Group. By assigning users to a User Group, you can manage what your users have access to on your website. User groups are a core functionality of Discourse and this plugin does nothing with them except and and remove users from the group you accociated with your Plan.

Enter your configuration details

Testing

Test with these credit card numbers:

  • 4111 1111 1111 1111

Warranty

This software comes without warranties or conditions of any kind.

Credits

Many thanks to Chris Beach and Angus McLeod who helped on the previous version of this plugin. Many thanks to the Discourse team who sponsored this plugin! You guys rock.

Known issues

  • CSS is mucked up in Safari and probably Firefox too.
  • The phone number isn't sent to Stripe

TODOs

  • Confirm dialog CSS isn't the best.
  • Check against other themes (works ok with light and dark)
  • Validate the model properly. Not in the stripe component
  • Show the transaction on the thank you page.
  • Work out where to put the helper tests. Name collision!