apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
- タイプ
- filter
- カテゴリー
- ローカライズされたコンテンツの取得
- WPMLバージョン
- 3.2
説明
*（パッケージ**の一部である文字列とは異なり）個別のテキスト文字列の翻訳を取得します。フィルターは、一致する$domainと$nameを持つ文字列を検索します。見つかった場合、現在の言語、または指定した言語の翻訳を検索します。翻訳が存在する場合は、それを返します。それ以外の場合は、元の文字列を返します。
*翻訳用に文字列を登録するには、次を参照してください: wpml_register_single_string
**パッケージの一部である文字列の翻訳を取得するには、次を参照してください: wpml_translate_string
注意: このフックにはWPML 文字列翻訳モジュールが必要です
引数
- $original_value
- (string) (必須) 文字列の元の値
- $domain
- (string) (必須) 文字列の登録済みドメイン
- $name
- (string) (必須) 文字列の登録名
- $language_code
- (string) (任意) この言語での翻訳を返します。デフォルトはNULLで、現在の言語を返します
使用例
「wpml_register_single_string」アクションフックで使用したウィジェットと同じ例を取り上げます。内容を確認したい場合は、そちらを参照してください。ウィジェットの出力関数で「wpml_translate_single_string」フィルターを使用します。
例
function widget($args, $instance){
extract($args);
$title = apply_filters('widget_title', $instance['title'] );
$custom_input = apply_filters('wpml_translate_single_string', $instance['custom_input'], 'Widgets', 'Custom Widget - input field' );
$custom_textarea = apply_filters('wpml_translate_single_string', $instance['custom_textarea'], 'Widgets', 'Custom Widget - textarea field' );
# Before the widget
echo $before_widget;
# The title
if ( $title )
echo $before_title . $title . $after_title;
# Output...
関連するフック
wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_string, wpml_elements_without_translations, wpml_permalink, wpml_unfiltered_admin_string, wpml_element_link