• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/load child theme textdomain

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「関数リファレンス/load child theme textdomain」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

子テーマの翻訳文字列を読み込みます。

現在のロケールを持つ .mo ファイルが子テーマのルートディレクトリにあれば、$domain の翻訳文字列として含められます。

.mo ファイルは ja.mode_DE.mo のように ロケールにもとづいた正確な名前 にする必要があります。

この関数は子テーマの翻訳をロードする適切な方法です。親テーマやシングルテーマには代わりに load_theme_textdomain() を使用します。子テーマの翻訳を拡張部分として読み込むことにより、読み込み処理が最適化しやすくなったり、コードとファイルをうまく構成したりできます。

例: 親テーマに "Twenty Eleven" を使う場合、その中に関数 load_theme_textdomain() が含まれており、多くの言語の翻訳が利用できます。ここで新しいサイドバーや他のセクションなどのカスタム要素をたくさん持った子テーマを作ったとします。フロントエンドとバックエンドの新しいセクションで使われるすべての文字列は子テーマの翻訳ファイルで制御する必要があります。もし親テーマが更新されても(言語文字列も一緒に変わることが多い)、子テーマの翻訳は影響を受けません。これは適切な方法であり、WordPress は最初から準備ができています。

使い方

<?php load_child_theme_textdomain( $domain, $path ) ?>

パラメータ

$domain
文字列) (必須) テキストドメイン。翻訳された文字列を取得するためのユニークな識別子。
初期値: なし
$path
unknown) (オプション) .mo ファイルが存在するディレクトリ。(最後のスラッシュなし)
初期値: false

返り値

(真偽値) 
テキストドメインが読み込まれた際に TRUE を、失敗した際に FALSE を返します。

用例

load_child_theme_textdomain() 関数は、ふつう after_setup_theme /en アクションフック内から呼び出すべきです。これは load_theme_textdomain() 関数と同様です。

add_action( 'after_setup_theme', 'my_child_theme_setup' );
function my_child_theme_setup() {
    load_child_theme_textdomain( 'my_child_theme', get_stylesheet_directory() . '/languages' );
}

.mo ファイルは言語名のみのファイル名で, 子テーマディレクトリ下に languages/de_DE.mo のように設置してください。

プラグインの言語ファイルとは異なり、my_child_theme-de_DE.mo動作しません。プラグインの言語ファイルはファイル名にテキストドメインを含めることができますが、これはテーマや子テーマでは動作しません。テーマの言語ファイルは言語コード (language shortcut) のみを含めてください。

参考

国際化・ローカリゼーションとは、コンピュータソフトウェアに他の言語を適応させるための方法です。

国際化は「Internationalization」または「internationalisation」、ローカリゼーションは「localization」または「localisation」と表記します。

  • 「l10n」はローカリゼーション(localization)の頭と最後の2文字と、間にある10文字を取って作られた略語です。
  • 「i18n」は国際化(internationalization)の頭と最後の2文字と、間にある18文字を取って作られた略語です。

変更履歴

新規追加: 2.9.0

ソースファイル

load_child_theme_textdomain()wp-includes/l10n.php にあります。

関連項目

ローカライズ: get_locale() /en, load_default_textdomain() /en, load_plugin_textdomain() /en, load_textdomain() /en, load_theme_textdomain()

最新英語版: WordPress Codex » Function_Reference/load_child_theme_textdomain最新版との差分


関数リファレンステンプレートタグ目次もご覧ください。