1. Hiểu đúng về Action và Filter

• Action: là “điểm móc” (hook point) cho phép bạn chèn hành động vào một thời điểm cụ thể trong luồng chạy.
• Filter: là “điểm can thiệp” để thay đổi dữ liệu trước khi nó được sử dụng hoặc hiển thị.

Ví dụ:

// Action: in thêm HTML sau nội dung bài viết
add_action('the_content', 'append_notice');
function append_notice($content) {
    return $content . '<p>Cảm ơn bạn đã đọc!</p>';
}

Ở đây the_content là một filter hook – vì bạn đang thay đổi giá trị của $content – nhưng lại gọi bằng add_action, vẫn hoạt động được. Nhưng… không phải cách nên làm.

2. Sự khác biệt giữa do_action và apply_filters

Đây là hai hàm lõi tạo nên toàn bộ hệ thống hook:

do_action('hook_name', $param1, $param2, ...);
apply_filters('hook_name', $value, $param1, $param2, ...);

do_action() dùng để chạy các hàm không cần return.
apply_filters() dùng để truyền qua các hàm xử lý rồi trả kết quả về.

Ví dụ: bạn muốn cho phép người khác sửa nội dung nút:

$label = apply_filters('init_button_label', 'Gửi bình luận');

Ai đó có thể sửa như sau:

add_filter('init_button_label', function($label) {
    return 'Send it!';
});

3. Ưu tiên và số lượng tham số

Mỗi hook đều có thể được gắn nhiều lần. WordPress sẽ gọi theo thứ tự ưu tiên (mặc định là 10):

add_action('init', 'do_this_first', 5);
add_action('init', 'do_this_normal'); // Ưu tiên mặc định = 10
add_action('init', 'do_this_later', 20);

Nếu hook có nhiều tham số truyền vào, bạn phải khai báo đúng:

add_filter('the_title', 'my_title', 10, 2);

function my_title($title, $id) {
    if ($id === 42) return 'Tiêu đề đặc biệt';
    return $title;
}

4. Tự tạo hook trong plugin

Nếu bạn viết plugin, việc tạo hook giúp người khác mở rộng plugin dễ dàng:

do_action('initfx_effect_before_run', $effect_name);

Ai đó có thể hook vào:

add_action('initfx_effect_before_run', function($effect) {
    if ($effect === 'fireworks') {
        // Ghi log, thay đổi hiệu ứng...
    }
});

5. Gỡ hook bằng remove_action và remove_filter

Không phải lúc nào bạn cũng muốn hook nào đó hoạt động. Để gỡ, cần phải biết tên hàm và ưu tiên:

remove_action('init', 'default_function', 10);

Nếu hàm là ẩn danh hoặc closure, không thể remove được – vì không có tên hàm để đối chiếu.

6. Hook trong class – cẩn thận khi gán

Nếu viết hook trong class, bạn cần truyền đúng instance:

class MyPlugin {
    public function __construct() {
        add_action('init', [$this, 'run']);
    }

    public function run() {
        // ...
    }
}

Nếu bạn remove sau này, phải truyền đúng instance đó:

$plugin = new MyPlugin();
remove_action('init', [$plugin, 'run']);

Kết luận

Hook là nền tảng mở rộng của WordPress. Nhưng muốn dùng đúng – bạn phải hiểu sâu hơn mức chỉ “add_action là móc sự kiện, add_filter là thay dữ liệu”.

Hãy bắt đầu viết plugin với các hook riêng của bạn. Đừng ngại tạo thêm 1 dòng do_action hoặc apply_filters – vì đó là cách bạn mở cánh cửa cho người khác kết nối vào plugin của mình.