Easywpkit Paid Content Access Pro – Complete Documentation

Version: 2.0.0
Requires: EasyWPKit Paid Content Access (free)
Website: https://easywpkit.com

Table of Contents

  1. Getting Started
  2. License Activation
  3. Setting Up Payments (Stripe / PayPal)
  4. Role‑Based Access
  5. Both Mode – Payment + Roles
  6. WooCommerce Integration
  7. Statistics
  8. Notifications
  9. Locked Content Overview
  10. Advanced Styling
  11. Troubleshooting
  12. Frequently Asked Questions
  13. Support

1. Getting Started

Easywpkit Paid Content Access Pro extends the free Gutenberg block with payment acceptance (Stripe, PayPal, WooCommerce), detailed analytics, email alerts, and a full suite of visual customisation tools.
All Pro features appear seamlessly inside the same “Content Lock” block you already use – no separate blocks or shortcodes to learn.

Requirements

  • WordPress 6.0 or higher
  • PHP 7.4 or higher
  • Easywpkit Paid Content Access (free) installed and active
  • A valid license key purchased from easywpkit.com/easywpkit-pricing

Installation

  1. Download the Pro plugin ZIP file from your EasyWPKit account.
  2. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
  3. Choose the ZIP file and click Install Now.
  4. Activate the plugin. A new menu Content Lock will appear in the sidebar (Pro pages are integrated as sub‑menus of the free plugin).
  5. Make sure the free Easywpkit Paid Content Access is already active. If not, Pro will show a notice and its features won’t load.

2. License Activation

After activation, you’ll see a notice asking you to activate your license. Go to Content Lock → License.

Activate Your License

  1. Enter the License Key received after purchase.
  2. Select the License Type that matches your purchase (Single Site, 5 Sites, Unlimited).
    Choosing the wrong type may result in an error during activation.
  3. Click Activate License.

The plugin will contact the EasyWPKit API to validate your key and domain.
Upon success, you’ll see a confirmation message and the License Status section will display:

  • Status: Active
  • Expires: the expiration date of your subscription

Deactivating a License

If you need to move the license to another domain, click Deactivate License. This frees the domain slot and the key can be reused.

Expiration Warning

Seven days before your license expires, a yellow notice will appear in every admin page reminding you to renew. After expiration, Pro features will stop working until you renew and reactivate.

3. Setting Up Payments (Stripe / PayPal)

This section explains how to configure your block to accept payments and automatically unlock content after a successful purchase.

3.1 Create the Success Page

  1. Create a new page named “Payment Success” (or any title you prefer).
  2. Insert the shortcode [ewpkcl_payment_handler] – nothing else is needed on this page.
  3. Publish the page and copy its full URL.

3.2 Configure the Success Page URL in Pro

  1. Go to Content Lock → Settings & Help.
  2. Paste the copied URL into the Success Page URL field.
  3. Click Save.

3.3 Configure a Payment Block

  1. Edit the post or page where you want to lock content.
  2. Add a Content Lock block (or edit an existing one).
  3. In the inspector panel, select a payment‑related mode:
    • Payment Only – access only after payment.
    • Both – access by role or payment (see section 5).
  4. Fill in the payment fields:
    • Block Identifier – a unique ID for this block (e.g., premium‑ebook).
    • Payment URL – your Stripe Payment Link or PayPal.Me URL.
    • Button Text – the text shown on the pay button.
  5. Customise the button and box appearance under Cover & Typography, Button Styling, and Box Styling.

3.4 Generate the Return URL for Stripe

  1. In the same block inspector, click Generate Return URL for Stripe.
  2. A text field will appear with a long URL. Copy this URL – it contains the unique parameters that identify the block.
  3. Paste this URL into your Stripe Payment Link’s “Redirect customers to a custom page” field (or into PayPal’s “Return URL” field).

Note for PayPal: When creating a PayPal button, set the return URL to the generated link. PayPal does not support the same dynamic redirect as Stripe, but the Pro plugin will still handle the unlock correctly.

3.5 How the Payment Flow Works

  1. Visitor clicks the “Buy Now” button on your site.
  2. They are taken to the payment page (Stripe / PayPal).
  3. After successful payment, they are redirected back to the return URL (your success page with the special parameters).
  4. The shortcode [ewpkcl_payment_handler] verifies the request and redirects the visitor back to the original page where the block is unlocked automatically.
  5. For guests, access is stored in a browser cookie for 30 days. For logged‑in users, access is permanent and linked to their account.

