Pengenalan Pembangunan Plugin WordPress: Panduan Langkah Demi Langkah untuk Menerbitkan Plugin Berdiri Sendiri dan Memulakan Jalan Ke Pendapatan

Ramai pembangun ingin mengubah kemahiran mereka dalam menggunakan WordPress menjadi pendapatan yang sebenar, dan mengembangkan serta mengeluarkan plugin yang berdiri sendiri merupakan cara yang ideal. Ini bukan sahaja membolehkan kod anda memberi perkhidmatan kepada ribuan pengguna, tetapi juga menjana pendapatan yang berterusan. Namun, untuk membina sebuah plugin yang memenuhi piawaian rasmi WordPress, mempunyai ciri-ciri yang lengkap, dan boleh dijual dari awal, diperlukan pengetahuan dan pengalaman yang sistematik. Artikel ini akan memberikan panduan yang jelas tentang proses lengkap, daripada persiapan persekitaran, pembangunan asas, hingga ke pengeluaran dan pemasaran plugin tersebut.

Pengurusan persiapan dan pembinaan persekitaran pembangunan

Sebelum menulis baris kod pertama, adalah sangat penting untuk mewujudkan persekitaran pembangunan yang cekap dan standard. Ini bukan sahaja dapat meningkatkan kecekapan pembangunan, tetapi juga memastikan kualiti kod yang dihasilkan.

Mencipta persekitaran pembangunan tempatan

Cara yang paling disyorkan adalah untuk membina persekitaran operasi WordPress pada komputer lokal anda. Anda boleh menggunakan alat terintegrasi seperti XAMPP, MAMP, Local by Flywheel, atau Laragon, yang membenarkan pemasangan Apache, MySQL, dan PHP dengan cepat. Pastikan bahawa versi PHP yang anda gunakan adalah selaras dengan persekitaran hos yang biasa digunakan (biasanya tidak kurang dari 7.4), dan aktifkan mod pembangunan (debug mode) dalam WordPress, kerana ini akan membantu mengenal pasti ralat semasa fasa pembangunan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Dari Kosong Ke Satu: Panduan Autoriti dan Tutorial Amalan Pembangunan Plugin WordPress。

在 wp-config.php Dalam fail tersebut, tetapkan konstanta berikut untuk mengaktifkan mod pembangunan (debugging):

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 ); // 不在页面上显示错误

Struktur asas bagi plugin perancangan

Cipta sebuah folder yang berasingan untuk plugin anda. Misalnya, jika nama plugin kita adalah “My First Plugin”, maka nama folder tersebut bolehlah menjadi “My First Plugin”. my-first-pluginDalam folder plugin, terdapat sekurang-kurangnya beberapa fail utama yang diperlukan:

1. Fail Utama: Biasanya dinamakan berdasarkan nama plugin, seperti my-first-plugin.phpIni adalah satu-satunya pintu masuk untuk plugin tersebut, yang mengandungi ulasan berkaitan bahagian kepala (header) plugin.
2. Fail Kelas Utama: Seperti class-my-first-plugin.phpIa digunakan untuk mengatur logik fungsi utama plugin.
3. assets Folder: Digunakan untuk menyimpan sumber JavaScript, CSS, dan gambar.
4. includes Folder: Digunakan untuk menyimpan fail-fail kelas bantuan atau fungsi lain.
5. languages Folder: Tempat penyimpanan fail terjemahan antarabangsa (.po/.mo).

Menulis plugin pertama anda

Sekarang, mari kita buat kerangka untuk plugin ini dan laksanakan satu fungsi asas.

Mendefinisikan fail utama plugin

Kitaran hidup sebuah plugin bermula daripada fail utamanya. Dalam fail utama tersebut… my-first-plugin.php Pada permulaan kod plugin, anda mesti menulis ulasan kepala plugin mengikut spesifikasi WordPress. Ini adalah kunci untuk WordPress mengenali plugin tersebut.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Dari awal: Panduan lengkap untuk pembangunan plugin WordPress dan perkongsian amalan terbaik.。

