Panduan Permulaan Untuk Pengembangan Plugin WordPress

CMS WordPress telah mengubah wajah Internet kami dan membenarkan lonjakan idea-idea baru untuk berjaya dan pergerakan sumber terbuka memegang kehadiran yang kuat yang berakar pada perisian dan pembangunan web. WordPress adalah platform blog yang mempunyai keupayaan untuk melancarkan banyak skrip lain seperti forum web, papan kerja, dan juga laman web klasik Content Management System.

Kami akan meneruskan beberapa cara untuk memulakan pembangunan plug-in untuk WordPress. Langkah-langkahnya agak mudah dan tidak memerlukan dedikasi yang besar untuk belajar. Pengetahuan asas tentang PHP akan berguna walaupun dengan pemahaman asas mengenai struktur fail WordPress dan panel Pentadbiran.

Dalam tutorial ringkas ini, kami akan meneruskan langkah asas yang diperlukan untuk membuat pemalam WordPress mudah. Fungsi ini akan digunakan untuk membuat petikan dinamik berdasarkan nombor yang diluluskan ke panggilan fungsi kami. Anda perlu memuat naik fail pemalam dan aktifkan dari panel Admin, kemudian susulan dengan memanggil fungsi kami dari halaman apa sahaja yang kami mahu kutipan itu muncul. Pautan kepada kod sumber pemalam yang telah lengkap telah ditambahkan kemudian di dalam artikel ini :)

Mengapa Dibangunkan untuk WordPress?

Plug-in adalah cara yang bagus untuk meningkatkan fungsi blog anda dengan menambah ciri-ciri tambahan. Ini boleh diletakkan di mana-mana di dalam templat anda dengan cangkuk fungsi. Dari masa ke masa, sistem plug-in WordPress telah memperluas pertumbuhan dan ratusan pemaju perisian yang dikemukakan.

WordPress secara khusus menawarkan ciri-ciri canggih sedemikian dalam CMSnya bahawa plug-in unik adalah sedikit dan jauh di antara. Sebagai pemaju anda memegang kawalan penuh ke atas spesifik backend dari weblog anda. Menyewa pemaju PHP untuk membuat plugin sistem akan menelan kos lebih banyak daripada yang anda bayangkan dan API cukup mudah untuk berfungsi dan belajar sendiri.

Sebagai hujah menengah, membangunkan WordPress adalah amalan yang baik untuk menuntun diri ke kawasan lain. Membina plugin yang lebih kecil dan widget sidebar di WordPress akan membantu anda mengembangkan pemahaman tentang bagaimana sistem backend benar-benar berfungsi. Ini bukan hanya terhad kepada WordPress kerana anda akan mendapat pemahaman yang lebih mendalam mengenai kebanyakan Sistem Kandungan.

1. Struktur Folder WP

Pengenalan ke dalam struktur folder WordPress akan menunjukkan direktori aplikasi asas. Dalam kandungan wp anda akan dapati plugin direktori. Di sini adalah di mana semua plug-in individu anda akan ditempatkan, sama ada satu fail atau nama sub-direktori yang betul.

Untuk pemalam yang lebih kecil yang hanya memerlukan fail .php tunggal, anda mempunyai pilihan untuk meletakkannya terus ke dalam pemalam / direktori. Walau bagaimanapun, apabila anda mula membuat aplikasi yang lebih rumit, lebih berguna untuk membuat direktori sub yang dinamakan selepas pemalam anda. Di dalamnya anda boleh membina JavaScript, CSS, dan HTML termasuk bersama dengan fungsi PHP anda.

A readme.txt fail juga boleh berguna jika anda merancang untuk menawarkan plugin anda untuk muat turun. Fail ini harus termasuk nama anda dan apa yang plugin itu lakukan. Sebagai pengarang, anda juga boleh mempertimbangkan termasuk butir-butir mengenai setiap semakan dan kemas kini yang keluar.

2. Memulakan Fail PHP anda

Apabila membuat plugin baru, anda perlu memulakan dengan fail PHP yang mudah. Ini boleh dinamakan apa-apa tetapi pada umumnya akan mencerminkan nama rasmi plug-in anda. Oleh itu, contohnya saya telah mencipta kod asas kami dan telah menamakan fail saya hongkiat-excerpt.phps.

Baris pertama pemalam anda mestilah menjadi maklumat komen untuk enjin parsing. Ini sangat penting kerana WordPress tidak dapat memproses fail anda tanpa. Berikut ini adalah contoh snippit kod yang anda boleh salin dan acuan ke arah anda sendiri.

Nama Plugin ialah apa yang akan muncul di panel backend Admin anda apabila anda mengaktifkannya. Sama dengan URI yang akan diletakkan di dalam panel butiran di dalam panel pemalam. Walaupun ia tidak dikehendaki memasukkan versi atau keterangan, ia menjadikan plugin anda kelihatan lebih profesional.

3. Konvensyen Penamaan WordPress dan Amalan Terbaik

