Dari awal: Panduan lengkap dan tutorial amali untuk pembangunan plugin WordPress.

Pra-persiapan sebelum membangunkan plugin WordPress

Sebelum memulakan penulisan baris kod pertama, persiapan yang menyeluruh merupakan asas kejayaan sesuatu projek. Ini bukan sahaja termasuk pembinaan persekitaran teknikal, tetapi juga melibatkan analisis keperluan yang jelas dan perancangan projek yang terperinci.

Pertama sekali, anda memerlukan sebuah persekitaran pembangunan setempat. Alat seperti Local by Flywheel, MAMP, XAMPP, atau Docker disyorkan untuk membangunkan dengan cepat persekitaran operasi WordPress yang merangkumi PHP, MySQL, dan Apache/Nginx. Pastikan versi PHP yang anda gunakan memenuhi keperluan terkini daripada pihak WordPress; biasanya, versi PHP 7.4 atau lebih tinggi diperlukan.

Kedua, tentukan dengan jelas masalah yang ingin diselesaikan oleh plugin anda. Adakah ia bertujuan untuk menambahkan fungsi tertentu ke laman web, atau untuk mengoptimumkan proses sedia ada? Deskripsi plugin yang jelas dan senarai fungsi merupakan panduan penting untuk pembangunan seterusnya. Disarankan untuk menggunakan alat seperti Trello atau dokumen yang ringkas untuk merancang iterasi versi dan ciri-ciri plugin tersebut.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan Pembangunan Plugin WordPress: Dari Asas Hingga Proses Penerbitan dan Penyediaan di Pasaran。

Akhirnya, anda memerlukan sebuah editor kod atau persekitaran pembangunan terintegrasi (Integrated Development Environment/IDE). Visual Studio Code,PhpStorm, dan Sublime Text semuanya merupakan pilihan yang sangat baik, kerana ia menyediakan sokongan yang baik untuk pembangunan aplikasi PHP dan WordPress, termasuk penyorotan sintaks, cadangan kod, dan ciri-ciri penyelidikan (debugging). Setelah semua ini siap, anda boleh mula membuat asas untuk pembangunan plugin tersebut – iaitu fail utama (main file) plugin tersebut.

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

Membuat plugin WordPress pertama anda

Segala sesuatu memang sukar pada mulanya, tetapi membuat fail plugin WordPress yang paling asas adalah sangat mudah. Bahagian ini akan membimbing anda dalam membina struktur asas plugin, menyediakan kenyataan keselamatan (security statement), dan proses pengaktifan plugin tersebut.

Buatlah sebuah folder baru, dan namanya harus unik serta mampu menggambarkan fungsi plugin tersebut dalam bahasa Inggeris. Contohnya:my-first-pluginDalam folder tersebut, buat fail plugin utama, yang biasanya dinamakanplugin-name.phpMari berikan nama kepada fail ini. Fail ini merupakan titik masuk (entry point) untuk plugin, dan WordPress mengenal pasti plugin tersebut dengan membaca maklumat khusus yang terdapat dalam nota (comment) di bahagian awal fail tersebut.

Di bahagian atas fail utama ini, anda mesti menambahkan komen header plugin yang mematuhi standard WordPress. Berikut adalah contoh asas:

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

“Nama Plugin” dalam ulasan ini adalah wajib diisi, manakala maklumat lain adalah pilihan. Namun, sangat disyorkan untuk mengisi semua maklumat dengan lengkap. Setelah selesai, muat naik folder plugin tersebut ke dalam direktori pemasangan WordPress./wp-content/plugins/Ia berada dalam laluan yang betul. Masuk ke halaman “Pemasangan” (Plugins) di panel pentadbiran WordPress, dan anda akan dapat melihat pemasangan anda serta mengaktifkannya. Pada masa ini, pemasangan tersebut belum mempunyai sebarang fungsi, tetapi anda telah berjaya membuat sebuah pemasangan yang dikenali oleh WordPress.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pembangunan plugin WordPress adalah daripada kosong kepada satu, untuk sistem pengurusan kandungan yang paling popular di dunia.。

Melaksanakan satu fungsi yang mudah

Mari kita tambahkan fungsi pertama yang substantif kepada plugin kosong ini: menambahkan kenyataan hak cipta secara automatik di bahagian bawah kandungan artikel. Ini akan membantu anda memahami mekanisme “hook” dalam WordPress.

