Pembangunan plugin WordPress: Membina modul fungsi khusus dari awal hingga akhir.

Memahami struktur asas plugin WordPress

Sebelum meneroka kod dengan lebih mendalam, adalah sangat penting untuk memahami komponen asas sebuah plugin WordPress. Sebenarnya, sebuah plugin merupakan satu atau sekumpulan kod yang disimpan dalam fail khusus dan dipasang ke dalam sistem WordPress untuk menambahkan fungsi atau ciri tambahan kepada laman web tersebut.wp-content/plugins/Fail-fail PHP yang terdapat dalam direktori tersebut. Intipatnya adalah sebuah fail utama yang mengandungi maklumat meta tentang plugin tersebut, dan maklumat ini dinyatakan kepada WordPress melalui blok ulasan dalam format khusus.

Fail pintu masuk utama untuk plugin, sebagai contoh, kita namakannya…my-first-plugin.phpFail tersebut mesti mengandungi satu notis kepala fail (header comment) yang khusus. Blok notis ini mendefinisikan nama plugin, deskripsi, versi, penulis, dan maklumat lain, dan merupakan satu-satunya asas bagi WordPress untuk mengenal pasti serta memuatkan plugin tersebut. Sebuah plugin yang paling asas boleh terdiri daripada fail ini sahaja, dan ia menggunakan API yang disediakan oleh WordPress, seperti Action Hooks dan Filter Hooks, untuk memodifikasi atau memperluas fungsi laman web.

Fungsi plugin boleh sangat ringkas, seperti menambahkan satu baris teks di bahagian bawah halaman; atau ia boleh sangat kompleks, seperti membuat sistem e-dagang yang lengkap. Tidak kira sama ada ia kompleks atau tidak, pembangunannya mengikuti corak asas yang sama: Pertama, buat struktur fail yang betul di tempat yang betul; kemudian, tulis kod dan sambungkannya ke dalam kitaran hayat (lifecycle) WordPress; akhirnya, lakukan konfigurasi dan interaksi yang diperlukan melalui antara muka pentadbiran WordPress.

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

Mencipta plugin pertama anda

Mari kita praktikkan pembuatan plugin yang paling asas dengan menggunakan contoh klasik “Hello World”. Fungsi plugin ini adalah untuk memaparkan ucapan selamat di bahagian atas kandungan artikel pada setiap halaman web.

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

Pertama sekali, anda perlu melakukannya di lokal atau pada pelayan.wp-content/plugins/Cipta sebuah folder baru dalam direktori tersebut, dan berikan nama ia sebagai…my-hello-pluginKemudian, dalam folder tersebut, buat sebuah fail PHP utama, dan namakan ia sebagaimy-hello-plugin.php。

Menulis fail utama untuk plugin

Bukamy-hello-plugin.phpSalin fail tersebut, kemudian masukkan kod berikut. Kod ini mengikut format standard untuk plugin WordPress, termasuk kepala maklumat plugin dan kod yang melaksanakan fungsi-fungsi yang diperlukan.

<?php
/**
 * Plugin Name:       我的问候插件
 * Plugin URI:        https://yourwebsite.com/my-hello-plugin
 * Description:       这是一个简单的插件，用于在文章内容前输出“您好，读者！”。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-hello-plugin
 */

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * 在主文章内容前添加问候语。
 *
 * @param string $content 原始的文章内容。
 * @return string 添加了问候语后的新内容。
 */
function my_hello_add_greeting( $content ) {
    $greeting = &#039;<p style="background-color:#f0f8ff; padding:10px; border-left:4px solid #0073aa;"><strong>Selamat sejahtera, pembaca! Terima kasih kerana membaca artikel ini.</strong></p>';
    // 只在主循环且是文章页面时添加
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $greeting . $content;
    }
    return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器
add_filter( 'the_content', 'my_hello_add_greeting' );

Aktifkan dan uji plugin tersebut.

Muat naik folder yang mengandungi fail tersebut ke pelayan.wp-content/plugins/Senarai fail, atau jika anda sedang mengembangkan di lokal, letakkan fail tersebut di lokasi yang sesuai. Kemudian, log masuk ke panel pentadbiran WordPress anda dan navigasi ke menu “Pemalam” (Plugins). Anda sepatutnya dapat melihat “My Greeting Plugin” dalam senarai pemalam. Klik butang “Aktifkan” (Enable).

