Content Locker System¶
The Content Locker addon is a premium monetization tool that allows you to lock specific files, scripts, or premium content behind a high-converting offerwall gateway. Users must complete one or more actions (surveys, app installs, or PIN submits) to unlock the protected content.
🏗️ Technical Architecture¶
The Content Locker operates on a headless, session-driven architecture, ensuring high performance and security even behind external CDNs or iframes.
The Lifecycle of a Lock¶
- Request: The user accesses a locked resource, triggering the Iframe or JS loader.
- Session Initialization: The system creates a temporary record in
content_locker_sessionswith a signed HMAC token. - Offer Delivery: A filtered list of high-payout offers is served based on the user's IP geography and device type.
- Verification: Upon completion, the ad network sends a postback to
/locker/postback. - Unlocking: The platform verifies the payout and automatically releases the
unlock_token, allowing the user to access the content.
🎨 Template Engine¶
The system features a 100% customizable template engine, allowing you to match the locker's aesthetic to your network's branding.
- Pre-Built Themes: Includes professional templates like Rigoto, Dark Gamer, and Minimalist.
- Dynamic Placeholders: Use
{title},{description}, and{offers}to inject content into custom HTML/CSS layouts. - Device-Specific Routing: Configure different templates for Desktop vs. Mobile to maximize mobile conversion rates.
🛡️ Administrative Control¶
Manage the health and compliance of your locker network from the Admin Panel → Management → Content Lockers.
Compliance Filtering¶
To protect your domain reputation, the platform includes a Banned Words Engine. Any locker created with prohibited terms in its title or description is automatically flagged and disabled.
Global Settings¶
- Global Priority: Set the default offer priority for all lockers.
- Min/Max Offers: Control the minimum number of tasks a user must complete to unlock.
- Currency Customization: Define how payouts (points vs. cash) are displayed to the end user.
📊 Developer Integration¶
JS Loader Script¶
The preferred integration method for high-traffic sites:
Tracking API¶
For custom frontend implementations, use the platform's public tracking endpoints:
POST /api/locker/track: Logs click intent and validates device fingerprints.GET /api/locker/{uuid}/progress: Real-time polling for unlock status.