Tìm hiểu Hooks, Action và Filter trong lập trình WordPress

WordPress là phần mềm mã nguồn mở cho việc tạo lập website miễn phí và nhanh chóng, vì là phần mềm mã nguồn mở nên chúng ta có thể và được phép thay đổi cũng như bổ sung cấu trúc mã nguồn.

DANH SÁCH BÀI VIẾT
Cấu trúc mã nguồn của một Blugin WordPress cơ bản nhất
Hướng dẫn cài đặt WordPress trên Localhost nhanh nhất
Tìm hiểu Hooks, Action và Filter trong lập trình WordPress
Cấu trúc Database(Cơ sở dữ liệu) mã nguồn WordPress
Tìm hiểu cấu trúc tập tin và thư mục mã nguồn WordPress

Trong bài viết này chúng ta sẽ cùng tìm hiểu về Hooks, Action và Filter trong lập trình WordPress là gì, cách dùng ra sao. Một số Action hooks và Filter hooks thường dùng nhất.

1. Hooks WordPress là gì?

Trong WordPress, hooks là danh sách các điểm nhấn (điểm móc) nằm trong hệ thống mã nguồn của WordPress, tại đây bạn có thể bổ sung các đoạn code thông qua hai hàm add_action và add_filter mà WordPress đã cung cấp sẵn. Chúng ta có hai nhóm hooks chính đó là filter và action.

Ví dụ:

Bạn muốn kiểm tra loại bỏ những đường link mà người quản trị đã cố tình thêm vào khi sửa bài viết thì sẽ sử dụng đến hook có tên là save_post, và nó thuộc nhóm action.

• Kiếm tiền Accesstrade, kiếm tiền tại nhà với Accesstrade.vn – Tiếp thị liên kết
• MegaURL – Rút gọn link kiếm tiền có giá cao tại Việt Nam
• Top những App kiếm tiền online trên điện thoại tốt nhất hiện nay

add_action('save_post', 'function_name', 10, 2);

Bạn muốn khi hiển thị nội dung bài viết ra ngoài frontend thì thêm một dòng chữ ở vị trí cuối cùng của content thì có thể sử dụng hook có tên là the_content, và nó thuộc nhóm filter.

add_filter( 'the_content', 'function_name', 1 );

Mỗi hook sẽ có các tham số truyền vào khác nhau, Ví dụ với hook the_title thì sẽ có hai tham số truyền vào đó là $title và $id.

2. Filter hooks trong WordPress?

Filter hooks liên quan đến xử lý nội dung dữ liệu, đặc điểm chung của các filter là mỗi hook sẽ trả về một nội dung nào đó, sử dụng hàm add_filter để bổ sung một hành động vào hook.

Hàm add_filter có cấu trúc như sau:

add_filter ( $tag, $function_to_add, $priority, $accepted_args )

Trong đó:

• $tag: là tên của filter hook
• $function_to_add là hàm callback muốn bổ sung vào $tag
• $priority là mức độ ưu tiên của hàm callback, mức độ ưu tiên càng cao thì hàm callback đó sẽ được gọi trước. Giá trị mặc định là 10.
• $accepted_args là tổng số các tham số tham gia vào hàm callback và không được vượt quá tổng số của hook. Giá trị mặc định là 1

Ví dụ: Giả sử muốn khi in ra tiêu đề của các bài viết thì bổ sung thêm “ Tui có cách” ở cuối tiêu đề thì làm như sau.

Bạn mở file hook-filter.php lên và code như sau(Tất nhiên không bắt buộc là phải đặt nó tại hook-filter.php, có thể đặt bất cứ chỗ nếu chắc chán khi hiển thị kết quả nó sẽ gọi tới hàm này):

//Hàm bổ sung "tuicocach.com" váo cuối chuỗi tiêu đề
function add_string_to_title($content){
    return $content . ' - Tui có cách';
}
//Đưa hàm  add_string_to_title vào hook filter là the_title
add_filter("the_title", "add_string_to_title",10,1);

Trong đó:

• the_title là hook filter tiêu đề bài viết
• add_string_to_title là tên của hàm muốn bổ sung vào hook the_title.

Hook the_title sẽ truyền tiêu đề của bài viết vào hàm add_string_to_title và thực thi nó, sau đó lấy kết quả của hàm này trả về làm tiêu đề mới.

3. Action hooks trong WordPres?

Action hooks là danh sách các hook liên quan đến xử lý sự kiện. Ví dụ khi lưu một bài viết thì ta có hook save_post, khi người dùng comment thì có hook comment_post.

Để sử dụng được các Action hooks ta có hàm add_action, có cấu trúc như sau:

add_action ($tag, $function_to_add, $priority, $accepted_args )

Trong đó:

• $tag: là tên của Action hook
• $function_to_add là hàm callback muốn bổ sung vào $tag
• $priority là mức độ ưu tiên của hàm callback, mức độ ưu tiên càng cao thì hàm callback đó sẽ được gọi trước. Giá trị mặc định là 10.
• $accepted_args là tổng số các tham số tham gia vào hàm callback và không được vượt quá tổng số của hook. Giá trị mặc định là 1

Ví du: Khi lưu bài viết nếu bài viết ở trạng thái public thì hãy gửi email đến cho admin

Action hook lưu bài viết là save_post, hook này có ba tham số truyền vào đó là:

• $id: id bài viết đang lưu hoặc mới thêm
• $post: toàn bộ nội dung như title, content của bài viết
• $is_update: nếu TRUE tức hành động save post này là hành động update, ngược lại là hành động insert.

Bây giờ bạn mở file hook-action.php lên và code như sau:

function send_email_public($id, $post){
    //Viết code thực hiện gửi email ở đây
}
//Đưa hàm send_email_public vào hook action là wpcf7_before_send_mail
add_action('wpcf7_before_send_mail','send_email_public',11,2);

4. Các Hooks WordPress thông dụng nhất

Trong WordPress chúng ta có hơn tổng số là 1500 hooks, bao gồm cả các action hooks và filter hooks. Bảng dưới đây sẽ liệt kê một số hooks thường được dùng phổ biến nhất.