Katsushi Kawamori

<p>Generate a license key to in WooCommerce product for web services.</p>
<h4>REST API</h4>
<ul>
<li>When an order is placed, it encrypts the customer’s license key and outputs it as a REST API. When it expires, it is gone.</li>
</ul>
<h4>Issue a license key</h4>
<ul>
<li>To activate the license key, you need code to client side.</li>
</ul>
<h4>Cooperation with other plugins</h4>
<ul>
<li>Work with <a href="https://wordpress.org/plugins/woocommerce/" rel="ugc">WooCommerce</a>.</li>
</ul>


Simple License Key for WooCommerce

Generate a license key to in WooCommerce product for web services.

junaidbhatti

<p><strong>JB License Manager for WooCommerce</strong> turns your WordPress + WooCommerce site into a complete software licensing server. Sell plugins, themes, SaaS tools, or any digital product and automatically deliver encrypted license keys, control which domains can use each license, and revoke access instantly — all from your own WordPress dashboard.</p>
<h3>🔑 Core Licensing</h3>
<ul>
<li><strong>Automatic key generation</strong> — cryptographically random keys with customizable prefix (e.g. <code>MYAPP-XXXXXX-XXXXXX-XXXXXX</code>)</li>
<li><strong>WooCommerce auto-delivery</strong> — license key is emailed to the customer the moment an order is completed, processing, or payment confirmed</li>
<li><strong>Multi-domain activation</strong> — each license can allow 1 to unlimited domains (configured per product)</li>
<li><strong>Domain allow / disallow</strong> — admin or customer can block a specific domain without revoking the whole license</li>
<li><strong>Instant remote deactivation</strong> — when a domain is disallowed, the client plugin detects it within 15 seconds via WordPress Heartbeat and immediately locks premium features — no click required on the client site</li>
<li><strong>Expiry by months or years</strong> — set 1 Month, 3 Months, 6 Months, 1 Year, 2 Years, or any duration (1–120 months / 1–10 years)</li>
<li><strong>Status management</strong> — Active, Inactive, Suspended, Expired, Revoked</li>
<li><strong>Automatic expiry</strong> — daily cron marks licenses expired and sends reminder emails</li>
<li><strong>Domain-level encryption</strong> — activated domain names are hashed and never stored in plain text</li>
</ul>
<h3>🛒 WooCommerce Integration</h3>
<ul>
<li>Dedicated <strong>License</strong> product tab — enable licensing per product with one click</li>
<li>Set <strong>max domains</strong>, <strong>validity period</strong>, and <strong>key prefix</strong> per product</li>
<li>Auto-fill license settings from product when creating a manual license</li>
<li>License key shown on the <strong>order details page</strong> inside WooCommerce</li>
<li><strong>My Account <span aria-hidden="true" class="wp-exclude-emoji">→</span> Licenses</strong> — full customer portal with all purchased licenses</li>
<li>Customer can <strong>view</strong>, <strong>copy</strong>, and <strong>allow/disallow</strong> their own domains without contacting support</li>
<li>Per-domain popup card showing activation date, last validated time, and IP address</li>
</ul>
<h3>🌐 REST API</h3>
<p>Full public and admin REST API at <code>/wp-json/jblm/v1/</code>:</p>
<p><strong>Public endpoints (license key authentication):</strong></p>
<ul>
<li><code>POST /activate</code> — register a domain against a license key</li>
<li><code>POST /validate</code> — verify a license key + domain (12-hour cached on client)</li>
<li><code>POST /deactivate</code> — release a domain slot</li>
<li><code>POST /status</code> — lightweight heartbeat check (does not update last_validated)</li>
</ul>
<p><strong>Admin endpoints (API key or logged-in admin):</strong></p>
<ul>
<li><code>GET /licenses</code> — list all licenses with pagination, search, status filter</li>
<li><code>POST /licenses</code> — create a license programmatically</li>
<li><code>GET /licenses/{id}</code> — get single license with activations</li>
<li><code>PUT /licenses/{id}</code> — update status, max_domains, expiry</li>
<li><code>DELETE /licenses/{id}</code> — revoke a license</li>
<li><code>GET /licenses/{id}/activations</code> — list all domain activations</li>
<li><code>GET /stats</code> — dashboard stats (total, active, expired, expiring, revoked)</li>
</ul>
<h3>📊 Admin Dashboard</h3>
<ul>
<li><strong>Stats cards</strong> — Total / Active / Expiring Soon / Expired / Revoked at a glance</li>
<li><strong>Filterable table</strong> — search by email or key, filter by status</li>
<li><strong>Click-to-copy</strong> license keys</li>
<li><strong>View Sites popup modal</strong> — see all activated domains per license, allow/disallow with one click, quick status change</li>
<li><strong>Domain progress bar</strong> — visual fill showing slots used vs. available</li>
<li><strong>Expiry countdown</strong> — “14d left” shown in amber when expiring soon</li>
<li><strong>Activity Logs page</strong> — last 500 events with time, license key, action, domain, IP, and result</li>
<li><strong>Settings page</strong> — key prefix, expiry reminder days, email from name/address, email subject and template, REST API key</li>
</ul>
<h3>✉️ Email Notifications</h3>
<ul>
<li><strong>License delivery email</strong> — sent automatically on WooCommerce order completion</li>
<li><strong>Expiry reminder email</strong> — sent N days before expiry (configurable)</li>
<li><strong>Status change email</strong> — sent when license is suspended or revoked</li>
<li>Fully customizable HTML template with placeholder tags: <code>{license_key}</code>, <code>{expires_at}</code>, <code>{max_domains}</code>, <code>{order_id}</code>, <code>{customer_email}</code>, <code>{site_name}</code>, <code>{site_url}</code></li>
</ul>
<h3>📤 CSV Export / Import</h3>
<ul>
<li>Export all or filtered licenses to CSV with one click</li>
<li>CSV includes: ID, License Key, Customer Email, Status, Max Domains, Active Domains, Expiry, Order ID, Product ID, Created At, Active Domain URLs</li>
<li>Bulk import licenses from CSV — only <code>customer_email</code> required; other columns optional</li>
<li>Drag-and-drop upload zone in admin</li>
<li>Duplicate keys automatically skipped on import with per-row error reporting</li>
</ul>
<h3>🔒 Security</h3>
<ul>
<li>All domain names stored as <strong>SHA-256 hashes</strong> — even database access cannot reveal which domains are activated</li>
<li>Encryption secret key auto-generated on activation and stored securely in the database. Optionally define <code>JBLM_SECRET_KEY</code> in wp-config.php to use a custom value</li>
<li>All AJAX handlers protected with <code>wp_nonce</code> and <code>current_user_can()</code> checks</li>
<li>All API inputs sanitized with <code>sanitize_text_field()</code>, <code>sanitize_email()</code>, <code>intval()</code></li>
<li>All outputs escaped with <code>esc_html()</code>, <code>esc_attr()</code>, <code>esc_url()</code></li>
<li>All database queries use <code>$wpdb->prepare()</code> with parameterized placeholders</li>
</ul>
<h3>📦 Client SDK</h3>
<p>Include the bundled <code>jblm-client.php</code> in your plugin or theme:</p>
<p>See Sample Plugin<br />
    <?php<br />
    /**<br />
     * Plugin Name: Your Plugin Name<br />
     * Version: 1.0.0<br />
     */</p>
