A Solidus extension for subscriptions. Important note: this is PRE-RELEASE software and is currently a work-in-progress. There are no guarantees this will work for your store!

Add solidus_subscriptions to your Gemfile:

gem 'solidus_subscriptions', git: 'https://github.com/brendandeere/solidus_subscriptions/'

Bundle your dependencies and run the installation generator:

bundle
bundle exec rails g solidus_subscriptions:install

This gem requires a gateway which supports credit cards in order to process subscription orders. By default the gem will look for the first active gateway with Spree::CreditCard as its payment_source_class.

If you would like to specify the gateway used by the gem you can add this to an initialzer.

SolidusSubscriptions::Config.default_gateway { my_gateway }

By default only Spree::Variants are subscribable. To subscribe to a variant, it must have the :subscribable attribute set to true.

To subscribe to a variant include the following parameters when posting to /orders/populate (The add to cart button on the product page):

  {
    // other add to cart params
    subscription_line_item: {
      quantity: 2,              // number of units in each subscription order.
      subscribable_id: 1234,    // Which variant the subscription is for.
      interval_length: 1,       // The time between subscription activations.
      interval_units: "month", // A plural qualifier for length.
                                // Can be one of "day", "week", "month", or "year".
      max_installments: 12      // Stop processing after this many subscription orders.
                                // (use null to process the subscription ad nauseam)
    }
  }

This will associate a SolidusSubscriptions::LineItem to the line item being added to the cart.

The customer will not be charged for the subscription until it is processed. The subscription line items should be shown to the user on the cart page by looping over Spree::Order#subscription_line_items.

When the order is finalized, a full SolidusSubscriptions::Subscription will be created for each subscription line items associated to the order, through the order's line items.

To process actionable subscriptions simply run:

bundle exec rake solidus_subscriptions:process

To schedule this task we suggest using the Whenever gem.

Subscriptions require a user to be present to allow them to be managed after they are purchased.

Because of this you must disabling guest checkout for orders which contain subscription_line_items.

An example of this would be adding this to the registration page:

<%# spree/checkout/registration.html.erb %>
<% if Spree::Config[:allow_guest_checkout] && current_order.subscription_line_items.empty? %>

This allows guests to add subscriptions to their carts as guests, but forces them to login or create an account before purchasing them.

First bundle your dependencies, then run rake. rake will default to building the dummy app if it does not exist, then it will run specs, and Rubocop static code analysis. The dummy app can be regenerated by using rake test_app.

bundle
bundle exec rake

When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:

require 'solidus_subscriptions/testing_support/factories'

Copyright (c) 2016 Stembolt, released under the New BSD License