Pembangunan plugin WordPress dari pemula hingga mahir: Panduan langkah demi langkah untuk membantu anda mencipta fungsi khusus.

Pengaturcaraan persekitaran pembangunan plugin WordPress

Sebelum memulakan penulisan baris kod pertama, memiliki persekitaran pembangunan yang sesuai merupakan asas penting untuk bekerja dengan cekap. Ini bukan sahaja dapat memastikan bahawa plugin anda berfungsi dengan stabil dalam pelbagai persekitaran WordPress, tetapi juga dapat meningkatkan kecekapan proses pembetulan ralat (debugging) dan ujian dengan ketara.

Membina persekitaran pembangunan tempatan

Saya sangat mengesyorkan untuk melakukan pembangunan di persekitaran lokal, bukan secara langsung pada pelayan dalam talian. Anda boleh menggunakan alat seperti XAMPP, MAMP, Local by Flywheel, atau Docker untuk dengan cepat membina persekitaran pelayan lokal yang merangkumi PHP, MySQL, dan Apache/Nginx. Pastikan bahawa versi PHP yang anda gunakan adalah selaras dengan versi WordPress yang ingin anda gunakan; biasanya, pihak WordPress akan mengesyorkan julat versi PHP tertentu.

Pemilihan Editor dan Alat Kod

Memilih editor kod yang berkuasa adalah sangat penting, seperti VS Code, PhpStorm, atau Sublime Text. Editor-editor ini biasanya menyediakan ciri-ciri seperti penyorotan sintaks, cadangan kod, dan integrasi dengan sistem kawalan versi. Selain itu, memasang beberapa klip kod (Snippets) atau tambahan (plugins) yang berkaitan dengan WordPress dapat mempercepatkan proses pembangunan.add_action、add_filterPenulisan fungsi-fungsi yang sering digunakan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Menguasai Pembangunan Plugin WordPress dari Awal: Membina Fungsi Khusus dan Amalan Terbaik。

Mencipta fail utama untuk plugin

Setiap plugin WordPress mesti mempunyai satu fail PHP utama, dan di bahagian atas fail tersebut perlu mengandungi ulasan maklumat plugin yang standard. Fail ini merupakan titik masuk (entry point) untuk plugin tersebut. Sebagai contoh, jika kita merancang untuk membuat sebuah plugin bernama “My Custom Greeting”, maka fail utama boleh dinamakan…my-custom-greeting.php。

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: My Custom Greeting
 * Plugin URI:  https://yourwebsite.com/my-custom-greeting
 * Description: 一个简单的插件，用于在网站前台显示自定义问候语。
 * Version:     1.0.0
 * Author:      Your Name
 * License:     GPL v2 or later
 * Text Domain: my-custom-greeting
 */

Komen ini adalah penting, kerana WordPress menggunakan ia untuk mengenal pasti plugin dan menunjukkannya dalam antara muka pengurusan latar belakang.

Struktur Asas Plugin dan Piawaian Keselamatan

Sebuah plugin yang mempunyai struktur yang jelas dan mematuhi piawaian keselamatan merupakan asas untuk penyelenggaraan jangka panjang serta mendapatkan kepercayaan pengguna. Mengikuti standard pengkodan dan amalan keselamatan rasmi WordPress dapat membantu mengelakkan kelemahan yang sering berlaku.

Gunakan kelas untuk mengatur kod.

Walaupun anda boleh menggunakan pemrograman fungsi murni, penggunaan kelas berorientasikan objek (OOP) untuk mengapsulkan fungsi tambahan (plugin) adalah pendekatan yang lebih moden dan disyorkan. Ini membantu mengelakkan konflik nama fungsi dan menjadikan struktur kod lebih jelas. Mari kita buat sebuah kelas utama.My_Custom_Greeting。

if ( ! class_exists( 'My_Custom_Greeting' ) ) {
    class My_Custom_Greeting {
        public function __construct() {
            // 构造函数，在这里挂载钩子
        }
    }
    // 初始化插件
    new My_Custom_Greeting();
}

! class_exists()Pemeriksaan ini bertujuan untuk mencegah kelas daripada didefinisikan berulang kali.

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

Mengimplementasikan pengesahan keselamatan dan hak akses

Semua fungsi yang mungkin memproses permintaan pengguna pada bahagian hadapan (front end) atau belakang (back end) mesti menjalani pemeriksaan hak akses dan keselamatan. WordPress menyediakan mekanisme untuk ini.wp_verify_nonce()和current_user_can()Fungsi-fungsi seperti ini digunakan untuk membantu proses pelaksanaan. Ia merupakan keperluan wajib dalam mana-mana halaman tetapan plugin atau logik pemprosesan borang.

Direktori Plugin dan Organisasi Fail

Struktur direktori yang logik membantu dalam pengurusan. Sebuah direktori plugin yang tipikal mungkin mengandungi:
Dokumen utama my-custom-greeting.php (Terdapat di direktori akar plugin)
- includes/ Indeks: Menyimpan fail-fail berkaitan kelas fungsi utama
- admin/ Indeks: Menyimpan kod yang berkaitan dengan bahagian belakang aplikasi (backend).
- public/ Indeks: Menyimpan kod yang berkaitan dengan bahagian hadapan (front end)
- assets/ Indeks: Menyimpan fail CSS, JavaScript, dan gambar
- languages/ Indeks: Tempat penyimpanan fail terjemahan antarabangsa (.po/.mo)

