云策 WordPress 开发者社区

钩子文档

load_textdomain

查看官方原文 ↗
💡 云策文档标注

概述

load_textdomain 是一个 WordPress 动作钩子，在 MO 翻译文件加载前触发，允许开发者在翻译过程中执行自定义操作。

关键要点

  • 钩子名称：load_textdomain，通过 do_action 调用。
  • 参数：$domain（文本域的唯一标识符）和 $mofile（.mo 文件的路径）。
  • 用途：用于在加载翻译文件时添加日志记录、修改翻译行为或执行其他自定义功能。
  • 相关函数：load_textdomain()，位于 wp-includes/l10n.php 中。
  • 版本历史：自 WordPress 2.9.0 版本引入。

代码示例

/**
 * Example of load_textdomain usage
 * @param string $domain Unique domain for translation.
 * @param string $mofile Path to the .mo file.
 * @param array|string $args Optional args used in taxonomy registration.
 */
function log_mo_file_load($domain, $mofile){
    echo 'loading file "' . $mofile . '" on domain "' . $domain . '"';
    // or whatever else you'd like to do here.
}

add_action( 'load_textdomain', 'log_mo_file_load' );
📄 原文内容

Fires before the MO translation file is loaded.

Parameters

$domainstring
Text domain. Unique identifier for retrieving translated strings.
$mofilestring
Path to the .mo file.

Source

do_action( 'load_textdomain', $domain, $mofile );

View all references View on Trac View on GitHub

Used by Description
load_textdomain()wp-includes/l10n.php

Loads a .mo file into the text domain $domain.

Changelog

Version Description
2.9.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content


    Codex


    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Example:

    /**
 * Example of load_textdomain usage
 * @param string $domain Unique domain for translation.
 * @param string $mofile Path to the .mo file.
 * @param array|string $args Optional args used in taxonomy registration.
 */
function log_mo_file_load($domain, $mofile){
    echo 'loading file "' . $mofile . '" on domain "' . $domain . '"';
    // or whatever else you'd like to do here.
}

add_action( 'load_textdomain', 'log_mo_file_load' );