Panduan Permulaan Pembangunan Plugin WordPress: Cipta Plugin Custom Pertama Anda Dari Kosong

Mengapa perlu mengembangkan sendiri plugin untuk WordPress?

Dalam ekosistem WordPress, plugin merupakan komponen utama untuk memperluas fungsi laman web. Walaupun terdapat beribu-ribu plugin yang tersedia di pasaran, mengembangkan plugin sendiri memberikan kelebihan yang unik. Pertama sekali, ia membolehkan anda mencipta fungsi yang disesuaikan sepenuhnya dengan keperluan anda, mengelakkan kod yang berlebihan atau ciri-ciri yang tidak diperlukan yang terdapat dalam plugin umum. Kedua, plugin yang dibangunkan sendiri boleh disintegrasikan dengan tema atau kod kustom lain dengan lebih baik, memastikan keserasian dan prestasi yang lebih tinggi. Selain itu, dengan mengembangkan plugin, anda dapat memisahkan logik perniagaan daripada kod tema, yang merupakan amalan terbaik dalam pembangunan WordPress. Dengan cara ini, walaupun anda menukar tema pada masa hadapan, fungsi-fungsi utama laman web masih dapat berfungsi dengan baik, meningkatkan kebolehjagaan laman web tersebut.

Bagi pembangun, mempelajari pembangunan plugin adalah cara yang sangat baik untuk memahami dengan lebih mendalam struktur WordPress. Anda akan berkenalan dengan konsep “action hooks”.add_actionFilter Hooksadd_filterShortcodesadd_shortcodeKonsep-konsep teras seperti ini sangat penting untuk difahami. Dengan menguasai pengetahuan ini, anda bukan sahaja dapat membuat plugin sendiri, tetapi juga dapat menyesuaikan tema dan plugin sedia ada dengan lebih cekap.

Pengaturan persekitaran dan persiapan sebelum pembangunan

Sebelum mula menulis baris kod pertama, adalah sangat penting untuk menyediakan persekitaran pembangunan yang sesuai. Ini bukan sahaja dapat meningkatkan kecekapan, tetapi juga dapat mengelakkan ralat.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pengenalan kepada pembangunan plugin WordPress, dari asas hingga mahir: berkongsi pengalaman praktikal dan teknik-teknik utama.。

Membina persekitaran pembangunan tempatan.

Disyorkan untuk menggunakan perisian pelayan tempatan, seperti Local by Flywheel, XAMPP, atau MAMP, yang membolehkan anda mengkonfigurasi persekitaran operasi WordPress yang mengandungi Apache, MySQL, dan PHP dengan cepat pada komputer anda. Berbanding dengan pelayan dalam talian, pembangunan tempatan membenarkan anda menguji dan membetulkan kod dengan lebih cepat, tanpa perlu risau tentang kesan terhadap laman web dalam talian.

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

Setelah memasang WordPress di komputer anda, anda perlu…wp-content/pluginsDalam direktori tersebut, buatlah sebuah folder khusus untuk plugin baru anda. Disarankan untuk menggunakan nama yang ringkas, dalam huruf kecil, dan tanpa ruang kosong, sebagai contoh:my-first-plugin。

Mengenali struktur asas plugin

Satu plugin WordPress yang paling mudah boleh terdiri daripada hanya satu fail utama. Fail ini mesti mengandungi ulasan kepala plugin yang khusus, yang digunakan oleh WordPress untuk mengenal pasti maklumat plugin tersebut. Anda juga memerlukan langkah-langkah keselamatan, seperti perlindungan akses langsung, yang biasanya dilakukan dengan pemeriksaan.ABSPATHAdakah konstanta ditakrifkan untuk tujuan tertentu?

Berikut adalah contoh fail utama plugin yang telah dipermudahkan (diminimized), dan fail tersebut boleh dinamakan…my-first-plugin.phpDan letakkan ia dalam folder yang baru sahaja dibuat:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习的入门级WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 */

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

