Velvet Rope for Craft CMS

Velvet Rope is a Craft 6 plugin. Craft 6 is still in beta, and so is Velvet Rope (6.0.0-beta.1) — it takes payments, so test every flow in Stripe test mode and use caution on production sites.

Configuration

Everything lives in Settings → Plugins → Velvet Rope. Each setting can also be set in config/craft/velvetrope.php, which wins over the CP.

SettingDefaultWhat it does
Stripe publishable key$STRIPE_KEYUse an environment variable.
Stripe secret key$STRIPE_SECRETUse an environment variable.
Webhook signing secret$STRIPE_WEBHOOK_SECRETWebhooks are refused (503) until it's set. A reference to an unset variable counts as unset, never as the literal text.
CurrencyusdCashier's default currency. Prices themselves live in Stripe.
Plans—Rows of handle, name, Stripe price ID, user group, trial days.
Grace period (days)3How long a member whose payment failed keeps access (Stripe status past_due). 0 = none.
Join path—Where non-members are sent by a gate. Blank: the plan's checkout when one plan is named, otherwise a 403.
Success path / Cancel path—Site paths Stripe Checkout returns to. Always a path on the visitor's own site, never another host.
Checkout rate limit20Checkout and gift links one visitor may open per minute (each creates a Stripe session). 0 = no limit.
Guest checkoutoffSee Plans and checkout.
Show Members in the sidebar / label / icononOnly people with “View members” see it.

Plans

A plan is a Stripe price plus the Craft user group its members are put in. The handle is what templates, gates and checkout links use (gold); it's also stored on each Stripe subscription as its type, so don't rename a plan's handle once people have subscribed.

Velvet Rope only ever adds people to, and removes them from, the groups your plans name. Other groups a user is in are left alone.

Permissions

  • View members — the Members screen and the Membership tab on user accounts.
  • Manage memberships (nested) — resync a member's groups, and in Pro grant or revoke complimentary access.

Admins have both.

More plugins

Pairs well with Velvet Rope