add_action() เป็นฟังก์ชันสำหรับเรียกใช้งาน Hook ของ WP
รูปแบบฟังก์ชัน add_action()
add_action( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 )
- string $stag ค่าพารามิเตอร์ตัวนี้คือชื่อของ hook ที่เราต้องการจะเรียกใช้ เช่น ‘wp_head’
- callable $function_to_add ค่าพารามิเตอร์ตัวนี้คือชื่อฟังก์ชันของเราที่เราเขียนขึ้นมาเอง เพื่อเพิ่ม code ของเราเข้าไปใน hook ที่เรากำหนด
- int $priority ค่าพารามิเตอร์ตัวนี้คือการจัดลำดับการทำงานให้กับมัน ว่าจะให้มันทำงานเป็นลำดับที่เท่าไหร่ ค่าเริ่มต้นคือ 10
- int $accepted ค่าพารามิเตอร์ตัวนี้คือการกำหนดจำนวนพารามิเตอร์ของฟังก์ชันเราว่ามีได้กี่พารามิเตอร์ ค่าเริ่มต้นคือ 1
การใช้งาน add_action()
รายการ hook ทั้งหมดของ WP
WordPress Action Reference
WordPress Filter Reference
wp_head
hook ที่ชื่อว่า wp_head เกิดขึ้นหลัง WP ได้สร้าง code ทั้งหมดที่อยู่ภายในแท็ก <head></head> เสร็จ
หลังเสร็จ WP สร้าง hook ที่ชื่อ wp_head ขึ้นมาให้เราเรียกใช้ hook wp_head เพื่อเขียน code ตัวเองเพิ่มต่อจาก code เดิมที่ WP ทำเอาไว้ได้
ตัวอย่าง ต้องการใส่ code ด้านล่างนี้เข้าไปใน <head>
<style>.wp_head_example {background-color : #f1f1f1;}</style>
ต้องสร้าง function ขึ้นมาใหม่หนึ่งฟังก์ชัน
function add_new_head() { ?> <style> .wp_head_example {background-color : #f1f1f1;}</style> <?php }
หลังจากสร้าง function เสร็จ ต้องเอาฟังก์ชันนี้ ใส่ add_action() ซึ่งจะได้แบบนี้
add_action(‘wp_head’, ‘add_new_head’);
Code สุดท้าย ใช้งานจริง จะได้แบบนี้
function add_my_style_to_head() { ?> <style> .wp_head_example {background-color : #f1f1f1;}</style> <?php } add_action('wp_head', 'add_my_style_to_head');