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
- (مختلط) (مطلوب) القيمة التي سيتم إرجاعها في حال عدم وجود السلسلة النصية
- $option_name
- (سلسلة نصية) (اختياري) اسم الخيار المراد استرداده. يُتوقع أن يكون الاسم غير مُهرَّب بـ SQL.
مثال على الاستخدام
بالنسبة للمثال التالي أدناه، تخيل أنك تعرض لغة أخرى غير اللغة الافتراضية.
تُحفظ قيمة الخيار التي تستردها كمصفوفة متسلسلة. تريد تحديث زوج واحد من المفتاح والقيمة في المصفوفة وحفظه في قاعدة البيانات. تتوقع أن تتأثر اللغة الحالية فقط.
مثال
// 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