Dari awal: Panduan lengkap untuk pembangunan plugin WordPress dan perkongsian amalan terbaik.

Asas Pembangunan Plugin WordPress dan Penubuhan Persekitaran

Inti pembangunan plugin WordPress adalah untuk memperluas fungsi asas WordPress, dan semua ini bermula dengan persekitaran pembangunan yang teratur dan terstruktur dengan baik. Sebuah plugin pada asasnya terdiri daripada satu atau lebih fail PHP, yang diletakkan dalam direktori pemasangan WordPress./wp-content/plugins/Dalam folder tersebut, setiap plugin mesti mempunyai satu fail utama. Blok ulasan di bahagian atas fail tersebut merupakan “kad pengenalan” plugin tersebut, yang digunakan untuk memberitahu sistem WordPress maklumat asas tentang plugin tersebut.

Sebuah ulasan kepala plugin yang tipikal adalah seperti berikut:

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

Komen ini sangat penting, kerana ia membenarkan plugin tersebut untuk muncul pada halaman pengurusan “Plugins” di bahagian belakang (backend) WordPress.Text DomainUntuk tujuan internasionalisasi, sebagai persediaan untuk kerja terjemahan yang akan datang.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Lengkap Pembangunan Plugin WordPress: Daripada Asas Hingga Pelancaran Ke Aplikasi Sebenar。

Konfigurasi persekitaran pembangunan tempatan

Sebelum memulakan proses pengkodan, membina persekitaran pembangunan setempat merupakan pilihan yang efisien dan selamat. Alat seperti XAMPP, MAMP, Local by Flywheel, atau Docker disyorkan untuk membina pelayan setempat yang mengandungi Apache/Nginx, MySQL, dan PHP. Pastikan bahawa versi PHP yang anda gunakan sesuai dengan keperluan versi WordPress yang terkini (biasanya versi PHP 7.4 atau lebih tinggi). Selain itu,wp-config.phpAktifkan di sini.WP_DEBUGPola (patterns) membantu dalam proses pembangunan untuk mengenal pasti dan membetulkan ralat dengan cepat.

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

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误日志保存到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不在页面上显示错误信息

Core Architecture of Plugins and Hook Mechanism

Memahami mekanisme Hook dalam WordPress adalah kunci kepada pembangunan plugin yang berkesan. Hook membenarkan plugin anda untuk “terhubung” dengan proses utama WordPress pada titik masa yang tertentu, dan menjalankan kod yang disesuaikan. Terdapat dua jenis utama Hook dalam WordPress: Action dan Filter.

Action Hooks dan Filter Hooks

Action Hooks membenarkan anda menjalankan kod apabila sesuatu acara berlaku. Sebagai contoh, menghantar e-mel pemberitahuan selepas artikel diterbitkan, atau merekod log apabila pengguna log masuk.add_action()Fungsi ini digunakan untuk mendaftarkan fungsi anda ke dalam sesuatu “action hook”.

function myplugin_send_notification( $post_id ) {
    // 当文章发布时，执行发送通知的逻辑
    wp_mail( '[email protected]', '新文章已发布', '文章ID：' . $post_id );
}
// 将 myplugin_send_notification 函数挂载到 ‘publish_post’ 这个动作钩子上
add_action( 'publish_post', 'myplugin_send_notification' );

Filter Hooks membenarkan anda mengubah data yang dihantar semasa proses berjalan. Sebagai contoh, anda boleh mengubah cara kandungan artikel dipaparkan atau mengubah nilai yang dikembalikan oleh sesuatu fungsi.add_filter()Fungsi untuk mendaftar penapis (filters).

function myplugin_modify_content( $content ) {
    // 在文章内容的末尾追加一段自定义文本
    $custom_text = '<p><em>Terima kasih kerana membaca! Artikel ini ditambahkan oleh plugin saya.</em></p>';
    return $content . $custom_text;
}
// 将 myplugin_modify_content 函数挂载到 ‘the_content’ 这个过滤器钩子上
add_filter( 'the_content', 'myplugin_modify_content' );

Membina kelas utama untuk plugin

