Panduan Lengkap Pembangunan Plugin WordPress: Dari Permulaan Hingga Mahir Membina Fungsi Khusus

Mengapa memilih untuk membangunkan plugin untuk WordPress?

WordPress, sebagai sistem pengurusan kandungan yang paling popular di dunia, keupayaannya untuk diperluas (scalability) adalah terutamanya berkat kehadiran plugin. Dengan mengembangkan plugin khusus, pembangun dapat menambahkan fungsi-fungsi yang diperlukan ke laman web tanpa perlu mengubah kod asas, yang memastikan keselamatan proses peningkatan versi dan kebebasan fungsi laman web tersebut. Sama ada untuk memenuhi keperluan perniagaan tertentu, mengoptimumkan proses kerja, atau mencipta produk dalam ekosistem WordPress yang luas, pengembangan plugin merupakan kemahiran yang sangat berharga.

Berbeza dengan mengubah suai kandungan topik secara langsung…functions.phpBerbanding dengan fail biasa, plugin mengemas logik fungsional dalam modul yang berasingan. Ini bermakna walaupun tema diganti, fungsi yang disediakan oleh plugin masih boleh berfungsi dengan baik. Selain itu, plugin yang mempunyai struktur yang baik boleh dipindahkan dan digunakan semula dengan mudah di antara laman web yang berbeza, yang sangat meningkatkan kecekapan pembangunan.

Bina pemalam pertama anda

Langkah pertama dalam memulakan pembangunan plugin adalah memahami struktur asas sebuah plugin. Semua plugin WordPress disimpan di…/wp-content/plugins/Dalam direktori tersebut, setiap plugin mempunyai folder yang berasingan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan Pembangunan Plugin WordPress: Buat Plugin Pertama Anda Dari Kosong。

Buat fail plugin utama

Inti daripada plugin tersebut adalah sebuah fail utama dalam bahasa PHP. Anda perlu membuat folder baru, sebagai contoh…my-first-pluginDan dalamnya, buat sebuah fail PHP dengan nama yang sama seperti folder tersebut:my-first-plugin.phpKomen di bahagian atas fail ini sangat penting, kerana ia memberikan maklumat meta tentang plugin kepada WordPress.

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

<?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
 * Domain Path:       /languages
 */

Setelah menyimpan fail tersebut, anda akan dapat melihat dan mengaktifkannya pada halaman “Plugin” di bahagian belakang WordPress (backend). Walaupun ia belum mempunyai sebarang fungsi pada masa ini, anda telah berjaya membuat sebuah kerangka plugin yang sah.

Menambahkan fungsi asas untuk plugin

Setelah mengaktifkan plugin tersebut, kita boleh mula menambahkan fungsi-fungsi asas kepadanya. Sebuah contoh mudah untuk permulaan adalah dengan menambahkan baris teks khusus di bahagian kaki laman web (footer) sesuatu laman web. Ini boleh dilakukan dengan menggunakan…wp_footerAks ini dilaksanakan menggunakan Hook Aksi (Action Hook).

Dalam fail utama plugin, tambahkan kod berikut:

// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
    echo '<p style="text-align: center;">Terima kasih kerana menggunakan perkhidmatan yang disokong oleh plugin pertama saya!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );

Di sini, kita telah mendefinisikan sebuah fungsi.my_first_plugin_footer_text()Kemudian gunakanadd_action()Fungsi tersebut akan menggunakannya untuk pemasangan (mounting).wp_footerPada “hook” tersebut, apabila WordPress menjalankan bahagian kaki halaman (footer), fungsi kita akan dipanggil secara automatik untuk menghasilkan kandungan HTML yang telah ditetapkan sebelumnya. Ini menunjukkan penggunaan asas mekanisme “hook dan callback” dalam WordPress.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan Pembangunan Plugin WordPress: Bina Plugin Fungsi Pertama Anda Dari Kosong。

Menggali Lebih Dalam: Hook dan Filter

