License Model

DB Table Name	{wp_db_prefix}_fct_licenses
Schema	Check Schema
Source File	fluent-cart-pro/app/Modules/Licensing/Models/License.php
Name Space	FluentCartPro\App\Modules\Licensing\Models
Class	FluentCartPro\App\Modules\Licensing\Models\License
Plugin	FluentCart Pro

Attributes

Attribute	Data Type	Comment
id	Integer	Primary Key
status	String	License status (active, inactive, expired, suspended)
limit	Integer	Activation limit
activation_count	Integer	Current activation count
license_key	String	Unique license key
product_id	Integer	Reference to product
variation_id	Integer	Reference to product variation
order_id	Integer	Reference to order
parent_id	Integer	Parent license ID (for renewals)
customer_id	Integer	Reference to customer
expiration_date	Date Time	License expiration date
last_reminder_sent	Date Time	Last reminder sent date
last_reminder_type	String	Last reminder type
subscription_id	Integer	Reference to subscription
config	JSON	License configuration
created_at	Date Time	Creation timestamp
updated_at	Date Time	Last update timestamp

Usage

Please check Model Basic for Common methods.

Accessing Attributes

$license = FluentCartPro\App\Modules\Licensing\Models\License::find(1);

$license->id; // returns id
$license->license_key; // returns license key
$license->status; // returns status
$license->activation_count; // returns activation count
$license->limit; // returns activation limit

Scopes

This model has the following scopes that you can use

ofStatus($status)

Filter licenses by status

• Parameters
  • $status - string

Usage:

// Get all active licenses
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::ofStatus('active')->get();

ofCustomer($customerId)

Filter licenses by customer ID

• Parameters
  • $customerId - integer

Usage:

// Get all licenses for a specific customer
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::ofCustomer(123)->get();

ofProduct($productId)

Filter licenses by product ID

• Parameters
  • $productId - integer

Usage:

// Get all licenses for a specific product
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::ofProduct(456)->get();

ofOrder($orderId)

Filter licenses by order ID

• Parameters
  • $orderId - integer

Usage:

// Get all licenses for a specific order
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::ofOrder(789)->get();

ofSubscription($subscriptionId)

Filter licenses by subscription ID

• Parameters
  • $subscriptionId - integer

Usage:

// Get all licenses for a specific subscription
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::ofSubscription(101)->get();

active()

Filter active licenses

• Parameters
  • none

Usage:

// Get all active licenses
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::active()->get();

expired()

Filter expired licenses

• Parameters
  • none

Usage:

// Get all expired licenses
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::expired()->get();

expiringSoon($days = 30)

Filter licenses expiring soon

• Parameters
  • $days - integer (default: 30)

Usage:

// Get licenses expiring in next 30 days
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::expiringSoon()->get();

// Get licenses expiring in next 7 days
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::expiringSoon(7)->get();

Relations

This model has the following relationships that you can use

customer

Access the associated customer

• return FluentCart\App\Models\Customer Model

Example:

// Accessing Customer
$customer = $license->customer;

// For Filtering by customer relationship
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::whereHas('customer', function($query) {
    $query->where('email', '[email protected]');
})->get();

order

Access the associated order

• return FluentCart\App\Models\Order Model

Example:

// Accessing Order
$order = $license->order;

// For Filtering by order relationship
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::whereHas('order', function($query) {
    $query->where('status', 'completed');
})->get();

product

Access the associated product

• return FluentCart\App\Models\Product Model

Example:

// Accessing Product
$product = $license->product;

// For Filtering by product relationship
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::whereHas('product', function($query) {
    $query->where('post_status', 'publish');
})->get();

variation

Access the associated product variation

• return FluentCart\App\Models\ProductVariation Model

Example:

// Accessing Product Variation
$variation = $license->variation;

subscription

Access the associated subscription

• return FluentCart\App\Models\Subscription Model

Example:

// Accessing Subscription
$subscription = $license->subscription;

// For Filtering by subscription relationship
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::whereHas('subscription', function($query) {
    $query->where('status', 'active');
})->get();

activations

Access license activations

• return FluentCartPro\App\Modules\Licensing\Models\LicenseActivation Collection

Example:

// Accessing Activations
$activations = $license->activations;

// For Filtering by activations relationship
$licenses = FluentCartPro\App\Modules\Licensing\Models\License::whereHas('activations', function($query) {
    $query->where('status', 'active');
})->get();

