Dari pemula hingga mahir: Panduan lengkap untuk pembangunan plugin WordPress.

Asas Pembangunan Plugin WordPress dan Persediaan Persekitaran

Untuk memulakan pembangunan plugin WordPress, anda mesti memahami konsep-konsep terasnya dan menyediakan persekitaran pembangunan standard. Plugin WordPress pada dasarnya terdiri daripada satu atau lebih fail PHP, yang disimpan dalam/wp-content/plugins/Dalam katalog, kewujudan plugin diumumkan melalui header khusus (Plugin Header). Ini bukan sekadar kod, tetapi juga cara mengikuti falsafah reka bentuk WordPress, supaya ia dapat berintegrasi dengan lancar dengan teras dan plugin lain.

Persekitaran pembangunan merupakan titik permulaan untuk kerja yang berkesan. Adalah amat disyorkan untuk mengkonfigurasi pemasangan WordPress yang berdiri sendiri pada komputer setempat, dan bukan pada laman web produksi dalam talian. Anda boleh menggunakan pakej pelayan setempat seperti MAMP, XAMPP, atau alat moden yang lebih fleksibel seperti Local by Flywheel atau Docker. Memasang editor kod atau persekitaran pembangunan bersepadu (IDE) seperti Visual Studio Code, PHPStorm, dsb. juga sangat penting, kerana ia menyediakan sorotan sintaks, petunjuk kod, dan fungsi debugging, yang membantu meningkatkan produktiviti pembangunan secara signifikan.

Prosedur untuk mencipta plugin baru sangat mudah. Masuk ke dalam/wp-content/plugins/Katalog, buat folder baru, nama terbaiknya menggunakan huruf kecil semua dan garis bawah, seperti contohnyamy-first-pluginKemudian, cipta fail PHP utama di bawah folder tersebut, biasanya dengan nama yang sama seperti folder tersebut, sepertimy-first-plugin.phpAwal filem ini mesti mengandungi blok anotasi tertentu (kepala fail), yang merupakan “ID” bagi plugin tersebut.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Dari kosong ke satu: Panduan lengkap untuk pembangunan plugin WordPress dan tutorial praktikal.。

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

Selepas menyimpan fail, log masuk ke panel pentadbiran WordPress anda dan pergi ke menu “Plugins”. Anda akan melihat plugin baru ini muncul dalam senarai plugin dan boleh mengaktifkan atau menyahaktifkannya. Dengan ini, persekitaran pembangunan asas dan rangka kerja plugin telah siap.

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

Struktur fail-fail plugin dan komponen teras.

Sebuah projek plugin yang terstruktur dan teratur dengan baik merupakan asas untuk penyelenggaraan jangka panjang. Selain daripada fail utama yang mengandungi kepala fail, sebuah plugin yang lengkap biasanya mengandungi beberapa komponen.

