Panduan Permulaan untuk Membangunkan Plugin WordPress: Membina Sambungan Fungsi Pertama Anda Dari Awal

Inti pembangunan WordPress terletak pada arkitektur plugin yang kuat, yang membenarkan pembangun untuk memperluas fungsi laman web tanpa perlu mengubah kod asas. Sebuah plugin boleh bersaiz kecil, seperti menambahkan satu baris teks di bahagian kaki halaman, atau bersaiz besar, seperti membina sistem e-dagang yang lengkap. Panduan ini akan membimbing anda melalui proses pembuatan plugin pertama anda, memahami struktur asas plugin, garis panduan keselamatan, cara berinteraksi dengan kod asas WordPress, serta cara mengemas dan mengedarkan plugin tersebut. Melalui amalan, anda akan mempelajari kemahiran penting untuk menyumbang kepada sistem pengurusan kandungan yang paling popular di dunia ini.

Pengurusan persiapan dan persekitaran pembangunan

Sebelum menulis baris kod pertama, adalah sangat penting untuk membina sebuah persekitaran pembangunan tempatan yang profesional. Ini dapat memastikan proses pembangunan anda berjalan dengan cekap dan tidak mempengaruhi laman web yang berada dalam talian.

Membina persekitaran pelayan tempatan

Disyorkan untuk menggunakan pakej perisian pelayan tempatan yang terintegrasi, seperti Local by Flywheel, XAMPP, atau MAMP. Alat-alat ini memasang Apache/Nginx, PHP, dan MySQL dengan satu klik sahaja, dan sangat sesuai untuk keperluan operasi WordPress. Pastikan bahawa persekitaran anda menggunakan PHP 7.4 atau versi yang lebih baru, serta MySQL 5.6 atau versi yang lebih baru, untuk memenuhi konfigurasi yang disyorkan oleh WordPress untuk tahun 2026.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan untuk Membangunkan Plugin WordPress: Membina Ekstensi Fungsi Pertama Anda Dari Awal。

Mencipta fail plugin asas

Setiap plugin WordPress memerlukan sekurang-kurangnya satu fail PHP utama. Pertama sekali, dalam direktori pemasangan WordPress anda yang berada di lokal komputer anda…wp-content/pluginsDalam folder tersebut, buatlah sebuah folder baru. Nama folder tersebut seharusnya ringkas, terdiri daripada huruf kecil dan tanda hubung (-), sebagai contoh:my-first-pluginDalam folder ini, buat sebuah fail PHP dengan nama yang sama seperti folder tersebut.my-first-plugin.phpFail ini akan menjadi pintu masuk untuk plugin tersebut.

UltaHost – Penyedia Hosting untuk WordPress

Jaminan pemulangan wang dalam tempoh 30 hari, lebar jalur dan pangkalan data yang tidak terhad, perlindungan DDoS percuma, diskaun 50% untuk pembelian selama 3 tahun.

Lawati halaman

Membina struktur plugin pertama anda

Sebuah plugin yang standard bukan sahaja perlu mempunyai fungsi yang diperlukan, tetapi juga harus mengandungi metakumpulan maklumat (metadata) yang membolehkan WordPress mengenal pasti dan menguruskannya. Ini merupakan asas utama dalam pembangunan plugin.

Tambahkan komen di bahagian atas kod untuk plugin.

Di bahagian atas fail utama plugin, anda mesti menambahkan blok ulasan PHP yang khusus, iaitu “Maklumat Kepala Plugin”. WordPress membaca maklumat ini untuk menampilkan plugin anda dalam senarai plugin di panel pentadbiran. Berikut adalah contoh kepala plugin yang paling asas:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习的示例插件，它在文章页脚添加自定义文本。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Plugin NameIni adalah satu-satunya item yang wajib diisi; item lain walaupun boleh dipilih, tetapi ia dapat meningkatkan kualiti dan profesionalisme plugin tersebut.Text DomainDigunakan untuk terjemahan antarabangsa, biasanya selaras dengan nama folder plugin.

