Baris itu menggunakan dua fungsi berbeda yang membutuhkan dua penjelasan terpisah.
__ ()
Ini adalah fungsi terjemahan. Jika pengaturan dilakukan dengan benar, itu akan menerjemahkan parameter pertama dari daftar string yang telah diterjemahkan sebelumnya. Jika suatu instalasi memiliki file dengan terjemahan yang dikompilasi untuk digunakan fungsi ini, itu akan menggunakannya. Tentu saja, plugin harus mengemas terjemahannya sendiri, maka parameter kedua. simplr-reg
memberitahu __()
bahwa terjemahan string 'Please fill out this form to sign up for this site'
harus dalam file terjemahan yang terkait 'simplr-reg'
(ini dilakukan sebelumnya dalam plugin dengan menggunakan load_plugin_textdomain()
fungsi).
Fungsi kemudian mengembalikan terjemahan. Jika tidak ada terjemahan yang dikembalikan (mis. Bahasa saat ini tidak memiliki terjemahan yang dikompilasi, string tidak memiliki terjemahan yang dikompilasi untuk paket itu, dll.), Input asli dikembalikan.
Jadi untuk situs WordPress dalam bahasa Inggris, __( 'This', 'simplr-reg' )
secara fungsional sama dengan 'This'
. Untuk mempelajari lebih lanjut tentang l10n (Pelokalan), bacalah di dalam kodeks:
http://codex.wordpress.org/I18n_for_WordPress_Developers
apply_filters ()
Fungsi ini memungkinkan Anda untuk memfilter nilai yang digunakan oleh plugin sesuai kebutuhan. Ini adalah salah satu konsep utama yang harus dipahami sebagai pengembang plugin. WordPress diperluas melalui pengait, yang pada dasarnya adalah titik akses yang memungkinkan Anda menentukan waktu pelaksanaan tindakan plugin Anda dan / atau memanipulasi informasi / data yang digunakan WordPress, dll.
Untuk memanipulasi data seperti cuplikan kode yang Anda tanyakan, Anda akan menggunakan fungsinya add_filter()
. Inilah contoh dasar bagaimana ini bekerja:
add_filter( 'simplr-reg-instructions', 'wpse16573_my_filter' );
Anda mungkin akan mengenali argumen pertama di sana. Itu sama dengan yang digunakan di add_filter
atas. Ini adalah nama pengait. Argumen kedua adalah panggilan balik filter. Itu harus berupa panggilan balik yang valid ke suatu fungsi ( baca lebih lanjut tentang panggilan balik di sini ). Baris kode itu mengatakan "Ketika 'simplr-reg-instructions'
hook dieksekusi, jalankan fungsinya dengan callback yang saya berikan." apply_filters()
mengeksekusi hook yang ditemukan dalam argumen pertamanya, pada dasarnya berarti "menjalankan semua fungsi yang terdaftar untuk hook ini." apply_filters
lalu meneruskan semua argumen lain (dalam hal ini, 'Please fill out this form to sign up for this site'
) ke fungsi pada filter itu. Jadi, panggilan balik yang saya gunakan di atas akan terlihat seperti ini:
function wpse16573_my_filter( $text ){
$text = "<strong>$text</strong>";
return $text;
}
Ada dua jenis kait di WordPress: filter (jenis yang kami gunakan di sini) dan tindakan. Perbedaan utama antara keduanya adalah filter berharap Anda mengembalikan sesuatu dan tindakan tidak. Jadi, untuk filter ini, contoh saya di atas menambahkan beberapa html sekitar 'Please fill out this form to sign up for this site'
dan mengembalikannya.
Baca lebih lanjut tentang tindakan dan kaitan di sini:
http://codex.wordpress.org/Plugin_API