Pertama sekali, kita perlu membuat sebuah fungsi untuk melaksanakan logik penambahan teks hak cipta. Kita akan menamakan fungsi ini…myplugin_add_footer_text。

function myplugin_add_footer_text($content) {
    // 确保只在网站前端的主文章循环中执行
    if (is_single() && in_the_loop() && is_main_query()) {
        $footer_text = '<p><em>Artikel ini disajikan untuk anda oleh plugin pertama saya.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

Seterusnya, kita perlu “memuatkan” fungsi ini ke titik pelaksanaan tertentu dalam WordPress, dan proses ini dikenali sebagai “menambahkan hook”. Di sini, kita menggunakan…the_contentFilter Hook. Dalam fail utama plugin anda, tambahkan kod berikut:

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_filter('the_content', 'myplugin_add_footer_text');

Setelah menyimpan fail tersebut, muat semula halaman artikel di laman web anda dan anda akan melihat teks hak cipta yang telah anda tetapkan di hujung kandungan. Melalui contoh yang mudah ini, anda telah memahami corak asas pembangunan plugin: mencipta fungsi -> menggunakannya.add_action或add_filterHook berfungsi untuk menghubungkan fungsi tertentu dengan kitaran hayat (lifecycle) WordPress.

Menggali Lebih Dalam: Hook dan API WordPress

Mekanisme hook merupakan inti utama dalam pembangunan plugin untuk WordPress, kerana ia membenarkan kod anda untuk dijalankan pada masa atau tempat yang tertentu. Memahami dan menguasai penggunaan hook dengan baik adalah kunci untuk membina ciri-ciri yang kompleks dalam aplikasi WordPress.

Hook dalam WordPress terbahagi kepada dua jenis utama: Action dan Filter. Hook Action akan diaktifkan apabila acara tertentu dalam kod inti WordPress berlaku, seperti penerbitan artikel atau pemuatkan halaman pentadbiran. Fungsi yang anda tulis boleh melakukan sesuatu tindakan pada masa itu. Sebaliknya, Hook Filter digunakan untuk mengubah data, membenarkan fungsi anda memodifikasi nilai data sebelum ia digunakan atau disimpan, seperti mengubah kandungan artikel atau tajuknya.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pembangunan plugin WordPress dari pemula hingga mahir: Panduan langkah demi langkah untuk membantu anda mencipta fungsi khusus.。

Create an action hook function:

function myplugin_log_post_published($ID, $post) {
    // 当文章发布时，在错误日志中记录一条信息（仅用于演示）
    error_log("文章 {$post->post_title} (ID: {$ID}) 已发布。");
}
// 将函数挂载到 `publish_post` 这个动作钩子上
add_action('publish_post', 'myplugin_log_post_published', 10, 2);

Create a filter hook function:

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 myplugin_excerpt_length($length) {
    // 将默认的摘要长度从55个词修改为20个词
    return 20;
}
// 将函数挂载到 `excerpt_length` 这个过滤器钩子上
add_filter('excerpt_length', 'myplugin_excerpt_length');

Apabila digunakanadd_action或add_filterApabila menggunakan fungsi tersebut, parameter ketiga dan keempat masing-masing mewakili keutamaan (priority) dan bilangan parameter. Dengan menetapkan nilai-nilai ini dengan betul, kita dapat mengawal susunan pelaksanaan beberapa fungsi panggilan balik (callback functions) dengan tepat.

Menggunakan WordPress untuk mengatur API

Untuk membolehkan pengguna plugin menyesuaikan tingkah laku plugin tersebut, anda perlu membuat halaman konfigurasi. WordPress menyediakan API tetapan untuk memudahkan proses ini. Ini biasanya melibatkan tiga fungsi utama:register_settingDigunakan untuk mendaftar satu set tetapan.add_settings_sectionDigunakan untuk menambahkan kawasan tetapan pada halaman.add_settings_fieldDigunakan untuk menambahkan bidang-bidang tertentu dalam kawasan tersebut.

Cipta sebuah fungsi untuk halaman pilihan:

function myplugin_settings_page() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}
add_action('admin_menu', 'myplugin_settings_page');

Kemudian, anda perlu melaksanakannya.myplugin_render_settings_pageFungsi ini digunakan untuk memaparkan sebuah borang.settings_fields和do_settings_sectionsFungsi ini digunakan untuk mengeluarkan maklumat daripada bidang-bidang borang yang diproses secara automatik oleh API WordPress.get_optionDalam fungsi tersebut, anda boleh dengan mudah mendapatkan nilai pilihan yang disimpan oleh pengguna di mana-mana bahagian kod plugin.

Amalan Lanjutan dalam Pembangunan Plugin dan Pengedaran

Apabila fungsi plugin anda semakin lengkap dan jumlah kod semakin bertambah, pengurusan kod yang baik, langkah-langkah keselamatan yang ketat, serta sokongan untuk penggunaan dalam pelbagai bahasa (internationalization) menjadi sangat penting.

Untuk menjaga kejelasan kod, disyorkan agar kod yang mempunyai fungsi yang berbeza dipisahkan ke dalam fail-fail yang berbeza. Sebagai contoh, kod untuk pendaftaran hook (hook registration) dan fungsi-fungsi utama boleh diletakkan dalam fail utama, manakala kod yang berkaitan dengan halaman tetapan (setting page) boleh diletakkan dalam fail yang berasingan.admin/Subdirektori, letakkan kod fungsi bahagian hadapan di sana.public/Subdirektori, dan ia boleh diimport melalui penggunaan pengkondisan (condition loading). Menggunakan Pemrograman Berorientasikan Objek (Object-Oriented Programming/OOP) juga merupakan amalan yang baik untuk menguruskan plugin yang kompleks, kerana ia membolehkan data dan fungsi diselaraskan dengan lebih baik.

Keselamatan merupakan nyawa dalam pembangunan plugin. Semua data yang diperolehi daripada pengguna (seperti…)$_GET， $_POST， $_COOKIESemua item tersebut mesti melalui proses pengesahan dan pembasmian kuman. WordPress menyediakan sebilangan besar fungsi untuk tujuan ini.sanitize_text_field， wp_kses_post， intvalDan sebagainya. Semasa menghantar sebarang data ke pelayar atau pangkalan data, proses pengelakkan (escaping) juga perlu dilakukan dengan menggunakan kaedah yang sesuai.esc_html， esc_attr或wp_ksesFungsi. Untuk operasi pangkalan data, anda mesti menggunakan yang disediakan oleh WordPress.$wpdbKelas dan kes-kesnyaprepareCara untuk mencegah serangan SQL injection.

Mengimplementasikan pengantarabangsaan plugin.

Untuk membolehkan plugin anda digunakan oleh pengguna di seluruh dunia, internationalisasi (penyesuaian untuk bahasa yang berbeza) adalah langkah yang penting. Ini terutamanya melibatkan dua langkah utama:__()或_e()Fungsi seperti `wait` digunakan untuk mengelilingi semua rentetan teks yang perlu diterjemahkan, serta memastikan bahawa bidang teks (text field) dimuat dengan betul.

Dalam bahagian kepala plugin, kita telah mendefinisikan Domain Tekst (Text Domain). Semasa plugin diinisialisasikan (biasanya dalam fail utama), fail bahasa perlu dimuat turun.

function myplugin_load_textdomain() {
    load_plugin_textdomain('my-first-plugin', false, dirname(plugin_basename(__FILE__)) . '/languages/');
}
add_action('init', 'myplugin_load_textdomain');

Selepas itu, anda boleh menggunakan kaedah yang serupa dengan…__('Hello World', 'my-first-plugin')Cara penulisan ini digunakan untuk menandakan rentetan teks. Penterjemah boleh menggunakan alat seperti Poedit, berdasarkan hasil yang dihasilkan..potPembuatan fail templat.po和.moTerjemahkan fail tersebut, dan letakkannya dalam plugin./languages/Dalam direktori tersebut.

Akhirnya, apabila fungsi plugin tersebut menjadi stabil, anda boleh memilih untuk menghantarinya ke direktori plugin rasmi WordPress agar lebih ramai orang dapat menggunakannya. Ini memerlukan anda untuk mengumpulkan kod plugin tersebut dan menulis dokumentasi yang terperinci.readme.txtFail tersebut harus mematuhi piawaian pembangunan komuniti yang ditetapkan.

RINGKASAN

Pembangunan plugin untuk WordPress merupakan perjalanan praktikal yang mengubah idea-idea menjadi ciri-ciri yang berkuasa. Bermula dengan membina persekitaran dan mencipta fail-fail plugin asas, anda akan secara beransur-ansur mempelajari mekanisme hook teras dan API pengaturan, serta topik-topik lanjutan seperti pengaturan kod, keselamatan, dan penyesuaian untuk penggunaan di pelbagai bahasa. Inti keseluruhan proses ini adalah memahami reka bentuk berdasarkan acara (event-driven architecture) WordPress, di mana ciri-ciri teras dapat diperluas dengan lancar melalui hook tindakan (action hooks) dan hook penapis (filter hooks). Ingatlah, bermula dengan satu ciri kecil, melakukan iterasi secara berterusan, dan sentiasa meletakkan keselamatan kod serta pengalaman pengguna sebagai keutamaan, adalah kunci untuk menjadi seorang pembangun plugin yang berjaya.

FAQ - Soalan Lazim

Untuk mengembangkan plugin WordPress, apakah bahasa pengaturcaraan yang perlu dikuasai?
Untuk mengembangkan plugin WordPress, kemahiran dalam bahasa PHP adalah sangat penting, kerana kod asas WordPress ditulis dalam PHP. Selain itu, fungsi-fungsi bahagian hadapan (front-end) biasanya melibatkan penggunaan HTML, CSS, dan JavaScript. Untuk interaksi dengan pangkalan data, pengetahuan asas SQL juga diperlukan.$wpdbKelas tersebut mengandungi kebanyakan operasi yang diperlukan.

Bagaimana untuk men-debug plugin WordPress saya?

Pada peringkat pembangunan, disyorkan untuk mengaktifkan mod pembangunan (debug mode) di WordPress.wp-config.phpDalam fail tersebut, akan…WP_DEBUGKonstanta ditetapkan kepadatrueAnda juga boleh menggunakan…error_log()Fungsi tersebut akan merekod maklumat ke dalam log ralat pada pelayan. Untuk penyelidikan yang lebih kompleks, anda boleh menggunakan alat tambahan profesional seperti Xdebug atau Query Monitor untuk melacak pelaksanaan kod dan pertanyaan pangkalan data.

Bagaimanakah plugin saya boleh berinteraksi dengan perkhidmatan pihak ketiga atau API?

Plugin boleh digunakan melalui API HTTP WordPress (seperti…)wp_remote_get()， wp_remote_post()Ia memastikan komunikasi yang selamat dan stabil dengan perkhidmatan luaran. API HTTP WordPress dilengkapi dengan ciri-ciri seperti pengurusan masa tamat (timeout) dan pengesahan SSL, yang menjadikannya lebih boleh dipercayai berbanding menggunakan fungsi curl atau file_get_contents dalam PHP secara langsung. Semasa memproses respons, pastikan anda memeriksa ralat yang mungkin timbul dan mengambil tindakan yang sesuai untuk mengatasinya.

Bagaimanakah saya boleh menambahkan jadual pangkalan data khusus untuk plugin saya?

Walaupun jadual pilihan WordPress cukup untuk mengurus kebanyakan keperluan penyimpanan konfigurasi, data yang terstruktur mungkin lebih sesuai disimpan dalam jadual khusus yang dibina sendiri. Anda boleh menggunakan pengaitan (hook) yang diaktifkan oleh plugin untuk melakukan ini.register_activation_hookDalam proses pendaftaran fungsi, perintah SQL untuk membuat jadual akan dijalankan. Penggunaan perintah SQL tersebut adalah wajib.$wpdb->prefixPastikan prefiks jadual adalah betul, dan gunakannya.dbDeltaFungsi ini digunakan untuk membuat atau mengemas kini struktur jadual dengan selamat. Sebarang pertanyaan (query) terhadap jadual yang disesuaikan (custom table) harus dilakukan melalui fungsi tersebut.$wpdbObjek tersebut dilakukan.

Bagaimana untuk memastikan bahawa plugin saya serasi dengan plugin lain atau tema?

保持兼容性的最佳实践是：使用WordPress核心API和标准钩子；为函数、类、选项名添加唯一前缀（如使用插件缩写）；将功能封装在类或命名空间中以避免命名冲突；避免直接修改全局变量；并在执行可能影响全局状态的操作（如注册短码、自定义文章类型）前，先检查是否已经存在。在发布前，尽可能多地在不同环境中进行测试。