Apa yang sebenarnya dilakukan apply_filters (…) di WordPress?

123

Saya mencoba untuk memahami beberapa fungsi di WordPress, tetapi saya tidak mengerti apa yang sebenarnya dilakukan apply_filters (...) .

Apakah seseorang dapat menjelaskan hal ini untuk saya dengan beberapa contoh?

wordpress function

— Tim
sumber

12

Luar biasa: dev.themeblvd.com/tutorial/filters

— Nabil Kadimi

Catatan yang apply_filters()merupakan nama yang sangat menyesatkan untuk fungsi tersebut karena menerapkan filter dan tindakan yang terkait dengan fungsi target

— cameronjonesweb

@NabilKadimi, saran bagus, dev.themeblvd.com/tutorial/filters/#highlighter_604585 , tetapi ketika fungsi ini tidak menerima argumen apa pun (silakan klik tautan untuk melihat fungsi mana yang saya bicarakan), bagaimana variabel $ output diubah , seperti yang dia jelaskan di bagian kode berikutnya?

— Ramesh Pareek

@RameshPareek Tautan Anda tampaknya tidak berfungsi seperti yang diharapkan, harap gunakan inti Github.

— Nabil Kadimi

Maaf! Gulir ke bawah ke Contoh 1: Dasar-dasar di halaman itu.

— Ramesh Pareek

104

apply_filters($tag, $value)meneruskan argumen 'nilai' ke setiap fungsi 'terkait' (menggunakan add_filter) ke dalam 'tag' filter yang ditentukan. Setiap fungsi melakukan beberapa pemrosesan pada nilai dan mengembalikan nilai yang dimodifikasi untuk diteruskan ke fungsi berikutnya dalam urutan.

Misalnya, secara default (di WordPress 2.9) the_contentfilter meneruskan nilai melalui urutan fungsi berikut:

wptexturize
convert_smilies
convert_chars
wpautop.dll
shortcode_unautop
prepend_attachment
do_shortcode

— Richard M
sumber

Juga ingatlah untuk menggemakan apa pun yang tidak Anda gunakan nilainya jika tampaknya itu apply_filters($value)menghapus nilai ...

— MrMesees

32

jawaban terlambat

Penjelasan singkat

apply_filters()berinteraksi dengan global $wp_filtersarray. Pada dasarnya ini hanya memeriksa array jika filter saat ini (atau hook) memiliki aksi (/ fungsi panggilan balik) terpasang dan kemudian memanggilnya.

Penjelasan panjang

Saat Anda memasang callback / action ke filter atau hook, maka Anda cukup menambahkan nama callback ke array filter global. Ketika kemudian, dalam kode (misalnya template, file inti atau plugin) panggilan ke do_action()atau apply_filters()terjadi, maka WordPress mencari melalui array dan memanggil callback. Satu-satunya hal yang lebih istimewa dengan filter daripada dengan hook adalah, ia mengembalikan nilai (untuk penanganan lebih lanjut) daripada hanya mengaktifkan callback. Kesimpulannya: Hooks untuk memasukkan data, sedangkan filter untuk mengubah data.

— kaisar
sumber

19

Inilah yang saya kumpulkan, setelah mempertimbangkan jawaban paling populer dan sumber daya tambahan:

$ tag sepertinya sinonim untuk nama kail. (Itu tidak terlalu intuitif bagi saya.)
the_content adalah contoh dari sebuah hook, dari tipe "filter".
hook the_content terdiri dari beberapa filter.
Filter mengubah data. Mereka pada dasarnya memfilter database, mengubah data sebelum pengguna melihatnya.
Penggunaan umum dari apply_filters (), misalnya, adalah untuk menerapkan filter the_content ke $ content. Dalam hal ini, pengembalian ganda akan diubah menjadi <p>tag, wajah tersenyum akan diubah menjadi ikon, dll.
"the_content" adalah hook, sedangkan "the_content ()" adalah fungsi.

— Marjorie Roswell
sumber

1

Dalam istilah yang paling dasar, apply_filters digunakan untuk menginisialisasi pengait filter ... add_filter memberikan fungsi baru ke pengait yang telah dibuat.

— Steve
sumber

3

Maaf, ini adalah cara yang salah: apply_filters () memanggil kait filter yang sudah diinisialisasi dan add_filter () adalah panggilan yang membuat kait filter. Saya tahu Anda benar-benar bermaksud demikian, tetapi Anda memiliki fungsi di sekitar cara yang salah!

— Brian C

apply_filters ($ tag, $ value); memungkinkan Anda untuk membuat tempat dalam kode Anda di mana Anda kemudian dapat mengizinkan nilai $ yang Anda berikan untuk dihubungkan dan dimodifikasi dengan menggunakan add_filter ();

— Styledev