You've already forked wc-licensed-product
Add dashboard widget and auto-expire license cron (v0.3.5)
- Add admin dashboard widget with license statistics - Add daily wp-cron to auto-expire licenses past expiration date - Add LicenseExpiredEmail notification for expired licenses - Add getExpiredActiveLicenses() and autoExpireLicense() to LicenseManager Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
12
CHANGELOG.md
12
CHANGELOG.md
@@ -9,6 +9,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
## [0.3.5] - 2026-01-23
|
## [0.3.5] - 2026-01-23
|
||||||
|
|
||||||
|
### Added
|
||||||
|
|
||||||
|
- Admin dashboard widget showing license statistics on WordPress dashboard
|
||||||
|
- Automatic license expiration via daily wp-cron job
|
||||||
|
- License expired email notification sent when license auto-expires
|
||||||
|
- New `LicenseExpiredEmail` WooCommerce email class (configurable via WooCommerce > Settings > Emails)
|
||||||
|
|
||||||
### Changed
|
### Changed
|
||||||
|
|
||||||
- Improved download list layout in customer account licenses page
|
- Improved download list layout in customer account licenses page
|
||||||
@@ -17,6 +24,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
### Technical Details
|
### Technical Details
|
||||||
|
|
||||||
|
- New `DashboardWidgetController` class in `src/Admin/` for WordPress dashboard widget
|
||||||
|
- Widget displays: total licenses, active, expiring soon, expired counts, status breakdown, license types
|
||||||
|
- New `LicenseExpiredEmail` class in `src/Email/` for expired license notifications
|
||||||
|
- Added `getExpiredActiveLicenses()` and `autoExpireLicense()` methods to `LicenseManager`
|
||||||
|
- Daily cron now auto-expires licenses with past expiration date and sends notification emails
|
||||||
- Updated `templates/frontend/licenses.html.twig` with new two-row structure
|
- Updated `templates/frontend/licenses.html.twig` with new two-row structure
|
||||||
- Added `.download-item`, `.download-row-file`, `.download-row-meta` CSS classes
|
- Added `.download-item`, `.download-row-file`, `.download-row-meta` CSS classes
|
||||||
- Improved responsive behavior for download metadata
|
- Improved responsive behavior for download metadata
|
||||||
|
|||||||
38
CLAUDE.md
38
CLAUDE.md
@@ -36,6 +36,10 @@ This project is proudly **"vibe-coded"** using Claude.AI - the entire codebase w
|
|||||||
|
|
||||||
No known bugs at the moment.
|
No known bugs at the moment.
|
||||||
|
|
||||||
|
### Version 0.4.0
|
||||||
|
|
||||||
|
- On first plugin activation, get the checksums of all security related files (at least in `src/`) as hashes, store them encrypted on the server and add a mechanism to check the integrity of the files and the license validity periodically, control via wp-cron.
|
||||||
|
|
||||||
## Technical Stack
|
## Technical Stack
|
||||||
|
|
||||||
- **Language:** PHP 8.3.x
|
- **Language:** PHP 8.3.x
|
||||||
@@ -933,26 +937,40 @@ Added current version display on single product pages for licensed products.
|
|||||||
- Only displays if product has at least one version defined
|
- Only displays if product has at least one version defined
|
||||||
- Uses `LicensedProduct::get_current_version()` which queries `VersionManager::getLatestVersion()`
|
- Uses `LicensedProduct::get_current_version()` which queries `VersionManager::getLatestVersion()`
|
||||||
|
|
||||||
### 2026-01-23 - Version 0.3.5 - Download List UI Improvement
|
### 2026-01-23 - Version 0.3.5 - Dashboard Widget & Auto-Expire
|
||||||
|
|
||||||
**Overview:**
|
**Overview:**
|
||||||
|
|
||||||
Improved the download list layout in customer account licenses page with a two-row format.
|
Added admin dashboard widget for license statistics and automatic license expiration via daily cron job.
|
||||||
|
|
||||||
**Implemented:**
|
**Implemented:**
|
||||||
|
|
||||||
- Downloads now displayed in two rows per entry
|
- Admin dashboard widget showing license statistics (total, active, expiring soon, expired)
|
||||||
- First row: File download link
|
- Status breakdown display with color-coded badges
|
||||||
- Second row: Metadata (version, date, checksum)
|
- License type breakdown (time-limited vs lifetime)
|
||||||
- Better visual separation and readability
|
- Daily wp-cron job to auto-expire licenses past their expiration date
|
||||||
|
- License expired email notification sent when license auto-expires
|
||||||
|
- Downloads in customer account now displayed in two-row format
|
||||||
|
|
||||||
|
**New files:**
|
||||||
|
|
||||||
|
- `src/Admin/DashboardWidgetController.php` - WordPress dashboard widget controller
|
||||||
|
- `src/Email/LicenseExpiredEmail.php` - WooCommerce email for expired license notifications
|
||||||
|
|
||||||
**Modified files:**
|
**Modified files:**
|
||||||
|
|
||||||
|
- `src/Plugin.php` - Added DashboardWidgetController instantiation
|
||||||
|
- `src/License/LicenseManager.php` - Added `getExpiredActiveLicenses()` and `autoExpireLicense()` methods
|
||||||
|
- `src/Email/LicenseEmailController.php` - Added auto-expire logic and LicenseExpiredEmail registration
|
||||||
- `templates/frontend/licenses.html.twig` - Restructured download list with two-row layout
|
- `templates/frontend/licenses.html.twig` - Restructured download list with two-row layout
|
||||||
- `assets/css/frontend.css` - Added `.download-item`, `.download-row-file`, `.download-row-meta` styles
|
- `assets/css/frontend.css` - Added dashboard widget and download list styles
|
||||||
|
|
||||||
**Technical notes:**
|
**Technical notes:**
|
||||||
|
|
||||||
- Changed `<li>` from single-row flex to column flex layout
|
- Dashboard widget uses `wp_add_dashboard_widget()` hook, requires `manage_woocommerce` capability
|
||||||
- Metadata row indented with left padding for visual hierarchy
|
- Widget displays statistics from existing `LicenseManager::getStatistics()` method
|
||||||
- Updated responsive CSS for mobile devices
|
- Auto-expire runs during daily `wclp_check_expiring_licenses` cron event
|
||||||
|
- `getExpiredActiveLicenses()` finds licenses with past expiration date but still active status
|
||||||
|
- `autoExpireLicense()` updates status to expired and returns true if changed
|
||||||
|
- LicenseExpiredEmail follows same pattern as LicenseExpirationEmail (warning vs expired)
|
||||||
|
- Expired notification tracked via user meta to prevent duplicate emails
|
||||||
|
|||||||
225
src/Admin/DashboardWidgetController.php
Normal file
225
src/Admin/DashboardWidgetController.php
Normal file
@@ -0,0 +1,225 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Dashboard Widget Controller
|
||||||
|
*
|
||||||
|
* @package Jeremias\WcLicensedProduct\Admin
|
||||||
|
*/
|
||||||
|
|
||||||
|
declare(strict_types=1);
|
||||||
|
|
||||||
|
namespace Jeremias\WcLicensedProduct\Admin;
|
||||||
|
|
||||||
|
use Jeremias\WcLicensedProduct\License\License;
|
||||||
|
use Jeremias\WcLicensedProduct\License\LicenseManager;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Handles the WordPress admin dashboard widget for license statistics
|
||||||
|
*/
|
||||||
|
final class DashboardWidgetController
|
||||||
|
{
|
||||||
|
private LicenseManager $licenseManager;
|
||||||
|
|
||||||
|
public function __construct(LicenseManager $licenseManager)
|
||||||
|
{
|
||||||
|
$this->licenseManager = $licenseManager;
|
||||||
|
$this->registerHooks();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register WordPress hooks
|
||||||
|
*/
|
||||||
|
private function registerHooks(): void
|
||||||
|
{
|
||||||
|
add_action('wp_dashboard_setup', [$this, 'registerDashboardWidget']);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register the dashboard widget
|
||||||
|
*/
|
||||||
|
public function registerDashboardWidget(): void
|
||||||
|
{
|
||||||
|
if (!current_user_can('manage_woocommerce')) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
wp_add_dashboard_widget(
|
||||||
|
'wclp_license_statistics',
|
||||||
|
__('License Statistics', 'wc-licensed-product'),
|
||||||
|
[$this, 'renderWidget']
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Render the dashboard widget content
|
||||||
|
*/
|
||||||
|
public function renderWidget(): void
|
||||||
|
{
|
||||||
|
$stats = $this->licenseManager->getStatistics();
|
||||||
|
$licensesUrl = admin_url('admin.php?page=wc-licensed-product-licenses');
|
||||||
|
?>
|
||||||
|
<style>
|
||||||
|
.wclp-widget-stats {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(2, 1fr);
|
||||||
|
gap: 12px;
|
||||||
|
margin-bottom: 16px;
|
||||||
|
}
|
||||||
|
.wclp-stat-card {
|
||||||
|
background: #f8f9fa;
|
||||||
|
border: 1px solid #e2e4e7;
|
||||||
|
border-radius: 4px;
|
||||||
|
padding: 12px;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
.wclp-stat-card.highlight {
|
||||||
|
border-left: 3px solid #7f54b3;
|
||||||
|
}
|
||||||
|
.wclp-stat-card.warning {
|
||||||
|
border-left: 3px solid #f0b849;
|
||||||
|
}
|
||||||
|
.wclp-stat-card.danger {
|
||||||
|
border-left: 3px solid #dc3232;
|
||||||
|
}
|
||||||
|
.wclp-stat-card.success {
|
||||||
|
border-left: 3px solid #46b450;
|
||||||
|
}
|
||||||
|
.wclp-stat-number {
|
||||||
|
font-size: 28px;
|
||||||
|
font-weight: 600;
|
||||||
|
color: #1d2327;
|
||||||
|
line-height: 1.2;
|
||||||
|
}
|
||||||
|
.wclp-stat-label {
|
||||||
|
font-size: 12px;
|
||||||
|
color: #646970;
|
||||||
|
text-transform: uppercase;
|
||||||
|
letter-spacing: 0.5px;
|
||||||
|
margin-top: 4px;
|
||||||
|
}
|
||||||
|
.wclp-widget-divider {
|
||||||
|
border-top: 1px solid #e2e4e7;
|
||||||
|
margin: 16px 0;
|
||||||
|
}
|
||||||
|
.wclp-status-list {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
.wclp-status-badge {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 4px;
|
||||||
|
padding: 4px 10px;
|
||||||
|
border-radius: 12px;
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 500;
|
||||||
|
}
|
||||||
|
.wclp-status-badge.active {
|
||||||
|
background: #d4edda;
|
||||||
|
color: #155724;
|
||||||
|
}
|
||||||
|
.wclp-status-badge.inactive {
|
||||||
|
background: #e2e3e5;
|
||||||
|
color: #383d41;
|
||||||
|
}
|
||||||
|
.wclp-status-badge.expired {
|
||||||
|
background: #f8d7da;
|
||||||
|
color: #721c24;
|
||||||
|
}
|
||||||
|
.wclp-status-badge.revoked {
|
||||||
|
background: #d6d8db;
|
||||||
|
color: #1b1e21;
|
||||||
|
}
|
||||||
|
.wclp-widget-footer {
|
||||||
|
margin-top: 16px;
|
||||||
|
padding-top: 12px;
|
||||||
|
border-top: 1px solid #e2e4e7;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
.wclp-widget-footer a {
|
||||||
|
text-decoration: none;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
<div class="wclp-widget-stats">
|
||||||
|
<div class="wclp-stat-card highlight">
|
||||||
|
<div class="wclp-stat-number"><?php echo esc_html(number_format_i18n($stats['total'])); ?></div>
|
||||||
|
<div class="wclp-stat-label"><?php esc_html_e('Total Licenses', 'wc-licensed-product'); ?></div>
|
||||||
|
</div>
|
||||||
|
<div class="wclp-stat-card success">
|
||||||
|
<div class="wclp-stat-number"><?php echo esc_html(number_format_i18n($stats['by_status'][License::STATUS_ACTIVE])); ?></div>
|
||||||
|
<div class="wclp-stat-label"><?php esc_html_e('Active', 'wc-licensed-product'); ?></div>
|
||||||
|
</div>
|
||||||
|
<div class="wclp-stat-card warning">
|
||||||
|
<div class="wclp-stat-number"><?php echo esc_html(number_format_i18n($stats['expiring_soon'])); ?></div>
|
||||||
|
<div class="wclp-stat-label"><?php esc_html_e('Expiring Soon', 'wc-licensed-product'); ?></div>
|
||||||
|
</div>
|
||||||
|
<div class="wclp-stat-card danger">
|
||||||
|
<div class="wclp-stat-number"><?php echo esc_html(number_format_i18n($stats['by_status'][License::STATUS_EXPIRED])); ?></div>
|
||||||
|
<div class="wclp-stat-label"><?php esc_html_e('Expired', 'wc-licensed-product'); ?></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="wclp-widget-divider"></div>
|
||||||
|
|
||||||
|
<h4 style="margin: 0 0 8px 0; font-size: 13px; color: #1d2327;">
|
||||||
|
<?php esc_html_e('Status Breakdown', 'wc-licensed-product'); ?>
|
||||||
|
</h4>
|
||||||
|
<div class="wclp-status-list">
|
||||||
|
<span class="wclp-status-badge active">
|
||||||
|
<span class="dashicons dashicons-yes-alt" style="font-size: 14px; width: 14px; height: 14px;"></span>
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Active: %d', 'wc-licensed-product'),
|
||||||
|
$stats['by_status'][License::STATUS_ACTIVE]
|
||||||
|
); ?>
|
||||||
|
</span>
|
||||||
|
<span class="wclp-status-badge inactive">
|
||||||
|
<span class="dashicons dashicons-marker" style="font-size: 14px; width: 14px; height: 14px;"></span>
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Inactive: %d', 'wc-licensed-product'),
|
||||||
|
$stats['by_status'][License::STATUS_INACTIVE]
|
||||||
|
); ?>
|
||||||
|
</span>
|
||||||
|
<span class="wclp-status-badge expired">
|
||||||
|
<span class="dashicons dashicons-clock" style="font-size: 14px; width: 14px; height: 14px;"></span>
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Expired: %d', 'wc-licensed-product'),
|
||||||
|
$stats['by_status'][License::STATUS_EXPIRED]
|
||||||
|
); ?>
|
||||||
|
</span>
|
||||||
|
<span class="wclp-status-badge revoked">
|
||||||
|
<span class="dashicons dashicons-dismiss" style="font-size: 14px; width: 14px; height: 14px;"></span>
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Revoked: %d', 'wc-licensed-product'),
|
||||||
|
$stats['by_status'][License::STATUS_REVOKED]
|
||||||
|
); ?>
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="wclp-widget-divider"></div>
|
||||||
|
|
||||||
|
<h4 style="margin: 0 0 8px 0; font-size: 13px; color: #1d2327;">
|
||||||
|
<?php esc_html_e('License Types', 'wc-licensed-product'); ?>
|
||||||
|
</h4>
|
||||||
|
<p style="margin: 0; font-size: 13px; color: #646970;">
|
||||||
|
<span class="dashicons dashicons-calendar-alt" style="font-size: 14px; width: 14px; height: 14px; vertical-align: text-bottom;"></span>
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Time-limited: %d', 'wc-licensed-product'),
|
||||||
|
$stats['expiring']
|
||||||
|
); ?>
|
||||||
|
|
|
||||||
|
<span class="dashicons dashicons-infinity" style="font-size: 14px; width: 14px; height: 14px; vertical-align: text-bottom;"></span>
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Lifetime: %d', 'wc-licensed-product'),
|
||||||
|
$stats['lifetime']
|
||||||
|
); ?>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<div class="wclp-widget-footer">
|
||||||
|
<a href="<?php echo esc_url($licensesUrl); ?>" class="button button-secondary">
|
||||||
|
<?php esc_html_e('View All Licenses', 'wc-licensed-product'); ?>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<?php
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -55,6 +55,7 @@ final class LicenseEmailController
|
|||||||
public function registerEmailClasses(array $email_classes): array
|
public function registerEmailClasses(array $email_classes): array
|
||||||
{
|
{
|
||||||
$email_classes['WCLP_License_Expiration'] = new LicenseExpirationEmail();
|
$email_classes['WCLP_License_Expiration'] = new LicenseExpirationEmail();
|
||||||
|
$email_classes['WCLP_License_Expired'] = new LicenseExpiredEmail();
|
||||||
return $email_classes;
|
return $email_classes;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -69,10 +70,13 @@ final class LicenseEmailController
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Send expiration warning emails
|
* Send expiration warning emails and auto-expire licenses
|
||||||
*/
|
*/
|
||||||
public function sendExpirationWarnings(): void
|
public function sendExpirationWarnings(): void
|
||||||
{
|
{
|
||||||
|
// First, auto-expire licenses that have passed their expiration date
|
||||||
|
$this->autoExpireAndNotify();
|
||||||
|
|
||||||
// Check if expiration emails are enabled in settings
|
// Check if expiration emails are enabled in settings
|
||||||
if (!SettingsController::isExpirationEmailsEnabled()) {
|
if (!SettingsController::isExpirationEmailsEnabled()) {
|
||||||
return;
|
return;
|
||||||
@@ -107,6 +111,41 @@ final class LicenseEmailController
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Auto-expire licenses and send expired notifications
|
||||||
|
*/
|
||||||
|
private function autoExpireAndNotify(): void
|
||||||
|
{
|
||||||
|
// Get licenses that should be auto-expired
|
||||||
|
$expiredActiveLicenses = $this->licenseManager->getExpiredActiveLicenses();
|
||||||
|
|
||||||
|
if (empty($expiredActiveLicenses)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the WooCommerce email instance for expired notifications
|
||||||
|
$mailer = WC()->mailer();
|
||||||
|
$emails = $mailer->get_emails();
|
||||||
|
|
||||||
|
/** @var LicenseExpiredEmail|null $expiredEmail */
|
||||||
|
$expiredEmail = $emails['WCLP_License_Expired'] ?? null;
|
||||||
|
|
||||||
|
foreach ($expiredActiveLicenses as $license) {
|
||||||
|
// Auto-expire the license
|
||||||
|
$wasExpired = $this->licenseManager->autoExpireLicense($license->getId());
|
||||||
|
|
||||||
|
if ($wasExpired && $expiredEmail && $expiredEmail->is_enabled()) {
|
||||||
|
// Check if we haven't already sent an expired notification
|
||||||
|
if (!$this->licenseManager->wasExpirationNotified($license->getId(), 'license_expired')) {
|
||||||
|
// Send expired notification email
|
||||||
|
if ($expiredEmail->trigger($license)) {
|
||||||
|
$this->licenseManager->markExpirationNotified($license->getId(), 'license_expired');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Process and send expiration warnings for a specific time frame
|
* Process and send expiration warnings for a specific time frame
|
||||||
*
|
*
|
||||||
|
|||||||
335
src/Email/LicenseExpiredEmail.php
Normal file
335
src/Email/LicenseExpiredEmail.php
Normal file
@@ -0,0 +1,335 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* License Expired Email
|
||||||
|
*
|
||||||
|
* @package Jeremias\WcLicensedProduct\Email
|
||||||
|
*/
|
||||||
|
|
||||||
|
declare(strict_types=1);
|
||||||
|
|
||||||
|
namespace Jeremias\WcLicensedProduct\Email;
|
||||||
|
|
||||||
|
use Jeremias\WcLicensedProduct\License\License;
|
||||||
|
use WC_Email;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* License Expired Email class
|
||||||
|
*
|
||||||
|
* Sends email notifications to customers when their licenses have expired.
|
||||||
|
* Uses WooCommerce's transactional email system for consistent styling and customization.
|
||||||
|
*/
|
||||||
|
class LicenseExpiredEmail extends WC_Email
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* License object
|
||||||
|
*/
|
||||||
|
public ?License $license = null;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Product name
|
||||||
|
*/
|
||||||
|
public string $product_name = '';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Expiration date formatted
|
||||||
|
*/
|
||||||
|
public string $expiration_date = '';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Customer display name
|
||||||
|
*/
|
||||||
|
public string $customer_name = '';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructor
|
||||||
|
*/
|
||||||
|
public function __construct()
|
||||||
|
{
|
||||||
|
$this->id = 'wclp_license_expired';
|
||||||
|
$this->customer_email = true;
|
||||||
|
$this->title = __('License Expired', 'wc-licensed-product');
|
||||||
|
$this->description = __('License expired emails are sent to customers when their licenses have expired.', 'wc-licensed-product');
|
||||||
|
|
||||||
|
$this->placeholders = [
|
||||||
|
'{site_title}' => $this->get_blogname(),
|
||||||
|
'{product_name}' => '',
|
||||||
|
'{expiration_date}' => '',
|
||||||
|
];
|
||||||
|
|
||||||
|
// Call parent constructor
|
||||||
|
parent::__construct();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get email subject
|
||||||
|
*/
|
||||||
|
public function get_default_subject(): string
|
||||||
|
{
|
||||||
|
return __('[{site_title}] Your license for {product_name} has expired', 'wc-licensed-product');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get email heading
|
||||||
|
*/
|
||||||
|
public function get_default_heading(): string
|
||||||
|
{
|
||||||
|
return __('License Expired', 'wc-licensed-product');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Trigger the email
|
||||||
|
*
|
||||||
|
* @param License $license License object
|
||||||
|
*/
|
||||||
|
public function trigger(License $license): bool
|
||||||
|
{
|
||||||
|
$this->setup_locale();
|
||||||
|
|
||||||
|
$customer = get_userdata($license->getCustomerId());
|
||||||
|
if (!$customer || !$customer->user_email) {
|
||||||
|
$this->restore_locale();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
$this->license = $license;
|
||||||
|
$this->recipient = $customer->user_email;
|
||||||
|
$this->customer_name = $customer->display_name ?: __('Customer', 'wc-licensed-product');
|
||||||
|
|
||||||
|
$product = wc_get_product($license->getProductId());
|
||||||
|
$this->product_name = $product ? $product->get_name() : __('Unknown Product', 'wc-licensed-product');
|
||||||
|
|
||||||
|
$expiresAt = $license->getExpiresAt();
|
||||||
|
$this->expiration_date = $expiresAt ? $expiresAt->format(get_option('date_format')) : '';
|
||||||
|
|
||||||
|
// Update placeholders
|
||||||
|
$this->placeholders['{product_name}'] = $this->product_name;
|
||||||
|
$this->placeholders['{expiration_date}'] = $this->expiration_date;
|
||||||
|
|
||||||
|
if (!$this->is_enabled() || !$this->get_recipient()) {
|
||||||
|
$this->restore_locale();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
$result = $this->send(
|
||||||
|
$this->get_recipient(),
|
||||||
|
$this->get_subject(),
|
||||||
|
$this->get_content(),
|
||||||
|
$this->get_headers(),
|
||||||
|
$this->get_attachments()
|
||||||
|
);
|
||||||
|
|
||||||
|
$this->restore_locale();
|
||||||
|
|
||||||
|
return $result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get content HTML
|
||||||
|
*/
|
||||||
|
public function get_content_html(): string
|
||||||
|
{
|
||||||
|
ob_start();
|
||||||
|
|
||||||
|
// Use WooCommerce's email header
|
||||||
|
wc_get_template('emails/email-header.php', ['email_heading' => $this->get_heading()]);
|
||||||
|
|
||||||
|
$this->render_email_body_html();
|
||||||
|
|
||||||
|
// Use WooCommerce's email footer
|
||||||
|
wc_get_template('emails/email-footer.php', ['email' => $this]);
|
||||||
|
|
||||||
|
return ob_get_clean();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get content plain text
|
||||||
|
*/
|
||||||
|
public function get_content_plain(): string
|
||||||
|
{
|
||||||
|
ob_start();
|
||||||
|
|
||||||
|
echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n";
|
||||||
|
echo esc_html(wp_strip_all_tags($this->get_heading()));
|
||||||
|
echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n";
|
||||||
|
|
||||||
|
$this->render_email_body_plain();
|
||||||
|
|
||||||
|
return ob_get_clean();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Render HTML email body content
|
||||||
|
*/
|
||||||
|
private function render_email_body_html(): void
|
||||||
|
{
|
||||||
|
$account_url = wc_get_account_endpoint_url('licenses');
|
||||||
|
?>
|
||||||
|
<p><?php printf(esc_html__('Hello %s,', 'wc-licensed-product'), esc_html($this->customer_name)); ?></p>
|
||||||
|
|
||||||
|
<p style="color: #dc3232; font-weight: 600;">
|
||||||
|
<?php printf(
|
||||||
|
esc_html__('Your license for %1$s has expired on %2$s.', 'wc-licensed-product'),
|
||||||
|
'<strong>' . esc_html($this->product_name) . '</strong>',
|
||||||
|
esc_html($this->expiration_date)
|
||||||
|
); ?>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<?php esc_html_e('Your license is no longer valid and the product will stop working until you renew.', 'wc-licensed-product'); ?>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h2><?php esc_html_e('Expired License Details', 'wc-licensed-product'); ?></h2>
|
||||||
|
|
||||||
|
<div style="margin-bottom: 40px;">
|
||||||
|
<table class="td" cellspacing="0" cellpadding="6" style="width: 100%; font-family: 'Helvetica Neue', Helvetica, Roboto, Arial, sans-serif;" border="1">
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<th class="td" scope="row" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php esc_html_e('Product:', 'wc-licensed-product'); ?></th>
|
||||||
|
<td class="td" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php echo esc_html($this->product_name); ?></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th class="td" scope="row" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php esc_html_e('License Key:', 'wc-licensed-product'); ?></th>
|
||||||
|
<td class="td" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;">
|
||||||
|
<code style="background: #f5f5f5; padding: 3px 8px; border-radius: 3px; font-family: monospace;">
|
||||||
|
<?php echo esc_html($this->license->getLicenseKey()); ?>
|
||||||
|
</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th class="td" scope="row" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php esc_html_e('Domain:', 'wc-licensed-product'); ?></th>
|
||||||
|
<td class="td" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php echo esc_html($this->license->getDomain()); ?></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th class="td" scope="row" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php esc_html_e('Expired on:', 'wc-licensed-product'); ?></th>
|
||||||
|
<td class="td" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>; color: #dc3232; font-weight: 600;"><?php echo esc_html($this->expiration_date); ?></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<th class="td" scope="row" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;"><?php esc_html_e('Status:', 'wc-licensed-product'); ?></th>
|
||||||
|
<td class="td" style="text-align:<?php echo is_rtl() ? 'right' : 'left'; ?>;">
|
||||||
|
<span style="background: #f8d7da; color: #721c24; padding: 3px 10px; border-radius: 12px; font-size: 12px; font-weight: 500;">
|
||||||
|
<?php esc_html_e('Expired', 'wc-licensed-product'); ?>
|
||||||
|
</span>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<?php
|
||||||
|
$additional_content = $this->get_additional_content();
|
||||||
|
if ($additional_content) :
|
||||||
|
?>
|
||||||
|
<p><?php echo wp_kses_post($additional_content); ?></p>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<p style="margin-top: 25px;">
|
||||||
|
<a href="<?php echo esc_url($account_url); ?>" class="button" style="display: inline-block; background-color: #7f54b3; color: #ffffff; padding: 12px 24px; text-decoration: none; border-radius: 4px; font-weight: 600;">
|
||||||
|
<?php esc_html_e('View My Licenses', 'wc-licensed-product'); ?>
|
||||||
|
</a>
|
||||||
|
</p>
|
||||||
|
<?php
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Render plain text email body content
|
||||||
|
*/
|
||||||
|
private function render_email_body_plain(): void
|
||||||
|
{
|
||||||
|
printf(esc_html__('Hello %s,', 'wc-licensed-product'), esc_html($this->customer_name));
|
||||||
|
echo "\n\n";
|
||||||
|
|
||||||
|
printf(
|
||||||
|
esc_html__('Your license for %1$s has expired on %2$s.', 'wc-licensed-product'),
|
||||||
|
esc_html($this->product_name),
|
||||||
|
esc_html($this->expiration_date)
|
||||||
|
);
|
||||||
|
echo "\n\n";
|
||||||
|
|
||||||
|
echo esc_html__('Your license is no longer valid and the product will stop working until you renew.', 'wc-licensed-product');
|
||||||
|
echo "\n\n";
|
||||||
|
|
||||||
|
echo "----------\n";
|
||||||
|
echo esc_html__('Expired License Details', 'wc-licensed-product') . "\n";
|
||||||
|
echo "----------\n\n";
|
||||||
|
|
||||||
|
echo esc_html__('Product:', 'wc-licensed-product') . ' ' . esc_html($this->product_name) . "\n";
|
||||||
|
echo esc_html__('License Key:', 'wc-licensed-product') . ' ' . esc_html($this->license->getLicenseKey()) . "\n";
|
||||||
|
echo esc_html__('Domain:', 'wc-licensed-product') . ' ' . esc_html($this->license->getDomain()) . "\n";
|
||||||
|
echo esc_html__('Expired on:', 'wc-licensed-product') . ' ' . esc_html($this->expiration_date) . "\n";
|
||||||
|
echo esc_html__('Status:', 'wc-licensed-product') . ' ' . esc_html__('Expired', 'wc-licensed-product') . "\n\n";
|
||||||
|
|
||||||
|
$additional_content = $this->get_additional_content();
|
||||||
|
if ($additional_content) {
|
||||||
|
echo "----------\n\n";
|
||||||
|
echo esc_html(wp_strip_all_tags(wptexturize($additional_content)));
|
||||||
|
echo "\n\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
echo esc_html__('View My Licenses', 'wc-licensed-product') . ': ' . esc_url(wc_get_account_endpoint_url('licenses')) . "\n\n";
|
||||||
|
|
||||||
|
echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Default content to show below main email content
|
||||||
|
*/
|
||||||
|
public function get_default_additional_content(): string
|
||||||
|
{
|
||||||
|
return __('To continue using this product, please renew your license.', 'wc-licensed-product');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Initialize settings form fields
|
||||||
|
*/
|
||||||
|
public function init_form_fields(): void
|
||||||
|
{
|
||||||
|
$placeholder_text = sprintf(
|
||||||
|
/* translators: %s: list of placeholders */
|
||||||
|
__('Available placeholders: %s', 'wc-licensed-product'),
|
||||||
|
'<code>{site_title}, {product_name}, {expiration_date}</code>'
|
||||||
|
);
|
||||||
|
|
||||||
|
$this->form_fields = [
|
||||||
|
'enabled' => [
|
||||||
|
'title' => __('Enable/Disable', 'wc-licensed-product'),
|
||||||
|
'type' => 'checkbox',
|
||||||
|
'label' => __('Enable this email notification', 'wc-licensed-product'),
|
||||||
|
'default' => 'yes',
|
||||||
|
],
|
||||||
|
'subject' => [
|
||||||
|
'title' => __('Subject', 'wc-licensed-product'),
|
||||||
|
'type' => 'text',
|
||||||
|
'desc_tip' => true,
|
||||||
|
'description' => $placeholder_text,
|
||||||
|
'placeholder' => $this->get_default_subject(),
|
||||||
|
'default' => '',
|
||||||
|
],
|
||||||
|
'heading' => [
|
||||||
|
'title' => __('Email heading', 'wc-licensed-product'),
|
||||||
|
'type' => 'text',
|
||||||
|
'desc_tip' => true,
|
||||||
|
'description' => $placeholder_text,
|
||||||
|
'placeholder' => $this->get_default_heading(),
|
||||||
|
'default' => '',
|
||||||
|
],
|
||||||
|
'additional_content' => [
|
||||||
|
'title' => __('Additional content', 'wc-licensed-product'),
|
||||||
|
'description' => __('Text to appear below the main email content.', 'wc-licensed-product') . ' ' . $placeholder_text,
|
||||||
|
'css' => 'width:400px; height: 75px;',
|
||||||
|
'placeholder' => $this->get_default_additional_content(),
|
||||||
|
'type' => 'textarea',
|
||||||
|
'default' => '',
|
||||||
|
'desc_tip' => true,
|
||||||
|
],
|
||||||
|
'email_type' => [
|
||||||
|
'title' => __('Email type', 'wc-licensed-product'),
|
||||||
|
'type' => 'select',
|
||||||
|
'description' => __('Choose which format of email to send.', 'wc-licensed-product'),
|
||||||
|
'default' => 'html',
|
||||||
|
'class' => 'email_type wc-enhanced-select',
|
||||||
|
'options' => $this->get_email_type_options(),
|
||||||
|
'desc_tip' => true,
|
||||||
|
],
|
||||||
|
];
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -862,6 +862,56 @@ class LicenseManager
|
|||||||
return (bool) get_user_meta($license->getCustomerId(), $metaKey, true);
|
return (bool) get_user_meta($license->getCustomerId(), $metaKey, true);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get licenses that have passed their expiration date but are still marked as active
|
||||||
|
*
|
||||||
|
* @return array Array of License objects that need to be auto-expired
|
||||||
|
*/
|
||||||
|
public function getExpiredActiveLicenses(): array
|
||||||
|
{
|
||||||
|
global $wpdb;
|
||||||
|
|
||||||
|
$tableName = Installer::getLicensesTable();
|
||||||
|
$now = new \DateTimeImmutable();
|
||||||
|
|
||||||
|
$sql = "SELECT * FROM {$tableName}
|
||||||
|
WHERE expires_at IS NOT NULL
|
||||||
|
AND expires_at < %s
|
||||||
|
AND status = %s";
|
||||||
|
|
||||||
|
$rows = $wpdb->get_results(
|
||||||
|
$wpdb->prepare($sql, $now->format('Y-m-d H:i:s'), License::STATUS_ACTIVE),
|
||||||
|
ARRAY_A
|
||||||
|
);
|
||||||
|
|
||||||
|
return array_map(fn(array $row) => License::fromArray($row), $rows ?: []);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Auto-expire a license and return true if status was changed
|
||||||
|
*
|
||||||
|
* @param int $licenseId License ID
|
||||||
|
* @return bool True if license was expired, false if already expired or error
|
||||||
|
*/
|
||||||
|
public function autoExpireLicense(int $licenseId): bool
|
||||||
|
{
|
||||||
|
$license = $this->getLicenseById($licenseId);
|
||||||
|
if (!$license) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Only expire if currently active and past expiration date
|
||||||
|
if ($license->getStatus() !== License::STATUS_ACTIVE) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!$license->isExpired()) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
return $this->updateLicenseStatus($licenseId, License::STATUS_EXPIRED);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Import a license from CSV data
|
* Import a license from CSV data
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -10,6 +10,7 @@ declare(strict_types=1);
|
|||||||
namespace Jeremias\WcLicensedProduct;
|
namespace Jeremias\WcLicensedProduct;
|
||||||
|
|
||||||
use Jeremias\WcLicensedProduct\Admin\AdminController;
|
use Jeremias\WcLicensedProduct\Admin\AdminController;
|
||||||
|
use Jeremias\WcLicensedProduct\Admin\DashboardWidgetController;
|
||||||
use Jeremias\WcLicensedProduct\Admin\OrderLicenseController;
|
use Jeremias\WcLicensedProduct\Admin\OrderLicenseController;
|
||||||
use Jeremias\WcLicensedProduct\Admin\SettingsController;
|
use Jeremias\WcLicensedProduct\Admin\SettingsController;
|
||||||
use Jeremias\WcLicensedProduct\Admin\VersionAdminController;
|
use Jeremias\WcLicensedProduct\Admin\VersionAdminController;
|
||||||
@@ -151,6 +152,7 @@ final class Plugin
|
|||||||
new VersionAdminController($this->versionManager);
|
new VersionAdminController($this->versionManager);
|
||||||
new OrderLicenseController($this->licenseManager);
|
new OrderLicenseController($this->licenseManager);
|
||||||
new SettingsController();
|
new SettingsController();
|
||||||
|
new DashboardWidgetController($this->licenseManager);
|
||||||
|
|
||||||
// Show admin notice if unlicensed and not on localhost
|
// Show admin notice if unlicensed and not on localhost
|
||||||
if (!$isLicensed && !$licenseChecker->isLocalhost()) {
|
if (!$isLicensed && !$licenseChecker->isLocalhost()) {
|
||||||
|
|||||||
Reference in New Issue
Block a user