翻译功能

如果您希望翻译自定义文本，您可以通过调用翻译函数trp_translate($content, $language = null, $prevent_over_translation = true ); 来实现。

翻译函数中使用了以下参数：

• $content（必需）：您想要翻译的实际文本。它可以是任何简单文本或 HTML。
• $language（可选）：您希望将内容翻译成的语言代码。语言代码（例如“en_US”、“de_DE”）可在“设置”->“TranslatePress”->“常规”中找到。它不一定与语言 slug（例如“en”、“de”）相同。如果您不添加此参数，内容将被翻译成当前语言。
• $prevent_over_translation（可选）：此参数用于确保翻译后的文本不会在稍后被 TranslatePress 拾取以尝试第二次翻译。它添加了一个包装 <span data-no-translation> 标签。可以通过将 $prevent_over_translation 设置为 false 来更改此默认行为，在这种情况下不会添加 <span> 标签。如果翻译后的文本不会简单地打印（回显）在 HTML 源中并因此被 TP 检测到，则可以安全地将其设置为“false”。

返回值是一个字符串，其中包含初始格式（文本或 HTML）的翻译内容，使用数据库中可用的翻译或激活的自动翻译。HTML 结构被保留，该函数仅翻译标签内的节点和属性。

在下面的例子中，我们可以观察 trp_translate 函数的功能：

function tpc_enqueue_scripts(){

$message = trp_translate('<div>Hey, this is a test.</div><p>This is another test.</p>', 'pt_BR');

$tpc_array = array();

$tpc_array['alert'] = $message;

echo '<button id=tpc_test_button>Click Here</button>';

wp_enqueue_script( 'tpc_test_trp_translate_function', plugin_dir_url( __FILE__ ). '/assets/output.js', array("jquery"), 1.0, true );

wp_localize_script( 'tpc_test_trp_translate_function', 'tpc_alert_message', $tpc_array);

}

add_action(‘wp_enqueue_scripts’, ‘tpc_enqueue_scripts’);

• 在 javascript 文件中写入以下代码：

jQuery(function() {

    jQuery( '#tpc_test_button' ).on( 'click', function () {
        alert( tpc_alert_message['alert'] );
    } );

});

下面的示例应该附加一个按钮，单击该按钮将显示一个带有翻译后的 HTML 的警告框：