4. Role‑Based Access

Pro fully supports the same role‑based locking as the free plugin. You do not need Pro to use roles – but Pro enhances the experience with advanced styling and statistics.

If you want to restrict content solely by role (no payment):

  • Set Lock Mode to Roles Only.
  • Enter the allowed roles (in English, e.g., subscriber, premium).
  • Customise the Roles Only Message.

All role unlocks are recorded in Statistics (once per user per day) and can trigger email notifications.

5. Both Mode – Payment + Roles

The most flexible option – give access to users who either have the required role or have paid via the payment link.

  1. Set Lock Mode to Both.
  2. Configure the allowed roles in Roles Settings.
  3. Configure the payment fields (Block Identifier, Payment URL, etc.) as described in section 3.

Now:

  • Logged‑in users with the correct role see the content immediately.
  • Other visitors must pay to unlock it.

6. WooCommerce Integration

Link any WooCommerce product to a Content Lock block. When a customer purchases that product and the order is marked “Completed”, the corresponding block is automatically unlocked.

Prerequisites

  • WooCommerce must be installed and active.
  • The free Easywpkit Paid Content Access must be active.

Automatic Linking

  1. In the Gutenberg editor, select a Content Lock block.
  2. In the Inspector sidebar, open the WooCommerce Integration panel (Pro).
  3. Choose WooCommerce as the Lock Mode.
  4. Select a product from the dropdown. The Block Identifier will be auto‑generated if empty.
    You can still edit the Block ID manually, but it must remain unique.
  5. Save the page – the link is automatically stored.

Important: One Product – Multiple Blocks

⚠️ If you link several Content Lock blocks to the same WooCommerce product, purchasing that product will unlock all those blocks.
To unlock blocks independently, create a separate WooCommerce product for each block.

Manual Linking

You can also create links manually by going to Content Lock → WooCommerce:

  • Enter the Block ID exactly as set in the block settings.
  • Choose the WooCommerce Product from the dropdown.
  • Click Add Link.

The table on this page shows all existing links and allows you to Remove any link.

Guest Unlock

Guests are automatically redirected to the page containing the unlocked block after viewing the “Thank You” page. The block will be immediately visible.

7. Statistics

Statistics tracks every block unlock, giving you detailed insights about who accessed your content and how.

Go to Content Lock → Statistics.

Filtering Unlocks

Use the Unlock method dropdown to filter by:

  • All – every recorded unlock
  • WooCommerce – unlocks triggered by a WooCommerce order
  • Payment Links – unlocks via Stripe / PayPal payments
  • Role Access – unlocks based on user roles

You can also search for a specific Block ID using the text field.

Understanding the Table

ColumnDescription
Block IDThe unique identifier you set in the block settings
MethodHow the block was unlocked: WooCommerce, Payment Link, or Role
UnlocksTotal number of times this block has been unlocked
Last UnlockDate and time of the most recent unlock
UsersAggregated list of users (name + email) who unlocked the block

Viewing History

Click the View History button next to any block to see a chronological list of every unlock event, including:

  • Date and time
  • User name and email
  • Exact unlock method

How Statistics Are Collected

  • Payment Links: recorded immediately after a successful Stripe / PayPal return.
  • WooCommerce: recorded when the order status changes to “Completed”.
  • Role Access: recorded once per day when a logged‑in user with the required role views the page.

Clearing Statistics

Click Clear All Stats to reset the entire statistics table. This action cannot be undone.

8. Notifications

Pro can send you an email every time a block is unlocked, whether by payment, WooCommerce order, or role.

Go to Content Lock → Notifications.

Enabling Notifications

Check the Enable Notifications box and save. Emails will be sent to the address in the Recipient Email field (defaults to the site admin email).

Sending a Test Email

Click the Send Test Email button next to the recipient field. A test email will be sent immediately, and a success/failure message will appear beside the button.

Email Content

Each notification includes:

  • Subject: “New content unlock: {Block ID}”
  • Body: Block ID, date/time of unlock, and a note that it’s an automated message.

Troubleshooting Emails

