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