Falsafah utama dalam pembangunan plugin WordPress adalah berdasarkan konsep “Hook” (Pegangan). Terdapat dua jenis Hook: Action Hooks dan Filter Hooks. Memahami kedua-duanya adalah kunci untuk anda bermula dari tahap asas dan maju ke tahap kecekapan yang lebih tinggi.

Mengerti tentang “action hook” (tangkai tindakan)

Action hooks membenarkan anda menyisipkan kod sendiri pada titik masa tertentu semasa WordPress dijalankan. Seperti yang dilihat dalam contoh di atas…wp_footerIa akan diaktifkan semasa proses pembuatan kod HTML untuk bahagian kaki halaman (footer). Satu lagi hook tindakan yang sering digunakan ialah…initIa dilaksanakan selepas WordPress selesai memuatkan kandungan asas dan sebelum memproses permintaan pengguna. Ia sering digunakan untuk menginisialisasi tetapan plugin, mendaftar jenis artikel khusus, dan lain-lain tindakan yang berkaitan dengan konfigurasi sistem.

// 在初始化时执行一些操作
function my_plugin_init_action() {
    // 例如，在这里可以注册一个自定义文章类型
    // if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );

Menguasai filter hooks

Berbeza dengan hook tindakan (action hook), hook penapis (filter hook) digunakan untuk mengubah data. Ia menerima sebuah nilai, membenarkan anda membuat pengubahsuaian pada nilai tersebut, dan kemudian mengembalikan nilai yang telah diproses. Sebuah contoh klasik ialah…the_contentPenapis ini membenarkan anda mengubah kandungan utama artikel atau halaman.

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

// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">Kandungan artikel ini dihasilkan melalui proses penapisan oleh plugin saya.</div>';
        $content .= $extra_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );

Dalam contoh ini, fungsi…my_plugin_content_filter()Menerima yang asli$contentPeriksa sama ada halaman tersebut merupakan halaman untuk satu artikel sahaja, kemudian tambahkan segmen HTML di bahagian akhirnya. Akhirnya, kembalikan kandungan yang telah diubah suai. WordPress akan menggunakan nilai yang dikembalikan ini untuk menggantikan kandungan asal dan memaparkannya.

Membina plugin yang boleh disesuaikan

Sebuah plugin profesional biasanya memerlukan antara muka pengurusan yang membenarkan pengguna untuk membuat konfigurasi. Ini melibatkan penciptaan halaman tetapan di bahagian belakang WordPress, pemprosesan data daripada borang, dan penyimpanan data tersebut dengan selamat.

Membuat menu pengurusan dan halaman

Gunakanadd_menu_page()或add_options_page()Fungsi tersebut boleh menambahkan satu item menu dan halaman tetapan untuk plugin anda di latar belakang. Ini biasanya dilakukan…admin_menuTindakan tersebut telah selesai dalam fungsi “action hook”.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan Pembangunan Plugin WordPress: Dari Kosong Hingga Mahir Membina Fungsi Khusus。

// 添加插件管理菜单
function my_plugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

// 设置页面的HTML内容
function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Tetapan-tetapan plugin saya</h1>
        <form method="post" action="/ms/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'my_plugin_settings_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Pengaturan pendaftaran, bidang data, dan pengurusan keselamatan

Seterusnya, anda perlu menggunakan WordPress Settings API untuk mendaftar tetapan, medan (fields), dan mengurus proses penyimpanan data. Ini memastikan keselamatan data melalui pengesahan data, pemeriksaan hak akses, serta penyimpanan data yang teratur (serialization).

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个新的设置项到“my_plugin_settings_group”
    register_setting( 'my_plugin_settings_group', 'my_plugin_options' );

// 在设置页面添加一个区域
    add_settings_section(
        'my_plugin_section_id',
        '基础配置',
        null,
        'my-plugin-settings'
    );

