ZiziCache License Transfer Guide

This guide reflects the current license system in ZiziCache, including how activation and deactivation work in the plugin.

How Licensing Works (Verified Behavior)

• Licenses are activated via the ZiziCache proxy API (api.zizicache.com).
• The license key must be a UUID format (for example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
• License data is stored locally in an encrypted form in the database.
• Validation is cached for 24 hours; if the API is temporarily unavailable, the plugin can fall back to the last valid check (up to 7 days).
• Status values used by the plugin: active, inactive, expired, disabled.

Recommended Transfer Process

Step 1 – Deactivate on the Old Site

Use the License tab in the admin UI and click Deactivate. This calls the built-in deactivation endpoint and then clears local license data.

Important: even if the API call fails, the plugin still removes the local license record. If the activation limit remains reached after a failed deactivation, repeat the deactivation or contact support.

Step 2 – Activate on the New Site

• Open the License tab in the new sites admin UI and activate with your key, or
• Use WP-CLI: wp zizi-cache activate-license

There is no WP-CLI command to deactivate a license in the current version.

Activation Limit Reached

If you see an activation limit reached message, you must deactivate the key on an existing site before activating elsewhere.

Check License Status (Admin-Only REST)

• GET /wp-json/zizi-cache/v1/license/status
• POST /wp-json/zizi-cache/v1/license/validate with force_remote=true to bypass cache
• POST /wp-json/zizi-cache/v1/license/deactivate

Security Notes

• The license key is stored encrypted locally; the plain key is never saved in the database.
• Deactivation clears local license data and related update cache entries.