SpreeSubscriptions

This extension allows Spree to handle subscribable products with number-based subscriptions. This means that you can subscribe to N issues for a subscribable product (e.g., magazine). Once a new issue is created and shipped, every subscription decreases its remaining issues number. When this number decreases to 1, the associated user is notified via email that he has to renew his subscription. When it decreases to 0, the subscription becomes inactive.

Features

Admin can mark products as subscribable
Admin can set the number of issues that compose a subscription for each product and variant (default => 12)
Admin can create issues in each subscribable item (with the ability to associate issue with existing products, useful to link issue with backlog products of the same magazine)
Admin can view, print and mark as shipped the list of subscribed users (which have to receive new issue)
Keep track of shipped issues for each subscription
Send mail notification when only one issue remains to be shipped
Send mail notification when subscription expires (no remaining issues)

Installation

Add the gem to your Gemfile:

gem 'spree_subscriptions', :git => 'git://github.com/nebulab/spree-subscriptions.git'

Run bundle:

bundle

Run the generate and database migration:

rails g spree_subscriptions:install
rake db:migrate

Configure default issues number for subscriptions

For each subscribable product (and his variants) you can choose the number of issues a user can subscribe to. Default value is 12. To change this default value you can run from the rails console:

Spree::Subscriptions::Config.set(:default_issues_number, 24)

Use delayed job for email notifications

To use delyed_job to send notification mail just add delayed_job to your store Gemfile and run from rails console:

Spree::Subscriptions::Config.set(:use_delayed_job, true)

Testing

Be sure to bundle your dependencies and then create a dummy test app for the specs to run against.

$ bundle
$ bundle exec rake test_app
$ bundle exec rspec spec

stevenbarragan / spree-subscriptions Goto Github PK