Menguasai pembangunan plugin WordPress: Membina modul fungsi tambahan pertama anda dari awal hingga akhir.

Memahami arkitektur asas plugin WordPress

Pemalam (plugin) WordPress pada dasarnya terdiri daripada satu atau lebih fail PHP yang mengikuti struktur penamaan dan organisasi yang tertentu. Pemalam ini digunakan untuk memperluas atau mengubah fungsi asas WordPress melalui sistem “Hook” yang disediakan oleh WordPress. Memahami arkitektur ini merupakan langkah pertama yang penting untuk mengembangkan pemalam dengan berjaya.

Satu plugin yang paling mudah hanya memerlukan satu fail utama dan satu ulasan di bahagian kepala plugin. Ulasan di bahagian kepala plugin adalah kunci untuk WordPress mengenali plugin tersebut, dan ia mesti terletak di bahagian atas fail PHP utama. Sebagai contoh, sebuah plugin yang bernama…my-first-plugin.phpFail tersebut, bahagian permulaan kandungannya sepatutnya seperti berikut:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于演示的简单WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Komen ini memberitahu panel pentadbiran plugin WordPress bahawa ini adalah sebuah plugin yang bernama “My First Plugin”. Buat fail ini dan letakkannya di tempat yang sesuai./wp-content/plugins/my-first-plugin/Selepas direktori tersebut disediakan, anda boleh melihatnya di halaman “Pemasangan” (Plugins) di panel kawalan WordPress, dan kemudian mengaktifkan atau menonaktifkannya mengikut keperluan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Belajar mengembangkan plugin WordPress dari awal: Bina fungsi khusus pertama anda。

Prinsip kerja utama plugin ini berpusat pada konsep “hook” (tangkai). Terdapat dua jenis hook: Action dan Filter. Hook Action membenarkan anda menjalankan kod khusus pada masa-masa tertentu, seperti semasa artikel diterbitkan atau halaman dimuat. Hook Filter pula membenarkan anda mengubah data yang dihasilkan semasa proses, seperti kandungan artikel atau tajuknya. Kod plugin anda terutamanya berfungsi melalui mekanisme hook ini.add_action()和add_filter()Dua fungsi ini “dipasang” pada titik-titik pengaitan (hook points) yang ditentukan.

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

Membina persekitaran pembangunan plugin pertama anda

Sebelum mula meng kod, sebuah persekitaran pembangunan tempatan yang boleh dipercayai adalah sangat penting. Ia membolehkan anda melakukan ujian dan penyelarasan dengan selamat.

Pilih alat pelayan tempatan yang sesuai

Disyorkan untuk menggunakan penyelesaian pelayan tempatan yang terintegrasi, seperti Local by Flywheel, XAMPP, atau MAMP. Penyelesaian ini membenarkan pemasangan lengkap persekitaran yang merangkumi PHP, MySQL, dan Apache/Nginx dengan satu klik, sekali gus memudahkan proses konfigurasi. Di antaranya, Local by Flywheel menawarkan sokongan yang sangat baik untuk WordPress, membolehkan penciptaan dan pengklonan laman web WordPress dengan cepat.

Menginisialisasi direktori dan fail plugin

Pada laman web WordPress tempatan anda…wp-content/plugins/Dalam direktori tersebut, buatlah sebuah folder yang khusus untuk plugin anda. Nama folder tersebut seharusnya terdiri daripada huruf kecil, nombor, dan tanda hubung (-), dan sebaiknya selaras dengan nama fail utama plugin tersebut. Sebagai contoh, anda boleh membuat folder dengan nama “my-plugin-folder”.greeting-pluginDan dalamnya, buatlah fail utama.greeting-plugin.php。

Untuk memastikan kod disusun dengan jelas, disyorkan untuk menggunakan struktur modular sejak awal. Senarai direktori plugin asas mungkin kelihatan seperti berikut:

Diperoleh daripada WEB\nDisyorkan untuk membaca. Penguraian Mendalam Pembangunan Plugin WordPress: Dari Permulaan Hingga Penyesuaian yang Cekap。

greeting-plugin/
├── greeting-plugin.php      // 主文件，包含插件头部注释和核心逻辑
├── includes/                // 存放核心功能类或函数文件
├── admin/                   // 存放后台管理界面相关文件
├── public/                  // 存放前端功能相关文件
├── assets/                  // 存放CSS、JavaScript和图片资源
│   ├── css/
│   ├── js/
│   └── images/
└── languages/               // 存放国际化翻译文件（可选）

