is_textdomain_loaded()


関数 WordPressis_textdomain_loaded()は、特定のテキストドメインが読み込まれているかを確認するために使用されます。

構文

is_textdomain_loaded( string $textdomain );
  • $textdomain (string) — テキストドメインの名前。このドメインが読み込まれているかどうかを確認します。

例 1: テキストドメインの読み込み状態を確認

次のコードは、'my-textdomain'というテキストドメインが読み込まれているかどうかを確認します。

<?php
if ( is_textdomain_loaded( 'my-textdomain' ) ) {
    echo 'テキストドメインは読み込まれています。';
} else {
    echo 'テキストドメインは読み込まれていません。';
}
?>

例 2: 条件に基づいて翻訳関数を使用

テキストドメインが読み込まれている場合のみ、翻訳関数__()を使用します。

<?php
if ( is_textdomain_loaded( 'my-textdomain' ) ) {
    echo __( 'こんにちは、世界！', 'my-textdomain' );
} else {
    echo '翻訳は利用できません。';
}
?>

例 3: プラグインの初期化チェック

特定のプラグインが正しくロードされたかをテキストドメインで確認します。

<?php
if ( is_textdomain_loaded( 'plugin-textdomain' ) ) {
    echo 'プラグインがロードされています。';
} else {
    echo 'プラグインがロードされていません。';
}
?>

例 4: テキストドメインのデバッグログ

デバッグログにテキストドメインの状態を記録します。

<?php
if ( is_textdomain_loaded( 'debug-textdomain' ) ) {
    error_log( 'Debugテキストドメインがロードされています。' );
} else {
    error_log( 'Debugテキストドメインがロードされていません。' );
}
?>

例 5: 動的なテキストドメインチェック

動的に取得したテキストドメインがロードされているか確認します。

<?php
$textdomain = apply_filters( 'custom_textdomain', 'default-textdomain' );
if ( is_textdomain_loaded( $textdomain ) ) {
    echo $textdomain . ' はロードされています。';
} else {
    echo $textdomain . ' はロードされていません。';
}
?>

注意事項

  • テキストドメインが読み込まれていない場合、翻訳関数は元の文字列を返します。

関連機能：