Mulai dari nol: Panduan lengkap dan tutorial praktis untuk pengembangan plugin WordPress.

Persiapan sebelum mengembangkan plugin WordPress.

Sebelum mulai menulis baris kode pertama, persiapan yang memadai merupakan dasar kesuksesan proyek. Ini tidak hanya mencakup pengaturan lingkungan teknis, tetapi juga analisis kebutuhan dan perencanaan proyek yang jelas.

Pertama, Anda memerlukan lingkungan pengembangan lokal. Disarankan untuk menggunakan alat seperti Local by Flywheel, MAMP, XAMPP, atau Docker untuk dengan cepat membangun lingkungan runtime WordPress yang mencakup PHP, MySQL, dan Apache/Nginx. Pastikan versi PHP Anda memenuhi persyaratan terbaru dari WordPress, yang biasanya membutuhkan PHP 7.4 atau versi yang lebih baru.

Kedua, tentukan masalah yang ingin dipecahkan oleh plugin Anda. Apakah itu untuk menambahkan fitur tertentu ke situs web, atau mengoptimalkan proses yang sudah ada? Deskripsi plugin yang jelas dan daftar fitur merupakan cetak biru untuk pengembangan selanjutnya. Disarankan untuk menggunakan alat seperti Trello atau dokumen sederhana untuk merencanakan iterasi versi dan fitur-fiturnya.

推荐阅读 Panduan Memulai Pengembangan Plugin WordPress: Seluruh Proses dari Nol hingga Rilis dan Publikasi.。

Akhirnya, Anda memerlukan editor kode atau lingkungan pengembangan terintegrasi. Visual Studio Code, PhpStorm, dan Sublime Text adalah pilihan yang sangat baik, yang memberikan dukungan yang baik untuk pengembangan PHP dan WordPress, termasuk penyorotan sintaks, petunjuk kode, dan fitur debugging. Setelah semuanya siap, Anda dapat membuat file utama, yang merupakan dasar dari plugin tersebut.

UltaHost – Hosting untuk WordPress

Jaminan pengembalian uang dalam 30 hari, bandwidth dan basis data yang tidak terbatas, perlindungan DDoS gratis, diskon 50% untuk pembelian selama 3 tahun (dari harga normal: 50%).

halaman akses

Membuat plugin WordPress pertamamu.

Semua hal sulit di awal, tetapi membuat file plugin WordPress paling dasar sangatlah mudah. Bagian ini akan memandu Anda melalui pembuatan struktur dasar plugin, deklarasi keamanan, dan proses aktivasi.

Buat folder baru, yang namanya harus unik dan menggambarkan fungsi plugin dalam bahasa Inggris, misalnyamy-first-pluginDi dalam folder tersebut, buat file utama plugin, yang biasanya diberi nama In this folder, create the main plugin file, which is usually named <plugin-name.phpUntuk memberi nama. File ini adalah titik masuk untuk plugin, dan WordPress mengidentifikasi plugin dengan membaca informasi komentar tertentu di bagian atas file ini.

Di bagian atas file utama ini, Anda harus menambahkan komentar header plugin yang sesuai dengan standar WordPress. Berikut ini adalah contoh paling dasarnya:

<?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 anotasi ini wajib diisi. Informasi lainnya bersifat opsional, tetapi sangat disarankan untuk mengisinya secara lengkap. Setelah selesai, unggah folder plugin ini ke direktori instalasi WordPress./wp-content/plugins/Di dalam Path. Setelah masuk ke halaman “Plugins” di backend WordPress, Anda akan dapat melihat plugin Anda dan mengaktifkannya. Pada saat ini, plugin tersebut belum memiliki fungsi apa pun, tetapi Anda telah berhasil membuat plugin yang dikenali oleh WordPress.

推荐阅读 Mengembangkan plugin WordPress dari nol hingga satu, untuk sistem manajemen konten paling populer di dunia.。

Merealisasikan sebuah fungsi sederhana.

Mari kita tambahkan fungsi substantif pertama ke plugin shell ini: menambahkan pernyataan hak cipta secara otomatis di bagian bawah konten artikel. Ini akan membantu Anda memahami mekanisme hook di WordPress.

Pertama, kita perlu membuat sebuah fungsi untuk mengimplementasikan logika menambahkan teks hak cipta. Kami akan memberi nama fungsi inimyplugin_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 kepada Anda oleh plugin pertama saya.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

Selanjutnya, kita perlu “memasang” fungsi ini ke titik eksekusi tertentu di WordPress, proses ini disebut “menambahkan hook”. Di sini kita menggunakanthe_contentKait filter. Di file utama plugin Anda, tambahkan kode berikut:

hosting.com hosting bersama

Kinerja tinggi, dilengkapi dengan CPU AMD EPYC, penyimpanan SSD NVMe, dan LiteSpeed, dukungan internal ahli 24 jam sehari, langkah-langkah keamanan canggih termasuk SSL, brute force, malware, dan perlindungan DDoS, menghemat hingga 731 TB/bulan.

halaman akses

add_filter('the_content', 'myplugin_add_footer_text');

