钩子文档

change_locale

💡 云策文档标注

概述

change_locale 是一个 WordPress 动作钩子,在站点语言环境(locale)被切换或恢复时触发。它允许开发者在语言环境变更时执行自定义代码。

关键要点

  • change_locale 是一个动作钩子,用于响应语言环境的变更事件。
  • 钩子接受一个参数 $locale,表示新的语言环境字符串。
  • 该钩子由 WP_Locale_Switcher::change_locale() 方法调用,用于实际更改站点的语言环境。
  • change_locale 钩子自 WordPress 4.7.0 版本引入。

代码示例

do_action( 'change_locale', $locale );

📄 原文内容

Fires when the locale is switched to or restored.

Parameters

$localestring
The new locale.

Source

do_action( 'change_locale', $locale );

Changelog

Version Description
4.7.0 Introduced.