apply_filters( 'wpml_unfiltered_admin_string', mixed $default_value, string $option_name )
- סוג
- filter
- קטגוריה
- אחזור תוכן מותאם מקומית
- גרסת WPML
- 3.2.3-dev
תיאור
WPML תרגום מחרוזות מסנן את אפשרויות ההגדרות של ערכת העיצוב/התוסף כדי להחזיר את התרגומים של הערכים שלהן בשפה הנוכחית.
פירוש הדבר הוא שבהתקנת WordPress שבה שפות WPML מוגדרות, לדוגמה, לאנגלית כשפה ראשית ולגרמנית כשפה משנית, תוכל לצפות שהתרגומים לגרמנית יהיו הערכים שיתקבלו בעת קריאה ל:get_option('{theme_name}_settings'); כאשר השפה הנוכחית היא גרמנית. לאחר מכן, כאשר השפה הנוכחית היא אנגלית, יוצגו הערכים באנגלית.
עם זאת, פירוש הדבר הוא גם שכאשר ערך של אפשרות מעודכן באמצעות: update_option('{theme_name}_settings', $new_value); ערך האפשרות יעודכן בשתי השפות. ייתכן שזה לא תמיד רצוי.
כאן הפילטר שלעיל שימושי. הפילטר מאפשר לקבל ערך של אפשרות תוך עקיפת הפילטרים של WPML תרגום מחרוזות. מה שמוחזר הוא הערך בשפה שבה הוא התקבל, כך שפעולות נוספות שיבוצעו, כגון עדכון הערך במסד הנתונים, לא ישפיעו על שפות אחרות מלבד זו שאתה עובד איתה.
ארגומנטים
- $default_value
- (mixed) (נדרש) הערך שיוחזר במקרה שהמחרוזת אינה קיימת
- $option_name
- (string) (אופציונלי) שם האפשרות לאחזור. מצופה לקבל שם ללא SQL-escape.
דוגמה לשימוש
עבור הדוגמה שלהלן, תאר לעצמך שאתה צופה בשפה שאינה שפת ברירת המחדל.
ערך האפשרות שאתה מאחזר נשמר כמערך שעבר serialization. ברצונך לעדכן צמד מפתח-ערך יחיד במערך ולשמור אותו במסד הנתונים. אתה מצפה שרק השפה הנוכחית תושפע.
דוגמה
// retrieve option value is current language
$a = apply_filters( 'wpml_unfiltered_admin_string', get_option( 'my_option_name' ), 'my_option_name' );
// some operations ...
$a['number']++;
//update the value for the current language only
update_option('my_option_name', $a); הוקים קשורים
wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_single_string, wpml_translate_string, wpml_elements_without_translations, wpml_permalink, wpml_element_link