<pre><code>// ============================================================
// STEP 1 — Load the license client
// Copy jblm-client.php into your plugin folder, then include it.
// ============================================================
require_once plugin_dir_path( __FILE__ ) . 'jblm-client.php';


// ============================================================
// STEP 2 — Set up your license
// Replace the two values below:
//   - 'https://yoursite.com'  <span aria-hidden="true" class="wp-exclude-emoji">→</span> the site where you installed JB License Manager
//   - 'your-plugin-slug'      <span aria-hidden="true" class="wp-exclude-emoji">→</span> any unique name for your plugin (no spaces)
// ============================================================
$license = new JBLM_Client(
    'https://yoursite.com',   // <span aria-hidden="true" class="wp-exclude-emoji">←</span> CHANGE THIS
    'your-plugin-slug'        // <span aria-hidden="true" class="wp-exclude-emoji">←</span> CHANGE THIS  e.g. 'my-seo-plugin'
);


// ============================================================
// STEP 3 — Register AJAX (required for Activate/Deactivate buttons)
// Just copy this line as-is. Don't change anything.
// ============================================================
add_action( 'plugins_loaded', function() use ( $license ) {
    $license->register_ajax_hooks();
});


// ============================================================
// STEP 4 — Block your premium features if license is not active
// Put this check at the top of any function that has premium code.
// If the license is invalid, the function will stop here.
// ============================================================
function my_premium_feature() {
    global $license;

    if ( ! $license->is_valid() ) {
        return; // <span aria-hidden="true" class="wp-exclude-emoji">←</span> stops here if no valid license
    }

    // Your premium code goes below this line <span aria-hidden="true" class="wp-exclude-emoji">↓</span>
    echo 'Premium feature is running!';
}