File-file plugin utama (sepertimy-first-plugin.phpIni adalah titik masuk untuk plugin, yang biasanya bertanggungjawab untuk memuat fail lain, mentakrifkan pemalar global, mendaftar pengait (Hooks) dan kerja-kerja permulaan yang lain. Dengan fungsi yang bertambah, kod tidak sepatutnya terkumpul semua dalam fail utama. Adalah disyorkan untuk memodulkan kod bagi fungsi-fungsi berbeza, dan menyimpannya dalam sub-direktori yang berbeza. Sebagai contoh,/includes/Katalog tersebut menyimpan kelas-kelas fungsi utama dan fail-fail fungsi;/admin/Katalog ini menyimpan kod dan halaman yang berkaitan dengan pengurusan backend;/public/或/frontend/Katalog menyimpan logik paparan halaman depan;/assets/Di sisi lain, direktori digunakan untuk menyimpan sumber statik seperti JavaScript, CSS, dan gambar.

Pendorong utama plugin WordPress ialah sistem “hook”, yang terbahagi kepada dua jenis: tindakan (Action) dan penyaring (Filter). Tindakan hook melaksanakan fungsi kustom anda apabila peristiwa tertentu berlaku, digunakan untuk “melakukan sesuatu”, sepertiinit、wp_head或save_postPengait penyaring digunakan untuk “mengubah suai data tertentu”, yang membenarkan anda untuk mengubah suai data sebelum ia digunakan, sebagai contoh.the_content、wp_title或excerpt_length。

Langkah penting dalam pembangunan plugin ialah mendaftar dan menulis fungsi untuk mengendalikan pengait. Ini biasanya dilakukan dalam fail utama plugin. Anda perlu menggunakanadd_action()或add_filter()Fungsi tersebut digunakan untuk memberitahu WordPress fungsi mana yang harus dipanggil apabila pengait tertentu dicetuskan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Utama untuk Membangunkan Ekstensi WooCommerce: Dari Pemula hingga Pakar dalam Membina Plugin E-dagang Tersuai。

\n// Tambahkan pengait tindakan untuk menambahkan teks selepas kandungan artikel
function mfp_add_text_to_content( $content ) {
    // Hanya berlaku untuk kandungan artikel dalam gelungan utama
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = ' <ms>'<p><em>Teks ini ditambahkan oleh “Plug-in pertama saya”.</em></p>'// Menggunakan add_filter untuk memasangkan fungsi kami kepada penyaring ‘the_content‘  
add_filter( 'the_content', 'mfp_add_text_to_content' );

Mencipta halaman pilihan latar belakang untuk plugin.

Menyediakan halaman konfigurasi untuk plugin anda adalah kunci untuk mencipta plugin yang mesra pengguna. Ini membenarkan pentadbir laman web untuk menyesuaikan tingkah laku atau konfigurasi plugin tanpa mengubah kod.

WordPress menyediakan pelbagai fungsi untuk mencipta halaman pentadbiran pada pelbagai tahap. Yang paling sering digunakan ialah WordPress provides multiple functions to create different levels of administration pages. The most commonly used one isadd_menu_page()Fungsi ini menambahkan item menu utama dan halamannya ke bar sisi pentadbiran, atau menggunakanadd_submenu_page()Tambahkan sublaman di bawah menu utama yang sedia ada (seperti “Tetapan” atau “Alat”).

Halaman pilihan latar belakang berpusatkan pada interaksi dengan input pengguna. Biasanya, halaman tersebut terdiri daripada borang, dan setelah data borang dihantar, plugin perlu menerima, mengesahkan, dan menyimpan data tersebut ke dalam pangkalan data dengan selamat. WordPress mengesyorkan penggunaanoptions API untuk mengendalikan data seperti ini, ia menyediakanregister_setting()、add_settings_section()和add_settings_field()Fungsi-fungsi seperti ini boleh mengendalikan pengesahan keselamatan secara automatik (pemeriksaan Nonce, pemeriksaan kebenaran, dll.) dan penyimpanan data, yang sangat memudahkan proses.

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

Di bawah ini adalah contoh rangka untuk mencipta halaman tetapan yang mudah:

/ / Langkah 1: Daftar halaman pilihan dalam menu belakang
function mfp_register_options_page() {
    add_options_page(
        'Pengaturan Plugin Saya',   // Tajuk halaman
        'Plugin Saya',   // Tajuk menu
        'manage_options',   // Keperluan keizinan
        'mfp-options',   // Slug halaman
        'mfp_options_page_html'   // Fungsi panggilan balik untuk mengeluarkan HTML halaman
    );
}
add_action('admin_menu', 'mfp_register_options_page');

// Langkah 2: Definisikan fungsi panggilan balik untuk mengeluarkan HTML halaman
function mfp_options_page_html() {
    // Memeriksa keizinan
    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">
            <p><strong>Sekiranya anda mengalami masalah semasa menggunakan plugin ini, sila rujuk kepada dokumentasi resmi atau hubungi pembangunnya.</strong></p>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    <p>  'mfp_custom_message']
    );
}
add_action('admin_init', 'mfp_settings_init');