Letakkan folder yang mengandungi fail ini di tempat yang sesuai.wp-content/pluginsSelepas menambahkannya ke dalam direktori yang sesuai, anda akan dapat melihatnya di halaman “Pembantu” (Plugins) di bahagian belakang WordPress, dan kemudian mengaktifkannya.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Terakhir Pembangunan Plugin WordPress: Membina Ekspansi Fungsi Khusus Dari Kosong Ke Sifar。

Mencipta fungsi teras yang pertama

Sekarang, mari kita tambahkan beberapa fungsi praktikal kepada plugin ini. Kita akan membuat satu fungsi yang mudah: menambahkan secara automatik segmen teks yang ditentukan sendiri di akhir kandungan artikel.

Menggunakan penapis untuk mengubah kandungan artikel

WordPress menyediakan sebilangan besar “Filter Hooks” yang membenarkan anda mengubah data sebelum ia disimpan ke dalam pangkalan data atau dipaparkan di dalam pelayar. Untuk mengubah kandungan artikel, kita boleh menggunakan…the_contentPenapis.

Dalam fail plugin utama anda, setelah mengaktifkan hook tersebut, tambahkan fungsi berikut dan panggilan kepada hook tersebut:

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_first_plugin_add_text_to_content( $content ) {
    // 确保只在主循环的单篇文章页面执行
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $additional_text = '<p><em>Terima kasih kerana membaca artikel ini! Artikel ini disokong oleh “My First Plugin”.</em></p>';
        $content .= $additional_text;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'my_first_plugin_add_text_to_content' );

Fungsi ini pertama-tama melakukan siri penilaian syarat untuk memastikan bahawa teks tambahan hanya muncul pada halaman artikel yang berasingan, dan tidak mempengaruhi halaman utama, halaman arkib, atau halaman lain. Kemudian, ia menambahkan segmen HTML yang disesuaikan ke dalam kandungan asal.$contentSelepas mengubah nilai variabel tersebut, kandungan yang telah diubah akan dikembalikan.

Membuat halaman tetapan pengurusan yang ringkas

Untuk membolehkan pengguna menyesuaikan teks yang ingin ditambahkan, kita perlu membuat pilihan tetapan khusus untuk mereka. Ini melibatkan penambahan item menu dan halaman tetapan di bahagian pentadbiran WordPress.

Pertama sekali, gunakanadd_actionKekunci “Hook” menambahkan halaman sub-menu dalam menu pentadbir:

Diperoleh daripada WEB\nDisyorkan untuk membaca. Menguasai pembangunan plugin WordPress: Membina plugin kustom pertama anda dari awal hingga akhir.。

// 创建管理菜单
function my_first_plugin_add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件设置',       // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'my_first_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_first_plugin_add_admin_menu' );

Seterusnya, definisikan fungsi panggil balik (callback function) untuk halaman tetapan penampilan (display settings page).my_first_plugin_settings_pageDan menguruskan logik penyimpanan borang:

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