Melaksanakan fungsi utama dan pengurusan latar belakang (backend management).

Mari kita gunakan satu contoh untuk menggabungkan pengetahuan yang telah kita pelajari: membuat sebuah plugin yang menampilkan ucapan selamat yang diperibadikan di bahagian depan laman web, dan membenarkan pengguna untuk menyesuaikan teks ucapan tersebut di bahagian belakang.

Membina fungsi fungsi asas

Pertama sekali, kita berada dalam fail utama…greeting-plugin.phpDi bawah ulasan kepala (header comment), tulis sebuah fungsi fungsi utama (core function).display_greeting()Digunakan untuk mendapatkan ucapan selamat dan menyediakan kandungan untuk output.

function display_greeting() {
    // 从WordPress选项中获取存储的问候语，默认为“欢迎光临！”
    $greeting_text = get_option('my_greeting_text', '欢迎光临！');
    // 将问候语进行安全转义后返回
    return '<p class="custom-greeting">'`. esc_html($greeting_text)`.'</p>';
}

Untuk memastikan ucapan selamat ini dipaparkan selepas kandungan artikel, kita perlu menggunakan “action hook”.the_contentKita mencipta sebuah fungsi baru.append_greeting_to_content()Dan pasangkannya pada pengait 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 append_greeting_to_content( $content ) {
    // 只在单篇文章和页面中追加问候语
    if ( is_single() || is_page() ) {
        $content .= display_greeting();
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器
add_filter( 'the_content', 'append_greeting_to_content' );

Tambahkan menu pengurusan plugin dan halaman tetapan.

Untuk membolehkan pengguna menyesuaikan ucapan selamat mereka, kita perlu menambahkan halaman tetapan di bahagian belakang WordPress (backend). Ini biasanya dilakukan…admin/Cipta sebuah fail berasingan di dalam direktori sub untuk mengendalikannya, sebagai contoh…admin/settings-page.php。

Pertama sekali, gunakan dalam fail utama.add_action()Mount a function that creates a management menu.

// 仅在后台加载时引入管理页面代码
if ( is_admin() ) {
    require_once plugin_dir_path( __FILE__ ) . 'admin/settings-page.php';
}

在admin/settings-page.phpDalam fail tersebut, kami menulis logik untuk membuat menu dan mengendalikan borang. Fungsi utama yang terlibat adalah…add_options_page()。

Diperoleh daripada WEB\nDisyorkan untuk membaca. Memulakan dari awal: Membina plugin WordPress pertama anda。

function my_greeting_add_admin_menu() {
    add_options_page(
        '问候语设置',          // 页面标题
        '自定义问候语',        // 菜单标题
        'manage_options',      // 所需权限
        'greeting-settings',   // 菜单slug
        'my_greeting_settings_page' // 用于显示页面内容的回调函数
    );
}
add_action( 'admin_menu', 'my_greeting_add_admin_menu' );

function my_greeting_settings_page() {
    ?>
    <div class="wrap">
        <h1>Pengaturan ucapan selamat</h1>
        <form method="post" action="/ms/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'greeting_settings_group' ); // 设置组名
            do_settings_sections( 'greeting-settings' ); // 页面slug
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Seterusnya, kita perlu mendaftar satu pilihan tetapan.my_greeting_textDan tambahkan satu bidang input untuknya. Ini dilakukan dengan…register_setting()、add_settings_section()和add_settings_field()Fungsi telah selesai.

function my_greeting_settings_init() {
    register_setting( 'greeting_settings_group', 'my_greeting_text' );

add_settings_section(
        'greeting_settings_section',
        '编辑问候文本',
        null,
        'greeting-settings'
    );

add_settings_field(
        'my_greeting_field',
        '问候语内容',
        'my_greeting_field_render',
        'greeting-settings',
        'greeting_settings_section'
    );
}
function my_greeting_field_render() {
    $value = get_option( 'my_greeting_text', '欢迎光临！' );
    echo '<input type="text" name="my_greeting_text" value="' . esc_attr( $value ) . '" class="regular-text">';
}
add_action( 'admin_init', 'my_greeting_settings_init' );

Sekarang, pengguna boleh mengubah teks pada halaman “Setelan” -> “Ucapan Selamat Saya” (Settings -> Custom Greetings). Ucapan selamat yang telah diubah akan dipaparkan di akhir artikel dan kandungan halaman pada antaramuka pengguna.

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

Keamanan plugin, pengoptimuman, dan persiapan untuk penerbitan

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

Melaksanakan amalan terbaik keselamatan

Keselamatan adalah faktor utama yang perlu diambil kira. Semua data yang diperoleh daripada input pengguna atau pangkalan data, dan kemudian dihantar ke bahagian hadapan (frontend), mesti di-escape (diproses secara khusus untuk mengelakkan masalah keselamatan). Gunakan fungsi yang disediakan oleh WordPress untuk melakukan ini.esc_html()、esc_attr()、wp_kses_post()Dalam mengendalikan penghantaran borang dan permintaan bukan AJAX, pastikan anda menggunakan...wp_verify_nonce()和check_admin_referer()Untuk mengesahkan kesahihan permintaan, serta mencegah serangan penggodaman jenis Cross-Site Request Forgery (CSRF).

Untuk sebarang skrip atau fail gaya (stylesheet) yang diperkenalkan melalui plugin, ia mesti digunakan dengan cara yang sesuai dan mengikut garis panduan yang ditetapkan.wp_enqueue_script()和wp_enqueue_style()Lakukan pendaftaran dan proses muat turun yang betul. Ini akan memastikan bahawa hubungan kebergantungan antara komponen-komponen berjalan dengan lancar dan mengelakkan konflik. Pada masa yang sama, gunakan objek skrip anda dengan cara yang sesuai.wp_localize_script()Untuk menghantar variabel PHP ke JavaScript dengan selamat.

Melakukan internationalisasi dan lokalisasi

Untuk membolehkan plugin digunakan oleh pengguna di seluruh dunia, ia mesti menyokong pengaturcaraan antarabangsa (internationalization). Ini bermakna anda perlu menggantikan semua rentetan teks yang ditujukan untuk pengguna dalam plugin dengan versi yang sesuai untuk bahasa yang berbeza.__()或_e()Fungsi terjemahan perlu dibungkus dalam sebuah kelas atau modul. Dalam nota di bahagian atas fail utama, nyatakan penggunaan fungsi tersebut dan bagaimana ia boleh digunakan.Text DomainIa mesti sama dengan nama direktori plugin. Contohnya:
Text Domain: greeting-plugin

Kemudian, anda boleh menggunakan alat terjemahan (seperti Poedit) untuk menghasilkannya..potFail templat, penterjemah boleh menggunakan ia untuk membuat kandungan yang diinginkan..po和.moFail tersebut disimpan dalam plugin.languages/Dalam folder tersebut.

Sedia untuk diterbitkan dalam direktori rasmi WordPress.

Jika anda merancang untuk menghantar plugin ke direktori plugin WordPress.org, terdapat beberapa persiapan tambahan yang perlu dilakukan. Pertama sekali, pastikan kod tersebut mematuhi standard pengaturcaraan WordPress. Kedua, buat sebuah dokumentasi yang lengkap…readme.txtFail tersebut harus memenuhi keperluan format yang ditetapkan oleh direktori, termasuk mengandungi deskripsi, langkah-langkah pemasangan, tangkapan skrin, log kemas kini, dan lain-lain. Anda juga perlu menghantar plugin tersebut ke repositori SVN dan memastikan struktur direktori mematuhi spesifikasi yang ditetapkan. Sebelum pelancaran, pastikan anda melakukan ujian keserasian yang menyeluruh merentasi versi, topik, dan plugin lain.

RINGKASAN

Pembangunan plugin WordPress adalah proses mengubah idea menjadi ciri-ciri yang berguna, dan intipatinya terletak pada pemahaman serta penggunaan sistem hook dengan mahir. Bermula dengan membuat satu fail yang mengandungi ulasan kepala (header comments) yang betul, anda perlu membina modul-modul fungsi secara beransur-ansur sambil mematuhi piawaian pengkodan yang selamat dan antarabangsa (internationalization). Dengan melalui proses yang lengkap ini – termasuk membina persekitaran setempat (local environment), mengatur kod secara modular, menghubungkan antara bahagian hadapan (frontend) dan belakang (backend), serta menyediakan plugin untuk diterbitkan – anda telah mempelajari asas-asas pembangunan plugin dari awal hingga akhir. Terus belajar tentang API teras WordPress dan menganalisis kod sumber plugin yang berkualiti tinggi merupakan cara terbaik untuk meningkatkan kemahiran pembangunan anda.

FAQ - Soalan Lazim

Adakah mustahil untuk mengembangkan plugin tanpa mahir dalam PHP?

Ya, memiliki asas PHP yang kukuh adalah penting. Ini kerana WordPress sendiri ditulis dalam PHP, dan kod untuk plugin juga kebanyakannya menggunakan PHP. Anda perlu memahami sintaks PHP, fungsi-fungsi, pengaturcaraan berorientasikan objek, serta cara berinteraksi dengan pangkalan data MySQL. Selain itu, pengetahuan asas tentang HTML, CSS, dan JavaScript juga sangat membantu dalam mencipta antara muka pengguna (user interface).

Bagaimana untuk membaiki (debug) plugin saya?

WordPress menyediakan pelbagai alat untuk penyelidikan dan pembetulan masalah (debugging tools). Pertama sekali, pada…wp-config.phpAktifkan mod pembangunan (debug mode) dalam fail tersebut.WP_DEBUGKonstanta ditetapkan kepadatrueIni akan memaparkan ralat PHP, amaran, dan notis pada skrin. Anda juga boleh menggunakan…error_log()Fungsi tersebut akan merekod maklumat khusus ke dalam log ralat pada pelayan, atau menggunakan alat yang lebih canggih seperti plugin Query Monitor yang boleh menganalisis pertanyaan pangkalan data, hook, skrip, dan sebagainya. Ia merupakan alat yang sangat berguna untuk para pembangun.

Adakah plugin saya akan bertentangan dengan tema atau plugin lain?

Ia mungkin. Konflik biasanya berlaku disebabkan oleh beberapa sebab berikut: penggunaan nama fungsi, kelas, atau pemalar yang umum; pertembungan antara skrip dan fail gaya yang dimuat; atau pengurusan keutamaan untuk hook yang sama yang tidak betul. Untuk mengelakkan konflik nama, semua fungsi, kelas, dan pemalar harus menggunakan prefiks yang unik, yang biasanya berkaitan dengan nama plugin atau singkatan.wp_enqueue_scriptFungsi-fungsi dalam siri ini dapat mengurus kitaran hayat aset dengan baik. Semasa membuat perubahan pada tingkah laku asas, pertimbangkan dengan teliti keutamaan dan hubungan kebergantungan antara fungsi-fungsi tersebut (dikenali sebagai “hooks”).

Adakah saya perlu membuat sebuah jadual data yang berasingan untuk plugin saya?

Dalam kebanyakan kes, tidak perlu dan tidak disyorkan untuk membuat jadual pangkalan data baru secara langsung. WordPress menyediakan API Options yang kuat (untuk menyimpan data berbentuk pasangan kunci-nilai) dan API Post Meta/User Meta (untuk menyimpan data yang berkaitan dengan artikel dan pengguna), yang mampu memenuhi keperluan penyimpanan data melebihi 90%. Penggunaan jadual pangkalan data baru hanya perlu dipertimbangkan apabila perlu menyimpan sejumlah besar data yang mempunyai hubungan yang kompleks dan memerlukan carian yang cekap.$wpdbKelas mencipta jadual khusus, tetapi ini akan meningkatkan kerumitan plugin dengan ketara.

Bagaimana untuk menambahkan pilihan tetapan untuk plugin saya?

Seperti yang dinyatakan sebelum ini, kaedah standard adalah menggunakan API Settings dari WordPress. API ini menguruskan aspek keselamatan (seperti pengesahan nonce), pemeriksaan hak pengguna, dan rendering antaramuka pengguna. Langkah-langkah yang perlu diikuti termasuk:add_menu_page()atau fungsi-fungsi yang terbit daripadanya (seperti…)add_options_page()Tambahkan menu dan halaman, kemudian gunakannya.register_setting()、add_settings_section()和add_settings_field()Ia digunakan untuk mendefinisikan dan merender bidang tetapan yang khusus. Ini lebih selamat dan teratur berbanding dengan membuat borang secara manual dan mengurus proses penghantaran (submission).