labels

Access license labels

• return FluentCart\App\Models\LabelRelationship Collection

Example:

// Accessing Labels
$labels = $license->labels;

Methods

Along with Global Model methods, this model has few helper methods.

getConfigAttribute($value)

Get config as array (accessor)

• Parameters
  • $value - mixed
• Returns array

Usage

$config = $license->config; // Returns array

setConfigAttribute($value)

Set config from array (mutator)

• Parameters
  • $value - array|object
• Returns void

Usage

$license->config = ['auto_renew' => true, 'max_sites' => 5];

isActive()

Check if license is active

• Parameters
  • none
• Returns boolean

Usage

$isActive = $license->isActive();

isExpired()

Check if license is expired

• Parameters
  • none
• Returns boolean

Usage

$isExpired = $license->isExpired();

isExpiringSoon($days = 30)

Check if license is expiring soon

• Parameters
  • $days - integer (default: 30)
• Returns boolean

Usage

$isExpiringSoon = $license->isExpiringSoon();
$isExpiringInWeek = $license->isExpiringSoon(7);

canActivate()

Check if license can be activated

• Parameters
  • none
• Returns boolean

Usage

$canActivate = $license->canActivate();

getRemainingActivations()

Get remaining activations

• Parameters
  • none
• Returns integer

Usage

$remaining = $license->getRemainingActivations();

isAtLimit()

Check if license is at activation limit

• Parameters
  • none
• Returns boolean

Usage

$isAtLimit = $license->isAtLimit();

getExpirationDateFormatted()

Get formatted expiration date

• Parameters
  • none
• Returns string

Usage

$expirationDate = $license->getExpirationDateFormatted(); // Returns: "2024-12-31"

getDaysUntilExpiration()

Get days until expiration

• Parameters
  • none
• Returns integer

Usage

$daysLeft = $license->getDaysUntilExpiration();

generateLicenseKey()

Generate new license key

• Parameters
  • none
• Returns string

Usage

$licenseKey = $license->generateLicenseKey();

activate($siteUrl, $siteName = null)

Activate license on a site

• Parameters
  • $siteUrl - string
  • $siteName - string (optional)
• Returns boolean

Usage

$activated = $license->activate('https://example.com', 'My Site');

deactivate($activationId)

Deactivate license on a site

• Parameters
  • $activationId - integer
• Returns boolean

Usage

$deactivated = $license->deactivate(123);

renew($newExpirationDate)

Renew license

• Parameters
  • $newExpirationDate - string|DateTime
• Returns boolean

Usage

$renewed = $license->renew('2025-12-31');

suspend($reason = null)

Suspend license

• Parameters
  • $reason - string (optional)
• Returns boolean

Usage

$suspended = $license->suspend('Payment failed');

unsuspend()

Unsuspend license

• Parameters
  • none
• Returns boolean

Usage

$unsuspended = $license->unsuspend();

getConfigValue($key, $default = null)

Get specific config value

• Parameters
  • $key - string
  • $default - mixed
• Returns mixed

Usage

$maxSites = $license->getConfigValue('max_sites', 1);

setConfigValue($key, $value)

Set specific config value

• Parameters
  • $key - string
  • $value - mixed
• Returns void

Usage

$license->setConfigValue('auto_renew', true);

License Statuses

Common license statuses in FluentCart Pro:

• active - License is active and can be used
• inactive - License is inactive
• expired - License has expired
• suspended - License is suspended
• cancelled - License is cancelled

Usage Examples

Get Customer Licenses

$customer = FluentCart\App\Models\Customer::find(123);
$licenses = $customer->licenses()->active()->get();

foreach ($licenses as $license) {
    echo "License: " . $license->license_key . " - " . $license->status;
}

Get Expiring Licenses

$expiringLicenses = FluentCartPro\App\Modules\Licensing\Models\License::expiringSoon(7)
    ->active()
    ->get();

Check License Activation

$license = FluentCartPro\App\Modules\Licensing\Models\License::find(1);

if ($license->canActivate()) {
    $activated = $license->activate('https://example.com', 'My Site');
    if ($activated) {
        echo "License activated successfully";
    }
} else {
    echo "License cannot be activated";
}

Get License with Relationships

$license = FluentCartPro\App\Modules\Licensing\Models\License::with([
    'customer',
    'product',
    'order',
    'activations'
])->find(1);

---

Plugin: FluentCart Pro