// 注册设置、区域和字段
function my_first_plugin_settings_init() {
    register_setting( &#039;my_first_plugin_settings_group&#039;, &#039;my_first_plugin_custom_text&#039; );

add_settings_section(
        &#039;my_first_plugin_section&#039;,
        &#039;自定义文本设置&#039;,
        null,
        &#039;my-first-plugin&#039;
    );

add_settings_field(
        &#039;my_first_plugin_text_field&#039;,
        &#039;要在文末添加的文本&#039;,
        &#039;my_first_plugin_text_field_render&#039;,
        &#039;my-first-plugin&#039;,
        &#039;my_first_plugin_section&#039;
    );
}
add_action( &#039;admin_init&#039;, &#039;my_first_plugin_settings_init&#039; );

// 渲染文本输入字段
function my_first_plugin_text_field_render() {
    $option = get_option( &#039;my_first_plugin_custom_text&#039;, &#039;感谢您阅读这篇文章！本文由“我的第一个插件”提供支持。&#039; );
    echo &#039;<textarea name="my_first_plugin_custom_text" rows="3" cols="50">' . esc_textarea( $option ) . '</textarea>';
}

Akhir sekali, ubah fungsi yang digunakan untuk menambahkan teks sebelum ini agar ia dapat memilih daripada senarai pilihan yang tersedia.my_first_plugin_custom_textMembaca kandungan daripada:

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

function my_first_plugin_add_text_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = get_option( 'my_first_plugin_custom_text', '' );
        if ( ! empty( $custom_text ) ) {
            $additional_text = '<p><em>'. wp_kses_post($custom_text)'.'</em></p>';
            $content .= $additional_text;
        }
    }
    return $content;
}

Pengaturcaraan keselamatan, pengoptimuman, dan persiapan pengedaran plugin

Sebuah plugin yang berkualiti tidak hanya perlu berfungsi dengan baik, tetapi juga harus selamat, cekap, dan mudah diselenggara.

Pemverian data, pengekstrakan (escaping) dan keselamatan

Keselamatan merupakan nyawa dalam pembangunan plugin. Jangan pernah mempercayai data yang dimasukkan oleh pengguna atau data yang diambil terus dari pangkalan data. Apabila data hendak dihasilkan pada halaman, proses pengelakkan serangan (escaping) mesti dilakukan. Dalam kod sebelumnya, kita telah menggunakan…esc_textarea()Pada halaman pengurusan, output perlu di-ejek (escaped) sebelum digunakan.wp_kses_post()Pada halaman artikel, proses penapisan HTML hanya membenarkan tag kandungan pos yang selamat untuk dilalui. Untuk pemprosesan borang, penggunaan ciri-ciri yang disediakan oleh WordPress, seperti pemeriksaan keselamatan dan pengesahan hak akses, adalah sangat penting.sanitize_text_field()Fungsi-fungsi seperti ini digunakan untuk membersihkan data.

Pengaturan Kod dan Pengoptimuman Prestasi

Seiring dengan peningkatan fungsi tambahan (plugins), menjadi sukar untuk mengurus semua kod yang terdapat dalam satu fail utama. Amalan yang baik adalah untuk memisahkan kod mengikut fungsi ke dalam fail-fail yang berbeza. Sebagai contoh, anda boleh membuat…includes/admin/Direktori tersebut menyimpan semua kod yang berkaitan dengan pentadbiran latar belakang (management backend).includes/public/Direktori tersebut menyimpan kod fungsi untuk bahagian hadapan (front-end) aplikasi.includes/class-*.phpMenyimpan definisi kelas.

Dari segi prestasi, penggunaan “hook” perlu dilakukan dengan berhati-hati. Pastikan fungsi yang terdapat di dalam “hook” hanya dilaksanakan apabila perlu, seperti melalui penilaian keadaan (condition checking). Untuk nilai pilihan yang perlu dibaca dari pangkalan data, terutamanya jika ia digunakan berulang kali di bahagian hadapan (front end), nilai tersebut boleh disimpan dalam variabel global atau menggunakan cache objek untuk mengelakkan pertanyaan pangkalan data yang berulang.

Sedia untuk menerbitkan plugin anda.

Jika anda bercadang untuk mengeluarkan plugin tersebut ke dalam direktori plugin rasmi WordPress atau menyediakannya untuk digunakan oleh lebih ramai orang, terdapat beberapa aspek yang perlu diperbaiki. Pertama sekali, pastikan bahawa maklumat dalam nota kepala (header comments) plugin tersebut adalah lengkap dan tepat. Kedua, tulis sebuah dokumentasi yang jelas dan mudah difahami.readme.txtFail tersebut harus mengikut keperluan format rasmi WordPress, termasuk menggambarkan fungsi plugin, langkah-langkah pemasangan, soalan-soalan yang sering diajukan, dan sebagainya. Akhir sekali, lakukan ujian yang menyeluruh, termasuk ujian keserasian pada pelbagai versi PHP, pelbagai versi WordPress, serta ketika digunakan bersama tema-tema yang berbeza dan plugin-popular yang lain.

RINGKASAN

Melalui panduan ini, kita telah menyelesaikan proses pembuatan sebuah plugin WordPress yang lengkap dengan fungsi dan mempunyai antara muka pengurusan (management backend) dari awal hingga akhir. Kita telah mempelajari struktur asas plugin, cara menggunakan fungsi “actions” dan “filters” untuk berinteraksi dengan kod inti WordPress, cara membuat halaman pengurusan, serta memahami kepentingan keselamatan dan pengurusan kod plugin. Inti pembangunan plugin adalah memahami reka bentuk berdasarkan acara (event-driven architecture) WordPress dan belajar cara menyisipkan kod khusus kita pada masa yang sesuai. Dengan titik permulaan ini, anda boleh meneruskan penyelidikan mengenai topik yang lebih lanjut seperti jenis artikel khusus (custom article types), metadata, titik akhir API REST (REST API endpoints), dan pembuatan jadual pangkalan data (database tables), untuk membina plugin yang berkuasa dan berkualiti tinggi.

FAQ - Soalan Lazim

Apa pengetahuan asas yang diperlukan untuk membangunkan plugin WordPress?

Anda perlu menguasai sintaks asas bahasa pengaturcaraan PHP, konsep pengaturcaraan berorientasikan objek, serta pemahaman asas tentang HTML, CSS, dan JavaScript. Kemahiran dalam operasi asas WordPress dan konsep-konsep utamanya, seperti artikel, halaman, dan kategori, akan sangat membantu. Yang paling penting, anda perlu memahami mekanisme “Hook” (Actions and Filters) dalam WordPress, yang merupakan cara utama bagi plugin untuk berinteraksi dengan WordPress.

Apa perbezaan antara fungsi plugin dan tema, dan bagaimanakah kita harus memilih antara keduanya?

Tema terutamanya mengawal penampilan dan susun atur laman web, manakala plugin digunakan untuk menambahkan ciri-ciri tambahan. Prinsip yang baik adalah: jika sesuatu ciri berkait rapat dengan penampilan visual laman web, lebih sesuai untuk disertakan dalam tema tersebut; jika ciri tersebut berfungsi secara berasingan (seperti borang hubungan, pengoptimuman SEO, e-dagang), ia sebaiknya dibuat sebagai plugin. Dengan mengimplementasikan ciri-ciri tersebut sebagai plugin, ia dapat dijamin bahawa ciri-ciri tersebut tidak akan hilang apabila tema diubah, dan ini merupakan amalan terbaik dalam pembangunan WordPress.

Bolehkah saya membuat beberapa fail PHP dalam satu plugin?

Tentu saja boleh, dan ini merupakan amalan yang disyorkan terutamanya untuk plugin yang kompleks. Anda boleh memisahkan modul-modul fungsi yang berbeza ke dalam fail-fail yang berasingan, kemudian menggabungkannya semula melalui fail plugin utama.require_once或include_onceGunakan ayat-ayat yang sesuai untuk memperkenalkan konsep tersebut. Struktur fail yang baik membantu dalam mengatur kod dan meningkatkan kerjasama antara ahli pasukan.

Bagaimana untuk membaiki (debug) plugin yang saya bangunkan?

Metode pembaikan (debugging) yang sering digunakan dalam pembangunan WordPress adalah dengan mengaktifkan...WP_DEBUGAnda boleh melakukannya di laman web tersebut.wp-config.phpDalam fail tersebut, akan…define( 'WP_DEBUG', true );Ini akan memaparkan ralat PHP, amaran, dan notis 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, penggunaan alat pembangun pelayar (browser developer tools) dan plugin pemantauan pertanyaan (Query Monitor) untuk tujuan pembetulan kod (debugging) juga dapat meningkatkan kecekapan dengan ketara.

Plugin saya perlu serasi dengan pelbagai versi WordPress yang lama.

Ia bergantung pada pengguna sasaran anda. Secara umumnya, disyorkan untuk menyokong sekurang-kurangnya dua versi terdahulu daripada versi utama yang sedang digunakan. Anda boleh merujuk kepada statistik rasmi WordPress untuk memahami pengedaran versi tersebut. Dalam kod, anda boleh menggunakan pernyataan bersyarat untuk menguruskan kesesuaian dengan versi yang berbeza.function_exists()Untuk memeriksa sama ada fungsi atau kelas tertentu tersedia, agar dapat menyediakan sokongan keserasian terbalik (backward compatibility), dalam plugin…readme.txtDalam fail tersebut, perlu dinyatakan dengan jelas versi WordPress yang telah diuji dan didapati lulus (berjaya).