WooSocialUnlock — How To

Summary

Let users complete actions (share/follow/subscribe/join) to instantly unlock a coupon, discount, or free download.

Prerequisites

• WordPress + WooCommerce (latest).
• Optional: Mailchimp/Klaviyo/ConvertKit keys if using email subscribe.

Install & Activate

Upload ZIP → Activate → WooCommerce → Settings → Social Unlock.
Add provider API keys (Links to “create API key” open in a new tab).

Enable on a Product

1. Products → Edit the product.
2. Open the Social Unlock tab.
3. Toggle Enable for this product.
4. Choose Required Actions (Share, Follow, Subscribe, Join, Custom).
5. Choose Reward (Reveal unique coupon / Auto-apply discount / Unlock file/free product).
6. Update product.

Display Options

• Modal (auto-show or on button click).
• Inline widget (below price or in a custom hook/shortcode area).
• Skinning: set colors, fonts, and radius in Settings; match your brand.

Verification & Anti-abuse

• Built-in listeners for share/subscribe events.
• Optional email double opt-in for “Subscribe.”
• Rate limit + reCAPTCHA support.
• One-time coupons per user email if desired.

Caching/CDN

Exclude:

/?add-to-cart=*
/?wc-ajax=*
/cart/
/checkout/
/wp-json/wc-social-unlock/v1/*

Troubleshooting

• Modal too tall on mobile: enable “Auto fit” or reduce max options per step.
• Coupon not applying: confirm coupon exists, is in date, and not restricted by product/category.
• Verification fails: recheck provider API key; test in an incognito window.

Uninstall

Deactivate → Delete (toggle “Remove data” in Settings to wipe widget/task setups).