acf_localize_text()


WordPressのacf_localize_text()関数は、Advanced Custom Fields(ACF)プラグインで使用される関数で、フロントエンドで表示されるテキストをローカライズ(翻訳)するために使用されます。この関数を使用することで、ACFフィールドのラベルやメッセージを多言語対応させることができます。

構文

acf_localize_text( string $text, string $domain = 'acf' );

引数の説明:

  • $text(string) — ローカライズするテキスト。
  • $domain(string) — テキストドメイン。デフォルトは’acf’。

例1: 基本的なテキストのローカライズ

この例では、フロントエンドに表示されるテキストをローカライズします。

<?php echo acf_localize_text('Hello, World!'); ?>

例2: カスタムテキストドメインの使用

カスタムテキストドメインを使用してテキストをローカライズします。

<?php echo acf_localize_text('Welcome', 'my-custom-domain'); ?>

例3: ACFフィールドのラベルをローカライズ

ACFフィールドのラベルをローカライズする例です。

<?php echo acf_localize_text(get_field('my_field_label')); ?>

例4: 複数のテキストをローカライズ

複数のテキストを一度にローカライズする例です。

<?php echo acf_localize_text('First Text') . ' ' . acf_localize_text('Second Text'); ?>

例5: 翻訳ファイルを使用したローカライズ

翻訳ファイルを使用してテキストをローカライズする例です。

<?php echo acf_localize_text('Goodbye', 'my-theme'); ?>

例6: 動的なテキストのローカライズ

動的に生成されたテキストをローカライズする例です。

<?php echo acf_localize_text(sprintf('Welcome, %s', $username)); ?>

注意点

  • 翻訳ファイルが正しくロードされていることを確認してください。
  • テキストドメインが翻訳ファイルと一致していることを確認してください。