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) (ไม่บังคับ) ชื่อของตัวเลือกที่ต้องการดึงข้อมูล โดยคาดว่าจะเป็นชื่อที่ไม่ได้ผ่านการ escape สำหรับ SQL
ตัวอย่างการใช้งาน
สำหรับตัวอย่างด้านล่างนี้ สมมติว่าคุณกำลังดูภาษาอื่นที่ไม่ใช่ภาษาเริ่มต้น
ค่าตัวเลือกที่คุณกำลังดึงข้อมูลถูกบันทึกเป็นอาร์เรย์แบบ serialized คุณต้องการอัปเดตคู่คีย์-ค่าเพียงคู่เดียวในอาร์เรย์และบันทึกลงในฐานข้อมูล คุณคาดหวังว่าจะมีผลกับภาษาปัจจุบันเท่านั้น
ตัวอย่าง
// 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
ฮุก การดึงเนื้อหาที่ปรับให้เข้ากับท้องถิ่น ทั้งหมด 12 รายการ →