钩子文档

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 );

Changelog

Version Description
6.1.0 Added the $reloadable parameter.
3.0.0 Introduced.