How can I offer a Free Registration with Access Code?

KB Article Creation Checklist

[x] Write initial draft for this KB Article; label this issue draft and either questions or tutorials
[x] Add required YAML configuration
[x] Add Tags for this KB Article to the YAML config (see YAML Keys (Explained))
[ ] Edit and finalize draft for publishing (remove draft label, add draft-finalized label)
[ ] Assign Issue to yourself and create Markdown file (remove draft-finalized label, add pending)
[ ] Project Lead: Review and Publish KB Article (remove pending label, add published label)

title: How can I offer a Free Registration with Access Code?
categories: Questions
tags: mu-plugins-hacks, tricks, giftredemption-codes, pro-forms, custom-capabilities
author: kristineds
github-issue: https://github.com/websharks/s2member-kb/issues/#

Additional TODOs

[ ] Insert screenshots

This is a work in progress.

I want people to get free access to my exclusive content (via promo code). I don't want to charge any fee, just allow people to enter their code and create an account.

You could set this up by generating a Paypal (Buy Now) Pro-Form and applying a coupon code that gives your customers 100% discount which will make it free and give them access to your exclusive content

Generate Pro-Form Coupon Code

Go to: WordPress Dashboard → s2Member → Pro Coupon Codes → Pro Coupon Codes Configuration
Add a Coupon code called "exclusive" (or any coupon code name you prefer) with 100% discount. Save All Changes.
See: http://s2member.com/kb-article/how-do-i-enter-a-pro-form-coupon-code/

To give specific users access to exclusive content, you’ll want to give those pages specific Custom Capabilities and then assign those users the Custom Capabilities for the pages you want to give them access to. Please see this video for more on Custom Capabilities. To assign those ccaps to specific users, this could be done by integrating [s2If /] (Simple Shortcode Conditionals) into your content.

Restrict content using Custom Capabilities (`ccaps`) and `[s2If /]` conditionals

See: http://s2member.com/kb-article/s2if-simple-shortcode-conditionals/#toc-cc6d1c60
On your content page, you could set it up to something like this:

[s2If current_user_can(access_s2member_ccap_exclusive)]
   Insert exclusive content here.
[/s2If]

To automatically assign new users one or more Custom Capabilities, you simply add those Custom Capabilities to the ccaps=”” attribute in your Paypal (Buy Now) Pro-Form shortcode. When the user signs up with that Paypal (Buy Now) Pro-Form, they’ll automatically get those Custom Capabilities and therefore have access to the pages restricted to them.

Generate Paypal (Buy Now) Pro-Form shortcode

Go to: WordPress Dashboard → s2Member → Paypal Pro-Forms → Forms For Level #1 Access
On the dropdown selection, you could choose "PayPal Pro (Buy Now): One Time (for lifetime access, non-recurring, no trial)". This depends if you want on how long you want your users to access the exclusive content
Add the new Custom Capability exclusive or edit the attribute ccaps="exclusive" on the Pro-Form shortcode
On the generated shortcode, set accept_coupons="1". You could also set it to accept="paypal" as to not confuse your users with entering their credit card information.
It should look something like this:

[s2Member-Pro-PayPal-Form level="1" ccaps="exclusive" desc="Exclusive access to online content" ps="paypal" lc="" cc="USD" dg="0" ns="1" custom="example.com" ta="0" tp="0" tt="D" ra="0.01" rp="1" rt="L" rr="BN" rrt="" rra="2" accept="paypal" accept_via_paypal="paypal" coupon="" accept_coupons="1" default_country_code="" captcha="0" /]

If you want to extend this further, you can use a success="" attribute that will redirect users to a Thank you page after they sign up on your Membership page. See: http://s2member.com/kb-article/creating-a-registration-thank-you-page/#toc-3a5b356b

wpsharks / s2member-kb