Terdapat beberapa cara untuk benar-benar menyusun pemalam anda. Ramai kali pemaju PHP akan membuat sistem kelas keseluruhan untuk mengelakkan pertembungan dengan fungsi dan nama berubah. Sekiranya anda tidak mengetahui dengan fungsi OOP maju PHP maka lebih baik anda hanya menulis kod anda dalam fungsi sampel.

Jadi bagi kod contoh kami, kami akan menulis satu fungsi untuk menempatkan data kami. Kita juga perlu menentukan beberapa pemboleh ubah yang penting untuk dilaksanakan di dalam fail template kami. Berikut adalah contoh bit kod yang diambil dari fail plugin kami dengan logik teras dikeluarkan.

Apabila menulis kod sampel anda sebaiknya mengikuti peraturan dan panduan yang ditetapkan oleh WordPress. Oleh kerana terdapat banyak fungsi dalaman yang telah ditentukan anda boleh mengelakkan pendua dengan menyusun label kepada semua pembolehubah dan nama fungsi anda.

Dalam contoh di atas, kami mengandaikan semua nama tetapan kami hongkiat. Ini boleh digantikan dengan kata kunci yang anda pilih biasanya berkaitan dengan nama plugin anda. Kod di atas adalah tepat tetapan sampel dan tidak sepatutnya berkaitan dengan pemalam akhir kami. Ini hanya memberi anda gambaran tentang bagaimana nama pemboleh ubah dan panggilan berfungsi harus ditulis.

4. Menyelam ke Penapis dan Tindakan

Terdapat satu lagi konsep yang perlu diberi perhatian sebelum kita melompat ke dalam kod mentah kita. Tindakan dan penapis adalah dua konsep yang berbeza yang berkaitan dengan cara mereka memanipulasi data pemalam.

Kedua-dua bit kod ini datang standard dalam API WordPress. Penapis dan tindakan membolehkan pemaju pemalam untuk mengemas kini bit kod di seluruh panel admin WordPress yang berkaitan dengan pemalam baru anda. Ini bermakna anda boleh menambah tab baru di bar sisi atau pautan tetapan tambahan untuk pilihan Plug-in anda.

Memahami add_filter ()

A penapis digunakan pada sedikit teks atau data yang diluluskan ke WordPress. Dengan penapis anda cukup mampu kandungan penapis melalui fungsi bertulis anda sendiri untuk menukar data dalam apa jua cara.

Sebagai contoh, anda boleh membuat penapis untuk berubah $ the_content yang merupakan pemboleh ubah yang ditetapkan oleh WordPress yang mengandungi kandungan keseluruhan artikel tulisan WordPress. Untuk pemalam kami, kami akan mengambil $ the_content dan memendekkan panjang aksara menjadi petikan.

Penapis berguna apabila anda menulis plug-in untuk menyesuaikan penampilan dan rasa blog anda. Ini sangat popular ketika menulis widget sidebar atau fungsi yang lebih kecil untuk mengubah cara posting harus dipaparkan. Di bawah adalah garisan contoh kod yang menunjukkan cara untuk menggunakan penapis.

add_filter ('wp_title', 'hongkiat_func');

Di sini kita menambah penapis ke tajuk halaman WordPress. Perhatikan kod ini tidak berkaitan dengan plugin rasmi kami dan hanya digunakan sebagai contoh di sini.

The add_filter fungsi berasal dari WordPress dan digunakan untuk menambah penapis baru kepada pembolehubah yang terdapat dalam kandungan halaman. Dalam baris di atas, kami menyasarkan $ wp_title yang mengandungi tajuk halaman semasa kami. Kami kemudian lulus pembolehubah ini menjadi fungsi palsu yang bertajuk hongkiat_func () yang kemudian dapat memanipulasi dan mengembalikan tag tajuk baru untuk tujuan apa pun.

Memahami add_action ()

Tindakan adalah sama dengan penapis kerana mereka tidak berfungsi pada bit data tetapi sebaliknya menargetkan kawasan yang telah ditetapkan dalam templat dan panel admin anda. Sebagai contoh, anda boleh memohon tindakan apabila anda mengemas kini atau mengedit kandungan halaman. WordPress menawarkan senarai tindakan komprehensif dalam dokumentasi API mereka. Berikut ialah senarai kecil contoh tindakan untuk anda mengenali beberapa kawasan sasaran yang telah ditentukan sebelumnya.

• publish_post - dipanggil apabila siaran diterbitkan atau apabila status ditukar menjadi “diterbitkan”
• save_post - dipanggil apabila jawatan / halaman dibuat dari mula atau dikemas kini
• wp_head - dipanggil apabila templat dimuat dan berjalan wp_head () fungsi
• loop_end - dipanggil segera selepas jawatan terakhir diproses melalui gelung WordPress
• trackback_post - dipanggil setiap kali trackback baru dimasukkan ke dalam jawatan

Sekali lagi kita dapat melihat betapa mudahnya kod kecil ini beralih ke. Jika anda dapat memahami perbezaan antara tindakan dan penapis, anda akan menjadi lebih dekat dengan membina plugin yang komprehensif dan berfungsi WordPress. Berikut adalah satu lagi baris kod yang memulakan fungsi tindakan pada save_post cangkuk. Untuk memperjelas sekali lagi ini tidak berkaitan dengan plugin kami yang sedang dibangunkan dan hanya digunakan sebagai sekeping kod contoh untuk memahami add_action () fungsi.