// Langkah 4: Definisikan panggilan balik HTML medan
function mfp_field_message_html() {
    $value = get_option('mfp_custom_message', 'Mesej Lalai');
    ?&gt; <p>
    <input type='text' id='mfp_custom_message' name='mfp_custom_message' value='<?php echo esc_attr($value); ?>' class='regular-text'>
    &lt;?php
}

Keselamatan plugin dan amalan terbaik.

Menerbitkan sebuah plugin bukan sekadar melaksanakan fungsi, tetapi juga memastikan keselamatan, kestabilan dan keserasiannya. Mengikuti standard pengekodan keselamatan merupakan langkah pertama untuk melindungi diri anda dan laman web pengguna.

Pertama sekali, semua data yang diterima daripada pengguna atau pihak ketiga mesti dianggap tidak bolehsipercayai. Ini bermaksud, sebelum data tersebut dihantar ke pelayar (HTML, JavaScript), digunakan untuk pertanyaan pangkalan data atau operasi sistem fail, data tersebut mesti disunting, disahkan dan disanitasi dengan betul. WordPress menyediakan pelbagai fungsi keselamatan, sepertiesc_html()、esc_attr()、esc_url()Dipergunakan untuk mengeluarkan karakter yang melakukan pelarian;sanitize_text_field()、sanitize_email()Dipergunakan untuk memasukkan disinfektan;wp_kses()Dipergunakan untuk menyaring tag HTML yang dibenarkan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan untuk Membangunkan Plugin WordPress: Membina Plugin Fungsi Pertama Anda Dari Awal。

Kedua, semasa memproses penyerahan borang atau permintaan AJAX, anda mesti menggunakan mekanisme Nonce WordPress untuk mencegah serangan Cross-Site Request Forgery (CSRF), dan menggunakancurrent_user_can()Fungsi tersebut melakukan pemeriksaan kebenaran yang ketat.

Interaksi pangkalan data sepatutnya menggunakan kelas pangkalan data WordPress sebanyak mungkin.$wpdbBerikan kaedahnya, dan sentiasa gunakan pernyataan prepare untuk variabel dalam pertanyaan SQL, untuk mencegah suntikan SQL.

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

global $wpdb;
$user_input = $_POST['search'];
$safe_input = $wpdb->esc_like($user_input); // 转义LIKE语句中的特殊字符
$prepared_sql = $wpdb->prepare(
    "SELECT * FROM {$wpdb->posts} WHERE post_title LIKE %s",
    '%' . $safe_input . '%'
);
$results = $wpdb->get_results($prepared_sql);

Dari segi amalan terbaik, adalah dinasihatkan untuk menambahkan awalan unik (seperti <) kepada nama fungsi, kelas, dan pilihan plugin.mfp_(Untuk mengelakkan konflik penamaan dengan tema, plugin lain atau teras WordPress.) Penggunaan pemrograman berorientasikan objek (OOP) secara wajar dapat membantu mengatur kod dengan lebih baik, serta mencapai pengkapsulan dan penggunaan semula. Selain itu, mempertimbangkan pengantarabangsaan plugin juga sangat penting, dengan menggunakan__()、_e()\nFungsi tersebut membungkus semua rentetan yang dapat dilihat oleh pengguna, dan menyediakan pengait untuknya.plugins_loadedDaftar fungsi permulaan yang memuatkan medan teks, yang membolehkan anda menterjemahkan plugin ke dalam bahasa lain dengan mudah pada masa akan datang.

RINGKASAN

Pembangunan plugin WordPress merupakan proses mengubah idea menjadi fungsi yang boleh digunakan semula, yang memerlukan pembangun tidak hanya menguasai PHP, tetapi juga memahami secara mendalam arkitektur teras WordPress, khususnya sistem hook yang kuat. Dari membina folder plugin dan fail pengisytiharan yang sederhana, hingga menggunakan hook tindakan dan penyaring untuk memperluas fungsi, dan seterusnya membina antaramuka pengurusan belakang yang mesra pengguna, setiap langkah adalah penting untuk membina plugin yang kuat.

