override_unload_textdomain
云策文档标注
概述
本文档介绍了 WordPress 中的 override_unload_textdomain 过滤器,用于控制是否覆盖文本域的卸载行为。开发者可以通过此过滤器干预翻译卸载过程,例如基于特定条件阻止卸载。
关键要点
- override_unload_textdomain 是一个过滤器,允许开发者覆盖文本域的卸载操作。
- 过滤器接受三个参数:$override(布尔值,默认 false)、$domain(字符串,文本域标识符)和 $reloadable(布尔值,指示文本域是否可重新加载)。
- 此过滤器在 unload_textdomain() 函数中被调用,用于管理翻译的卸载。
- 从 WordPress 6.1.0 版本开始,添加了 $reloadable 参数,增强了控制能力。
代码示例
$plugin_override = apply_filters( 'override_unload_textdomain', false, $domain, $reloadable );注意事项
- 使用此过滤器时,需确保正确处理 $domain 和 $reloadable 参数,以避免影响其他文本域的翻译管理。
- 在 WordPress 3.0.0 中引入,6.1.0 版本更新了参数,开发时应注意版本兼容性。
原文内容
Filters whether to override the text domain unloading.
Parameters
$overridebool-
Whether to override the text domain unloading. Default false.
$domainstring-
Text domain. Unique identifier for retrieving translated strings.
$reloadablebool-
Whether the text domain can be loaded just-in-time again.
Source
$plugin_override = apply_filters( 'override_unload_textdomain', false, $domain, $reloadable );