Setelah diaktifkan, apabila anda mengakses mana-mana artikel atau halaman di laman web tersebut, anda akan melihat ucapan selamat yang ditampilkan sebelum kandungan utama artikel bermula. Ucapan selamat ini mempunyai latar belakang berwarna biru muda dan bingkai di sebelah kiri. Proses ini dengan jelas menunjukkan aliran utama dalam pembangunan plugin: membuat fail, menggunakan “hooks” untuk menambahkan fungsi, dan mengaktifkannya di belakang tabir. Anda telah berjaya mengambil langkah pertama dalam pembangunan plugin untuk WordPress.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pembangunan plugin WordPress: Membina lanjutan laman web yang kuat dari awal hingga akhir.。

Menggunakan kaitan (hooks) dan penapis (filters) untuk memperluas fungsi

Kekuatan dan kebolehluasan WordPress sebahagian besarnya disebabkan oleh sistem “Hook”nya. Hook terbahagi kepada dua kategori: Hook Aksi (Actions) dan Hook Penapis (Filters). Memahami dan menggunakannya dengan mahir adalah kunci untuk pembangunan plugin yang canggih.

Action hooks membenarkan anda untuk menyisipkan dan menjalankan kod sendiri pada titik masa tertentu semasa WordPress berjalan, seperti semasa artikel diterbitkan atau halaman dimuat. Sebagai contoh,save_postTindakan tersebut akan diaktifkan apabila kandungan artikel atau halaman disimpan ke dalam pangkalan data. Anda boleh melakukan ini dengan…add_action()Fungsi tersebut akan “memuatkan” fungsi kustom anda ke dalam hook ini.

Hook untuk penapis membenarkan anda mengubah data yang dihasilkan oleh WordPress semasa proses pemprosesan. Anda mendaftarkan sebuah fungsi ke dalam penapis tersebut, dan apabila WordPress menjalankan penapis tersebut, ia akan menghantar data tersebut kepada semua fungsi yang telah didaftarkan, serta menerima nilai yang telah diproses sebagai balasan. Fungsi yang digunakan dalam contoh di atas adalah…the_contentIni adalah contoh klasik bagi fungsi “filter hook” yang membenarkan anda mengubah kandungan artikel sebelum ia dipaparkan.

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

Create a simple management option.

Sebuah plugin yang benar-benar berguna biasanya memerlukan beberapa pilihan yang boleh disesuaikan oleh pengguna. Ini melibatkan interaksi dengan bahagian belakang (backend) WordPress. Kita akan menunjukkan cara untuk menambahkan halaman tetapan khusus (custom settings page) melalui sebuah contoh yang mudah.

Pertama sekali, kita gunakan…add_action(‘admin_menu’, …)Mari daftarkan sebuah fungsi yang akan membuat item menu baru di latar belakang pengurusan (management backend).

/**
 * 在WordPress后台添加一个自定义菜单页面。
 */
function my_hello_add_admin_menu() {
    add_menu_page(
        ‘问候插件设置’， // 页面标题
        ‘问候插件’，     // 菜单标题
        ‘manage_options’， // 所需权限
        ‘my-hello-plugin’， // 菜单slug
        ‘my_hello_admin_page_html’， // 用于显示页面内容的回调函数
        ‘dashicons-format-chat’， // 图标（可选）
        80 // 菜单位置（可选）
    );
}
add_action( ‘admin_menu‘, ’my_hello_add_admin_menu’ );

/**
 * 自定义设置页面的HTML输出。
 */
