Panduan Terakhir Pembangunan Plugin WordPress: Bina Plugin Custom Pertama Anda Dari Kosong

Mengapa memilih pembangunan plugin untuk WordPress?

WordPress menjadi sistem pengurusan kandungan (Content Management System/CMS) yang paling popular di dunia kerana keupayaannya yang sangat luas untuk diperluas, dan ini terutamanya berkat arkitektur plugin-nya. Dengan mengembangkan plugin khusus, anda boleh menambahkan sebarang fungsi yang anda inginkan ke laman web anda tanpa perlu mengubah kod asas WordPress. Ini bermakna fungsi-fungsi tersebut boleh wujud secara berasingan daripada tema yang digunakan, dan akan kekal utuh walaupun tema tersebut ditukar. Yang lebih penting, sebuah plugin yang berkualiti tinggi dapat menyelesaikan masalah tertentu yang dihadapi oleh pengguna, dan bahkan boleh menjadi produk atau perkhidmatan yang berdiri sendiri.

Menguasai pembangunan plugin bermakna anda beralih daripada sekadar pengguna WordPress kepada pencipta plugin. Sama ada untuk memenuhi keperluan khusus projek anda sendiri atau untuk menjana pendapatan dengan mengembangkan plugin komersial, memahami prinsip asas dan amalan terbaik dalam pembangunan plugin adalah langkah pertama yang penting. Panduan ini akan membimbing anda bermula dari struktur yang paling asas dan secara beransur-ansur membina sebuah plugin yang lengkap dengan fungsi serta memenuhi standard yang ditetapkan.

Membina struktur plugin pertama anda

Sebuah plugin WordPress yang standard merupakan sebuah folder yang mengandungi satu atau lebih fail PHP, dan direktori akar (root directory)nya mesti mempunyai sebuah fail utama. Fail utama ini perlu mengandungi maklumat header plugin yang khusus, supaya WordPress dapat mengenalinya dan menguruskannya dengan betul.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Menguasai Pembangunan Plugin WordPress: Membina Modul Fungsi Khusus yang Cekap dari Kosong。

Buat fail plugin utama

Langkah pertama yang perlu anda lakukan adalah membuat fail utama untuk plugin tersebut. Fail ini biasanya dinamakan sama dengan nama plugin itu sendiri, sebagai contoh… my-first-plugin.phpDi bahagian atas fail ini, anda mesti menambahkan satu ulasan kepala plugin standard.

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:       我的第一个自定义插件
 * Plugin URI:        https://yourwebsite.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
 * Domain Path:       /languages
 */

Ini adalah “kad pengenalan” bagi plugin tersebut. Di dalamnya… Plugin NameNama plugin merupakan bidang yang wajib diisi sahaja; bidang-bidang lain digunakan untuk memberikan maklumat tambahan. Halaman “Plugins” di panel pentadbiran WordPress akan membaca maklumat tersebut dan memaparkannya. Setelah fail tersebut dibuat, anda perlu meletakkannya di dalam direktori pemasangan WordPress. /wp-content/plugins/ Dalam folder tersebut, anda boleh membuat sebuah sub-folder dengan nama “my-first-plugin”, kemudian letakkan fail utama anda di dalamnya. Selepas itu, log masuk ke panel pentadbiran WordPress dan anda akan dapat melihat serta mengaktifkan plugin tersebut dalam senarai plugin. Walaupun plugin ini belum mempunyai sebarang fungsi pada masa ini, anda telah mengambil langkah pertama yang penting ke arah kejayaan.

Organize your plugin files.

Seiring dengan penambahan fungsi, menjadi sukar untuk menyelenggara semua kod yang terdapat dalam satu fail utama. Struktur organisasi fail yang baik adalah sangat penting. Sebuah plugin tipikal mungkin mengandungi direktori-direktori berikut:
* /includes/Menyimpan fail-fail yang mengandungi fungsi utama dan definisi kelas.
* /admin/Menyimpan fail-fail yang berkaitan dengan antaramuka pengurusan latar belakang.
* /public/Menyimpan fail-fail fungsi frontend yang ditujukan untuk pengunjung laman web.
* /assets/Menyimpan sumber statik seperti JavaScript, CSS, dan gambar.
* /languages/Untuk menyimpan fail terjemahan antarabangsa (.po/.mo).