Implement a basic functional function

Mari kita laksanakan satu contoh klasik: menambahkan kenyataan hak cipta secara automatik di akhir setiap kandungan artikel. Ini memerlukan penulisan sebuah fungsi PHP dan menggunakannya untuk menyambungkannya dengan sistem penapis (filter) dalam WordPress.
Pertama sekali, definisikan fungsi-fungsi yang diperlukan dalam fail utama:

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan Pembangunan Plugin WordPress。

function myfp_add_footer_text( $content ) {
    // 仅在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $footer_text = '<p><em>Artikel ini pertama kali diterbitkan di blog saya. Sila berikan sumber apabila menggunakannya semula.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

Menyambungkan fungsi ke inti WordPress

Setelah fungsi didefinisikan, anda perlu memberitahu WordPress bila dan di mana ia perlu dijalankan. Ini dilakukan melalui…add_filterFungsi ini telah dilaksanakan. Selepas definisi fungsi di atas, tambahkan kod berikut:

add_filter( 'the_content', 'myfp_add_footer_text' );

Baris kod ini akan…myfp_add_footer_textFunction mountedthe_contentPenapis ini akan digunakan setiap kali WordPress bersedia untuk memaparkan kandungan artikel. Kandungan tersebut akan terlebih dahulu diproses oleh fungsi yang anda buat. Sekarang, anda boleh mengaktifkan “Plugin Pertama Saya” pada halaman “Plugin” di panel pentadbiran WordPress setempat, kemudian lihat mana-mana artikel. Teks yang anda buat sendiri sepatutnya sudah muncul di bahagian bawah artikel tersebut.

Mengkaji Keselamatan Plugin dan Amalan Terbaik

Pencapaian fungsi hanyalah langkah pertama; memastikan kod adalah selamat, cekap, dan mudah diselenggara merupakan ciri seorang pengembang profesional.

hosting.com Hosting Bersama

Prestasi tinggi, menampilkan CPU AMD EPYC, storan SSD NVMe dan LiteSpeed, dengan sokongan pakar dalaman 24/7, langkah keselamatan canggih termasuk SSL, perlindungan serangan paksa kata laluan, perisian hasad dan DDoS, menjimatkan sehingga 73%.

Lawati halaman

Gunakan kelas untuk mengapsulkan kod.

Seiring dengan peningkatan jumlah fungsi, meletakkan semua fungsi dalam ruang nama global (global namespace) boleh menyebabkan konflik. Penggunaan kelas PHP untuk mengemas kandungan fungsi-fungsi tersebut merupakan pilihan yang lebih baik. Berikut adalah contoh penataan semula yang dinyatakan di atas:

class My_First_Plugin {
    public function __construct() {
        // 在构造函数中挂载钩子
        add_action( 'init', array( $this, 'load_textdomain' ) );
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
    }

public function load_textdomain() {
        load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
    }

public function add_footer_text( $content ) {
        if ( is_single() && in_the_loop() && is_main_query() ) {
            $footer_text = '<p><em>' . esc_html__( '本文首发于我的博客，转载请注明出处。', 'my-first-plugin' ) . '</em></p>';
            $content .= $footer_text;
        }
        return $content;
    }
}
// 初始化插件类
new My_First_Plugin();

Berinteraksi dengan pangkalan data dengan selamat

Jika plugin anda memerlukan untuk menyimpan tetapan, sila gunakan ciri yang disediakan oleh WordPress.Options APIJangan sekali-kali melaksanakan kueri SQL secara langsung. Gunakan alat atau kaedah yang sesuai untuk mengurus dan menjalankan kueri tersebut.add_option、get_option和update_optionFungsi digunakan untuk mengakses data dengan selamat. Sebagai contoh, membenarkan teks di bahagian kaki halaman (footer) untuk disesuaikan:

// 保存设置
update_option( 'myfp_footer_text', sanitize_text_field( $_POST['footer_text'] ) );
// 获取设置
$saved_text = get_option( 'myfp_footer_text', '默认文本' );

Buat halaman Tetapan Pentadbiran

Menyediakan antara muka tetapan grafik untuk plugin dapat meningkatkan pengalaman pengguna dengan ketara. Anda boleh menggunakan ciri-ciri yang tersedia di WordPress untuk mencapai ini.Settings APIUntuk membuat halaman pilihan yang standard, terdapat beberapa langkah penting yang perlu diikuti:add_menu_page或add_submenu_pageHalaman pendaftaran fungsi, gunakanregister_settingPengaturan pendaftaran, serta penggunaannyaadd_settings_section和add_settings_fieldUntuk membina bidang borang (form fields).Settings APIPemprosesan pengesahan keselamatan (pemeriksaan Nonce, pengesahan hak akses) serta penyimpanan data akan dilakukan secara automatik.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan lengkap untuk pembangunan plugin WordPress: daripada tiada pengalaman hingga siap untuk dilancarkan.。

Menerbitkan dan menyelenggara plugin.

Setelah pembangunan selesai dan produk tersebut telah diuji dengan teliti, anda boleh mempertimbangkan untuk berkongsi hasil kerja anda.

Melakukan ujian akhir dan penyelesaian masalah (debugging).

Lakukan ujian yang menyeluruh pada pelayan tempatan dan pelayan sementara, termasuk: menguji pada pelbagai versi PHP, memeriksa keserasian dengan tema-tema popular dan plugin lain, memastikan semua input pengguna telah disahkan (validated) dan dibersihkan (sanitized), dan menggunakan ciri-ciri yang disediakan oleh WordPress.WP_DEBUGPeriksa mod untuk melihat sama ada terdapat sebarang amaran atau notis ralat.

Hosting Bersama InterServer

Hosting kongsi: 1TB/bulan pada $2.50 USD, bulan pertama pada $0.10 USD dengan kod promo tryinterserver. 461 skrip aplikasi awan tersedia untuk pemasangan satu klik.

Lawati halaman

Pakai plugin tersebut dan kemudian edarkannya.

Cipta sebuah fail kompresi ZIP yang bersih, yang hanya mengandungi folder plugin tersebut serta semua fail yang diperlukan (fail PHP utama,README.txtTerjemahkan fail, fail aset, dan sebagainya). Jangan termasuk direktori sistem kawalan versi (seperti…).gitAtau fail alat pembangunan. Anda boleh menghantar paket ZIP ini ke direktori plugin rasmi WordPress, yang memerlukan pematuhan kepada garis panduan semakan yang ketat, atau mengedarkannya ke laman web anda sendiri atau pasaran pihak ketiga.

Merancang Kemas Kini Versi dan Sokongan

Seiring dengan kemas kini terhadap kod asas WordPress, plugin anda juga perlu diselenggara. Adakan sistem pengurusan nombor versi yang teratur (seperti versi yang bermakna), dan jelaskan perubahan pada setiap versi dengan jelas di bahagian atas plugin serta dalam log kemas kini. Respons dengan cepat terhadap maklum balas pengguna di forum sokongan, dan teruskan memperbaiki kod; ini sangat penting untuk kejayaan jangka panjang plugin anda.

RINGKASAN

Pembangunan plugin WordPress merupakan proses praktikal yang mengubah idea-idea kreatif menjadi ciri-ciri fungsional yang berguna dalam sebuah sistem. Kita bermula dengan membina persekitaran pembangunan, mencipta struktur fail asas, kemudian secara beransur-ansur memperdalam pemahaman kita tentang cara untuk melaksanakan fungsi-fungsi utama, menerapkan amalan terbaik dalam pengaturcaraan berorientasikan objek (object-oriented programming) dan pengaturcaraan yang selamat (secure programming). Akhirnya, kita membincangkan langkah-langkah yang perlu diikuti untuk mengeluarkan dan menyelenggara plugin tersebut. Kuncinya adalah untuk memahami serta menggunakan dengan mahir pelbagai alat dan ciri yang disediakan oleh WordPress.Hook(Kekunci, termasuk Action dan Filter) bersama-sama denganAPI(Seperti API Options, API Settings), ia merupakan jambatan yang selamat untuk anda berinteraksi dengan dunia WordPress. Ingatlah, sebuah plugin yang baik bukan sahaja perlu berfungsi dengan baik, tetapi juga harus selamat, cekap, dan mudah digunakan oleh orang lain. Kini, anda telah mempelajari asas-asas pembinaan plugin pertama anda, dan langkah seterusnya adalah dengan terus berlatih serta membaca kod sumber untuk memperdalam kemahiran anda.

FAQ - Soalan Lazim

Adakah mustahil untuk mengembangkan plugin tanpa mahir dalam PHP?

Ya, pengetahuan PHP yang mahir adalah asas untuk pembangunan plugin WordPress. Anda perlu memahami sintaks PHP, fungsi, kelas, ruang nama (namespace), serta cara berinteraksi dengan pangkalan data dengan selamat. Pemahaman tentang HTML, CSS, dan JavaScript asas juga akan sangat membantu.

Mengapa laman web saya menunjukkan skrin putih setelah saya mengaktifkan plugin saya?

“Skrin putih dan sistem terhenti” biasanya disebabkan oleh ralat serius dalam PHP. Sila pastikan bahawa persekitaran pembangunan tempatan anda telah diaktifkan.WP_DEBUG“Mode.” Anda boleh menggunakannya pada laman web…wp-config.phpTambahkan kod berikut ke dalam fail untuk mengaktifkan mod pembangunan (debug mode):define( 'WP_DEBUG', true );Ini akan memaparkan maklumat ralat yang spesifik pada skrin, yang akan membantu anda mengenal pasti masalah tersebut.

Bagaimana untuk menangani konflik yang mungkin timbul antara pelbagai plugin?

Konflik biasanya berlaku disebabkan oleh pertindihan nama fungsi atau kelas, atau pengurusan keutamaan (priority) bagi hook yang sama yang tidak betul. Amalan terbaik untuk mencegah pertindihan nama adalah dengan menambahkan awalan yang unik kepada semua fungsi dan kelas anda (seperti menggunakan singkatan plugin). Bagi hook, anda boleh menggunakan…add_filter或add_actionparameter ketiga$priorityGunakan untuk menyesuaikan urutan pelaksanaan, dan gunakannya jika perlu.remove_actionPindahkan hook yang bercanggah dengan berhati-hati.

Bagaimana untuk menambahkan sokongan berbilang bahasa kepada plugin saya?

Anda perlu menggunakan ciri-ciri internasionalisasi (i18n) dan lokalisasi (l10n) dalam WordPress. Dalam kod, gunakan…__()、_e()Gunakan fungsi terjemahan untuk mengelilingi semua rentetan teks yang perlu diterjemahkan, dan tetapkan domain teks untuk plugin anda. Kemudian, gunakan alat seperti Poedit untuk membuat proses terjemahan tersebut..potFail templat, dan biarkan penterjemah menghasilkan versi dalam bahasa yang berbeza..mo和.poFail tersebut disimpan dalam plugin./languages/Dalam direktori tersebut.

Bolehkah saya menghantar plugin perniagaan ke direktori rasmi WordPress?

Ya, direktori plugin rasmi WordPress menerima plugin komersial yang selaras dengan falsafah perisian bebasnya (mengikut lesen yang serasi dengan GPL). Namun, yang dimaksud dengan “komersial” di sini adalah plugin tersebut mempunyai versi berbayar atau menyediakan sokongan berbayar, manakala versi yang dihantar ke direktori rasmi harus lengkap fungsi dan boleh digunakan secara percuma. Ciri-ciri tambahan berbayar, sokongan, atau peningkatan biasanya disediakan melalui laman web pembangun itu sendiri. Sebelum menghantar plugin, pastikan anda membaca dengan teliti panduan penghantaran plugin rasmi dan keperluan berkaitan lesen.