_x

説明

string _x( string $text , string $context [ , string $domain = 'default' ] )
現在のロケールとコンテキストに応じた翻訳テキストを取得する。

パラメータ

  • $text
    英文テキスト。
  • $context
    コンテキスト情報。
  • $domain
    ドメイン名を指定(省略時は'default')。

返り値

パラメータ$textについて現在のロケール、パラメータ$contextに応じたの翻訳テキストを返す。翻訳テキストが見つからなかった場合は$textをそのまま返す。

注意

通常の翻訳テキストは __関数で取得できるが、同じ単語であってもであっても目的や用途によって異なる翻訳テキストにしたいケースがある(例えば、'Add New'の翻訳テキストをリンクとユーザーで使い分けたい時)。そんな時に使用するのがコンテキストを指定した翻訳テキストである。
パラメータ$domainを省略した場合、国際化用ファイルはwp-content/languages/[ロケール名].moとなる。
テーマやプラグインで独自の国際化用ファイル(MOファイル)を使用する場合は、パラメータ$domainを指定しなければならない。

使用例

  • コンテキスト'user'で区別された'Add New'の翻訳テキストを取得する。
    <?php $text = _x( 'Add New', 'user' ); ?>
  • 自テーマの国際化用ファイル(ドメインが'mytheme'の場合)からコンテキスト'nav'で区別された'Video'の翻訳テキストを取得する。
    <?php $text = _x( 'Video', 'nav', 'mytheme' ); ?>

説明

string _x( string $text , string $context [ , string $domain = 'default' ] )
現在のロケールとコンテキストに応じた翻訳テキストを取得する。

パラメータ

  • $text
    英文テキスト。
  • $context
    コンテキスト情報。
  • $domain
    ドメイン名を指定(省略時は'default')。

返り値

パラメータ$textについて現在のロケール、パラメータ$contextに応じたの翻訳テキストを返す。翻訳テキストが見つからなかった場合は$textをそのまま返す。

注意

通常の翻訳テキストは __関数で取得できるが、同じ単語であってもであっても目的や用途によって異なる翻訳テキストにしたいケースがある(例えば、'Add New'の翻訳テキストをリンクとユーザーで使い分けたい時)。そんな時に使用するのがコンテキストを指定した翻訳テキストである。
パラメータ$domainを省略した場合、国際化用ファイルはwp-content/languages/[ロケール名].moとなる。
テーマやプラグインで独自の国際化用ファイル(MOファイル)を使用する場合は、パラメータ$domainを指定しなければならない。

使用例

  • コンテキスト'user'で区別された'Add New'の翻訳テキストを取得する。
    <?php $text = _x( 'Add New', 'user' ); ?>
  • 自テーマの国際化用ファイル(ドメインが'mytheme'の場合)からコンテキスト'nav'で区別された'Video'の翻訳テキストを取得する。
    <?php $text = _x( 'Video', 'nav', 'mytheme' ); ?>

最終更新 : 2014年12月23日 14:57



お勧め

スマートフォン向けの振り分けを自前で行う(2012年1月23日 更新)

PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。

使っていないか確認しないとね!(2017年11月18日 更新)

2003年に誕生したWordPress。その歴史の中には、廃止予定(deprecated)となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここでは3.24.9.0現在、廃止予定となっている関数をまとめて紹介する。

プラグインのロード順を制御する(2014年6月9日 更新)

これまでプラグインがどのような順番でロードされるか意識していなかったのだが、とある自作プラグインを他のプラグインよりも先にロードさせたくなったので調べてみた。

wp_titleからwp_get_document_titleへ(2018年5月27日 更新)

先週、WordPress 4.4 beta1(以降4.4 beta1)が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。

初期状態で「抜粋」ウィジェットを表示する(2014年1月7日 更新)

投稿編集ページのウィジェットは標準で表示されるものとされないものがある。フォーラムに『投稿の編集画面にデフォルトで抜粋を表示させたい』という投稿があったので、ちょっと調べてみた。