// ============================================================
// STEP 5 — Show the License Key field on your settings page
// Call this inside the function that renders your settings page.
// It will show an input box + Activate / Deactivate buttons.
// ============================================================
function my_plugin_settings_page() {
    global $license;

    echo '<h1>My Plugin Settings</h1>';

    // This one line draws the full license box — input + buttons
    $license->render_settings_field();

    // ... rest of your settings fields
}
</code></pre>
<p>The SDK handles:<br />
* License activation, validation (12 h cache), deactivation<br />
* WordPress Heartbeat integration for instant deactivation — no click needed<br />
* Built-in settings page with Activate / Check Status / Deactivate buttons<br />
* Friendly Urdu/English error messages for common failure cases</p>
<h3>⚡ Performance</h3>
<ul>
<li>License validation results cached as WordPress transients (12 hours by default)</li>
<li>Heartbeat status check (<code>/status</code>) does not write to the database — read-only</li>
<li>Index on <code>license_key</code>, <code>domain_hash</code>, <code>user_id</code>, <code>status</code>, and <code>created_at</code> columns</li>
<li>WooCommerce integration only loads when WooCommerce is active</li>
</ul>
<h3>Privacy Policy</h3>
<p>JB License Manager for WooCommerce stores the following data in your WordPress database:</p>
<ul>
<li><strong>License keys</strong> (hashed) and associated customer email addresses</li>
<li><strong>Domain names</strong> (stored as SHA-256 hashes — not in plain text)</li>
<li><strong>IP addresses</strong> of activation and validation requests</li>
<li><strong>Timestamps</strong> of all license events</li>
</ul>
<p>This data is stored solely on your own WordPress server. No data is transmitted to any third-party service by this plugin.</p>
<p><strong>External connections:</strong> Client sites that use the bundled SDK connect to your WordPress store URL to activate, validate, and check license status. This is a direct connection between two sites you control.</p>
<p>If you collect or process personal data (such as customer email addresses), ensure your site has an appropriate privacy policy as required by GDPR, CCPA, or your local regulations.</p>
<h3>Developer SDK</h3>
<p>The client-side SDK (for your own plugins/themes to validate licenses against this server) is available as a <strong>separate download</strong> from the plugin’s GitHub page. It is NOT included in the WordPress.org version of this plugin.</p>
<p>The WordPress.org version of this plugin is the <strong>license server</strong> — it stores and manages licenses. It does not lock any features behind a license check.</p>


JB License Manager for WooCommerce

Sell software licenses via WooCommerce. Auto-deliver keys, multi-domain activation, instant deactivation, REST API, and My Account license page.

Simple License Key for WooCommerce vs JB License Manager for WooCommerce