程序化检查 TranslatePress 插件的版本名称
数据小陈
结论
只需要 TranslatePress 的安装版本号时,优先通过 WordPress 读取插件头(get_file_data / get_plugin_data),不要依赖插件内部类属性。要区分 free、personal、business、developer 这些版本,查看 $trp->active_pro_addons 可以作为思路,但不适合把它当作唯一且稳定的公开 API。更稳妥的做法是把版本判断封装成一个返回版本名称的函数,并在使用前检查类、实例、属性和数组是否存在。原代码直接返回 true,既分不出 free 和 Pro 层级,调用方也不好据此判断版本。
原因与注意点
Version是插件主文件头里的标准字段,读取安装版本号用它比较合适。active_pro_addons是插件内部实现,版本变化后键名和结构都可能不同。使用前要确认$trp存在、对应属性存在,并且值是数组。TRP_Translate_Press::get_trp_instance()要等插件加载后再调用。放在init里通常没问题,但建议用稍后的优先级,并加class_exists做防御。- 属性不存在时,不能直接认定是 free,也可能只是当前版本的结构变了。这种情况下返回 unknown 或 free-or-unknown 更稳妥。
- 站点使用多站点,或 Pro 插件主文件路径不同时,插件头路径要按实际安装目录调整。
推荐实现
下面的示例会同时返回版本号和版本名称。只有在 active_pro_addons 存在且为数组、又没有匹配到 Pro 键时,才判定为 free;属性缺失时返回 unknown,避免误判。
function tp_get_translatepress_info() {
$info = array(
'edition' => 'unknown',
'version' => null,
);
if ( ! class_exists( 'TRP_Translate_Press' ) ) {
$info['edition'] = 'not_active';
return $info;
}
$plugin_file = WP_PLUGIN_DIR . '/translatepress-multilingual/index.php';
if ( file_exists( $plugin_file ) ) {
$data = get_file_data(
$plugin_file,
array(
'Version' => 'Version',
'Name' => 'Plugin Name',
)
);
if ( ! empty( $data['Version'] ) ) {
$info['version'] = $data['Version'];
}
}
$trp = TRP_Translate_Press::get_trp_instance();
if ( ! $trp || ! isset( $trp->active_pro_addons ) || ! is_array( $trp->active_pro_addons ) ) {
return $info;
}
if ( isset( $trp->active_pro_addons['translatepress-business'] ) ) {
$info['edition'] = 'business';
} elseif ( isset( $trp->active_pro_addons['translatepress-developer'] ) ) {
$info['edition'] = 'developer';
} elseif ( isset( $trp->active_pro_addons['translatepress-personal'] ) ) {
$info['edition'] = 'personal';
} else {
$info['edition'] = 'free';
}
return $info;
}
add_action( 'init', function () {
$info = tp_get_translatepress_info();
error_log( 'TranslatePress edition: ' . $info['edition'] . '; version: ' . ( $info['version'] ? $info['version'] : 'unknown' ) );
}, 20 );
使用建议
调用方应读取返回数组里的 edition 和 version,不要只判断布尔值。如果业务只关心是否 Pro,可以在函数外面再包一层判断。后续插件更新导致 active_pro_addons 结构变化时,优先回退到插件头读取版本号;版本名称识别失败就记为 unknown,不要静默当成 free。
备注:内容仅供参考。
