wpml_register_single_string

do_action( 'wpml_register_single_string', string $context, string $name, string $value )

סוג

action

קטגוריה

הכנסת תוכן

גרסת WPML

3.2

תיאור

רושם מחרוזת טקסט בודדת לתרגום (בניגוד למחרוזת שהיא חלק מחבילה). פעולה זו משמשת בדרך כלל עבור טקסטים של קלט משתמש המכונים גם “מחרוזות טקסט דינמיות”.

לאחזור תרגום מחרוזת, ראה: wpml_translate_single_string

לרישום מחרוזת טקסט שהיא חלק מחבילה, ראה: wpml_register_string

הערה: הוק זה דורש את המודול WPML תרגום מחרוזות

ארגומנטים

$context

(string) (נדרש) ערך זה מספק הקשר למחרוזת שאתה עומד לרשום. בדרך כלל זה יהיה שם התוסף או ערכת העיצוב, בפורמט קריא לאדם

$name

(string) (נדרש) שם המחרוזת שעוזר למתרגם להבין מה מתורגם

$value

(string) (נדרש) המחרוזת שדורשת תרגום

$allow_empty_value

(bool: false כברירת מחדל) (אופציונלי) האם ערך ריק מותר או לא

$source_lang_code

(string) (אופציונלי) קוד השפה עבור המחרוזת הרשומה

דוגמה לשימוש

תאר לעצמך שיצרת וידג’ט מותאם אישית עם שדה קלט לכותרת וכמה אפשרויות אחרות. אתה יכול לרשום את כותרת הווידג’ט לתרגום באמצעות apply_filters אבל אתה רוצה גם לרשום את טקסט הקלט שאתה יכול לשמור בשדות האפשרויות האחרים של הווידג’ט.

הדרך הטובה ביותר לרשום טקסטים של קלט לתרגום היא כאשר אפשרויות הווידג’ט נשמרות או מתעדכנות, כלומר בתוך מתודת ה־'update’ של וידג’טים.

להלן דוגמה לאופן שבו הקוד עשוי להיראות. לווידג’ט המותאם אישית בדוגמה שלנו יש כותרת, שדה קלט של שורה אחת ואזור טקסט.

function update($new_instance, $old_instance){
	$instance = $old_instance;
	$instance['title'] 		= strip_tags($new_instance['title']);
	$instance['custom_input'] 	= strip_tags($new_instance['custom_input']);
	$instance['custom_textarea'] 	= $new_instance['custom_textarea'];

	//WPML
	/**
	 * register strings for translation
	 */
	do_action( 'wpml_register_single_string', 'Widgets', 'Custom Widget - input field', $instance['custom_input'] );
	do_action( 'wpml_register_single_string', 'Widgets', 'Custom Widget - textarea field', $instance['custom_textarea'] );
	//WPML

	return $instance;
}

הוקים קשורים

wpml_set_element_language_details, wpml_make_post_duplicates, wpml_admin_make_post_duplicates, wpml_copy_post_to_language, wpml_delete_package, wpml_import_get_trid_from_imported_translations, wpml_register_string, wpml_show_package_language_ui, wpml_delete_package_action

כל 10 ההוקים בקטגוריה הכנסת תוכן →