Struktur modular ini bukan sahaja menjadikan kod lebih jelas, tetapi juga memudahkan kerjasama pasukan dan pengembangan fungsi tambahan pada masa hadapan. Dalam fail utama… my-first-plugin.php Dalam situasi ini, anda biasanya akan menggunakan… require_once Untuk memperkenalkan fail-fail fungsi yang terdapat dalam direktori-direktori ini…

Memahami konsep pembangunan teras WordPress: Hook dan Filter

Inti pembangunan plugin untuk WordPress adalah mekanisme “Hook”. Mekanisme ini membenarkan kod anda untuk “disambungkan” ke dalam proses pelaksanaan utama WordPress pada masa yang tertentu, sehingga anda dapat mengubah atau menambahkan fungsi-fungsi baru. Hook dibahagikan kepada dua jenis: Action dan Filter.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Belajar membangunkan plugin WordPress daripada awal: Pelaksanaan fungsi lanjutan dan panduan amalan terbaik.。

Gunakan pengait tindakan untuk menambah fungsi

Action hooks membenarkan anda menjalankan fungsi kustom anda pada masa tertentu semasa WordPress berjalan. Sebagai contoh, anda mungkin ingin melakukan sesuatu apabila sebuah artikel diterbitkan, atau menambahkan menu ke panel sisi (sidebar) di laman pentadbiran.

Berikut adalah satu contoh yang mudah, menggunakan… wp_footer Hook tindakan ini akan memaparkan mesej di kawasan awam di bahagian bawah halaman web. Anda perlu menambahkan kod berikut ke dalam fail utama plugin anda.

Fungsi myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Terima kasih kerana menggunakan plugin pertama saya!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Di sini,myplugin_add_footer_text Ia adalah fungsi yang kita definisikan sendiri.add_action() Fungsi tersebut akan “mengikat” fungsi ini kepada… wp_footer Aksinya tergantung pada “hook” ini. Apabila WordPress menjalankan bahagian kaki halaman (footer), fungsi kita akan dipanggil secara automatik.

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

Menggunakan pengait penapis (filter hook) untuk mengubah kandungan

Berbeza dengan hook tindakan (action hooks), hook penapis (filter hooks) digunakan untuk mengubah data. Fungsi anda akan menerima satu nilai masukan, dan setelah diproses, ia harus mengembalikan satu nilai. Sebagai contoh, mengubah tajuk artikel atau mengubah cara kandungan dipaparkan.

Contoh di bawah menunjukkan cara untuk menggunakannya. the_content Penapis: Menambahkan secara automatik segmen teks yang disesuaikan pada akhir semua kandungan artikel dan halaman.

