钩子文档

override_load_textdomain

💡 云策文档标注

概述

本文档介绍了 WordPress 中的 override_load_textdomain 过滤器,用于控制是否覆盖 .mo 文件的加载过程。开发者可以通过此过滤器自定义文本域翻译文件的加载行为。

关键要点

  • override_load_textdomain 是一个过滤器,允许开发者干预 .mo 文件的加载逻辑。
  • 过滤器接收四个参数:$override(布尔值,默认 false)、$domain(文本域标识符)、$mofile(MO 文件路径)和 $locale(区域设置)。
  • 此过滤器在 load_textdomain() 函数中被调用,用于加载指定文本域的翻译文件。
  • 从 WordPress 6.2.0 版本开始,增加了 $locale 参数,以支持更精细的区域设置处理。

代码示例

$plugin_override = apply_filters( 'override_load_textdomain', false, $domain, $mofile, $locale );

注意事项

  • 使用此过滤器时,需确保正确处理参数,以避免影响其他插件或主题的翻译加载。
  • 在自定义覆盖逻辑时,应考虑性能影响,避免不必要的文件操作。

📄 原文内容

Filters whether to override the .mo file loading.

Parameters

$overridebool
Whether to override the .mo file loading. Default false.
$domainstring
Text domain. Unique identifier for retrieving translated strings.
$mofilestring
Path to the MO file.
$localestring|null
Locale.

Source

$plugin_override = apply_filters( 'override_load_textdomain', false, $domain, $mofile, $locale );

Changelog

Version Description
6.2.0 Added the $locale parameter.
2.9.0 Introduced.