Skip to content

WordPress Integration

The Sesamy WordPress plugin (v2) allows you to easily add paywalls and subscription management to your WordPress site. Protect your content and monetize your audience with seamless integration.

Overview

The Sesamy WordPress plugin provides a complete solution for content monetization on WordPress sites.

Repository: github.com/sesamyab/wordpress-sesamy-2

Installation

⚠️ Important: Do not download the plugin from the WordPress Plugin Store. The version available there is outdated. Always download the latest version directly from GitHub as described below.

This method ensures you get the latest version of the plugin directly from the official repository.

Part 1: Download the Plugin

  1. Go to the Releases Page
    Navigate to the Sesamy WordPress plugin releases page:
    github.com/sesamyab/wordpress-sesamy-2/releases

  2. Find the Latest Version
    The latest stable version is usually at the top of the releases list. Identify the version you want to install (e.g., v1.1.10).

    GitHub Releases Page

  3. Locate the Assets
    Under the release notes, look for the "Assets" section. Click to expand it if necessary.

    Release Assets

  4. Download the .zip File
    Find the file named sesamy-wordpress-vX.Y.Z.zip (e.g., sesamy-wordpress-v1.1.10.zip). Click on it to download. Save it to an accessible location like your Downloads folder.

Part 2: Upload to WordPress

  1. Log in to WordPress Admin
    Navigate to your WordPress Admin Dashboard (typically yourwebsite.com/wp-admin)

  2. Go to Plugins
    In the left sidebar:

    • Hover over Plugins
    • Click Add New

    Add New Plugin

  3. Upload Plugin
    Click the Upload Plugin button at the top of the page

    Upload Plugin Button

  4. Choose File
    Click Choose File or Browse, navigate to your Downloads folder, select the sesamy-wordpress-vX.Y.Z.zip file, and click Open

  5. Install Now
    Click the Install Now button

    Install Now

  6. Wait for Installation
    WordPress will upload and unpack the plugin. You'll see progress messages like "Unpacking the package...", "Installing the plugin...", and "Plugin installed successfully."

    Installation Progress

  7. Activate or Replace
    After successful installation:

    • If this is a fresh install, click Activate
    • If you're updating an existing plugin, click Replace current with uploaded

Success! The Sesamy WordPress plugin is now installed and activated on your site.

Configuration

Initial Setup

After activating the plugin, you need to configure it with your Sesamy client-id:

  1. Access Plugin Settings
    In WordPress Admin, go to Settings > Sesamy (or look for Sesamy in the sidebar)

  2. Enter Your Credentials
    You'll need the following information from your Sesamy account:

    • Client ID: Your unique Sesamy client identifier
  3. Contact Sesamy Support
    If you don't have these credentials, contact your Sesamy account manager or support team to receive them.

Basic Settings

Configure the following settings in the plugin:

SettingDescription
Default PaywallSelect which paywall to use by default for protected content

Protecting Content

Using the Block Editor (Gutenberg)

If you're using the WordPress Block Editor:

  1. Create or edit a post/page
  2. Add a Read More block where you want the paywall to appear
  3. Configure the block settings:
    • Select paywall type (subscription, single purchase, or both)
    • Set pricing (if applicable)
  4. Content below the paywall block will be protected

Features

User Authentication

The plugin handles user authentication automatically:

  • Users can log in with existing Sesamy accounts
  • New users can create accounts during checkout
  • Session management across your site
  • Automatic access control for protected content

Single Article Purchases

For pay-per-article content:

  • Set individual prices per article

Plugin Update Issues

When updating the plugin:

  1. Always backup your site before updating
  2. Download the latest release from GitHub
  3. Deactivate the old version
  4. Upload and activate the new version
  5. Check settings to ensure configuration is preserved

Compatibility Issues

If you encounter conflicts:

  1. Disable other plugins to identify conflicts
  2. Switch to a default WordPress theme temporarily
  3. Check plugin compatibility requirements
  4. Update WordPress to the latest version
  5. Contact support with error details

For detailed GDPR information, see the plugin documentation or contact Sesamy support.

Support

Documentation & Resources

Getting Help

For assistance with the WordPress plugin:

  1. Check Documentation: Review this guide and the GitHub repository README
  2. GitHub Issues: Report bugs or request features on GitHub Issues
  3. Sesamy Support: Contact your account manager for configuration help
  4. WordPress Forums: Check WordPress support forums for general WordPress questions

Released under the MIT License.