Panduan Pemula Untuk Pengembangan Plugin WordPress

CMS WordPress telah mengubah wajah Internet kami dan memungkinkan munculnya ide-ide baru untuk berkembang dan gerakan sumber terbukanya memegang kuat kehadiran yang berakar pada pengembangan perangkat lunak dan web. WordPress adalah platform blogging yang memiliki kemampuan untuk meluncurkan ke banyak skrip lain seperti forum web, papan pekerjaan, dan bahkan halaman web klasik Sistem Manajemen Konten.

Kami akan membahas beberapa cara untuk memulai pengembangan plug-in untuk WordPress. Langkah-langkahnya cukup sederhana dan tidak memerlukan dedikasi besar untuk belajar. Pengetahuan dasar tentang PHP akan berguna bahkan dengan pemahaman dasar tentang struktur file WordPress dan panel Administrasi.

Dalam tutorial singkat ini kita akan membahas langkah-langkah dasar yang diperlukan untuk membuat plug-in WordPress sederhana. Fungsionalitas akan digunakan untuk membuat kutipan dinamis berdasarkan nomor yang diteruskan ke panggilan fungsi kami. Anda harus mengunggah file plug-in dan mengaktifkannya dari panel Admin, kemudian menindaklanjuti dengan memanggil fungsi kami dari halaman apa pun yang kita inginkan kutipannya muncul. Tautan ke kode sumber plug-in yang lengkap sudah ditambahkan kemudian dalam artikel ini :)

Mengapa Dikembangkan untuk WordPress?

Pengaya adalah cara yang bagus untuk meningkatkan fungsionalitas blog Anda dengan menambahkan fitur tambahan. Ini dapat ditempatkan di mana saja di dalam template Anda dengan kait fungsi. Seiring waktu, ekstensibilitas sistem plug-in WordPress telah memungkinkan pertumbuhan luar biasa dan ratusan perangkat lunak yang dikirimkan pengembang.

WordPress secara khusus menawarkan fitur-fitur canggih dalam CMS-nya sehingga plug-in yang unik sedikit dan jarang. Sebagai seorang pengembang, Anda memegang kendali penuh atas spesifikasi backend dari weblog Anda. Menyewa pengembang PHP untuk membuat plugin sistem akan jauh lebih mahal daripada yang Anda bayangkan dan API cukup mudah untuk bekerja dan belajar sendiri..

Sebagai argumen kedua, mengembangkan lebih dari WordPress adalah praktik yang bagus untuk menyesuaikan diri Anda ke area lain. Membangun plugin dan sidebar widget yang lebih kecil di WordPress akan membantu Anda mengembangkan pemahaman tentang bagaimana sistem backend benar-benar bekerja. Ini tidak hanya terbatas pada WordPress karena Anda akan mendapatkan pemahaman yang lebih dalam tentang sebagian besar Sistem Konten.

1. Struktur Folder WP

Pengantar struktur folder WordPress akan menampilkan direktori aplikasi dasar. Di dalam konten-wp Anda akan menemukan plugin direktori. Di sinilah semua plug-in individual Anda akan ditempatkan, baik file tunggal atau sub-direktori yang dinamai dengan benar.

Untuk plug-in yang lebih kecil yang hanya memerlukan satu file .php Anda memiliki opsi untuk menempatkan ini langsung ke direktori plug-in /. Namun ketika Anda mulai mengembangkan aplikasi yang lebih rumit, akan jauh lebih berguna untuk membuat sub direktori yang dinamai setelah plug-in Anda. Di dalamnya Anda dapat menyimpan JavaScript, CSS, dan HTML beserta fungsi PHP Anda.

SEBUAH readme.txt file juga dapat berguna jika Anda berencana menawarkan plugin untuk diunduh. File ini harus menyertakan nama Anda dan apa yang dilakukan plugin. Sebagai penulis, Anda juga dapat mempertimbangkan untuk memasukkan rincian tentang setiap revisi dan pembaruan mana yang telah keluar.

2. Mulai File PHP Anda

Saat membuat plugin baru Anda harus mulai dengan file PHP sederhana. Ini bisa dinamai apa saja tetapi umumnya harus mencerminkan nama resmi plug-in Anda. Jadi misalnya saya telah membuat kode dasar kami dan menamai file saya hongkiat-excerpt.phps.

Baris pertama plug-in Anda harus menjadi informasi komentar untuk mesin parsing. Ini sangat penting karena WordPress tidak akan dapat memproses file Anda tanpa. Di bawah ini adalah contoh kode snippit yang dapat Anda salin dan cetak sendiri.

Nama Plugin adalah apa yang akan muncul di panel backend Admin Anda ketika Anda pergi untuk mengaktifkan. Sama dengan URI yang akan ditempatkan di panel rincian di dalam panel plug-in. Meskipun tidak perlu menyertakan versi atau deskripsi, plugin ini membuat plugin Anda terlihat jauh lebih profesional.

3. Konvensi Penamaan WordPress dan Praktik Terbaik