Lebih penting lagi, selama keseluruhan kitaran pembangunan, keselamatan mesti diutamakan, dengan mengikuti garis panduan keselamatan seperti pengesahan data, pemformatan output, pemeriksaan keizinan, dan pencegahan suntikan SQL. Amalan terbaik seperti struktur fail modular, konvensyen penamaan yang jelas, dan persediaan pengantarabangsaan dapat memastikan kod plugin mudah untuk diselenggara, boleh skalabel, dan profesional.

FAQ - Soalan Lazim

### Apakah pengetahuan asas yang diperlukan untuk membangunkan plugin WordPress?
Untuk membangunkan plugin WordPress, anda perlu menguasai pengetahuan asas bahasa pengaturcaraan PHP, kerana kod plugin utamanya terdiri daripada PHP. Selain itu, anda perlu mempunyai pengetahuan asas tentang HTML, CSS dan JavaScript untuk membina antara muka interaktif depan dan belakang. Yang paling penting, anda perlu biasa dengan konsep-konsep teras WordPress, seperti Hooks, Shortcode, Custom Post Type dan Options API, yang merupakan jambatan antara plugin dan WordPress.

Bagaimana untuk men-debug kod plugin WordPress saya

Pembaikan merupakan fasa penting dalam proses pembangunan. Pertama sekali, adalah dinasihatkan untuk melakukannya dalam persekitaran pembangunan tempatan.wp-config.phpBuka fail tersebut.WP_DEBUGModel ini akan memaparkan kesilapan, amaran, dan pemberitahuan PHP. Anda boleh memasang dan mengkonfigurasi plugin debug khusus, seperti Query Monitor atau Debug Bar, yang memberikan maklumat terperinci tentang pertanyaan pangkalan data, pelaksanaan pengait, analisis prestasi, dan lain-lain. Untuk masalah logik yang kompleks, anda boleh menggunakan debugger profesional seperti Xdebug dengan IDE untuk debugging titik putus. Pada masa yang sama, memeriksa log ralat WordPress dan PHP juga merupakan kaedah yang berkesan untuk mengenal pasti masalah.

Selepas mengembangkan plugin, bagaimana untuk mengedarkan atau meletakkannya di pasaran?

Plugin untuk penggunaan peribadi atau pengedaran kecil boleh dibungkus secara langsung ke dalam fail ZIP, dan diunggah dan dipasang melalui panel pentadbiran WordPress. Jika anda ingin mengemukakan plugin ke direktori plugin WordPress rasmi, supaya ia boleh dicari dan dimuat turun oleh pengguna di seluruh dunia, anda perlu melawat WordPress.org, membuka akaun pembangun, dan mengemukakan kod plugin anda untuk semakan. Proses semakan akan memeriksa kualiti kod, keselamatan, dan pematuhan dengan garis panduan direktori. Setelah diluluskan, anda akan menerima repositori SVN untuk menjadi hos dan mengemaskini versi plugin anda.

Bagaimana untuk memastikan plugin saya serasi dengan versi WordPress yang berbeza?

Untuk memastikan keserasian maksimum, pembangun harus memberi perhatian kepada syarat-syarat versi PHP minimum yang dikeluarkan oleh WordPress, dan berusaha untuk mematuhi ciri-ciri sintaks PHP yang lama dalam kod plugin mereka (sambil menggunakan ciri-ciri PHP moden untuk penurunan yang anggun). Di bahagian atas fail utama plugin, mereka boleh menggunakanRequires at least:和Tested up to:Tunggu pengumuman keserasian dengan versi terbaru WordPress. Adalah penting untuk menguji secara regular dengan versi berbeza dari WordPress dan persekitaran PHP. Menggunakan sistem kawalan versi (seperti Git) untuk menguruskan perubahan kod boleh membantu anda menjejak dan membaiki masalah yang disebabkan oleh peningkatan versi dengan mudah.