Walaupun sebuah plugin yang ringkas boleh terdiri daripada hanya beberapa fungsi, namun demi modulariti kod, kebolehjagaan, dan untuk mengelakkan konflik nama, adalah sangat disyorkan untuk menggunakan pendekatan berorientasikan objek (Object-Oriented Programming/OOP) dengan mengemas fungsi-fungsi plugin tersebut dalam sebuah kelas utama. Ini merupakan amalan terbaik dalam pembangunan plugin untuk WordPress moden.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pengenalan Pembangunan Tema WordPress: Membina Tema Pertama Anda Dari Kosong。

class My_First_Plugin {
    public function __construct() {
        // 在构造函数中挂载所有的钩子
        add_action( 'init', array( $this, 'register_shortcode' ) );
        add_action( 'admin_menu', array( $this, 'add_admin_page' ) );
    }

public function register_shortcode() {
        add_shortcode( 'greeting', array( $this, 'render_greeting' ) );
    }

public function render_greeting( $atts ) {
        return '<h3>Hai, WordPress!</h3>';
    }

public function add_admin_page() {
        add_menu_page(
            '我的插件设置',
            '我的插件',
            'manage_options',
            'my-plugin-settings',
            array( $this, 'render_admin_page' )
        );
    }

public function render_admin_page() {
        echo '<div class="wrap"><h2>Halaman Tetapan Plugin</h2><p>Ini adalah antara muka pengurusan.</p></div>';
    }
}
// 初始化插件
new My_First_Plugin();

Membina antaramuka pengurusan dan kod ringkas

Sebuah plugin yang lengkap dan berfungsi dengan baik biasanya memerlukan interaksi dengan pengguna, yang termasuk menyediakan halaman tetapan untuk pentadbir laman web, serta cara yang mudah untuk pengedit kandungan untuk memanggil fungsi-fungsi tersebut.

Membina halaman tetapan latar belakang

WordPress menyediakan API yang kaya untuk membuat menu latar belakang dan halaman sub-menu, sebagai contoh…add_menu_page()、add_submenu_page()Dalam halaman tetapan, anda boleh menggunakan API Tetapan (Settings API) WordPress untuk mendaftar, mengesahkan, dan menyimpan pilihan dengan selamat, yang lebih mudah daripada mengurusnya secara manual.$_POSTData perlu menjadi jauh lebih selamat dan boleh dipercayai.

public function add_admin_page() {
    add_options_page(
        '我的插件选项',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 权限要求
        'my-plugin-options',    // 菜单slug
        array( $this, 'options_page_html' ) // 回调函数，用于输出页面HTML
    );
    // 注册设置、节和字段
    add_action( 'admin_init', array( $this, 'register_settings' ) );
}

public function register_settings() {
    register_setting( 'myplugin_options_group', 'myplugin_option_name' );
    add_settings_section( 'myplugin_section_id', '主要设置', null, 'my-plugin-options' );
    add_settings_field( 'myplugin_field_id', '示例字段', array( $this, 'field_html' ), 'my-plugin-options', 'myplugin_section_id' );
}

public function field_html() {
    $option = get_option( 'myplugin_option_name' );
    echo '<input type="text" name="myplugin_option_name" value="' . esc_attr( $option ) . '" />';
}