function myplugin_append_to_content( $content ) {
    $custom_text = '<div class="myplugin-note"><p><em>Paparan artikel ini telah diperbaiki dengan bantuan plugin khusus yang saya buat sendiri.</em></p></div>';
    // 仅在主循环的单篇文章页面添加
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $content . $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myplugin_append_to_content' );

fungsi myplugin_append_to_content Menerima yang asli $contentKita menggunakan penilaian berdasarkan syarat untuk memastikan bahawa teks hanya ditambahkan di tempat yang diperlukan, dan kemudian kandungan yang telah diubah suai akan dikembalikan.add_filter() Fungsi tersebut telah selesai dengan proses pendaftaran.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pembangunan Plugin WordPress dari Permulaan hingga Mahir: Membina Fungsi Kustom dan Perluasan Berkesan.。

Membuat halaman pengurusan untuk plugin

Kebanyakan plugin memerlukan halaman konfigurasi agar pengguna dapat menetapkan pilihan yang diinginkan. WordPress menyediakan API yang lengkap untuk mencipta antara muka pengurusan yang menarik dan standard.

Tambah menu pengurusan tahap atas

Anda boleh menambahkan item menu baharu pada bar navigasi kiri di latar belakang WordPress untuk plugin anda. Ini dilakukan dengan… add_menu_page() Fungsi tersebut dilaksanakan oleh kod yang ditulis oleh pengaturcara. Kita biasanya… admin_menu Fungsi ini dipanggil dalam hook tindakan ini.

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_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标签
        '我的插件',     // 菜单标题
        'manage_options', // 所需权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_settings_page_html', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80 // 菜单位置（可选）
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Membina kandungan halaman tetapan

Sekarang kita perlu mendefinisikan fungsi panggilan balik (callback function) yang telah disebutkan di atas. myplugin_settings_page_htmlUntuk merender kandungan HTML halaman tetapan, berikut adalah versi yang ringkas:

function myplugin_settings_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
            // 输出设置字段和非ce字段
            settings_fields( 'myplugin_options' );
            do_settings_sections( 'myplugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Fungsi ini membuat sebuah borang yang mematuhi gaya antaramuka (interface) latar belakang WordPress. Untuk menguruskan tetapan dengan lengkap, anda juga perlu menggunakan… register_setting(), add_settings_section() 和 add_settings_field() Fungsi-fungsi seperti ini digunakan untuk mendefinisikan item tetapan yang khusus, dan ini membentuk aliran kerja “Settings API” yang lengkap. Ia merupakan cara yang disyorkan untuk menyimpan dan mendapatkan semula pilihan tambahan (plugins) dengan selamat.

Membangunkan fungsi tambahan (plugin) yang sebenar: Pengiraan jumlah kali artikel dilihat

Mari kita gabungkan konsep-konsep di atas untuk mencipta sebuah fungsi yang praktikal: mengira dan menunjukkan jumlah kali setiap artikel telah dilihat.

Mencipta medan dalam pangkalan data dan menyimpan data

Pertama sekali, kita perlu mencipta tempat untuk menyimpan jumlah kali artikel dilihat semasa ia diterbitkan. Biasanya, kita menggunakan fungsi post meta (meta data artikel) dalam WordPress. Kita boleh menggunakan… add_post_meta Fungsi tersebut memang ada, tetapi cara yang lebih elegan adalah untuk memeriksa dan mengemaskini nilai tersebut ketika artikel tersebut dilihat oleh pengguna.

function myplugin_track_post_views( $post_id ) {
    if ( ! is_single() ) {
        return;
    }
    if ( empty( $post_id ) ) {
        global $post;
        $post_id = $post->ID;
    }
    // 获取当前浏览次数
    $count = get_post_meta( $post_id, 'myplugin_post_views', true );
    // 如果为空，初始化为0
    $count = $count ? absint( $count ) : 0;
    $count++;
    // 更新数据库
    update_post_meta( $post_id, 'myplugin_post_views', $count );
}
// 在模板重定向时触发，确保只对真实访客计数
add_action( 'template_redirect', 'myplugin_track_post_views' );

Menunjukkan jumlah kali halaman web dilihat di bahagian hadapan (frontend).

Setelah data disimpan, kita memerlukan sebuah fungsi untuk mengambil dan memaparkannya. Kita boleh membuat sebuah kod pendek (Shortcode) yang memudahkan pengguna untuk memasukkannya ke dalam kandungan artikel atau alat tambahan di sisi halaman (sidebar).

function myplugin_display_post_views_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => get_the_ID(),
    ), $atts, 'myplugin_views' );

$post_id = absint( $atts['id'] );
    $views = get_post_meta( $post_id, 'myplugin_post_views', true );
    $views = $views ? $views : 0;

return '<span class="myplugin-view-count">Jumlah kali dilihat: '. esc_html($views)'.'</span>'php
add_shortcode('myplugin_views', 'myplugin_display_post_views_shortcode');

Sekarang, pengguna hanya perlu memasukkan kod pendek dalam editor artikel tersebut. [myplugin_views]Atau dengan menambahkan sebuah alat tambahan (gadget) yang mempunyai “kod pendek” (short code), dan memasukkan kod tersebut, jumlah kali artikel tersebut dilihat dapat dipaparkan di halaman web. Contoh lengkap ini meliputi keseluruhan proses, termasuk penyimpanan data (hook), pengambilan data, dan penunjukkan data di bahagian hadapan pengguna (frontend display).

RINGKASAN