function my_hello_admin_page_html() {
    // 检查用户权限
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="“wrap”">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form action="/ms/“options.php”/" method="“post”" data-trp-original-action="“options.php”">
            <?php
            // 输出设置字段、安全性和保存更改按钮
            settings_fields( ‘my_hello_options’ );
            do_settings_sections( ‘my-hello-plugin’ );
            submit_button( ‘保存问候语设置’ );
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Medan tetapan pendaftaran dan pengeluaran

Hanya mempunyai halaman sahaja tidak cukup; kita perlu membuat pilihan-pilihan yang boleh disimpan. Ini memerlukan penggunaan…add_action(‘admin_init’, …), sertaregister_setting()、add_settings_section()和add_settings_field()Dan sejumlah fungsi lain.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Dari pemula hingga mahir: Panduan lengkap untuk pembangunan plugin WordPress.。

/**
 * 初始化插件的设置。
 */
function my_hello_settings_init() {
    // 注册一个设置项到数据库的‘my_hello_options’键下
    register_setting( ‘my_hello_options‘, ’my_hello_greeting_text’ );

// 在页面中添加一个设置区域
    add_settings_section(
        ‘my_hello_section’， // 区域ID
        ‘问候语设置’，        // 区域标题
        ‘my_hello_section_html’， // 区域描述的回调函数
        ‘my-hello-plugin’ // 所属页面slug
    );

// 在区域内添加一个具体的设置字段
    add_settings_field(
        ‘my_hello_field’， // 字段ID
        ‘自定义问候语’，    // 字段标签
        ‘my_hello_field_html’， // 用于渲染字段HTML的回调函数
        ‘my-hello-plugin’， // 所属页面slug
        ‘my_hello_section’ // 所属区域ID
    );
}
add_action( ‘admin_init‘, ’my_hello_settings_init’ );

/**
 * 设置区域的描述信息。
 */
function my_hello_section_html() {
    echo ‘<p>Di sini, anda boleh menetapkan kandungan ucapan selamat yang akan dipaparkan di awal setiap artikel.</p>’;
}

/**
 * 渲染设置字段的HTML。
 */
function my_hello_field_html() {
    // 从数据库获取已保存的值，如果没有则使用默认值
    $greeting = get_option( ‘my_hello_greeting_text‘, ’您好，读者！欢迎阅读本文。’ );
    ?&gt;
    <input type="‘text’"
           id="‘my_hello_greeting_text’"
           name="‘my_hello_greeting_text’"
           value="“NO NUMERIC NOISE KEY" 1000”
 class="“regular-text”" />
    <p class="“description”">Silakan masukkan ucapan selamat yang anda ingin paparkan di hadapan kandungan artikel.</p>
    &lt;?php
}

Sekarang, kita sudah mempunyai halaman tetapan latar belakang yang mempunyai kotak masukan. Seterusnya, kita perlu mengubah fungsi-fungsi asal yang telah ditulis sebelum ini.my_hello_add_greetingBiarkan ia membaca ucapan selamat dari pilihan dalam pangkalan data.

function my_hello_add_greeting( $content ) {
    // 获取保存的自定义问候语，如果不存在则使用默认值
    $custom_greeting = get_option( ‘my_hello_greeting_text‘, ’您好，读者！欢迎阅读本文。’ );
    $greeting = ‘<p style="“background-color:#f0f8ff;" padding:10px; border-left:4px solid #0073aa;”><strong>’. esc_html( $custom_greeting ) ‘</strong></p>’;
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $greeting . $content;
    }
    return $content;
}

Setakat ini, sebuah plugin yang mempunyai fungsi konfigurasi asas telah siap dibina. Pengguna boleh mengubah teks ucapan selamat dengan bebas di menu “Plugin Ucapan Selamat” di bahagian belakang (backend), dan artikel-artikel di bahagian depan (frontend) akan secara automatik menggunakan tetapan terkini.

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

Amalan terbaik dan keselamatan dalam pembangunan plugin

Membangunkan sebuah plugin WordPress untuk digunakan oleh orang lain memerlukan bukan sahaja fungsi yang lengkap, tetapi juga pematuhan kepada amalan terbaik dari segi keselamatan, prestasi, dan kebolehjagaan (maintainability).

Pertimbangan Keselamatan

Keselamatan adalah prinsip utama. Jangan pernah mempercayai input yang diberikan oleh pengguna. Semua data yang diperolehi daripada pengguna (seperti…)$_GET、$_POST、$_COOKIESebelum digunakan untuk pertanyaan pangkalan data, dipaparkan pada halaman web, atau melakukan operasi fail, data tersebut mesti dibersihkan, disahkan, dan di-escape dengan betul.

Untuk data yang dihasilkan dan dipaparkan pada halaman HTML, gunakan…esc_html()、esc_attr()或wp_kses_post()Fungsi seperti ini digunakan untuk melakukan “escape” (pembebasan) karakter khusus. Untuk variabel yang digunakan dalam pertanyaan pangkalan data, penggunaan escape adalah wajib.$wpdb->prepare()Gunakan kaedah untuk melakukan pertanyaan yang diparameterkan, dan jangan sekali-kali menyatukan nilai variabel secara langsung ke dalam ayat SQL. Dalam plugin, anda harus sentiasa menggunakan pendekatan ini.defined(‘ABSPATH’) or die;Untuk mencegah fail daripada diakses secara langsung.