<?php
/**
 * Plugin Name:       My First Plugin
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       一个用于演示的入门级 WordPress 插件，用于在文章末尾添加自定义内容。
 * Version:           1.0.0
 * Author:            Your Name
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Membina sebuah kelas fungsi teras

Pembinaan plugin yang baik biasanya menggunakan Pemrograman Berorientasikan Objek (Object-Oriented Programming/OOP). Kami mencipta sebuah kelas utama untuk mengumpulkan semua fungsi, bagi mengelakkan konflik nama fungsi.

Pertama sekali, buatlah fail tersebut. class-my-first-plugin.php：

<?php
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 防止直接访问
}

class My_First_Plugin {

/**
     * 构造方法，初始化钩子
     */
    public function __construct() {
        // 在文章内容末尾添加自定义文本
        add_filter( 'the_content', array( $this, 'append_custom_content' ) );
        // 在管理后台添加一个设置菜单
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

/**
     * 在文章内容末尾添加内容
     *
     * @param string $content 原始文章内容。
     * @return string 修改后的文章内容。
     */
    public function append_custom_content( $content ) {
        if ( is_single() && is_main_query() ) {
            $custom_text = get_option( 'mfp_custom_text', '感谢阅读！欢迎关注。' );
            $content .= &#039;<div class="my-custom-content"><p>' . esc_html( $custom_text ) . '</p></div>';
        }
        return $content;
    }

/**
     * 在 WordPress 后台添加一个设置菜单项
     */
    public function add_admin_menu() {
        add_options_page(
            'My First Plugin 设置', // 页面标题
            '我的第一个插件',       // 菜单标题
            'manage_options',      // 权限
            'my-first-plugin',     // 菜单 slug
            array( $this, 'render_settings_page' ) // 回调函数
        );
    }

/**
     * 渲染设置页面的 HTML
     */
    public function render_settings_page() {
        ?&gt;
        <div class="wrap">
            <h1>Pengaturan untuk “My First Plugin”</h1>
            <form action="/ms/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'mfp_settings_group' );
                do_settings_sections( 'my-first-plugin' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="ms"/></form>
        </div>
        &lt;?php
    }
}

Seterusnya, dalam fail utama… my-first-plugin.php Selepas ulasan kepala (header comment), masukkan kelas tersebut dan instansikan ia:

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

// 引入主类文件
require_once plugin_dir_path( __FILE__ ) . 'class-my-first-plugin.php';

// 初始化插件
function run_my_first_plugin() {
    new My_First_Plugin();
}
run_my_first_plugin();

Peningkatan fungsi tambahan dan keselamatan

Sebuah plugin yang berkualiti tidak hanya perlu melaksanakan fungsi yang diharapkan, tetapi juga perlu mengambil kira aspek keselamatan dan kebolehkonfigurasi.

Tambahkan pilihan tetapan dan pengesahan data.

Untuk membolehkan pengguna menyesuaikan teks tambahan, kita perlu membuat pilihan tetapan yang sebenar. Ini melibatkan penggunaan API tetapan WordPress.

在 My_First_Plugin Dalam kaedah pembinaan kelas (constructor method), tambahkan fungsi pengaitan (hook) untuk pengaturan awal (initialization settings):

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

add_action( 'admin_init', array( this， 'register_settings' ) );

Kemudian, tambahkan kaedah untuk mendaftar tetapan dalam kelas tersebut:

public function register_settings() {
    // 注册一个设置项 `mfp_custom_text` 到 `mfp_settings_group`
    register_setting(
        'mfp_settings_group', // 选项组
        'mfp_custom_text',    // 选项名
        array(
            'type'              => 'string',
            'sanitize_callback' => 'sanitize_text_field', // 数据净化，防止 XSS
            'default'           => '感谢阅读！欢迎关注。',
        )
    );

// 添加一个设置区域
    add_settings_section(
        'mfp_main_section',
        '主要设置',
        null, // 回调函数，可为空
        'my-first-plugin' // 页面 slug
    );

// 在设置区域中添加字段
    add_settings_field(
        'mfp_custom_text_field',
        '自定义追加文本',
        array( $this, 'render_text_field' ), // 渲染字段的回调
        'my-first-plugin',
        'mfp_main_section'
    );
}

public function render_text_field() {
    $value = get_option( 'mfp_custom_text' );
    echo '<input type="text" name="mfp_custom_text" value="' . esc_attr( $value ) . '" class="regular-text">';
    echo '<p class="description">Kandungan ini akan dipaparkan di akhir setiap artikel.</p>';
}

Mengimplementasikan sokongan antarabangsa (internationalization)

Untuk membolehkan plugin anda digunakan oleh pengguna di seluruh dunia, pengaturcaraan untuk sokongan bahasa antarabangsa (internationalization atau i18n) adalah penting. Kami telah menentukan butiran yang diperlukan dalam komen di bahagian atas kod plugin tersebut. Text Domain 和 Domain PathSekarang, semua rentetan teks yang ditujukan untuk pengguna perlu dibalut dengan fungsi terjemahan.

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

Sebagai contoh, semasa halaman tetapan rendering, gantilah rentetan yang dikodkan secara keras dengan:

<h1><?php esc_html_e( 'My First Plugin 设置', 'my-first-plugin' ); ?></h1>

在 append_custom_content Ketika mendapatkan teks lalai dalam kaedah tersebut:

$custom_text = get_option( 'mfp_custom_text', __( '感谢阅读！欢迎关注。', 'my-first-plugin' ) );

Akhirnya, anda perlu menggunakan alat seperti Poedit untuk mengimbas fungsi terjemahan dalam kod dan menghasilkan… .pot Fail templat, dan berdasarkan itu, cipta versi dalam bahasa yang berbeza (seperti…) zh_CN.po 和 .moFail terjemahan tersebut, letakkan di dalam… /languages Katalog.

Ujian, Pemampatan, dan Pengedaran

Sebelum menghantar plugin kepada pengguna, ujian yang menyeluruh dan proses pembungkusan yang profesional merupakan langkah kritikal yang terakhir.

Melakukan ujian fungsi yang menyeluruh

Ujian harus meliputi aspek-aspek berikut:
1. Ujian Fungsi: Pastikan bahawa fungsi “Menambahkan Tekst” berfungsi dengan betul pada halaman artikel individu, dan bahawa tetapan halaman dapat disimpan serta dibaca semula.
2. Ujian Keserasian: Uji plugin tersebut pada pelbagai versi WordPress (terutamanya versi terdahulu yang utama), versi PHP, serta beberapa tema yang popular.
3. Ujian Keselamatan: Semak sama ada semua input pengguna (seperti pilihan tetapan) telah melalui proses pengesahan yang sesuai. esc_html、sanitize_text_field Proses pembersihan atau pengekstrakan (purification/escaping) tersebut memastikan bahawa pengguna bukan pentadbir tidak dapat mengakses halaman tetapan (settings page).
4. Pemeriksaan Prestasi: Pastikan bahawa plugin tidak melakukan kueri pangkalan data yang tidak perlu atau menjalankan skrip yang berat setiap kali halaman dimuat.

Sedia untuk diterbitkan di WordPress.org

Jika anda memutuskan untuk mengeluarkan plugin tersebut secara percuma ke dalam direktori plugin rasmi WordPress, anda perlu:
1. Daftar sebuah repositori SVN di WordPress.org.
2. Buatlah satu nama yang profesional untuk plugin anda. readme.txt Fail ini menggunakan format tertentu (serupa dengan Markdown) untuk menunjukkan deskripsi, langkah-langkah pemasangan, tangkapan skrin, log kemas kini, dan lain-lain pada halaman direktori plugin. Ini merupakan komponen penting dalam pemasaran plugin.
3. Pastikan kod tersebut mematuhi standard pengaturcaraan WordPress. Anda boleh menggunakan PHP_CodeSniffer bersama dengan peraturan standard WordPress untuk melakukan pemeriksaan automatik.
4. Gunakan klien SVN untuk menghantar folder plugin anda (yang mengandungi semua fail) ke repositori. /trunk Senarai. Tagkan kod versi yang stabil. /tags/1.0.0 Katalog.

Mengatur persiapan untuk pelancaran komersial

Jika anda merancang untuk menjalankan jualan komersial (contohnya melalui laman web sendiri atau platform pasaran seperti CodeCanyon):
1. Menambahkan pengurusan lesen: Membangunkan sistem untuk mengesahkan bukti pembelian pengguna, yang mungkin berhubung dengan platform jualan anda melalui API.
2. Membina mekanisme peningkatan: Menambahkan fungsi pemeriksaan kemas kini kepada plugin, supaya apabila anda mengeluarkan versi baru pada pelayan anda sendiri, notis kemas kini dapat dihantar kepada pengguna yang telah memasangnya. Ini biasanya dilakukan dengan memasukkan data khusus ke dalam sistem kemas kini WordPress.
3. Menyempurnakan dokumen: Menulis dokumen penggunaan yang jelas, soalan lazim (FAQ), dan panduan penyelesaian masalah.
4. Pilih kaedah pembayaran dan pengedaran: Integrasikan gateway pembayaran seperti Stripe atau PayPal, atau gunakan plugin e-dagang yang telah terbukti seperti Easy Digital Downloads atau WooCommerce untuk membina portal jualan anda sendiri.

RINGKASAN

Pembangunan plugin WordPress merupakan proses sistem yang melibatkan kreativiti, pelaksanaan, dan pengkomersialan. Ia bermula dengan keperluan yang jelas serta persekitaran pembangunan yang standard. Kuncinya adalah untuk mengikuti garis panduan pengkodan WordPress, menggunakan API Hook yang kaya, serta memastikan prinsip keselamatan dan penyesuaian untuk pelbagai bahasa (internationalization) dipatuhi. Dengan mengatur kod secara berorientasikan objek, asas yang kukuh untuk penyelenggaraan plugin dapat dibina. Tahap ujian, pembungkusan, dan penerbitan merupakan jambatan yang menghubungkan pembangun dengan pengguna di seluruh dunia. Sama ada plugin tersebut disediakan untuk dikongsi secara percuma atau dijual secara komersial, penyampaian yang profesional sangat penting. Dengan mengikuti langkah-langkah dalam panduan ini, anda akan dapat membina plugin WordPress yang mempunyai struktur yang jelas, selamat, boleh dipercayai, dan memenuhi standard penerbitan, sekali gus mengambil langkah yang kukuh ke arah menjana pendapatan melalui teknologi.

FAQ - Soalan Lazim

Adakah pembangunan plugin WordPress mesti menggunakan pengaturcaraan berorientasikan objek?

Ia bukanlah sesuatu yang wajib, tetapi sangat disyorkan. Dengan menggunakan Pemrograman Berorientasikan Objek (Object-Oriented Programming/OOP) dan kelas untuk mengatur kod, anda dapat mengemas fungsi plugin anda dalam ruang nama (namespace) yang berasingan dengan berkesan, yang secara signifikan mengurangkan risiko konflik dengan nama fungsi tema atau plugin lain. Ini juga menjadikan struktur kod lebih jelas, lebih mudah untuk dijaga dan diperluas.

Dalam nota kepala plugin, apa itu `Text Domain` dan `Domain Path`?

Text Domain(Lembah teks) adalah pengekod unik yang digunakan untuk memberitahu WordPress plugin mana yang menggunakan “paket fail terjemahan” yang sesuai. Ia biasanya sama dengan nama folder plugin atau nama fail utama.Domain Path Ini menentukan laluan berkenaan berbanding dengan direktori akar plugin tersebut. WordPress akan mencari bahasa yang sesuai di dalam laluan ini. .mo Translate the document. For example,Domain Path: /languages Ia bermakna fail terjemahan disimpan dalam plugin tersebut. /languages Dalam folder tersebut.

Bagaimana untuk memastikan bahawa plugin saya tidak memperlahankan kelajuan laman web pengguna?

Mengoptimumkan prestasi plugin adalah sangat penting. Elakkan menjalankan kueri pangkalan data yang kompleks setiap kali halaman dimuat, dan gunakan API Transients untuk menyimpan data yang boleh disimpan dalam cache. Bagi fail JavaScript dan CSS di bahagian frontend, hanya muatkan mereka pada halaman-halaman yang memerlukannya, berdasarkan penilaian syarat tertentu (seperti…). is_admin() 或 is_single()Ia akan dimuat menggunakan kaedah tersebut, dan kemudian digunakan. wp_enqueue_script() 和 wp_enqueue_style() Fungsi tersebut diperkenalkan dengan hubungan kebergantungan yang betul dan nombor versi yang sesuai. Semakan kod dilakukan secara berkala untuk menghapuskan operasi yang tidak perlu (redundant operations).

Saya sepatutnya mengeluarkan plugin tersebut ke WordPress.org atau menjualnya sendiri?

Ia bergantung pada matlamat anda. Menerbitkan kandungan di WordPress.org adalah percuma, yang membolehkan anda menjangkau sejumlah besar pengguna, membina reputasi, dan mendapat keuntungan melalui sumbangan atau dengan mengarahkan pengguna ke perkhidmatan versi profesional anda. Namun, ia memerlukan plugin untuk mematuhi lesen GPL, dan terdapat beberapa kriteria penilaian yang perlu dipenuhi. Jika anda menjualnya sendiri (dengan lesen komersial), anda akan mempunyai kawalan penuh ke atas penetapan harga, pemasaran, dan saluran sokongan. Anda juga boleh membina plugin yang lebih kompleks dan berfungsi dengan lebih baik, tetapi anda perlu mengurus pembayaran, pengesahan lesen, penghantaran kemas kini, dan perkhidmatan pelanggan sendiri.

Bagaimana untuk mengendalikan perubahan dalam struktur pangkalan data dengan selamat ketika pengguna mengemaskini plugin?

Ini adalah masalah yang sering berlaku, walaupun ia dianggap “tinggi tahap” (complex). Apabila versi baru plugin anda memerlukan perubahan pada pangkalan data (seperti membuat jadual baru atau menambahkan lajur), anda tidak boleh membiarkan proses tersebut berlaku setiap kali halaman dimuat. CREATE TABLE Amalan terbaik adalah menyimpan nombor versi pangkalan data sebagai satu pilihan (option) dalam WordPress. <code>yourplugin_db_version</code>Semasa pemulaan plugin, periksa sama ada versi pangkalan data dalam kod semasa adalah sama dengan versi yang disimpan. Jika tidak sama, panggil fungsi khusus untuk mengemas kini yang akan melakukan perubahan SQL yang diperlukan, kemudian kemas kini nombor versi yang disimpan. Ini memastikan bahawa operasi kemas kini hanya dilakukan sekali sahaja.