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

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

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

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

説明

テーマ翻訳ファイルを読み込みます。 現在のロケールがテーマのルートディレクトリに.moファイルとして存在する場合、それは $domainにて翻訳された文字列に含まれます。

.moファイルはsv_SE.mo(スウェーデン)の様に、必ずロケールに一致した名前にしてください。

使い方

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

パラメータ

$domain
文字列) (必須) テキストドメイン。(翻訳ファイルを識別するために必要な個別識別子)
初期値: なし
$path
unknown) (オプション) .moファイルの存在するディレクトリを指定します。(最後にスラッシュは必要ありません)
初期値: false

戻り値

テキストドメインを取得できた場合はTRUEを、取得に失敗した場合はFALSEを返します。

用例

用例その1

load_theme_textdomain() 関数はアクションフックのafter_setup_themeにフックさせる必要があります。

add_action('after_setup_theme', 'my_theme_setup');
function my_theme_setup(){
    load_theme_textdomain('my_theme', get_template_directory() . '/languages');
}

テーマの翻訳ファイル(.mo)の名前はは必ず言語名だけにしてください。(例:languages/de_DE.mo)

日本語の場合はlanguades/ja.moとなります。

プラグインの言語ファイルとは異なり、my_theme-de_DE.moような名前は動作しません。 プラグインの言語ファイルは、ファイル名のテキストドメインを指定することができますが、これはテーマでは動作しません。 テーマの言語ファイルは、言語のショートカットだけを含める必要があります。

用例その2

例えば、Tamazikht言語をロードするために、例えば、URLの中に渡された変数を使用して、テーマの言語を切り替えたい場合は、URLは次のようになります。 www.example.com/?l=tz_MA これはテーマ内の言語ディレクトリで名前tz_MA.moという.moファイルを検索します。

// CHANGE LOCAL LANGUAGE
// must be called before load_theme_textdomain()
add_filter( 'locale', 'my_theme_localized' );
function my_theme_localized( $locale )
{
	if ( isset( $_GET['l'] ) )
	{
		return sanitize_key( $_GET['l'] );
	}

	return $locale;
}
// SET THEME LANGUAGES DIRECTORY
// Theme translations can be filed in the my_theme/languages/ directory
// Wordpress translations can be filed in the wp-content/languages/ directory
load_theme_textdomain( 'my_theme_textdomain', get_template_directory().'/languages' );

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

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

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

また、「i18n」は国際化(internationalization)の頭と最後の2文字と、間にある18文字を取って作られた略語です。

更新履歴

新規導入: 1.5.0

ソースファイル

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

関連資料

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

WordPressテーマサポートジェネレーター http://generatewp.com/theme-support/

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


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