Ada beberapa cara untuk benar-benar menyusun plug-in Anda. Berkali-kali pengembang PHP akan membuat seluruh sistem kelas untuk menghindari tabrakan dengan fungsi dan nama variabel. Jika Anda tidak terbiasa dengan fungsionalitas OOP lanjutan dari PHP maka yang terbaik adalah menuliskan kode Anda dalam fungsi sampel.

Jadi untuk kode contoh kita, kita akan menulis satu fungsi untuk menyimpan data kita. Kita juga perlu mendefinisikan beberapa variabel yang merupakan kunci untuk diterapkan di dalam file template kita. Di bawah ini adalah contoh sedikit kode yang diambil dari file plugin kami dengan logika inti dihapus.

Saat menulis kode sampel Anda, yang terbaik adalah mengikuti peraturan dan panduan yang dibuat oleh WordPress. Karena ada begitu banyak fungsi internal yang sudah ditetapkan, Anda dapat menghindari duplikat dengan mengawali label ke semua variabel dan nama fungsi Anda.

Dalam contoh di atas, kami awali semua nama pengaturan dengan hongkiat. Ini dapat diganti dengan kata kunci pilihan Anda yang biasanya terkait dengan nama plugin Anda. Kode di atas hanya pengaturan sampel dan seharusnya tidak berkaitan dengan plug-in terakhir kami. Ini hanya untuk memberi Anda beberapa wawasan tentang bagaimana nama variabel Anda dan panggilan fungsi harus ditulis.

4. Menyelam Menjadi Filter dan Aksi

Ada konsep lain yang perlu disebutkan sebelum kita beralih ke kode mentah kita. Tindakan dan filter adalah dua konsep yang sangat berbeda yang sangat terkait dengan cara mereka memanipulasi data plugin.

Kedua bit kode ini menjadi standar dalam WordPress API. Filter dan tindakan memungkinkan pengembang plug-in untuk memperbarui bit kode di seluruh panel admin WordPress yang berkaitan dengan plug-in baru Anda. Ini berarti Anda bisa menambahkan tab baru di bilah sisi atau tautan pengaturan tambahan untuk opsi Plug-in Anda.

Memahami add_filter ()

SEBUAH filter digunakan pada sedikit teks atau data yang diteruskan ke WordPress. Dengan filter, Anda benar-benar dapat melakukannya saring konten melalui fungsi tertulis kustom Anda sendiri untuk mengubah data dengan cara apa pun.

Misalnya, Anda dapat membuat filter untuk diubah $ the_content yang merupakan set variabel oleh WordPress yang berisi seluruh konten posting artikel WordPress. Untuk plug-in kami akan mengambil $ the_content dan memperpendek panjang karakter menjadi kutipan.

Filter sangat berguna ketika Anda menulis plug-in untuk menyesuaikan tampilan dan nuansa blog Anda. Ini sangat populer saat menulis widget bilah sisi atau fungsi yang lebih kecil untuk mengubah cara posting ditampilkan. Di bawah ini adalah contoh baris kode yang menunjukkan cara menerapkan filter.

add_filter ('wp_title', 'hongkiat_func');

Di sini kami menambahkan filter ke judul halaman WordPress. Perhatikan bahwa kode ini tidak terkait dengan plugin resmi kami dan hanya digunakan sebagai contoh di sini.

Itu add_filter fungsi adalah asli WordPress dan digunakan untuk menambahkan filter baru ke variabel yang ditemukan dalam konten halaman. Pada baris di atas kami menargetkan $ wp_title yang berisi judul halaman kami saat ini. Kami kemudian meneruskan variabel ini ke fungsi palsu berjudul hongkiat_func () yang kemudian dapat memanipulasi dan mengembalikan tag judul baru untuk tujuan apa pun.

Memahami add_action ()

Tindakan serupa dengan filter karena mereka tidak bekerja pada bit data tetapi malah menargetkan area yang telah ditentukan di template dan panel admin Anda. Sebagai contoh, Anda dapat menerapkan tindakan setiap kali Anda memperbarui atau mengedit konten halaman. WordPress menawarkan daftar tindakan komprehensif dalam dokumentasi API mereka. Di bawah ini adalah daftar kecil tindakan contoh agar Anda terbiasa dengan beberapa area target yang telah ditentukan.

• publish_post - dipanggil ketika posting dipublikasikan atau ketika status diubah menjadi “diterbitkan”
• save_post - dipanggil ketika posting / halaman dibuat dari awal atau diperbarui
• wp_head - dipanggil ketika templat dimuat dan menjalankan wp_head () fungsi
• loop_end - dipanggil segera setelah posting terakhir diproses melalui loop WordPress
• trackback_post - dipanggil setiap kali trackback baru ditambahkan ke pos

Sekali lagi kita dapat melihat betapa sederhananya sedikit kode ini. Jika Anda dapat memahami perbedaan antara tindakan dan filter, Anda akan semakin dekat dengan membangun plugin WordPress yang komprehensif dan berfungsi. Di bawah ini adalah baris kode lain yang menginisialisasi fungsi tindakan pada menu save_post menghubungkan. Untuk memperjelas lagi ini tidak berkaitan dengan plugin kami yang sedang berkembang dan hanya digunakan sebagai contoh kode untuk memahami add_action () fungsi.