Pengurusan Kod dan Penyesuaian Antarabangsa (Code Organization and Internationalization)

Seiring dengan pertumbuhan fungsi tambahan (plugins), menjadi sukar untuk menyelenggara semua kod yang terdapat dalam satu fail utama. Pendekatan yang lebih baik adalah untuk memisahkan kod mengikut fungsi ke dalam fail-fail yang berbeza. Biasanya, fail utama bertanggungjawab untuk mendefinisikan “hook” (mekanisme penghubung antara komponen program) dan proses utama program, manakala halaman tetapan, fungsi-fungsi khusus, dan definisi kelas diletakkan dalam fail-fail lain.includes/或admin/、public/Dalam subdirektori seperti ini, dan melalui…require_oncePengenalan.

Untuk membolehkan plugin anda digunakan oleh pengguna di seluruh dunia, ia harus menyokong pengaturcaraan antarabangsa (internationalization atau i18n). Ini bermakna semua rentetan teks yang dipaparkan dalam plugin harus menggunakan fungsi terjemahan yang disediakan oleh WordPress.__()、_e()Melakukan pengemasan barang, dan juga untuk…Text DomainSetkan satu penanda unik (seperti nama direktori plugin). Dalam blok ulasan di bahagian atas fail, kita telah mendefinisikannya.Text Domain: my-hello-pluginDalam kod, ia harus digunakan seperti berikut:

$greeting = ‘<p><strong>’ . esc_html__( ‘您好，读者！欢迎阅读本文。’ , ’my-hello-plugin’ ) . ‘</strong></p>’;

Dengan cara ini, penterjemah boleh menggunakannya..po和.moFail tersebut mengandungi terjemahan untuk bahasa-bahasa yang berbeza yang dibuat untuk plugin anda.

Pengoptimuman prestasi.

Plugin harus meminimumkan kesan terhadap prestasi laman web sebanyak mungkin. Elakkan melakukan banyak pertanyaan pangkalan data atau pengiraan yang kompleks setiap kali halaman dimuat, terutamanya pada bahagian frontend. Gunakan API Cache Transients WordPress dengan bijak untuk menyimpan hasil pertanyaan yang tidak sering berubah. Sebagai contoh, jika anda ingin menyimpan hasil daripada sebuah permintaan API, anda boleh melakukannya seperti berikut:

$data = get_transient( ‘my_plugin_api_data’ );
if ( false === $data ) {
    // 数据不存在或已过期，从API获取
    $data = wp_remote_retrieve_body( wp_remote_get( ‘https://api.example.com/data’ ) );
    // 将数据存储12小时
    set_transient( ‘my_plugin_api_data’, $data, 12 * HOUR_IN_SECONDS );
}
// 使用 $data

Selain itu, pastikan bahawa fail CSS dan JavaScript anda hanya dimuat turun pada halaman-halaman yang diperlukan. Gunakan ciri-ciri yang tersedia untuk mengoptimumkan proses ini.wp_enqueue_script()和wp_enqueue_style()Fungsi tersebut, digabungkan dengan hook yang sesuai (seperti…)wp_enqueue_scriptsUntuk memuatkan sumber frontend, kaedah tertentu digunakan; manakala untuk sumber backend, kaedah yang berbeza pula digunakan.admin_enqueue_scriptsKuku.

RINGKASAN

Melalui panduan langkah demi langkah dalam artikel ini, kita telah menyelesaikan proses pembangunan daripada sebuah plugin “Hello World” yang ringkas, ke sebuah plugin yang praktikal dan lengkap dengan pilihan konfigurasi di bahagian belakang (backend), serta mematuhi prinsip-prinsip asas keselamatan dan pengaturan kod. Kuncinya adalah memahami dan menggunakan mekanisme teras WordPress iaitu sistem hook. Sistem hook membenarkan kita memperluas fungsi platform dengan cara yang modular dan tidak invasif. Sama ada untuk mengubah kandungan (filter) atau menjalankan tugas tertentu (actions), hook berfungsi sebagai jambatan yang menghubungkan kod kita dengan dunia WordPress.

Ingatlah, pembangunan plugin yang cemerlang bukan sekadar tentang membuat fungsi-fungsi berfungsi dengan baik. Ia melibatkan pengendalian keselamatan yang ketat terhadap input pengguna, pengaturan kod yang jelas, sokongan terhadap penggunaan bahasa antarabangsa (internationalization), serta pertimbangan yang teliti terhadap prestasi laman web. Bermula dari penulisan header fail plugin yang jelas, menggunakan API standard untuk membuat menu dan tetapan, hingga ke proses pengelakkan risiko keselamatan terhadap kandungan yang dihasilkan, setiap langkah mempengaruhi kualiti, keselamatan, dan pengalaman pengguna plugin tersebut. Teruslah meneroka pelbagai API dan fungsi yang disediakan oleh WordPress, dan anda akan dapat membina plugin yang kuat dan stabil dari segi fungsionaliti.

FAQ - Soalan Lazim

Apa asas yang diperlukan untuk pembangunan plugin?

Anda perlu memiliki pengetahuan asas dalam bahasa pengaturcaraan PHP, termasuk konsep-konsep utama seperti variabel, fungsi, array, penilaian syarat (conditionals), dan pengulangan (loops). Pemahaman asas tentang HTML dan CSS juga sangat membantu, kerana banyak plugin memerlukan keupayaan untuk menjana atau mengubah suai antara muka pengguna (frontend). Pengetahuan tentang penggunaan asas WordPress dan struktur backend akan memudahkan proses pembangunan.

Bagaimana untuk men-debug plugin WordPress saya?

Pertama sekali, pastikan anda…wp-config.phpMod pembangunan (debug mode) untuk WordPress telah diaktifkan dalam fail tersebut. Ini dilakukan melalui pengaturan yang sesuai.define('WP_DEBUG', true);和define('WP_DEBUG_LOG', true);Mesej ralat akan direkodkan.wp-content/debug.logDalam fail, ini lebih selamat daripada menunjukkannya terus pada halaman web. Selain itu, ia boleh digunakan bersama-sama dengan cara lain.error_log()Fungsi tersebut digunakan untuk mencetak nilai variabel, atau anda boleh menggunakan panel “Network” dan “Console” dalam alat pembangun pelayar (browser developer tools) untuk memeriksa masalah yang berkaitan dengan skrip dan gaya (styles) pada bahagian hadapan (frontend) aplikasi.

Bolehkah saya mengemukakan plugin yang saya bangunkan ke direktori plugin rasmi?

Boleh, tetapi anda perlu memenuhi keperluan penghantaran plugin yang ditetapkan oleh WordPress secara rasmi. Ini termasuk memastikan plugin anda mematuhi lesen yang serasi dengan GPL, mengikuti standard pengkodan WordPress, memastikan keselamatan kod dan tidak mengandungi kandungan berbahaya, serta menyediakan dokumentasi yang jelas. Sebelum menghantar, adalah disyorkan untuk membaca dengan teliti panduan pengembang plugin dan garis panduan penghantaran yang disediakan oleh WordPress. Proses penghantaran perlu dilakukan melalui sistem penghantaran plugin di WordPress.org untuk pemeriksaan.

Apa perbezaan antara fungsi plugin dan tema? Bila sebaiknya untuk mengembangkan plugin?

Tema (Theme) terutamanya mengawal penampilan dan susun atur laman web, dan biasanya bertanggungjawab untuk fail templat, skrip gaya (style sheets), serta beberapa fungsi yang berkaitan dengan penyampaian kandungan. Sebaliknya, plugin (Plugin) digunakan untuk menambah atau mengubah fungsi-fungsi laman web, dan pengaruhnya (dalam kebanyakan kes) tidak berkaitan dengan tema yang sedang digunakan. Satu prinsip yang baik adalah: Jika sesuatu fungsi berkaitan secara langsung dengan penampilan laman web (seperti susun atur halaman, skema warna), ia boleh dipertimbangkan untuk dimasukkan ke dalam tema; jika fungsi tersebut bersifat umum dan berdiri sendiri (seperti borang hubungan, pengoptimuman SEO, caching), maka ia harus wujud tanpa mengira tema yang diganti, dan sebaiknya dibangunkan sebagai plugin. Ini membantu memisahkan fungsi daripada reka bentuk, serta meningkatkan kebolehlarasan laman web.