translate()


WordPressのtranslate()関数は、指定されたテキストを翻訳するために使用されます。この関数は、多言語対応のテーマやプラグインを作成する際に役立ちます。

構文

translate( string $text, string $domain = 'default' );

引数の説明:

  • $text (string) — 翻訳するテキスト。
  • $domain (string) — テキストドメイン。デフォルトは’default’。

例1: 基本的な翻訳

この例では、簡単なテキストを翻訳します。

<?php echo translate('Hello, World!', 'my-text-domain'); ?>

例2: ドメインの指定

特定のテキストドメインを使用してテキストを翻訳します。

<?php echo translate('Welcome', 'my-plugin-domain'); ?>

例3: 翻訳ファイルの読み込み

翻訳ファイルを読み込んでテキストを翻訳します。

<?php load_theme_textdomain('my-theme-domain', get_template_directory() . '/languages'); echo translate('Goodbye', 'my-theme-domain'); ?>

例4: 翻訳済みテキストの取得

翻訳済みのテキストを取得して表示します。

<?php $translated_text = translate('Thank you', 'my-text-domain'); echo $translated_text; ?>

例5: 動的なテキストの翻訳

動的に生成されたテキストを翻訳します。

<?php $dynamic_text = 'Welcome back, ' . $username; echo translate($dynamic_text, 'my-text-domain'); ?>

例6: 複数形の翻訳

複数形のテキストを翻訳します。

<?php echo _n('One comment', 'Many comments', $comment_count, 'my-text-domain'); ?>

例7: 翻訳のエスケープ

翻訳されたテキストをエスケープして表示します。

<?php echo esc_html(translate('Hello, World!', 'my-text-domain')); ?>

例8: 翻訳のキャッシュ

翻訳結果をキャッシュしてパフォーマンスを向上させます。

<?php $translated_text = wp_cache_get('my_translated_text'); if (false === $translated_text) { $translated_text = translate('Hello, World!', 'my-text-domain'); wp_cache_set('my_translated_text', $translated_text); } echo $translated_text; ?>

注意点:

  • 翻訳ファイルが正しく読み込まれていることを確認してください。
  • テキストドメインは一貫して使用する必要があります。
  • 翻訳されたテキストをエスケープしてセキュリティを確保してください。

関連機能：