// 向该区域添加一个字段
    add_settings_field(
        'my_plugin_text_field',
        '提示文本',
        'my_plugin_text_field_render',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 渲染文本框字段
function my_plugin_text_field_render() {
    $options = get_option( 'my_plugin_options' );
    ?>
    <input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
    <p class="description">Teks yang dimasukkan di sini akan dipaparkan di halaman depan laman web.</p>
    &lt;?php
}

Dengan cara ini, data yang dimasukkan oleh pengguna di bahagian frontend akan melalui proses pengurusan keselamatan yang terbina dalam WordPress, seperti pemprosesan non-cescape dan pengesahan, sebelum disimpan dalam bentuk array.wp_optionsDalam jadual tersebut. Kod plugin anda boleh digunakan melalui…get_option( ‘my_plugin_options’ )Dapatkan nilai-nilai ini dengan selamat.

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

Patuhi amalan terbaik dan bersiap sedia untuk penerbitan.

Membangunkan sebuah plugin yang berkualiti tinggi, mudah diselenggara, dan selamat memerlukan pematuhan kepada satu siri amalan terbaik (best practices).

Pengurusan Kod dan Keselamatan

Jangan pernah percaya pada apa yang dimasukkan oleh pengguna. Berhati-hati dengan semua maklumat yang diterima daripada mereka.$_GET、$_POSTData yang diperoleh, atau data yang dibaca dari pangkalan data dan disediakan untuk dihasilkan, perlu diubah suai (di-escape) atau disahkan menggunakan fungsi yang disediakan oleh WordPress.esc_html()、esc_attr()、sanitize_text_field()、wp_kses()Dan lain-lain. Gunakan.wp_enqueue_script()和wp_enqueue_style()Pastikan skrip dan gaya (styles) dimuat dengan betul, serta menguruskan kebergantungan (dependencies) dan kawalan versi (versioning) dengan baik. Bagi plugin yang kompleks, pertimbangkan untuk menggunakan pengaturcaraan berorientasikan objek (Object-Oriented Programming/OOP) untuk mengatur kod. Susun fungsi-fungsi dalam kelas (classes) untuk meningkatkan modulasi dan kebolehgunaan semula kod (reusability).

Internationalization (I18n) dan Localization (L10n)

Untuk membolehkan plugin anda digunakan oleh pengguna di seluruh dunia, pengantarabangsaan (i18n) adalah sangat penting. Ini bermakna anda perlu menggunakan…__()或_e()Fungsi-fungsi seperti ini mengelilingi semua rentetan teks yang ditujukan untuk pengguna. Ia didefinisikan dalam ulasan di bahagian atas plugin.Text Domain(Contohnyamy-first-pluginIa mesti selaras dengan bidang teks yang digunakan di sini.

// 错误示例
echo “Settings Saved”;

// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );

Kemudian, anda boleh menggunakan alat seperti Poedit untuk mengekstrak rentetan-rentetan tersebut dan menggunakannya untuk mencipta sesuatu yang diinginkan..potFail templat – Penterjemah boleh menggunakan fail ini untuk membuat kandungan dalam bahasa yang berbeza.zh_CN.poTerjemahan untuk teks tersebut adalah: “）”.moFail-fail kompilasi diletakkan dalam direktori plugin./languages/Di dalam folder tersebut, WordPress akan secara automatik memuat turun terjemahan yang sesuai berdasarkan bahasa laman web tersebut.

Sedia untuk diterbitkan dalam direktori rasmi.

Jika anda merancang untuk menghantar plugin anda ke direktori plugin rasmi WordPress.org, anda perlu memastikan bahawa kod tersebut mematuhi spesifikasi yang ditetapkan. Ini termasuk membuat dokumentasi yang terperinci…readme.txtFail-fail tersebut (yang menggunakan format tertentu untuk menggambarkan plugin, tangkapan skrin, langkah-langkah pemasangan, FAQ, dan log kemas kini) perlu mematuhi lesen GPL, dan kod tersebut harus dihantar ke repositori Subversion (SVN) yang rasmi. Sebelum diterbitkan, pastikan anda menguji dengan teliti keserasian plugin anda dengan pelbagai versi WordPress, PHP, tema-tema popular, serta plugin lain.

RINGKASAN

Pembangunan plugin WordPress adalah proses yang beransur-ansur, bermula dari pengapsulan fungsi yang mudah hingga pembinaan aplikasi yang kompleks. Ia bermula dengan sebuah fail PHP yang mengandungi ulasan kepala (header comments) yang betul, dan kuncinya terletak pada penggunaan yang mahir terhadap “action hooks” dan “filter hooks” untuk berinteraksi dengan inti WordPress. Dengan membina antara muka pengurusan pentadbiran melalui API Settings, plugin dapat dibuat lebih mesra pengguna. Mengikuti amalan terbaik keselamatan, melaksanakan pengaturcaraan yang bersifat antarabangsa (internationalization), dan mengatur kod dengan baik merupakan asas untuk membangunkan plugin yang berkualiti tinggi. Sama ada anda ingin memenuhi keperluan projek peribadi atau ingin menyumbang kepada komuniti sumber terbuka, menguasai proses pembangunan ini akan membuka pintu kepada kemampuan penyesuaian yang lebih kuat.

FAQ - Soalan Lazim

Apakah pengetahuan asas yang diperlukan untuk membangunkan plugin?

Anda perlu memiliki pengetahuan asas pengaturcaraan PHP, memahami HTML dan CSS, serta mempunyai pemahaman tentang operasi dan konsep asas WordPress (seperti artikel, halaman, dan widget). Kemahiran dalam mengendalikan pangkalan data MySQL juga akan membantu, namun ia bukanlah syarat wajib, kerana WordPress menyediakan fungsi-fungsi yang mudah untuk mengurus pangkalan data.WP_Query、wpdb(Kelas).

Apa perbezaan antara fail functions.php untuk plugin dan tema?

Letakkan kod tersebut dalam bahagian tema (theme).functions.phpDalam fail tersebut, terdapat kaedah untuk menambahkan ciri-ciri dengan cepat, tetapi ciri-ciri ini adalah berkait dengan tema yang digunakan. Apabila anda menukar tema, ciri-ciri tersebut akan hilang. Sebaliknya, plugin merupakan modul yang berdiri sendiri dan tidak bergantung pada tema; selagi plugin tersebut diaktifkan, ciri-cirinya akan kekal walaupun tema berubah. Oleh itu, bagi ciri-ciri yang dirancang untuk digunakan dalam jangka panjang atau perlu digunakan pada beberapa laman web, mengembangkannya menjadi plugin merupakan pilihan yang lebih baik.

Bagaimana untuk membaiki kod plugin saya?

WordPress menyediakan pelbagai alat untuk penyelidikan dan pembetulan masalah (debugging tools). Pertama sekali, anda boleh…wp-config.phpBuka fail tersebut.WP_DEBUG“Mode, akan…”define( 'WP_DEBUG', true );Ini akan memaparkan semua ralat, amaran, dan notis PHP pada skrin. Cara yang lebih selamat adalah dengan mengaturkannya pada masa yang sama.WP_DEBUG_LOG为trueCatatkan ralat tersebut ke dalam…/wp-content/debug.logDalam fail tersebut. Selain itu, gunakan…error_log()Menggunakan fungsi atau memasang alat tambahan profesional seperti Query Monitor dapat membantu mengesan pemboleh ubah (variables) dan pertanyaan pangkalan data (database queries) dengan lebih cekap.

Bagaimanakah plugin saya dapat bersesuaian dengan versi PHP yang lebih tinggi?

Untuk memastikan bahawa plugin berfungsi dengan baik dalam versi PHP yang akan datang, anda harus mengelakkan penggunaan fungsi dan sintaks yang telah diabaikan atau dikeluarkan. Dalam persekitaran pembangunan tempatan, gunakan persekitaran yang selaras dengan versi PHP sasaran masa depan (seperti PHP 8.x) untuk ujian. Sentiasa perhatikan pengumuman kemas kini rasmi dari WordPress dan PHP, dan senaraikan julat versi PHP yang disokong dalam log kemas kini plugin anda. Ini dapat membantu pengguna membuat pilihan persekitaran yang sesuai.