Rystiono 2.0

Note: Ini adalah artikel terjemahan dari http://lonewolf-online.net

Plugin ada bagian dari code tambahan yang digunakan untuk menambah kegunaan dari Wordpress, baik secara tak tampak (di belakang layar) maupun tampak secara visual.

Sebelum Wordpress versi 2.0, plugin yang tampak secara visual harus ditambahkan codenya secara manual (hand-coded) kedalam template theme. Hal ini membutuhkan pengetahuan tentang PHP. Di versi 2.0, mereka memperkenalkan “Widgets” yang terkait dengan plugin dan mengijinkan metode editing tanpa code untuk memasukkannya kedalam theme menggunakan “sidebars” dan sebuah “drag and drop interface”. Tutorial ini meliputi membuat Widget dan membuat plugin widget.

Membuat plugin sederhana.

Kamu dapat menggunakan cuplikan kode ini untu project kamu. Aku akan membuat plugin sederhana yang tidak menjalankan apa-apa kecuali menampilkan tulisan “Hello World”. Aku menyerahkan fungsi sebenarnya dari plugin ini kepada kamu.

Buat sebuah file php baru di dalam direktori plugin kamu dengan nama my-hello-world.php dan ketikkan kode plugin di bawah ini.

Baris didalam /* dan */ digunakan oleh Wordpress untuk mencari informasi tentang plugin. Kita punya satu function yang diberi nama sampleHelloWorld.

Sekarang, secara tradisional kita harus membuka sidebar dari theme yang kamu gunakan, temukan lokasi dimana kamu akan meletakannya dan meletakkan function itu disana. Upload ke server dan test. Jika ada kesalahan pada plugin kamu (atau plugin pihak ketiga) wordpress kamu akan berhenti berjalan. Merubah lokasi dari sidebar kiri ke sidebar kanan berarti melakukan editing pada kedua file ini. Ini sangat merepotkan.

Widgets

Widgets membuang keharusan melakukan editing terhadap file sidebar dari theme dan memberikan kita antar muka “drag and drop” di panel admin. Ayo kita coba membuat plugin kita widget-enable.

Buka file plugin Hello World lagi dan tambahkan baris ini :

Function pertama disini adalah yang akan ditampilkan pada sidebar ketika tertata secara benar. Untuk melakukan upgrade plugin yang non-widget, hanti function call dengan function statements dan kombinasikan keduanya.

Function kedua dipanggil oleh Wordpress ketika plugin diaktifkan. Ini memanggil function Wordpress yang akan mendaftarkan sebuah widget baru yang diberi nama “Hello World” yang akan memanggil fungsi widget baru.

Perluasan untuk kompatibilitas theme.

Ketika widget ini sudah berfungsi benar, kita dapat membuat semacam peningkatan untuk mendapatkan kecocokan dengan theme yang kita dipakai karena tidak tiap orang memakai theme yang kita pakai.

Wordpress akan melewatkan parameter pada widget kamu, yang berisi informasi tentang sidebar dan class CSS. Kita harus memproses parameter ini dan menghasilkan keluaran tag yang benar, atau kamu beresiko mematahkan theme.

Hal pertama yang kita perlu ubah adalah function sampleHelloWorld kita sehingga dapat menerima parameter ini, lalu memprosesnya menjadi variable. Ini bisa dilakukan dengan fungsi extract.

Dua line ini akan membuat kita mereferensi beberapa variabel dan menghasilkan keluaran html yang benar strukturnya untuk theme yang sedang digunakan. Variabel yang paling penting adalah before_widget, after_widget, before_title and after_title. Sebelum sekarang kita harus menambahkan secara manual tag H2 tag dengan class widgettitle, tapi beberapa themes tidak mensupport tag ini. Mereka mungkin menggunakan div, h1 atau span, dengan ini kita membuat theme kita jadi fleksibel.

Perubahan ini akan mengijinkan plugin kita untuk membuat tag yang sama dengan tag yang diinformasikan oleh pembuat theme. Dan akan membuat widget kamu tampak sama dengan widget lain di sidebar.

Plugin lengkapnya:

Testing your Plugin.

Jika kamu cek halaman plugin kamu sekarang, kamu seharusnya menemukan sebuah plugin baru bernama “Hello World” yang dapat kamu aktifkan. Pada Design tab, pilih widgets, dan kamu seharusnya menemukan widget kamu tersedia dan dapat dimasukkan kedalam sidebar. Simpan setting kamu dan lihatlah hasil kerjamu.