Fungsi utama: Penggunaan Hook dan Filter dalam Amalan Sebenar

Mekanisme plugin untuk WordPress adalah berdasarkan “Hook”, yang terdiri daripada Action dan Filter. Memahami dan menguasai penggunaan Hook dengan baik adalah kunci dalam pembangunan plugin.

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 pengait tindakan untuk menambah fungsi

Action hooks membenarkan anda menjalankan kod yang disesuaikan pada titik masa tertentu, seperti semasa pengaturcaraan awal (initialization), pemuatannya halaman web, atau semasa artikel diterbitkan. Kami menggunakan…add_action()Fungsi tersebut digunakan untuk proses pemasangan (mounting). Sebagai contoh, dalam…wp_footerTambahkan ucapan selamat kami di bahagian yang berlabel “hook”.

在My_Custom_GreetingMengaitkan (mounting) dalam konstruktor kelas:

public function __construct() {
    add_action( 'wp_footer', array( $this, 'display_greeting' ) );
}

Kemudian, definisikan kaedah panggilan balik (callback method) yang sesuai.display_greeting：

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan lengkap untuk pembangunan plugin WordPress: membina ekstensi profesional dari awal.。

public function display_greeting() {
    $name = get_option( 'my_greeting_name', '访客' );
    echo '<p id="custom-greeting">Hello, '. esc_html($name)'. ‘! Selamat datang ke laman web kami.</p>';
}

Menggunakan pengait penapis (filter hook) untuk mengubah kandungan

Hook filter membenarkan anda mengubah data yang dihasilkan oleh WordPress atau plugin lain. Kami menggunakannya.add_filter()Fungsi. Sebagai contoh, mengubah sambungan laluan (suffix) laluan default untuk tajuk artikel.

add_filter( 'the_title', array( $this, 'modify_post_title' ), 10, 2 );

public function modify_post_title( $title, $id ) {
    if ( ! is_admin() && in_the_loop() ) {
        $title .= ' [推荐阅读]';
    }
    return $title;
}

Parameter di sini10Ia adalah keutamaan.2Ini menunjukkan bahawa fungsi panggilan balik (callback function) menerima dua parameter.$title和$id）。

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

Mencipta hook tersuai

Sebuah plugin yang matang juga sepatutnya menyediakan “hooks” sendiri untuk pembangun lain menggunakannya untuk melakukan pengembangan tambahan.do_action()Create an action hook and use it.apply_filters()Create a filter hook.

// 在插件某处执行一个自定义动作
do_action( 'my_custom_greeting_before_display', $name );

// 提供一个可过滤的问候语文本
$greeting_text = apply_filters( 'my_custom_greeting_text', '你好，' . $name . '！', $name );

Membina antaramuka pengurusan untuk plugin

Kebanyakan plugin memerlukan halaman tetapan di belakang tabir (backend) agar pengguna dapat mengkonfigurasi tingkah laku plugin tersebut. WordPress menyediakan API yang lengkap untuk membuat halaman menu dan halaman pilihan (option pages).

Tambahkan menu pengurusan

Gunakanadd_action( ‘admin_menu’, … )Kita menggunakan “hook” untuk menambahkan item menu. Kita telah menambahkan halaman sub-menu yang terletak di bawah “Settings” untuk plugin tersebut.

add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );

public function add_admin_menu() {
    add_options_page(
        '自定义问候语设置', // 页面标题
        '问候语设置',       // 菜单标题
        'manage_options',   // 所需权限
        'my-custom-greeting', // 菜单slug
        array( $this, 'render_settings_page' ) // 回调函数，用于输出页面内容
    );
}

Membina halaman tetapan dan borang

Dalam fungsi panggil balik (callback function)render_settings_pageDi sini, kita perlu membuat sebuah borang dan menggunakan API tetapan WordPress untuk menyimpan data dengan selamat. Pertama sekali, daftarkan satu tetapan (setting).

add_action( 'admin_init', array( $this, 'register_settings' ) );

public function register_settings() {
    register_setting(
        'my_custom_greeting_options_group', // 选项组名
        'my_greeting_name',                 // 选项名
        array( 'sanitize_callback' => 'sanitize_text_field' ) // 清理回调
    );
}

Kemudian, outputkan borang tersebut dalam fungsi rendering halaman:

public function render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Pengaturan ucapan selamat hati yang diperibadikan</h2>
        <form method="post" action="/ms/options.php/" data-trp-original-action="options.php">
            <?php settings_fields( 'my_custom_greeting_options_group' ); ?>
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="greeting_name">Nama orang yang disapa</label></th>
                    <td>
                        <input type="text" id="greeting_name" name="my_greeting_name" value="<?php echo esc_attr( get_option( 'my_greeting_name', '访客' ) ); ?>" class="regular-text" />
                        <p class="description">Nama yang dimasukkan di sini akan dipaparkan dalam ucapan selamat datang di bahagian depan (frontend).</p>
                    </td>
                </tr>
            </table>
            <?php submit_button(); ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Tambah skrip dan jadual gaya

