WordPress Integration (3-Class)

The standard integration bundles three PHP files with your plugin or theme. Each class handles a single responsibility: license operations, admin UI, and automatic updates.

Files

Copy the following three files into your plugin or theme (typically inside an includes/ directory):

Initialization

Include all three files and instantiate them in your plugin's main file. The WPLF_Client constructor accepts either positional arguments or an associative array.

Positional arguments

require_once __DIR__ . '/includes/class-wplf-client.php';
require_once __DIR__ . '/includes/class-wplf-client-admin.php';
require_once __DIR__ . '/includes/class-wplf-client-updater.php';

$client  = new WPLF_Client( 'my-plugin', 'https://licences.example.com', __FILE__ );
$admin   = new WPLF_Client_Admin( $client );
$updater = new WPLF_Client_Updater( $client );

Array configuration

For additional options, pass an associative array as the sole argument:

$client = new WPLF_Client( [
    'product_slug'   => 'my-plugin',
    'api_url'        => 'https://licences.example.com',
    'plugin_file'    => __FILE__,
    'cache_duration' => 7200,   // Optional. Default: 3600 (1 hour).
    'api_key'        => 'lf_pk_abc123', // Optional. Required if server enforces API key auth.
] );

WPLF_Client methods

The core class provides the following public methods:

License operations

Feature and tier methods

Trial methods

Utility methods

WPLF_Client_Admin

The admin class creates a license management page in the WordPress admin panel and handles user interactions for activation and deactivation.

Constructor

$admin = new WPLF_Client_Admin( $client, [
    'page_title'  => 'My Plugin Licence',
    'menu_title'  => 'Licence',
    'menu_slug'   => 'my-plugin-licence',
    'parent_slug' => 'options-general.php', // Place under Settings
    'brand_name'  => 'Acme Corp',
    'brand_color' => '#4F46E5',
    'brand_logo'  => plugins_url( 'assets/logo.svg', __FILE__ ),
] );

Admin page features

The generated admin page at Settings > Licence (or your configured location) provides:

• A license key input field with Activate, Deactivate, and Refresh buttons.
• Current license status display: active, expired, inactive, or trial with days remaining.
• Tier name and feature list for the current license.
• Masked key display after activation (e.g. ****-****-****-7FGH).

Admin notices

WPLF_Client_Admin displays persistent admin notices when a license requires attention:

• Expired license -- Warning notice prompting the user to renew.
• No license key -- Info notice on the plugin's own pages only, with a link to the license page.
• Approaching expiration -- Notice shown 14 days before expiry.

WPLF_Client_Updater

The updater class hooks into the WordPress plugin update system to deliver new versions to licensed users.

Constructor

$updater = new WPLF_Client_Updater( $client );

No additional configuration is needed. The updater reads the product slug, API URL, and plugin file from the WPLF_Client instance.

WordPress hooks

The updater registers two filters:

• pre_set_site_transient_update_plugins -- Injects update data into the WordPress update transient when a newer version is available on the server.
• plugins_api -- Provides detailed plugin information (changelog, banners, icons) for the WordPress update modal.

Hash verification

Every package download is verified against a SHA-256 hash provided by the server. If the downloaded file's hash does not match the expected value, the update is aborted and the file is discarded. See Auto-Updates for the full verification flow.

Inactive license badge

When the license is not active, the updater adds a "Licence: Inactive" badge to the plugin's row on the Plugins page. This provides a visible reminder without blocking the plugin's normal operation.

Complete initialization example

Below is a complete example for a plugin called "AcmeForms Pro". This would typically live in the plugin's main PHP file.

<?php
/**
 * Plugin Name: AcmeForms Pro
 * Version:     2.4.1
 * Description: Advanced form builder with conditional logic.
 * Author:      Acme Corp
 * Requires PHP: 7.4
 */

defined( 'ABSPATH' ) || exit;

// ------------------------------------------------------------------
// 1. Include the LicenceForge client files
// ------------------------------------------------------------------
require_once __DIR__ . '/includes/class-wplf-client.php';
require_once __DIR__ . '/includes/class-wplf-client-admin.php';
require_once __DIR__ . '/includes/class-wplf-client-updater.php';

// ------------------------------------------------------------------
// 2. Initialize the client with array configuration
// ------------------------------------------------------------------
$acme_client = new WPLF_Client( [
    'product_slug'   => 'acmeforms-pro',
    'api_url'        => 'https://licences.acmecorp.com',
    'plugin_file'    => __FILE__,
    'cache_duration' => 3600,
    'api_key'        => 'lf_pk_acme_xxxxxxxxxxxx',
] );

// ------------------------------------------------------------------
// 3. Initialize the admin page with branding
// ------------------------------------------------------------------
$acme_admin = new WPLF_Client_Admin( $acme_client, [
    'page_title'  => 'AcmeForms Pro Licence',
    'menu_title'  => 'Licence',
    'menu_slug'   => 'acmeforms-licence',
    'parent_slug' => 'acmeforms-settings',
    'brand_name'  => 'Acme Corp',
    'brand_color' => '#2563EB',
    'brand_logo'  => plugins_url( 'assets/acme-logo.svg', __FILE__ ),
] );

// ------------------------------------------------------------------
// 4. Initialize the updater
// ------------------------------------------------------------------
$acme_updater = new WPLF_Client_Updater( $acme_client );

// ------------------------------------------------------------------
// 5. Gate features based on license tier
// ------------------------------------------------------------------
function acmeforms_has_conditional_logic() {
    global $acme_client;
    return $acme_client->has_feature( 'conditional-logic' );
}

function acmeforms_has_payment_fields() {
    global $acme_client;
    return $acme_client->has_feature( 'payment-fields' );
}

Theme integration

The 3-class system works with themes as well as plugins. Pass the theme's functions.php path as $plugin_file and set parent_slug to "themes.php" to place the license page under the Appearance menu:

// In functions.php of your theme
require_once get_template_directory() . '/includes/class-wplf-client.php';
require_once get_template_directory() . '/includes/class-wplf-client-admin.php';
require_once get_template_directory() . '/includes/class-wplf-client-updater.php';

$theme_client = new WPLF_Client( 'my-theme', 'https://licences.example.com', __FILE__ );

$theme_admin = new WPLF_Client_Admin( $theme_client, [
    'page_title'  => 'Theme Licence',
    'parent_slug' => 'themes.php',
] );

$theme_updater = new WPLF_Client_Updater( $theme_client );

Next steps

• Feature Checking -- Gate functionality based on tier and trial status
• Auto-Updates -- Understand the update delivery and verification pipeline
• Hooks and Filters -- Customise client behaviour with actions and filters