public function options_page_html() {
    if ( ! current_user_can( 'manage_options' ) ) return;
    ?&gt;
    <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( 'myplugin_options_group' );
            do_settings_sections( 'my-plugin-options' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Mengimplementasikan fungsi kod pendek

Shortcodes merupakan cara yang sangat baik untuk membolehkan pengguna dengan mudah memasukkan ciri-ciri tambahan (plugins) ke dalam artikel atau halaman web.add_shortcode()Fungsi tersebut didaftarkan, dan fungsi panggilan baliknya menerima atribut-atribut yang berkaitan.$atts）dan kandungan（$contentIa menerima parameter dan mengembalikan kandungan yang akhirnya akan 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

public function register_shortcodes() {
    add_shortcode( 'display_latest_posts', array( $this, 'render_latest_posts' ) );
}

public function render_latest_posts( $atts ) {
    // 设置默认属性，并使用 shortcode_atts 合并用户传入的属性
    $attributes = shortcode_atts( array(
        'count' => 5,
        'category' => '',
    ), $atts );

$args = array(
        'posts_per_page' => intval( $attributes['count'] ),
        'post_status' => 'publish',
    );
    if ( ! empty( $attributes['category'] ) ) {
        $args['category_name'] = sanitize_text_field( $attributes['category'] );
    }

$query = new WP_Query( $args );
    $output = '<ul>';
    while ( $query-&gt;have_posts() ) {
        $query-&gt;the_post();
        $output .= '<li><a href="/ms/' . get_permalink() . '/">'. get_the_title() . '</a></li>';
    }
    wp_reset_postdata();
    $output .= '</ul>';
    return $output;
}

Keamanan plugin, prestasi, dan persiapan untuk penerbitan

Pada fasa akhir pembangunan, anda perlu memastikan bahawa plugin tersebut adalah selamat, berkesan, dan mudah untuk diedarkan. Mengabaikan aspek-aspek ini boleh menyebabkan kelemahan keselamatan, laman web menjadi perlahan, atau pengalaman pengguna yang buruk.

Keselamatan dan Pengesahan Data

Sebarang data yang datang dari pengguna atau sumber luar (seperti parameter URL, penghantaran borang, pangkalan data) dianggap tidak boleh dipercayai. Data tersebut perlu disahkan, dibersihkan, dan di-escape menggunakan satu siri fungsi yang disediakan oleh WordPress.
* 验证（Validation）：检查数据是否符合预期格式（如是否为邮箱、数字），使用is_email()、intval()dan sebagainya.
* 清理（Sanitization）：在数据保存到数据库之前，移除其中不安全的字符，使用sanitize_text_field()、sanitize_email()、wp_kses_post()dan sebagainya.
* 转义（Escaping）：在将数据输出到HTML、JavaScript或URL之前，对其进行编码，防止XSS攻击，使用esc_html()、esc_js()、esc_url()、esc_attr()dan sebagainya.

Untuk operasi pangkalan data, pastikan anda menggunakan…$wpdbMetode yang disediakan oleh kelas tersebut, dan menggunakannya.prepare()Lakukan pertanyaan parameterized pada ayat tersebut untuk mencegah serangan SQL injection.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Prinsip Peningkatan Kelajuan CDN dan Panduan Amalan: Bagaimana Memilih Rangkaian Pengedaran Kandungan (Content Distribution Network) Terbaik untuk Laman Web Anda。

Pengoptimuman Prestasi dan Penyelenggaraan Lanjutan

Kualiti prestasi merupakan kunci kepada pengalaman pengguna. Elakkan menjalankan kueri atau proses yang memakan masa semasa setiap halaman dimuat. Untuk data yang jarang berubah, gunakan API Cache Sementara (Transients API) yang disediakan oleh WordPress untuk menyimpannya.

$data = get_transient( 'myplugin_expensive_data' );
if ( false === $data ) {
    $data = // ... 执行复杂的数据库查询或远程API调用 ...
    set_transient( 'myplugin_expensive_data', $data, HOUR_IN_SECONDS ); // 缓存1小时
}

Untuk menambahkan sokongan antarabangsa dan penyesuaian tempatan (localization) kepada plugin, gunakan kaedah berikut:__()、_e()Fungsi seperti ini mengelilingi semua teks yang kelihatan oleh pengguna, dan melalui…load_plugin_textdomain()Memuatkan fail bahasa. Pada masa yang sama, perlu merancang kitaran hidup (lifecycle) plugin dengan baik, dan menulis kod untuk mengaktifkannya.register_activation_hookAktifkan (Enable), Deaktifkan (Disable)register_deactivation_hook) dan membuangnya (uninstall).register_uninstall_hookLogik pengendalian ‘hook’ ini digunakan untuk mencipta/menghapus jadual dalam pangkalan data, membersihkan pilihan, dan sebagainya.

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

Pengaturcaraan untuk penerbitan: Dokumen dan pengepakan

Sebelum mengeluarkannya, buatlah satu dokumen yang terperinci…readme.txtFail tersebut perlu mematuhi spesifikasi rasmi WordPress, termasuk deskripsi plugin, langkah-langkah pemasangan, soalan yang sering diajukan, log kemas kini, dan lain-lain. Ini adalah halaman pengenalan plugin anda dalam direktori plugin WordPress. Akhir sekali, pastikan struktur direktori plugin anda jelas, hanya mengandungi fail-fail yang diperlukan, dan pakailah format ZIP yang standard untuk mengemaskannya.

RINGKASAN

Pembangunan plugin WordPress adalah proses mengubah idea menjadi ciri-ciri yang berguna, dan ia bergantung pada pemahaman yang mendalam tentang struktur asas WordPress (terutamanya mekanisme hook). Langkah pertama dalam memulakan pembangunan adalah menyediakan persekitaran yang sesuai, menulis kod untuk komponen asas plugin, serta menguasai penggunaan hook untuk tindakan (actions) dan penapis (filters). Menggunakan pendekatan pengaturcaraan berorientasikan objek (object-oriented programming) dapat meningkatkan kualiti kod dan kemudahan penyelenggaraan projek. Membina antara muka belakang yang selamat melalui API Settings, serta menyediakan fungsi-fungsi depan yang fleksibel melalui kod yang ringkas, merupakan cara utama untuk interaksi antara plugin dengan pengguna. Akhir sekali, amalan terbaik dalam aspek keselamatan (pemverifikasian, pembersihan data, pengekstrakan simbol berbahaya), prestasi (caching, pengoptimuman kueri), dan penyesuaian untuk penggunaan antarabangsa perlu diaplikasikan sepanjang proses pembangunan. Selain itu, penyediaan dokumentasi yang lengkap juga sangat penting untuk mencipta plugin WordPress yang profesional, boleh dipercayai, dan disukai oleh pengguna.

FAQ - Soalan Lazim

开发WordPress插件需要掌握哪些编程语言？

Keperluan utama adalah kemahiran yang tinggi dalam penggunaan PHP, kerana WordPress sendiri serta plugin dan tema-temanya ditulis dalam bahasa PHP. Pada masa yang sama, pemahaman asas tentang HTML, CSS, dan JavaScript adalah penting untuk membina antara muka pengguna (front-end) dan logik interaksi bagi plugin tersebut. Jika operasi yang melibatkan pangkalan data menjadi lebih kompleks, pengetahuan asas SQL juga diperlukan.

Bagaimana untuk mengelakkan konflik antara plugin yang saya bangunkan dengan plugin lain?

Kaedah utama adalah untuk memastikan identifikasi seperti nama fungsi, nama kelas, dan nama variabel adalah unik. Amalan terbaik adalah menggunakan pengaturcaraan berorientasikan objek (Object-Oriented Programming) dan mengemas semua kod dalam satu kelas. Untuk fungsi dan variabel global, anda boleh menggunakan prefiks yang unik, seperti menggunakan singkatan atau nama plugin sebagai prefiks.myplugin_function_name或MyPlugin_ClassName。

Mengapa plugin saya menambahkan menu di latar belakang, tetapi halaman tersebut menunjukkan “Anda tidak mempunyai hak akses yang cukup untuk mengakses halaman ini”?

Ini adalah kerana semasa panggilan dibuat…add_menu_page()Apabila menggunakan fungsi yang serupa, parameter “Capability” yang ditetapkan tidak betul. Anda perlu memastikan bahawa parameter ketiga (kebenaran/keupayaan) adalah sesuatu yang dimiliki oleh peranan pengguna semasa. Untuk halaman tetapan yang hanya boleh diakses oleh pentadbir, parameter tersebut biasanya digunakan khusus untuk tujuan pengesahan akses.‘manage_options’Anda boleh menggunakan fungsi tersebut sekali lagi dalam fungsi panggilan balik (callback function).current_user_can( ‘manage_options’ )Periksa dengan teliti.

Bagaimana untuk menambahkan sokongan terjemahan kepada plugin saya?

Pertama sekali, setkan dengan betul dalam ulasan di bahagian atas fail utama plugin.Text Domain(Contohnyamy-pluginKemudian, gunakan__( ‘Text’, ‘my-plugin’ )或_e( ‘Text’, ‘my-plugin’ )Fungsi tersebut mengelilingi semua rentetan teks yang perlu diterjemahkan. Akhirnya, semasa pemulaan plugin (contohnya, pada…)init(Dalam tindakan) menggunakanload_plugin_textdomain()Terdapat fungsi untuk memuatkan fail bahasa. Anda boleh menggunakan alat seperti Poedit untuk membuatnya..potFile-file templat dan.po/.moMenterjemahkan dokumen.