WordPress函数__()用法-445IT之家

File: wp-includes/l10n.php

function __( $text, $domain = 'default' ) {
	return translate( $text, $domain );
}

更新日志

Version	描述
2.1.0	Introduced.

在WordPress中，双下划线函数 __() 被用作一个国际化和本地化的函数。它用于将字符串翻译成当前语言环境的相应文本。这个函数在WordPress的插件和主题开发中非常重要，因为它帮助开发者创建可以被翻译和适配到不同语言环境的插件和主题。
下面是 __() 函数的基本用法：

<?php
$text = __('Text to translate', 'text-domain');
?>

这里的参数解释如下：

'Text to translate': 你希望被翻译的原始字符串。
'text-domain': 这是文本域的名称，它通常是你插件或主题的名称，用于区分不同的翻译文件。这对于确保正确加载翻译非常重要。
使用 __() 函数的步骤：

准备文本：在你插件或主题的PHP文件中，用 __() 函数包裹所有需要翻译的字符串。
定义文本域：为你的插件或主题定义一个唯一的文本域。通常这个文本域是你的插件或主题的文件夹名称。
创建 POT 文件：使用WordPress的工具，如 wp-cli 或者专门的插件，如 Poedit，来扫描你的代码并生成一个POT（Portable Object Template）文件，这个文件包含了所有可翻译的字符串。
翻译：翻译者会使用POT文件来创建PO（Portable Object）文件，这个文件包含了翻译后的字符串。
编译MO文件：PO文件需要被编译成MO（Machine Object）文件，这是WordPress用来读取翻译的格式。
加载翻译文件：确保在插件或主题的functions.php文件中加载了MO文件。通常情况下，WordPress会自动处理这个步骤，但有时候你可能需要手动加载：

load_plugin_textdomain('text-domain', false, basename(dirname(__FILE__)) . '/languages');

使用 __() 函数可以让WordPress社区中的任何人更容易地将你的插件或主题翻译成其他语言，从而扩大你的用户基础。