add_action ('save_post', 'notify');

Jadi di sini kita melihat persediaan yang sama sebelum ini add_filter (). Kami memerlukan 2 pembolehubah, yang pertama memegang nama cangkuk kami yang kami sasarkan. Dalam kes ini save_post yang bererti apabila jawatan baru diselamatkan kita akan memanggil fungsi kita ditakrifkan dalam kedudukan kedua (memberitahu ()). Anda dengan jelas boleh mengemaskini memberitahu apa nama fungsi yang anda mahu lari, namun ini tidak diperlukan untuk contoh semasa plug-in kami.

Menamatkan Logik Plugin kami

Menamatkan laluan kami, kami akan menambah fungsi terakhir kami ke dalam fail pemalam kami. Dokumentasi API sangat spesifik dan menyediakan sumber yang sangat baik kepada pemaju yang boleh memegang soalan lanjutan. Bahan mungkin kelihatan sukar jika anda tidak biasa dengan PHP tetapi mengambil masa anda dengan konsep dan hal-hal akan mula mengalir secara semula jadi!

Fungsi di bawah perlu ditambah terus selepas komen kepala plugin anda. Sebagai alternatif ini juga boleh diletakkan di dalam tema anda functions.php fail. Kod digunakan untuk membuat kandungan pos dinamik berdasarkan rangkaian watak terhad.

Jadi untuk contoh kami, kami boleh mengehadkan petikan cerita hanya 55 aksara yang panjang dengan hk_trim_content () fungsi. Anda boleh dengan mudah menyebut sedikit kod ini dari widget sidebar atau salah satu fail tema anda untuk menggantikan $ the_content.

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

Ia tidak seharusnya dijangka anda memahami sepenuhnya semua pembolehubah dalaman atau fungsi yang digunakan di sini. Hanya mendapat pemahaman umum tentang bagaimana fungsi anda harus ditulis dan apa contoh yang akan kelihatan seperti ini adalah permulaan yang sangat baik.

Anda juga dapat melihat bahawa kami menggunakan panggilan untuk apply_filters yang merupakan fungsi WordPress yang khusus. Ini adalah satu lagi aspek yang anda tidak perlu memahami sepenuhnya tetapi ia membantu dalam pengaturcaraan masa depan melalui WP. Lihat laman rujukan apply_filters untuk butiran lanjut dan Soalan Lazim mengenai subjek.

Fungsi teras di atas dinamakan hk_trim_content (). Ini hanya memerlukan 1 parameter bernama had $. Ini juga boleh dipendekkan $ lim yang sepatutnya menyimpan integer yang menyatakan berapa banyak aksara untuk mengehadkan petikan anda. Kandungan digunakan pada halaman pos penuh dan juga halaman statik (tentang kami, hubungi).

Oleh itu, untuk memanggil fungsi ini, kita perlu menambah parameter ke dalam fail template kami. Ini akan diletakkan di tempat yang mungkin di dalam anda index.php atau loop.php fail dan akan memerlukan anda memasang plugin terlebih dahulu. Contoh di bawah:

Memasang dan Menjalankan Plugin

Saya telah mencipta fail sampel untuk plugin untuk demo jika anda ingin melangkau pengekodan keras. Cukup muat turun fail ini (namakan semula kepada .php) atau salin / tampal kod itu ke dalam dokumen PHP baru dan muat naik ini kepada anda / wp-content / plugins direktori.

Setelah selesai, anda akan dapat mengakses panel pentadbiran WordPress dan menjelajah set plug semasa anda untuk demo yang dipasang. Sebaik sahaja anda mengaktifkan apa-apa yang baru akan berlaku, tidak sehingga kami menambah secara manual panggilan fungsi kami. Untuk melakukan ini, hanya menavigasi Rupa -> Editor dan cari single.php.

Fail ini mengandungi semua template HTML / CSS untuk halaman pos artikel asas anda. Tatal ke bawah sehingga anda dapati the_content () dan gantikan dengan kod contoh di atas. Ini akan mengehadkan semua halaman artikel anda kepada 55 aksara tidak kira pandangan mana yang digunakan. Anda juga boleh menambah fungsi ini ke halaman serupa dalam direktori templat anda seperti search.php atau arkib.php.

Kesimpulannya

Ini adalah beberapa asas untuk membuat anda mula bekerja dalam pembangunan WordPress. Sistem plugin sangat luas dan mengandungi banyak fungsi dalaman. Jika anda sudah mempunyai idea untuk plug-in mencubanya pada pemasangan WordPress tempatan untuk mengamalkan topik ini.

Jika anda masih keliru dengan banyak maklumat, anda boleh menyemak dokumentasi WordPress dan mencari jawapan anda di sana. Komuniti pembangunan penuh dengan pengguna yang berguna dan forum menyimpan arkib dengan soalan dari tahun ke tahun.