Panduan Pembangunan Plugin WordPress: Ajar Anda Langsung Bagaimana Membina Plugin Anda Sendiri Dari Kosong

Memahami asas plugin dan pembinaan persekitaran pembangunan

Sebelum mula menulis kod, adalah sangat penting untuk memahami konsep asas plugin WordPress dan menyediakan persekitaran pembangunan tempatan yang sesuai. Sebuah plugin pada asasnya adalah sebuah direktori yang mengandungi satu atau lebih fail PHP, dan ia memanjangkan atau mengubah fungsi asas WordPress melalui sistem Hook yang disediakan oleh WordPress. Berbeza dengan tema, plugin berfokuskan untuk menambahkan fungsi baharu, bukan untuk mengubah penampilan laman web; walaupun tema ditukar, fungsi plugin biasanya kekal tidak berubah.

Untuk memulakan pembangunan, anda perlu memiliki persekitaran WordPress setempat terlebih dahulu. Ini boleh dilakukan dengan mudah menggunakan alat seperti Local by Flywheel, MAMP, XAMPP, atau dengan terus menggunakan kontena Docker. Setelah WordPress dipasang di persekitaran setempat, anda perlu masuk ke…wp-content/pluginsSenarai. Inilah tempat di mana semua plugin disimpan. Buatlah folder baru, sebagai contoh…my-first-pluginDalam folder ini, anda mesti membuat sebuah fail PHP utama, yang namanya biasanya sama dengan nama folder tersebut. Contohnya:my-first-plugin.phpFail utama ini merupakan titik masuk untuk plugin, dan ia mengandungi sekumpulan maklumat khusus dalam bentuk ulasan (annotations) yang memberitahu WordPress tentang nama plugin, deskripsi, versi, pengarang, dan maklumat lain yang berkaitan.

Disyorkan untuk mengaktifkannya dalam persekitaran pembangunan.WP_DEBUGMod. Buka direktori akar WordPress.wp-config.phpFail tersebut, cari atau tambah baris berikut:

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Praktikal untuk Membangunkan Plugin WordPress: Membina Plugin Pertama Anda Daripada Nol Hingga Satu.。

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );

Ini akan merekodkan ralat dan amaran ke dalam…wp-content/debug.logDalam fail tersebut, terdapat maklumat yang dapat membantu anda menemui masalah dengan cepat semasa proses pembangunan. Pada masa yang sama, menggunakan editor kod yang berkuasa atau IDE (seperti VS Code, PhpStorm) dapat meningkatkan kecekapan pembangunan dengan ketara, kerana alat-alat ini biasanya menyediakan sokongan sintaks yang baik dan fungsi cadangan (tips) untuk PHP dan 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

Cipta fail plugin pertama anda.

Kita akan melalui proses penuh daripada membuat fail hingga mengaktifkan plugin dengan mencipta sebuah plugin “Hello World” yang mudah. Plugin ini akan memaparkan mesej selamat datang di bahagian atas laman pentadbiran laman web.

Dalam direktori plugin andamy-first-pluginDalam proses ini, anda perlu membuat fail utama (main file).my-first-plugin.phpStruktur asas kandungan fail mesti bermula dengan ulasan di bahagian kepala plugin:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的示例插件，它将在后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            开发者姓名
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Kepala-kepala ulasan ini adalah wajib, dan WordPress bergantung pada mereka untuk mengenal pasti dan menunjukkan plugin anda pada halaman pengurusan “plugin”. Di antaranya,Text DomainUntuk penggunaan antarabangsa (i18n – Internationalization),Domain PathMenentukan direktori di mana fail bahasa berada (jika perlu).

Seterusnya, kita akan menambahkan fungsi-fungsi utama. Dalam contoh ini, kita akan menggunakan…admin_noticesHook. Tambahkan kod berikut di bawah ulasan kepala (header comment):

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Lengkap Pembangunan Plugin WordPress: Daripada Permulaan Hingga Kemahiran Tinggi (Tutorial Praktikal)。

// 使用 admin_notices 钩子在管理后台输出提示信息
add_action( ‘admin_notices’, ‘my_first_plugin_display_admin_greeting’ );

/**
 * 在管理后台显示欢迎信息的函数
 * @return void
 */
function my_first_plugin_display_admin_greeting() {
    // 检查当前用户是否有权限，确保只在后台显示
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( ‘欢迎使用我的第一个插件！插件开发之旅正式开始！’, ‘my-first-plugin’ ); ?></p>
    </div>
    &lt;?php
}

