load_plugin_textdomain()
最后更新于:2021-11-27 14:00:36
load_plugin_textdomain( string$domain, string|false$deprecated=false, string|false$plugin_rel_path=false)Loads a plugin’s translated strings.
参数
- $domain
-
(string) (Required) Unique identifier for retrieving translated strings
- $deprecated
-
(string|false) (Optional) Deprecated. Use the $plugin_rel_path parameter instead.
Default value: false
- $plugin_rel_path
-
(string|false) (Optional) Relative path to GC_PLUGIN_DIR where the .mo file resides.
Default value: false
响应
(bool) True when textdomain is successfully loaded, false otherwise.
源文件
文件: gc-includes/l10n.php
function load_plugin_textdomain( $domain, $deprecated = false, $plugin_rel_path = false ) {
/**
* Filters a plugin's locale.
*
* @since 3.0.0
*
* @param string $locale The plugin's current locale.
* @param string $domain Text domain. Unique identifier for retrieving translated strings.
*/
$locale = apply_filters( 'plugin_locale', determine_locale(), $domain );
$mofile = $domain . '-' . $locale . '.mo';
// Try to load from the languages directory first.
if ( load_textdomain( $domain, GC_LANG_DIR . '/plugins/' . $mofile ) ) {
return true;
}
if ( false !== $plugin_rel_path ) {
$path = GC_PLUGIN_DIR . '/' . trim( $plugin_rel_path, '/' );
} elseif ( false !== $deprecated ) {
_deprecated_argument( __FUNCTION__, '2.7.0' );
$path = ABSPATH . trim( $deprecated, '/' );
} else {
$path = GC_PLUGIN_DIR;
}
return load_textdomain( $domain, $path . '/' . $mofile );
}