Apply_filters (…) thực sự làm gì trong WordPress?

Tôi đang cố gắng hiểu một số chức năng trong WordPress, nhưng tôi không thể hiểu được những gì apply_filters (...) thực sự làm.

Có ai đó có thể làm rõ điều này cho tôi với một vài ví dụ không?

apply_filters($tag, $value)chuyển đối số 'giá trị' cho mỗi hàm 'được nối' (sử dụng add_filter) vào 'thẻ' bộ lọc được chỉ định. Mỗi hàm thực hiện một số xử lý trên giá trị và trả về một giá trị đã sửa đổi để chuyển cho hàm tiếp theo trong chuỗi.

Ví dụ: theo mặc định (trong WordPress 2.9), the_contentbộ lọc chuyển giá trị qua chuỗi hàm sau:

• wptexturize
• convert_smilies
• convert_chars
• wpautop
• shortcode_unautop
• prepend_attachment
• do_shortcode

Câu trả lời muộn

Giải thích ngắn gọn

apply_filters()tương tác với global $wp_filtersmảng. Về cơ bản, nó chỉ kiểm tra mảng nếu bộ lọc hiện tại (hoặc hook) có một hành động (/ hàm gọi lại) được đính kèm và sau đó gọi nó.

Giải thích dài

Khi bạn đính kèm một lệnh gọi lại / hành động vào bộ lọc hoặc móc, thì bạn chỉ cần thêm tên gọi lại vào mảng bộ lọc chung. Khi đó, trong mã (ví dụ: mẫu, tệp lõi hoặc tệp plugin) một lệnh gọi đến do_action()hoặc apply_filters()xảy ra, thì WordPress đã tìm kiếm trong mảng và gọi lệnh gọi lại. Điều duy nhất đặc biệt hơn với bộ lọc so với hook là nó trả về giá trị (để xử lý thêm) thay vì chỉ kích hoạt callback. Tóm lại: Hook là để chèn dữ liệu, trong khi bộ lọc là để sửa đổi dữ liệu.

Đây là những gì tôi thu thập được, khi xem xét câu trả lời phổ biến nhất và các tài nguyên bổ sung:

• $ tag dường như là một từ đồng nghĩa với tên của hook. (Điều đó không đặc biệt trực quan đối với tôi.)
• the_content là một ví dụ về hook, thuộc loại "filter".
• hook the_content bao gồm nhiều bộ lọc.
• Bộ lọc sửa đổi dữ liệu. Về cơ bản, chúng lọc cơ sở dữ liệu, thay đổi dữ liệu trước khi người dùng xem nó.
• Ví dụ, một cách sử dụng phổ biến của apply_filters () là áp dụng các bộ lọc the_content cho $ content. Trong trường hợp này, trả về gấp đôi sẽ chuyển đổi thành <p>thẻ, mặt cười sẽ chuyển thành biểu tượng, v.v.
• "the_content" là một hook, trong khi "the_content ()" là một hàm.

Theo thuật ngữ cơ bản nhất, apply_filters được sử dụng để khởi tạo một hook bộ lọc ... add_filter chỉ định một chức năng mới cho các hook đã được tạo.