Setelah menyimpan file, segarkan halaman artikel di situs web Anda, dan Anda akan melihat teks hak cipta yang Anda definisikan muncul di akhir konten. Dengan contoh sederhana ini, Anda telah memahami pola inti dari pengembangan plugin: membuat fungsi -> menggunakannya.add_action或add_filterHooks mengintegrasikan fungsi ke dalam siklus hidup WordPress.

Membahas secara mendalam: Hook dan API WordPress.

Mekanisme hook adalah inti dari pengembangan plugin WordPress, yang memungkinkan kode Anda berjalan pada waktu atau lokasi tertentu. Memahami dan mahir menggunakan hook adalah kunci untuk membangun fungsionalitas yang kompleks.

Kait WordPress terutama dibagi menjadi dua jenis: Aksi (Action) dan Filter (Filter). Kait Aksi dipicu saat peristiwa inti WordPress tertentu terjadi, seperti memublikasikan artikel, memuat dasbor admin, dll. Fungsi Anda dapat “melakukan” beberapa hal. Kait Filter digunakan untuk memodifikasi data, memungkinkan fungsi Anda mengubah nilai data sebelum digunakan atau disimpan, misalnya mengubah konten artikel, judul, dll.

推荐阅读 Mengembangkan Plugin WordPress, dari Pemula hingga Ahli: Panduan Langkah demi Langkah untuk Membuat Fitur Kustomisasi.。

Membuat fungsi pengait aksi:

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);

\nBuat fungsi pengait filter:

Hosting bersama InterServer.

Hosting bersama seharga $2,50 USD per bulan, diskon $0,1 USD untuk bulan pertama dengan kode promo tryinterserver, serta 461 skrip aplikasi cloud yang dapat diinstal dengan sekali klik.

halaman akses

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

Saat menggunakanadd_action或add_filterKetika itu, parameter ketiga dan keempat masing-masing mewakili prioritas dan jumlah parameter. Dengan mengaturnya secara wajar, Anda dapat mengontrol urutan eksekusi beberapa fungsi panggilan balik secara tepat.

Menggunakan API yang disediakan oleh WordPress.

Untuk memungkinkan pengguna plugin menyesuaikan perilaku, Anda perlu membuat halaman konfigurasi. WordPress menyediakan API pengaturan untuk menyederhanakan proses ini. Ini biasanya melibatkan tiga fungsi utama:register_setting\nUntuk mendaftarkan sekumpulan pengaturan,add_settings_section\nUntuk menambahkan area pengaturan di halaman,add_settings_field\nUntuk menambahkan bidang spesifik di area tersebut.

\nFungsi untuk membuat halaman opsi:

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

Kemudian, kamu perlu mengimplementasikannya.myplugin_render_settings_pageFungsi untuk menampilkan formulir, dan menggunakansettings_fields和do_settings_sectionsFungsi untuk mengeluarkan bidang formulir yang diproses secara otomatis oleh WordPress API. Melaluiget_optionDengan fungsi ini, Anda dapat dengan mudah mengambil nilai opsi yang disimpan pengguna di mana saja dalam kode plugin.

Praktik lanjutan dan rilis pengembangan plugin.

Saat fungsi plugin Anda semakin sempurna dan jumlah kodenya bertambah, organisasi kode yang baik, perlindungan keamanan, dan dukungan internasional menjadi sangat penting.

Untuk menjaga kode tetap jelas, disarankan untuk memisahkan kode dari berbagai fungsi ke dalam file yang berbeda. Misalnya, tempatkan pendaftan hook dan fungsi inti di file utama, dan kode yang terkait dengan halaman pengaturan di file lain.admin/Subdirektori, tempatkan kode fungsi front-end di dalamnya.public/Subdirektori, dan diperkenalkan melalui pemuatan bersyarat. Menggunakan pemrograman berorientasi objek (OOP) juga merupakan praktik yang sangat baik untuk mengelola plugin yang kompleks, karena dapat mengemas data dan fungsi dengan lebih baik.

