WPML 站点密钥 – 工作原理、何时需要以及如何重置
站点密钥用于告知 WPML 站点属于哪个帐户。大多数客户通常无需直接操作密钥。当移动或复制站点时,WPML 会自动重新连接,密钥也会随之迁移。以下是少数需要您直接管理密钥的情况。
站点密钥的工作原理
每个使用 WPML 注册的站点都会获得一个与您的 WPML 帐户绑定的唯一站点密钥。该密钥授权站点使用您帐户的翻译记忆库、术语表和字数额度。
您可以在两个位置查看当前站点的密钥:
- WPML > 激活与更新。注册横幅会显示带有掩码的后缀(例如,
******abcd),以便您在不暴露完整密钥的情况下识别站点正在使用的密钥。 - 您的 WPML.org 帐户页面。列出了您注册的每个站点及其完整的密钥。
要手动注册新站点,请在您的帐户页面上生成一个密钥,并在出现提示时将其粘贴到 WPML 管理后台中:可以在初始设置的 Setup Wizard 中进行,或者在 WPML 要求时,粘贴到合并的迁移通知中嵌入的站点密钥表单里。
要取消注册站点(例如,因为您要停用该站点),请在 WPML > 激活与更新注册横幅中单击从此站点取消注册 WPML。WPML 安装和更新插件也在同一个屏幕进行,这里的站点密钥决定了这些下载内容属于哪个帐户。
移除“此站点已注册为开发站点”通知
每个生产站点允许 WPML 帐户注册一个开发站点。开发站点的通知(“此站点在 WPML.org 上注册为开发站点”)会有意显示在开发站点的每个 WPML 管理后台页面上,以防止开发克隆站点被当作生产站点处理。
当您准备好将站点从开发切换为生产时:
- 打开您的 WPML 帐户,并在已注册的站点列表中找到该站点。
- 将其类型从开发更改为生产。
- 保存。
- 在站点本身上,打开 WPML > 激活与更新,然后单击检查更新。一旦帐户端的更改同步,开发站点通知就会消失。
如果同步后通知仍然存在,请运行 WPML > 支持 > 系统检查 > 刷新许可证数据。这将清除本地许可证缓存并重新获取帐户状态。
通过 PHP 常量自动注册站点
对于自动化的开发/测试/生产工作流程(站点由 CI 管道部署,无需人工粘贴密钥),您可以使用 PHP 常量在 wp-config.php 中硬编码站点密钥。WPML 会在激活期间读取它们并注册站点,而不会出现提示。
在 wp-config.php 中,位于 “就是这些了,停止编辑吧!” 行之前:
define( 'OTGS_INSTALLER_SITE_KEY_WPML', 'your-site-key-here' );
WPML 会在激活时获取该常量并跳过注册提示。可以在开发、测试和生产环境中设置相同的密钥值。WPML 会按域名将它们区分开来。
此方法适用于以下环境:
- 站点由 Docker / Composer / WP-CLI 脚本配置,没有手动设置步骤。
- 您管理着许多站点,并希望注册是声明式的,而不是通过点击完成。
- 合并的迁移通知会在全新部署的环境中提示输入密钥。