load_theme_textdomain( string $domain, string|false $path = false )

使用示例

• 示例1

  第一个示例，通常应从after_setup_theme动作挂钩内调用load_theme_textdomain()函数。

  add_action('after_setup_theme', 'wpdocs_theme_setup');
  
  /**
   * Load translations for wpdocs_theme
   */
  function wpdocs_theme_setup(){
      load_theme_textdomain('wpdocs_theme', get_template_directory() . '/languages');
  }
  

  这个 .mo 文件必须使用纯语言文件名，如主题目录中的languages/de_DE.mo。

  与插件语言文件不同，像my_theme-de_DE.mo这样的名称不起作用。虽然插件语言文件允许您在文件名中指定文本域，但这不适用于主题。主题的语言文件应仅包括语言快捷方式。

• 示例2

  第二个示例，如果您希望使用URL内传递的变量切换主题语言，例如加载Tamazikht语，您的URL如下所示：www.example.com/?l=tz_MA，这将在主题内的语言目录中搜索名为tz_MA.mo的.mo文件。

  // CHANGE LOCAL LANGUAGE
  // must be called before load_theme_textdomain()
  
  add_filter( 'locale', 'wpdocs_theme_localized' );
  
  /**
   * Switch to locale given as query parameter l, if present
   */
  function wpdocs_theme_localized( $locale )
  {
  	if ( isset( $_GET['l'] ) )
  	{
  		return sanitize_key( $_GET['l'] );
  	}
  
  	return $locale;
  }
  
  // SET THEME LANGUAGES DIRECTORY
  // Theme translations can be filed in the my_theme/languages/ directory
  // Wordpress translations can be filed in the wp-content/languages/ directory
  load_theme_textdomain( 'wpdocs_theme_textdomain', get_template_directory().'/languages' );