配置

配置

Colvor 插件支持通过 WordPress 后台 UI 和 PHP 钩子/过滤器进行配置。

设置面板

激活后，进入 WooCommerce → Colvor 设置 进行以下配置：

设置项	说明
License Key	你的插件授权码
API 模式	live（正式）或 test（开发测试）
缓存 TTL	授权验证缓存时长（默认：3600 秒）
调试模式	开启后将向 WooCommerce 状态日志写入详细日志

钩子与过滤器

Colvor 为开发者提供了简洁的 PHP API，实现程序化控制。

过滤器：colvor/license/validate

在每次授权验证前调用。返回 false 可跳过验证（例如用于暂存/本地环境）。

add_filter( 'colvor/license/validate', function( bool $should_validate ): bool {
    // 在本地/暂存环境跳过授权验证
    if ( defined('WP_ENV') && WP_ENV !== 'production' ) {
        return false;
    }
    return $should_validate;
} );

过滤器：colvor/license/cache_ttl

覆盖授权验证缓存时长（单位：秒）。

add_filter( 'colvor/license/cache_ttl', fn() => 7200 ); // 缓存 2 小时

动作钩子：colvor/license/activated

授权成功激活后触发。

add_action( 'colvor/license/activated', function( string $license_key, string $domain ): void {
    error_log( "Colvor 授权已激活：{$license_key}，域名：{$domain}" );
}, 10, 2 );

环境变量（可选）

对于无界面/CI 环境，可在 wp-config.php 中通过 PHP 常量设置 License Key：

define( 'COLVOR_LICENSE_KEY', 'your-license-key-here' );

定义该常量后，设置界面中的输入框将被隐藏，系统自动使用常量中的值。