70

Product support

Get help in the plugin support forum.

Categories

Now you can monetize your content with member subscriptions!


Design goals

You can create an unlimited number of membership plans (year, month, week, day) and users can subscribe to these plans. All subscriptions are automagically terminated at the end of their billing cycle and a new subscription is generated. The user receives a mail that their subscription is renewed and a new invoice is created using either the Responsiv.Pay plugin or my own Briddle.Invoice plugin (but custom implementations are also possible by extending this plugin with your own cronjob and subscribe components or by hooking into it's events).

Please contact me if you encounter any issues!


Features

I want you to get excited about this plugin and I understand that that will only happen if you can really make it your own.

STATUS FEATURE
YES THOROUGHLY SUPPORTED
YES CONCISE DOCUMENTATION
YES MULTILINGUAL
YES PERMISSIONS
YES EXTENDABLE (USING briddle.members.beforeRenew and briddle.members.afterRenew EVENTS)
YES ACCESS COMPONENT (any subscription or a specific subscription, also usable to show or hide links to specific subscriptions)
YES CRONJOB COMPONENT
YES MAIL CUSTOMERS THEIR SUBSCRIPTION IS RENEWED (month, year)
YES AUTOMAGICALLY TERMINATE SUBSCRIPTIONS AT THE END OF THEIR BILLING CYCLE
YES AUTOMAGICALLY CREATE NEW SUBSCRIPTIONS FOR ACTIVE SUBSCRIPTIONS AT THE END OF THEIR BILLING CYCLE
YES AUTOMAGICALLY CREATE NEW INVOICE (using the FREE 3rd-party Responsiv.Pay plugin or my new Briddle.Invoice plugin) FOR RENEWED SUBSCRIPTIONS
YES SUPPORT FOR YOUR OWN CUSTOM BILLING SOLUTION (credit and debit tables)
YES EITHER ACTIVATE SUBSCRIPTIONS BEFORE THEY ARE PAID OR REQUIRE PAYMENT

You can complement and extend this plugin with various other (free and paid) plugins. See the documentation tab for more information.

Installation

You need an account on octobercms.com to install this plugin.

  1. Sign in and click on the Add to Project button on the product page for the plugin in the marketplace.
  2. Select the project you wish to add the plugin to (or create one).
  3. Make sure you install any 3rd-party plugins this plugin depends on
  4. Make sure you have attached this project to your website in the backend of your website in order to pull in the new plugin (Settings > Updates & Plugins). Don't worry, attaching or detaching your website to a project will never delete anything!
  5. Make sure you allow short_open_tag (this is allowed in PHP by default)

Like this plugin?

Did you know that only about 30% of my plugins are paid (70% of my plugins are free) and that 30% of your purchase goes to help fund the October Project? If you purchase this plugin, you can help me to develop it further, provide support for it or make new plugins.

My other plugins include:

Hello, I am Wiego Bergsma. Please start by reading the whole documentation! If you have any questions, find a bug or experience difficulties getting the plugin to work please use the Support Forum. Only leave a Review if you are happy with the plugin or are still unhappy with the plugin after reaching out to me in the Support Forum. Thank you! Wiego

Table of contents

Getting started

Please note that this plugin requires some other (free) plugin!

  1. Add Briddle.Members to a project and attach it to your website (This plugin requires RainLab.User, RainLab.UserPlus, and the User Plus plugin requires RainLab.Location and RainLab.Notify so add those first). Also add Responsiv.Pay if you want to use the default billing system component. All these plugins are free. Alternatively you can add my own paid plugin Briddle.Invoice to handle invoicing.
  2. Make sure you allow short_open_tag (this is the default PHP configuration) and setup a cronjob
  3. Configure the settings in Settings > Users > Members

Access component

Please note that the default configuration activates subscriptions by default (without being paid). You can require payment in Settings > Users > Members

Simply place the component on the pages you wish to make members-only. You can allow any member or a specific membership in the component settings.

You can either bounce users without a proper membership or use this component to hide sections on your page from them by using:

{% for access in componentName.access %}
    {% if access.name == 'gold' %}
        Visible for gold members only
    {% endif %}
{% endfor %}

Screenshot

Subscribe component

Please note that this component requires a signed-in user

Simply place the component on the page you wish to use. You can specify the number of days payments are due and the percentage VAT in the component settings. Make sure you create a partial success.htm to mark a membership as active.

<i class="fa fa-check"></i>

Screenshot

Screenshot

Cronjob component

The cronjob component allows keeping the integration with Responsiv.Pay optional. It requires a traditional cronjob on your server instead of using the command scheduler of October CMS.

Simply place the component on the page you wish to use (e.g. /cronjobs). You can specify the number of days payments are due and the percentage VAT in the component settings.

Run a cronjob daily like:

wget -O - https://www.yoursite.com/cronjobs >/dev/null 2>&1

Custom billing solutions

Please study the code in the Cronjob component if you want to implement your own billing solution!

Although this plugin supports both the FREE Responsiv.Pay plugin and my own new Briddle.Invoice plugin you can also choose to implement your own billing solution and 2 tables are included for this purpose (briddle_members_credit and briddle_members.debit). You can extend this plugin with your own cronjob and subscribe components.

Screenshot

Available events

The following events are available to extend the functionality of this plugin:

STATUS EVENT
YES briddle.members.beforeRenew
YES briddle.members.afterRenew
YES eloquent.creating: Briddle\Members\Models\Subscription
YES eloquent.created: Briddle\Members\Models\Subscription
YES eloquent.saving: Briddle\Members\Models\Subscription
YES eloquent.saved: Briddle\Members\Models\Subscription
YES eloquent.updating: Briddle\Members\Models\Subscription
YES eloquent.updated: Briddle\Members\Models\Subscription
YES eloquent.deleting: Briddle\Members\Models\Subscription
YES eloquent.deleted: Briddle\Members\Models\Subscription
YES eloquent.creating: RainLab\User\Models\User
YES eloquent.created: RainLab\User\Models\User
YES eloquent.saving: RainLab\User\Models\User
YES eloquent.saved: RainLab\User\Models\User
YES eloquent.updating: RainLab\User\Models\User
YES eloquent.updated: RainLab\User\Models\User
YES eloquent.deleting: RainLab\User\Models\User
YES eloquent.deleted: RainLab\User\Models\User

Available permissions

As always you can set permissions for this plugin in Settings > Administrators > Members

  • Manage memberships
  • Manage subscriptions
  • Manage credit (optional)
  • Manage debit (optional)

Available languages

This plugin can be translated in any language

This plugin supports the following languages out of the box:

  • english
1.1.7

Settings page allows you to either activate subscriptions before they are paid or require payment

Oct 11, 2019

1.1.6

Access component now supports either bounce or conditions

Sep 12, 2019

1.1.5

Bugfix Briddle.Invoice integration

Aug 27, 2019

1.1.4

Bugfix

Aug 27, 2019

1.1.3

Added support for my new plugin Briddle.Invoice.

Aug 26, 2019

1.1.2

Fixed another bug in the newly added subscribe component. Testing is now completed.

Aug 15, 2019

1.1.1

Fixed a bug in the newly added subscribe component.

Aug 15, 2019

1.1.0

Added Subscribe component and fixed a bug in the cronjobs component.

Aug 15, 2019

1.0.9

Made Responsiv.Pay integration optional.

Aug 15, 2019

1.0.8

Updated table briddle_members_memberships

Aug 14, 2019

1.0.7

Updated table briddle_members_debits

Aug 14, 2019

1.0.6

Updated table briddle_members_credits

Aug 14, 2019

1.0.5

Created table briddle_members_debits

Aug 14, 2019

1.0.4

Created table briddle_members_credits

Aug 14, 2019

1.0.3

Created table briddle_members_memberships

Aug 14, 2019

1.0.2

Created table briddle_members_subscriptions

Aug 14, 2019

1.0.1

Initialize plugin.

Aug 14, 2019