Setelah menyimpan fail tersebut, log masuk ke panel pentadbiran WordPress anda dan ke halaman “Pembantu” (Plugins). Anda sepatutnya dapat melihat sebuah plugin dengan nama “My First Plugin” dalam senarai plugin. Klik butang “Aktifkan” (Activate). Setelah diaktifkan, segarkan halaman pentadbiran mana-mana (seperti Dashboard), dan anda sepatutnya akan melihat mesej pengesahan berwarna hijau yang mengandungi ucapan selamat datang yang telah kita tetapkan dalam kod kita. Ini merupakan pelaksanaan fungsi yang minimum tetapi lengkap, dan ia mengesahkan bahawa persekitaran pembangunan anda serta struktur plugin adalah betul.

Teknologi teras WordPress: Hook dan Filter

Memahami dan menggunakan hook dengan mahir merupakan asas dalam pembangunan plugin untuk WordPress. Hook terbahagi kepada dua jenis: Action dan Filter. Hook Action membenarkan anda untuk memasukkan dan menjalankan kod khusus pada masa-masa tertentu, seperti selepas artikel diterbitkan atau sebelum kandungan halaman utama dimuat. Kami telah menggunakan hook tersebut dalam contoh yang diberikan sebelum ini.admin_noticesIa hanyalah sebuah “action hook”. Hook penapis (filter hook) pula membenarkan anda mengubah data yang dihasilkan atau dihantar semasa proses berjalan, seperti mengubah kandungan tajuk artikel atau hasil carian daripada plugin.

Bagaimana untuk menambahkan tindakan khusus (custom action)?

Tindakan telah dilaksanakan.add_action()Fungsi ditambahkan. Syntaxnya adalah:add_action( ‘hook_name’, ‘your_function_name’, priority, accepted_args )Kedudukan keutamaan (priority) adalah nombor bulat; semakin kecil nombornya, semakin awal ia akan dilaksanakan. Nilai laluan adalah 10. Sebagai contoh, jika anda ingin menambahkan beberapa kod HTML khusus selepas kandungan artikel, anda boleh mengatur kedudukan keutamaannya dengan cara yang sesuai.

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

add_action( ‘the_content’, ‘my_custom_content_append’ );
function my_custom_content_append( $content ) {
    // 只在单篇文章主循环内生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $extra_content = ‘<div class="“my-custom-box”"><p>Ini adalah kandungan khusus yang ditambahkan melalui plugin.</p></div>’;
        $content .= $extra_content;
    }
    return $content;
}

Perhatikan, walaupun…the_contentIa merupakan sebuah penapis (filter) yang perlu mengembalikan hasil yang telah diubah suai.$content), tetapi WordPress juga menggunakannya sebagai titik pencetus tindakan (action trigger point). Cara yang lebih tepat adalah dengan menggunakan…add_filter。

Bagaimana untuk menambahkan penapis khusus (custom filter)?

Filter telah diluluskan.add_filter()Fungsi ditambahkan. Sintaksnya adalah…add_action()Contohnya, perubahan pada panjang ringkasan artikel adalah perkara yang sering berlaku.

add_filter( ‘excerpt_length’, ‘my_custom_excerpt_length’, 999 );
function my_custom_excerpt_length( $length ) {
    // 将默认的55个词改为20个词
    return 20;
}

Anda boleh membuat “hook” sendiri, supaya plugin anda juga boleh diperluas oleh pembangun lain atau tema-tema lain. Gunakan kaedah ini untuk meningkatkan kefungsian plugin anda.do_action()Untuk mendefinisikan satu “action hook”, gunakan…apply_filters()Mari kita definisikan sebuah “filter hook”. Ini merupakan kunci untuk membina plugin yang modular dan boleh diperluas.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan lengkap untuk pembangunan plugin WordPress: daripada asas hingga tahap lanjutan.。

Pengembangan Fungsi Plugin dan Amalan Terbaik

Ketika ciri-ciri plugin menjadi semakin kompleks, pengurusan kod yang baik, keselamatan, kebolehpenyelenggaraan, dan prestasi menjadi sangat penting. Amalan yang biasa digunakan adalah dengan menggunakan Pemrograman Berorientasikan Objek (Object-Oriented Programming/OOP) untuk mengatur struktur kod, dengan mengemas fungsi dan data yang berkaitan dalam satu kelas utama.

Menggunakan pengaturcaraan berorientasikan objek untuk mengapsulkan kod.

Mencipta sebuah kelas utama dapat membantu menguruskan keadaan (state) dan kaedah (methods) plugin dengan lebih baik, serta mengelakkan konflik nama fungsi. Berikut adalah contoh struktur pengaturcaraan berorientasikan objek (Object-Oriented Programming/OOP) yang ringkas:

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