Click the Email Troubleshooting Guide title to expand a panel with three solutions:

  1. Install an SMTP plugin (recommended).
  2. Add WP_MAIL_FROM and WP_MAIL_FROM_NAME to wp-config.php.
  3. Contact your hosting support for SMTP details.

Note: On some shared hosts (e.g., InfinityFree), server‑side email is blocked. An external SMTP service (SMTP2GO, Brevo, etc.) is required.

9. Locked Content Overview

The Overview page gives you a bird’s‑eye view of all Content Lock blocks present on your site, regardless of whether they were unlocked or not.

Go to Content Lock → Overview.

Table Columns

ColumnDescription
Block IDThe block identifier (or a warning if missing)
TypeLock mode: WooCommerce, Payment Link, Roles, Payment + Roles
LocationThe page/post where the block is placed (edit and view links)
Unlocks (Total)Total number of unlock events recorded for this block
Last ActivityDate/time of the most recent unlock
HistoryExpand to view the detailed unlock timeline
ActionsReset Access – revokes access for all users

Filtering

Use the Block type dropdown and the search box to quickly find specific blocks.

Reset Access

Clicking Reset Access will delete the _ewpkcl_granted_blocks user meta for all users for that block and remove the corresponding statistics. This forces users to pay again or re‑authenticate. Use with caution – it cannot be undone.

10. Advanced Styling

Pro adds a suite of styling options directly into the free block inspector, no custom CSS knowledge required (though you can still add your own).

All controls appear in the Inspector sidebar when a Content Lock block is selected, organised into these panels:

  • Gradient Background – enter a CSS gradient value.
  • Animation – 17 entrance animations with delay and duration controls.
  • Theme Preset – instant styles: Glassmorphism, Dark Mode, Minimal, Neon, Card, Outline, Elegant, Brutalist, Paper, Gradient Border, Floating, Retro Wave.
  • Button Hover Effects – Glow, Underline, Fill, Shake; adjustable hover scale.
  • Button Icon – add any Dashicon class.
  • Pro Enhancements – Box Shadow, Border Style, Block Border Radius, Text Shadow, Overlay Color, Button Full Width, Hide Cover on Mobile.
  • Custom CSS – write rules that target only this specific block.

11. Troubleshooting

License Issues

  • “Invalid server response” or activation fails: Ensure your server allows outbound HTTPS connections. Try activating again. If the problem persists, contact support.
  • License key disappears after saving: The plugin verifies domain binding. If the signature check fails, the key is cleared. Re‑enter and activate.

Email Notifications Not Arriving

  • Check that you have saved the “Enable Notifications” option and the correct recipient email.
  • Send a test email. If it fails, expand the Email Troubleshooting Guide on the Notifications page and follow the steps.
  • If using wp-config.php defines, make sure they are placed before /* That's all, stop editing! */.
  • On restricted hosts (e.g., InfinityFree), SMTP plugins may not work. Use an HTTP‑based email service like Brevo with their API.

Statistics Missing for Role Unlocks

  • The free plugin must be updated to the latest version.
  • A role unlock is recorded only once per user per day to avoid duplicates.

Pro Styles Not Appearing on Frontend

  • Ensure you have saved the page after applying styles. Pro attributes are stored as block attributes.
  • Clear any caching plugin and browser cache.
  • If you’re using a child theme that strips styles, try with a default WordPress theme.

12. Frequently Asked Questions

Q: Does Pro work without the free plugin?
A: No. Easywpkit Paid Content Access Pro is an extension and requires the free plugin to function.

Q: What happens when my license expires?
A: Pro features will stop working, but your existing blocks and settings remain. Once you renew and reactivate, everything resumes.

Q: Can I use the same license on multiple sites?
A: Depending on your plan: Single – 1 site, 5 Sites – up to 5 sites, Unlimited – unlimited sites.

Q: Will my statistics be lost if I deactivate Pro?
A: No. Statistics are stored in your database and will reappear when Pro is reactivated.

Q: How do I get a refund?
A: Refund requests are handled through EasyWPKit support. Contact us with your order details.

13. Support

This documentation covers Easywpkit Paid Content Access Pro version 2.0.0. For updates and new features, visit our website regularly.ro version 1.0.0. For updates and new features, visit our website regularly.