PAYATHON 2026

程序化检查 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。

备注:内容仅供参考。