<?php
/**
 * Plugin Name:       进阶示例插件
 */
if ( ! class_exists( ‘My_Advanced_Plugin’ ) ) {
    class My_Advanced_Plugin {
        /**
         * 构造方法，用于初始化钩子
         */
        public function __construct() {
            add_action( ‘init’, array( $this, ‘register_custom_post_type’ ) );
            add_action( ‘admin_menu’, array( $this, ‘add_admin_menu_page’ ) );
            add_filter( ‘the_title’, array( $this, ‘filter_post_title_prefix’ ), 10, 2 );
        }

/**
         * 注册一个自定义文章类型
         */
        public function register_custom_post_type() {
            $args = array(
                ‘public’ => true,
                ‘label’  => ‘我的产品’,
                ‘supports’ => array( ‘title’, ‘editor’, ‘thumbnail’ ),
                ‘has_archive’ => true,
            );
            register_post_type( ‘my_product’, $args );
        }

/**
         * 在文章标题前添加前缀的过滤器
         * @param string $title 原标题
         * @param int    $id    文章ID
         * @return string 修改后的标题
         */
        public function filter_post_title_prefix( $title, $id = null ) {
            if ( ! is_admin() && in_the_loop() ) {
                $title = ‘[精品] ’ . $title;
            }
            return $title;
        }

// ... 其他方法
    }
    // 实例化插件类
    new My_Advanced_Plugin();
}

Struktur ini mengorganisasikan fungsi-fungsi yang berkaitan bersama-sama, menjadikan kod lebih jelas dan mudah untuk diurus.

Mengjamin keselamatan dan prestasi plugin

Keselamatan adalah keutamaan tertinggi dalam pembangunan plugin. Jangan pernah mempercayai input yang diberikan oleh pengguna. Untuk semua data yang diterima…$_GET、$_POST或$_REQUESTData yang diperoleh perlu disahkan (Validation), dibersihkan (Sanitization), dan di-escape (Escaping). WordPress menyediakan pelbagai fungsi bantuan untuk tujuan ini:
* 验证：check_ajax_referer()， wp_verify_nonce()
* 清理：sanitize_text_field()， sanitize_email()， absint()
* 转义：esc_html()， esc_url()， wp_kses_post()

Sebelum mengeluarkan sebarang data ke dalam HTML, atribut, atau URL, pastikan anda menggunakan fungsi pengelakkan (escape function) yang sesuai. Dari segi prestasi, gunakan hook dengan bijak untuk mengelakkan daripada menjalankan kueri yang memerlukan banyak sumber semasa setiap halaman dimuat. Pertimbangkan untuk menggunakan API Cache Transient dalam WordPress untuk menyimpan hasil kueri yang tidak kritikal dan boleh diulang guna untuk jangka masa yang tertentu.

Laksanakan halaman tetapan untuk plugin.

Kebanyakan plugin memerlukan halaman tetapan yang membolehkan pengguna untuk mengkonfigurasikannya. Ini biasanya dilakukan melalui…add_options_page()或add_menu_page()Fungsi-fungsi seperti ini, perlu dipasang (dimalunkan) ke…admin_menuPelaksanaan boleh dilakukan dengan menggunakan “hook” (pautan tertentu dalam kod). Untuk mengatur pilihan, API Settings WordPress perlu digunakan untuk pendaftaran yang selamat, penyimpanan, dan pengesahan data. Ini termasuk penggunaan fungsi yang disediakan oleh API tersebut.register_setting()、add_settings_section()和add_settings_field()Fungsi-fungsi seperti ini bukan sahaja dapat memastikan keselamatan (seperti pengesahan nilai nonce), tetapi juga menyediakan gaya antara muka pentadbiran WordPress yang seragam.

RINGKASAN