add_action ('save_post', 'notify');

Jadi di sini kita melihat pengaturan yang sama dengan sebelumnya add_filter (). Kami membutuhkan 2 variabel, yang pertama memegang nama hook kami yang kami targetkan. Pada kasus ini save_post yang berarti setiap kali posting baru disimpan kita akan memanggil fungsi kita didefinisikan di posisi kedua (memberitahukan()). Anda jelas dapat memperbarui pemberitahuan menjadi nama fungsi apa pun yang ingin Anda jalankan, namun ini tidak diperlukan untuk contoh plug-in kami saat ini.

Menyelesaikan Logika Plugin kami

Selesai di jalur kami, kami akan menambahkan fungsi final kami langsung ke file plug-in kami. Dokumentasi API sangat spesifik dan menyediakan sumber yang bagus untuk pengembang yang mungkin memiliki pertanyaan tingkat lanjut. Materi mungkin terlihat sulit jika Anda tidak terbiasa dengan PHP tetapi luangkan waktu Anda dengan konsep dan hal-hal akan mulai mengalir secara alami!

Fungsi di bawah ini harus ditambahkan langsung setelah komentar tajuk plugin Anda. Atau ini juga bisa ditempatkan di dalam tema Anda functions.php mengajukan. Kode ini digunakan untuk membuat konten posting dinamis berdasarkan rentang karakter yang terbatas.

Jadi sebagai contoh, kita dapat membatasi cuplikan cerita dengan panjang hanya 55 karakter hk_trim_content () fungsi. Anda dapat dengan mudah memanggil sedikit kode ini dari widget sidebar atau salah satu file tema Anda untuk mengganti $ the_content.

= $ limit) array_pop ($ content); $ content = implode ("", $ content). '...';  else $ content = implode ("", $ content);  $ content = preg_replace ('/\[.+\[/', ", $ content); $ content = apply_filters ('the_content', $ content); return $ content;?> 

Seharusnya tidak diharapkan bahwa Anda sepenuhnya memahami semua variabel internal atau fungsi yang digunakan di sini. Hanya mendapatkan pemahaman umum tentang bagaimana fungsi Anda harus ditulis dan seperti apa contohnya akan menjadi awal yang baik.

Anda juga mungkin memperhatikan kami menggunakan panggilan untuk apply_filters yang merupakan fungsi khusus WordPress lainnya. Ini adalah aspek lain yang tidak perlu Anda pahami sepenuhnya tetapi itu membantu pemrograman di masa depan melalui WP. Lihat halaman referensi apply_filters untuk perincian lebih lanjut dan FAQ tentang masalah ini.

Fungsi inti di atas diberi nama hk_trim_content (). Ini hanya membutuhkan 1 parameter bernama $ limit. Ini juga bisa disingkat menjadi $ lim yang harus menyimpan integer yang menentukan jumlah karakter untuk membatasi kutipan Anda. Konten tersebut digunakan pada halaman posting penuh dan juga halaman statis (tentang kami, kontak).

Oleh karena itu, untuk memanggil fungsi ini kita perlu menambahkan parameter ke file template kita. Ini akan ditempatkan di suatu tempat di Anda mungkin index.php atau loop.php file dan akan meminta Anda untuk menginstal plugin terlebih dahulu. Contoh di bawah ini:

Menginstal dan Menjalankan Plugin

Saya telah membuat file sampel untuk plugin untuk demo jika Anda ingin melewatkan pengodean keras. Cukup unduh file ini (ganti namanya menjadi .php) atau salin / tempel kode ke dalam dokumen PHP baru dan unggah ini ke Anda / wp-content / plugins direktori.

Setelah selesai Anda akan ingin mengakses panel administrasi WordPress dan menelusuri set plug-in Anda saat ini untuk demo yang baru saja diinstal. Setelah Anda mengaktifkan tidak ada hal baru yang akan terjadi, tidak sampai kami secara manual menambahkan panggilan fungsi kami. Untuk melakukan ini cukup menavigasi Penampilan -> Editor dan cari single.php.

File ini berisi semua templat HTML / CSS untuk halaman posting artikel dasar Anda. Gulir ke bawah sampai Anda menemukan the_content () dan ganti dengan kode contoh di atas. Ini akan membatasi semua halaman artikel Anda hingga 55 karakter tidak peduli apa pun tampilan yang digunakan. Anda juga bisa menambahkan fungsi ini ke halaman serupa di direktori template Anda seperti search.php atau archive.php.

Kesimpulan

Ini adalah beberapa dasar untuk membantu Anda mulai bekerja dalam pengembangan WordPress. Sistem plugin sangat luas dan berisi banyak fungsi internal. Jika Anda sudah memiliki ide untuk plug-in coba di instalasi WordPress lokal untuk mempraktekkan topik ini.

Jika Anda masih bingung dengan banyak informasi, Anda dapat meninjau dokumentasi WordPress dan mencari jawaban Anda di sana. Komunitas pengembang penuh dengan pengguna yang sangat membantu dan forum menyimpan arsip dengan pertanyaan dari tahun-tahun sebelumnya.