Untuk menjadikan antaramuka pengurusan lebih menarik atau interaktif, adalah perlu untuk menambahkan CSS dan JavaScript ke halaman tetapan.admin_enqueue_scriptsGunakan “hook” (mekanisme pengaitan) dan periksa nilai “slug” halaman untuk memastikan bahawa halaman tersebut hanya dimuatkan apabila plugin kami digunakan.

add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_assets' ) );

public function enqueue_admin_assets( $hook ) {
    if ( 'settings_page_my-custom-greeting' !== $hook ) {
        return;
    }
    wp_enqueue_style( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/css/admin-style.css' );
    wp_enqueue_script( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/js/admin-script.js', array( 'jquery' ), '1.0.0', true );
}

RINGKASAN

Melalui langkah-langkah yang diterangkan dalam artikel ini, kita telah menyelesaikan proses pembangunan sebuah plugin WordPress yang lengkap: daripada penyediaan persekitaran, pembinaan struktur keselamatan asas, hingga penggunaan fungsi-fungsi utama melalui action dan filter hook, serta penciptaan antara muka pengurusan yang mesra pengguna. Kunci kejayaan pembangunan plugin terletak pada pemahaman yang mendalam tentang sistem hook WordPress dan pematuhan terhadap standard keselamatan serta pengaturcaraan yang ditetapkan oleh platform tersebut. Berbekalkan plugin kecil ini sebagai asas, anda boleh terus mengembangkan fungsinya dengan memperkenalkan lebih banyak kelas, menggunakan operasi pangkalan data yang lebih kompleks, mengintegrasikan REST API, atau mencipta blok khusus (seperti Gutenberg Block), sehingga akhirnya membina sebuah plugin yang berkuasa dan mudah diselenggara.

FAQ - Soalan Lazim

###: Bagaimana untuk membaiki (debug) plugin WordPress saya?
Mengaktifkan mod pembangunan (debug mode) di WordPress adalah cara yang paling berkesan.wp-config.phpDalam fail tersebut, akan…WP_DEBUGKonstanta ditetapkan kepadatrue. Ini akan memaparkan ralat PHP, amaran dan notis terus pada halaman. Untuk penyahpepijat yang lebih kompleks, anda boleh menggunakanerror_log()Fungsi tersebut akan merekod maklumat ke dalam log ralat server, atau menggunakan alat pembangunan PHP yang profesional seperti Xdebug.

Bagaimanakah plugin saya boleh bersesuaian dengan pelbagai versi PHP?

Semasa pembangunan, sebaiknya elakkan menggunakan fungsi PHP yang terlalu baru atau sudah lama, yang telah diabaikan (diketepikan). Semak manual rasmi PHP untuk mengetahui versi minimum yang disokong oleh fungsi-fungsi tersebut. Dalam fail utama plugin atau dokumentasi, maklumat ini boleh disertakan untuk membantu pengguna memahami keperluan sistem.Requires PHP:Tag header digunakan untuk menyatakan versi PHP minimum yang diperlukan oleh plugin tersebut, supaya WordPress akan memberikan amaran sekiranya syarat tersebut tidak dipenuhi.

Bagaimana untuk menjadikan plugin saya menyokong pelbagai bahasa (internationalization)?

WordPress menggunakan rangka kerja GNU gettext untuk melaksanakan pengantarabangsaan (i18n). Pertama sekali, tag “%s” perlu digunakan di semua tempat di mana teks perlu diterjemahkan.__()、_e()或_x()Fungsi-fungsi tersebut kemudiannya akan dibungkus (wrapped). Selepas itu, alat seperti Poedit digunakan untuk mengimbas kod dan menghasilkannya..potFail templat, kemudian buat yang sesuai untuk setiap bahasa..po和.moDokumen. Akhir sekali, gunakan semasa plugin dimuatkan.load_plugin_textdomain()Function loading.

Apa yang perlu diperhatikan semasa menghantar plugin ke direktori rasmi WordPress?

Sebelum menghantar, pastikan kod tersebut mematuhi sepenuhnya piawaian pengaturcaraan dan garis panduan dokumentasi WordPress. Plugin tersebut harus menggunakan lesen yang serasi dengan GPLv2 atau yang lebih baru. Butiran terperinci diperlukan untuk proses penghantaran.readme.txtFail tersebut mengandungi deskripsi, langkah-langkah pemasangan, tangkapan skrin, soalan-soalan yang sering diajukan, dan lain-lain. Kod yang anda sediakan mesti selamat, bebas daripada sebarang aktiviti berbahaya, dan tidak boleh bergantung pada kod pendek (Shortcode) untuk fungsi-fungsi utama – ia sepatutnya boleh digunakan secara langsung tanpa perlu penyesuaian tambahan. Selepas penghantaran, pasukan pengauditan akan melakukan pemeriksaan yang ketat.