Pembangunan plugin WordPress adalah proses mengubah idea menjadi ciri-ciri yang berguna, yang bermula dengan memahami struktur asas plugin dan cara membangunkan persekitaran tempatan (local environment). Dengan membuat plugin “Hello World” yang paling asas, kita telah melaksanakan keseluruhan proses daripada penciptaan fail hingga pengaktifan fungsi tersebut. Inti pembangunan adalah pemahaman yang mendalam dan penggunaan yang fleksibel terhadap sistem hook yang kuat dalam WordPress – iaitu tindakan (actions) dan penapis (filters), yang berfungsi sebagai jambatan untuk berinteraksi dengan bahagian utama WordPress dan komponen lain. Seiring dengan peningkatan fungsi plugin, penggunaan pengaturcaraan berorientasikan objek, pematuhan kepada garis panduan pengkodan yang selamat (pemeriksaan, pembersihan, pengekstrakan), serta penggunaan API Settings untuk membina halaman tetapan, merupakan langkah-langkah kritikal untuk memastikan plugin tersebut stabil, selamat, mudah diselenggara, dan boleh diperluas. Dengan mengikuti panduan dan amalan terbaik ini, anda akan dapat membina pelbagai plugin WordPress yang berkualiti tinggi, daripada alat yang ringkas hingga aplikasi yang kompleks.

FAQ - Soalan Lazim

Apa pengetahuan asas yang diperlukan untuk membangunkan plugin WordPress untuk ###?
Anda perlu memiliki pengetahuan asas dalam bahasa pengaturcaraan PHP, kerana plugin tersebut kebanyakannya ditulis dalam PHP. Pemahaman asas tentang HTML, CSS, dan JavaScript juga akan membantu anda membuat plugin yang mempunyai interaksi pada bahagian hadapan (front end). Yang paling penting, anda perlu biasa dengan konsep-konsep asas WordPress, seperti artikel, halaman, kategori, peranan pengguna, dan sistem hook yang sangat penting dalam pengurusan WordPress.

Bagaimana untuk membaiki (debug) plugin WordPress yang sedang dibangunkan?

Sangat disyorkan untuk mengaktifkannya dalam persekitaran pembangunan.WP_DEBUGMod dan tetapan yang berkaitan telah dijelaskan dalam bahagian pembinaan persekitaran teks utama. Ini akan merekod ralat PHP, amaran, dan notis ke dalam fail log. Selain itu, anda boleh menggunakan…error_log()Fungsi atau fungsi bantuan seperti…var_dump()Kerjasamawp_die()Kita perlu mengeluarkan nilai variabel untuk pemeriksaan. Tab Console dan Network dalam alat pembangun pelayar (Browser Developer Tools) juga sangat penting untuk menyelesaikan masalah berkaitan JavaScript dan permintaan AJAX.

Bagaimanakah plugin saya dapat bersesuaian dengan pelbagai versi WordPress?

Dalam kod plugin, anda harus memeriksa sama ada fungsi atau kelas tertentu wujud dalam versi WordPress semasa sebelum menggunakannya. Anda boleh menggunakan alat atau kaedah yang sesuai untuk melakukan ini.function_exists()或is_admin()Keputusan berdasarkan syarat-syarat tertentu. Dalam penjelasan tentang plugin, ini boleh dilakukan melalui ulasan di kepala plugin (plugin header comments).Requires at least:Gunakan medan tersebut untuk menyatakan versi WordPress minimum yang diperlukan. Adalah amalan yang baik untuk menguji keserasian plugin anda dengan versi terkini WordPress secara berkala.

Bagaimana untuk menginternasionalisasi plugin saya agar ia menyokong berbilang bahasa?

Anda perlu menggunakan fungsi terjemahan WordPress untuk mengelilingi semua rentetan teks yang perlu diterjemahkan. Contohnya, gunakan:__( ‘文本’, ‘your-plugin-text-domain’ )来输出翻译后的文本，使用_e( ‘文本’, ‘your-plugin-text-domain’ )Ia perlu dipaparkan secara langsung. Anda perlu menetapkannya dengan betul dalam komen di bahagian atas plugin.Text Domain和Domain PathKemudian, gunakan alat seperti Poedit untuk membuatnya..potFail templat, penterjemah boleh menggunakan ia untuk membuat kandungan yang diinginkan..po和.moDokumen bahasa.

Setelah pembangunan selesai, bagaimanakah cara untuk menghantar plugin tersebut ke direktori plugin rasmi?

Pertama sekali, anda perlu mendaftar akaun di laman web rasmi WordPress dan menghantar kod plugin tersebut untuk semakan. Kod anda mesti mematuhi piawaian dan garis panduan pengaturcaraan rasmi, termasuk aspek keselamatan, tiada kod berbahaya, dan keserasian dengan lesen GPL. Struktur direktori plugin anda perlu merangkumi fail PHP utama, serta…readme.txtFail (dalam format yang memenuhi standard tertentu), serta tangkapan skrin dan ikon yang boleh disertakan (sukar untuk diwajibkan). Proses semakan mungkin memerlukan sedikit masa; pasukan akan memeriksa kod anda untuk memastikan ia memenuhi keperluan yang ditetapkan.