License Management

The theme provides a WP-CLI interface for managing theme license activation directly from the command line. This is useful for automated deployments, CI/CD pipelines, or managing licenses on staging/production environments without accessing the WordPress admin.

Namespace

All commands are available under the kalium license namespace.

---

Commands

Activate License

Activates the theme license using a license key.

wp kalium license activate <license-key>

Arguments

Argument	Description
<license-key>	Required. The license key to activate

Example

wp kalium license activate 'sk_abc123def456ghi789'

Important: Always wrap the license key in single quotes to prevent shell escaping issues.

Behavior

• Validates that a license key is provided

• Checks if a license is already activated (will error if so)

• Activates the license via the Freemius SDK

• Returns success or error message

Error Cases

Error	Description
License key is required.	No license key was provided
License is already activated.	A license is already active on this installation
{API Error}	License activation failed (invalid key, exceeded activations, etc.)

---

Deactivate License

Deactivates the currently active theme license.

wp kalium license deactivate

Example

wp kalium license deactivate

Behavior

• Checks if there is an active license to deactivate

• Deactivates the license via the Freemius SDK

• Returns success or error message

Error Cases

Error	Description
There is no active license to deactivate.	No license is currently active
{API Error}	License deactivation failed

---

Typical Workflow

New Installation

# Activate license on a fresh installation
wp kalium license activate 'sk_abc123def456ghi789'

Migration Between Environments

# Deactivate license on old server
wp kalium license deactivate

# Activate license on new server
wp kalium license activate 'sk_abc123def456ghi789'

CI/CD Pipeline

# Activate license during deployment (using environment variable)
wp kalium license activate "$KALIUM_LICENSE_KEY"

---

Notes

• Always wrap the license key in single quotes ('license-key') to prevent shell escaping issues

• Only one license can be active at a time per installation

• Deactivate your license before migrating to a new domain to free up the activation slot

• License activation requires an internet connection to communicate with the licensing server

• The license key is stored securely in the WordPress database