Dengan panduan ini, anda telah menyelesaikan proses pembinaan sebuah plugin khusus untuk WordPress bermula dari kosong. Pertama-tama, kita memahami struktur asas sebuah plugin dan membuat fail utama yang mengandungi maklumat header standard. Kemudian, kita mengkaji secara mendalam konsep asas pembangunan plugin WordPress iaitu “hook” (action dan filter), dan belajar cara menggunakannya untuk menambah atau mengubah fungsi-fungsi tertentu. Seterusnya, kita membuat halaman pentadbiran yang profesional untuk plugin tersebut, yang merupakan komponen penting dalam interaksi dengan pengguna. Akhirnya, kita mengaplikasikan konsep-konsep yang telah dipelajari melalui kes praktikal iaitu “pencatatan jumlah kali artikel dilihat”, dan melaksanakan keseluruhan rangkaian fungsi dari pengumpulan data hingga penampilan pada bahagian hadapan (frontend).

Ingatlah, pembangunan plugin yang cemerlang bukan sahaja melibatkan pengaturcaraan fungsi-fungsi tertentu, tetapi juga perlu memberi perhatian kepada keselamatan kod, kebolehjagaan, prestasi, dan pematuhan terhadap standard pengaturcaraan WordPress. Dengan berlatih secara berterusan dan meneroka lebih banyak API WordPress, anda akan dapat mencipta plugin yang berkuasa dan disukai oleh pengguna.

FAQ - Soalan Lazim

Apa pengetahuan asas yang diperlukan untuk membangunkan plugin?

Anda perlu memiliki asas pengaturcaraan PHP yang kukuh, kerana WordPress dan pluginnya kebanyakannya ditulis dalam PHP. Pemahaman asas tentang HTML, CSS, dan JavaScript juga sangat penting, kerana ia akan membantu anda membina antara muka pengguna dan fungsi interaktif. Mengetahui beberapa konsep asas pangkalan data MySQL juga akan membantu anda memahami cara WordPress menyimpan data.

Bagaimana untuk membaiki (debug) plugin WordPress saya?

Pertama sekali, pastikan bahawa anda telah… wp-config.php Aktifkan mod pembangunan (debug mode) untuk WordPress dalam fail tersebut. WP_DEBUG Konstanta ditetapkan kepada trueIni akan memaparkan ralat dan amaran PHP pada skrin. Selain itu, gunakan… error_log() Fungsi tersebut akan menulis maklumat pembaikan ke log ralat pada pelayan, yang merupakan cara pembaikan yang sangat boleh dipercayai. Bagi pemboleh ubah yang kompleks, kaedah ini boleh digunakan bersama-sama dengan teknik lain. print_r() 或 var_dump() 与 error_log()Selain itu, gunakan alat pembangun pelayar (F12) untuk membaiki masalah JavaScript dan CSS pada bahagian hadapan (frontend) aplikasi.

Bagaimanakah plugin saya dapat bersesuaian dengan pelbagai versi WordPress?

Semasa proses pembangunan, anda harus sentiasa merujuk kepada panduan pembangunan rasmi WordPress untuk mengetahui perubahan pada fungsi dan hook dalam versi yang berbeza. function_exists() 或 version_compare() Gunakan pernyataan syarat untuk memeriksa sama ada fungsi atau ciri tertentu tersedia, supaya dapat menyediakan penyelesaian alternatif yang serasi dengan versi sebelumnya. Nyatakan dengan jelas julat versi WordPress yang disokong dalam deskripsi plugin. Melakukan ujian berterusan dalam pelbagai persekitaran ujian WordPress adalah amalan terbaik untuk memastikan keserasian.

Apa yang perlu diperhatikan semasa mengembangkan plugin perniagaan?

Semasa mengembangkan plugin komersial, keselamatan, kualiti kod, dan pengalaman pengguna mesti diutamakan. Anda perlu melaksanakan sistem pengesahan autorisasi yang boleh dipercayai dan selamat (seperti menggunakan kunci lesen). Menyediakan dokumentasi pengguna yang jelas dan sokongan teknikal yang tepat pada masanya adalah sangat penting. Pastikan anda mematuhi garis panduan pembangunan plugin rasmi WordPress dan perjanjian lesen GPL. Pertimbangkan untuk menggunakan platform profesional seperti Freemius atau Easy Digital Downloads untuk mengurus jualan, penghantaran kemas kini, dan permintaan sokongan.