Labrador CMS Integration

Labrador is a specialized CMS that integrates natively with Sesamy's paywall and subscription features, enabling seamless content monetization for publishers.

Overview

The Sesamy plugin for Labrador allows you to protect content behind paywalls, manage subscriptions, and track user engagement directly from your Labrador dashboard.

Features:

• Easy paywall activation from the Labrador dashboard
• Single purchase and subscription support
• Integrated authentication
• Analytics tracking with Kilkaya
• Customizable pricing and currency settings

Setup

Activating the Sesamy Plugin

The Sesamy plugin can be activated directly in the Labrador dashboard:

Required Configuration

You'll need to provide the following properties in the Labrador dashboard:

Property	Description
ID	Your Sesamy client ID (provided by Sesamy support)
Price	The default price for single purchase articles
Currency	The default currency for single purchase articles (e.g., SEK, EUR, USD)
Paywall settings URL	Link to the paywall configuration in the Sesamy portal (available on the Paywalls page)
Paywall pass page with absolute URL	URL to the subscription signup page, typically linked to your product (provided by Sesamy support)

Obtaining Configuration Values

Contact your Sesamy account manager or support team to receive:

• Your unique Sesamy client ID
• The paywall settings URL for your account
• The subscription signup page URL

Login Button Setup

The login button integration is currently managed by Labrador support. Contact Labrador support to have the login button added to your pages.

Analytics Integration

Kilkaya Analytics

Labrador supports analytics tracking through Kilkaya. Since information about the currently logged-in user isn't directly available to Labrador, it needs to be fetched using a custom script.

Setting Up Kilkaya Integration

Step 1: Add Custom Script

Add the following script as a custom tag in the head bottom position in your Labrador dashboard:

const tokenData = localStorage.getItem('@@auth0spajs@@::<YOUR SESAMY CLIENT-ID>::@@user@@');
const tokenJson = tokenData ? JSON.parse(tokenData) : null;
Dac.clientData.paywall.isAuthenticated = !!tokenJson;
Dac.clientData.subscriberId = tokenJson?.decodedToken?.user?.sub;

Important: Replace <YOUR SESAMY CLIENT-ID> with your actual Sesamy client ID.

Step 2: Configure in Labrador Dashboard

1. Go to your Labrador dashboard
2. Navigate to Settings > Custom Tags (or similar section)
3. Add a new custom tag
4. Set the position to Head Bottom
5. Paste the script with your client ID
6. Save the configuration

What This Script Does

The script:

1. Retrieves the authentication token from browser local storage
2. Parses the token to extract user information
3. Sets Dac.clientData.paywall.isAuthenticated to track authentication status
4. Sets Dac.clientData.subscriberId to identify the current subscriber

This data is then available to Kilkaya for analytics tracking and reporting.

How It Works

Content Protection

1. Activate Paywall: Enable the Sesamy plugin in your Labrador dashboard
2. Configure Products: Set up single purchase prices and subscription options
3. Protect Content: Mark articles or content as protected in Labrador
4. User Experience: Non-subscribers see the paywall, while subscribers get automatic access

Authentication Flow

1. User encounters protected content
2. Paywall is displayed with purchase/subscription options
3. User either purchases single article or subscribes
4. Upon successful purchase, user gains immediate access
5. Future visits: user is automatically authenticated

Subscription Management

Subscribers can manage their subscriptions through:

• The Sesamy user portal
• Email notifications and links
• Account settings (if integrated in your Labrador site)

Best Practices

1. Clear Pricing: Display prices prominently in your site design
2. Value Proposition: Clearly communicate the benefits of subscribing
3. Preview Content: Show enough free content to entice readers
4. Test Thoroughly: Verify paywall behavior before launching
5. Monitor Analytics: Use Kilkaya data to optimize your paywall strategy

Troubleshooting

Paywall Not Appearing

If the paywall isn't showing on protected content:

1. Verify the Sesamy plugin is activated in Labrador
2. Check that your client ID is correct
3. Ensure the content is marked as protected
4. Clear browser cache and test again

Analytics Not Tracking

If Kilkaya isn't receiving user data:

1. Verify the custom script is added in the correct position (head bottom)
2. Check that your client ID in the script matches your actual client ID
3. Open browser developer tools and check for JavaScript errors
4. Verify the script is loading on all pages

Login Issues

If users can't log in:

1. Contact Labrador support to verify login button integration
2. Check that the paywall settings URL is correct
3. Verify your Sesamy client ID is active
4. Test in an incognito/private browser window

Support

For assistance with Labrador integration:

Sesamy Support:

• Configuration issues with Sesamy plugin
• Client ID and URL provisioning
• Paywall and subscription setup

Labrador Support:

• Plugin activation in Labrador dashboard
• Login button integration
• Custom tag configuration
• General Labrador CMS questions

Related Resources

• Labrador CMS Documentation (if available)
• Sesamy Paywall Setup
• Subscription Management
• Sesamy Portal