Keselamatan merupakan hal terpenting dalam pengembangan plugin. Semua data yang diperoleh dari pengguna (seperti$_GET， $_POST， $_COOKIESemua yang dimasukkan ke dalam database harus divalidasi dan didesinfeksi. WordPress menyediakan banyak fungsi, sepertisanitize_text_field， wp_kses_post， intvalDll. Saat mengeluarkan data apa pun ke browser atau database, Anda juga perlu melakukan penggantian karakter, dengan menggunakan <.esc_html， esc_attr或wp_ksesFungsi. Untuk operasi database, Anda harus menggunakan WordPress.$wpdbKlas dan metode-metodenyaprepareMetode untuk mencegah injeksi SQL.

Menginternasionalisasi plugin.

Untuk membuat plugin Anda dapat digunakan oleh pengguna di seluruh dunia, penting untuk melakukan internasionalisasi. Ini terutama melibatkan dua langkah: menggunakan__()或_e()Menunggu fungsi mengemas semua string yang perlu diterjemahkan, serta memuat bidang teks dengan benar.

Di bagian header plugin, kami telah mendefinisikan Text Domain. Saat plugin diinisialisasi (biasanya di file utama), file bahasa perlu dimuat:

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

Setelah itu, Anda dapat menggunakan sesuatu yang mirip dengan__('Hello World', 'my-first-plugin')Untuk menandai string, gunakan notasi seperti ini: \n. Penerjemah dapat menggunakan alat seperti Poedit, berdasarkan hasil yang dihasilkan..potMembuat file template..po和.moMenerjemahkan file dan menempatkannya di plugin./languages/Di bawah menu.

Akhirnya, setelah fungsi plugin stabil, Anda dapat memilih untuk mengirimkannya ke direktori plugin resmi WordPress agar lebih banyak orang dapat menggunakannya. Untuk itu, Anda perlu mengemas kode plugin dan menulis deskripsi yang terperinci.readme.txtUntuk melakukan ini, Anda harus membaca dokumentasi dan mengikuti pedoman pengembangan komunitas.

Menyimpulkan.

Mengembangkan plugin WordPress adalah perjalanan praktis untuk mengubah ide menjadi fitur yang kuat. Mulai dari menyiapkan lingkungan dan membuat file plugin dasar, Anda secara bertahap mempelajari mekanisme hook inti dan API pengaturan, dan akhirnya menyentuh topik lanjutan seperti organisasi kode, keamanan, dan internasionalisasi. Inti dari seluruh proses adalah memahami arsitektur berbasis event WordPress, yang memungkinkan Anda memperluas fungsionalitas inti secara mulus melalui aksi dan filter hook. Ingatlah bahwa memulai dengan fitur kecil, melakukan iterasi secara bertahap, dan selalu mengutamakan keamanan kode serta pengalaman pengguna adalah kunci utama untuk menjadi pengembang plugin yang sukses.

FAQ - Pertanyaan yang Sering Diajukan.

Untuk mengembangkan plugin WordPress, bahasa pemrograman apa yang perlu dikuasai?
Untuk mengembangkan plugin WordPress, Anda terutama perlu menguasai bahasa PHP, karena inti WordPress itu sendiri ditulis dalam PHP. Selain itu, fitur-fitur front-end biasanya melibatkan HTML, CSS, dan JavaScript. Untuk interaksi database, pengetahuan dasar SQL juga bermanfaat, tetapi WordPress sudah menyediakan fungsi database yang cukup lengkap.$wpdbKelas mengemas sebagian besar operasi.

Bagaimana cara men-debug plugin WordPress saya?

Di tahap pengembangan, disarankan untuk mengaktifkan mode debugging WordPress. Diwp-config.phpDalam dokumen tersebut, akan...WP_DEBUGKonstanta diatur ketrueAnda juga dapat menggunakanerror_log()Fungsi tersebut akan mencatat informasi ke dalam log kesalahan server. Untuk debugging yang lebih kompleks, Anda dapat menggunakan plugin profesional seperti Xdebug atau Query Monitor untuk melacak eksekusi kode dan kueri database.

Bagaimana plugin saya dapat berinteraksi dengan layanan atau API pihak ketiga?

Plugin dapat mengakses HTTP API WordPress (sepertiwp_remote_get()， wp_remote_post()Melakukan komunikasi yang aman dan stabil dengan layanan eksternal. HTTP API WordPress memiliki fitur seperti penanganan timeout, validasi SSL, dan lain-lain, yang lebih dapat diandalkan daripada menggunakan fungsi curl atau file_get_contents PHP secara langsung. Saat memproses respons, pastikan untuk memeriksa kesalahan dan melakukan penanganan kesalahan yang tepat.

Bagaimana cara menambahkan tabel database kustom untuk plugin saya?

Meskipun tabel opsi WordPress cukup untuk menangani sebagian besar penyimpanan konfigurasi, data terstruktur mungkin lebih cocok untuk disimpan di tabel khusus. Anda dapat menggunakan hook aktivasi plugin (menggunakan <) untuk melakukan ini.register_activation_hookUntuk melakukan ini, Anda perlu menggunakan pernyataan SQL untuk membuat tabel dalam fungsi registrasi. Hal ini harus dilakukan dengan menggunakan$wpdb->prefixUntuk memastikan prefiks tabel benar, dan gunakandbDeltaFungsi untuk membuat atau memperbarui struktur tabel secara aman. Setiap kueri untuk tabel kustom harus dilakukan melalui$wpdbHal ini dilakukan oleh objek.

Bagaimana memastikan plugin saya kompatibel dengan plugin atau tema lain?

Praktik terbaik untuk menjaga kompatibilitas adalah: menggunakan API inti WordPress dan hook standar; menambahkan awalan unik (seperti menggunakan singkatan plugin) untuk fungsi, kelas, dan nama opsi; mengemas fungsionalitas dalam kelas atau ruang nama untuk menghindari konflik penamaan; menghindari memodifikasi variabel global secara langsung; dan memeriksa apakah sudah ada sebelum melakukan tindakan yang dapat memengaruhi status global (seperti mendaftarkan kode pendek, tipe artikel kustom). Lakukan pengujian sebanyak mungkin di berbagai lingkungan sebelum merilisnya.