Panduan Pengembangan Kustom Plugin WooCommerce: Membuat Toko Online Eksklusif.

Dalam lingkungan e-commerce yang sangat kompetitif saat ini, sebuah toko WooCommerce standar seringkali tidak dapat memenuhi semua kebutuhan bisnis. Baik itu proses pembayaran yang disesuaikan, aturan perhitungan biaya pengiriman yang khusus, maupun integrasi yang mendalam dengan sistem pihak ketiga, semuanya memerlukan perluasan terhadap fungsi inti toko tersebut. Inilah nilai dari pengembangan plugin khusus. Dengan menulis plugin sendiri, kita dapat memastikan bahwa toko kita mampu beradaptasi dengan kebutuhan bisnis yang berubah-ubah. WooCommerce Dengan menggunakan plugin ini, Anda dapat memperoleh kendali penuh untuk menciptakan pengalaman belanja yang unik dan membangun hambatan bisnis yang sulit ditiru.

Konfigurasi Lingkungan Pengembangan Plugin WooCommerce

Sebelum memulai pengembangan apa pun, lingkungan pengembangan lokal yang stabil dan terisolasi sangat penting. Hal ini tidak hanya dapat melindungi data Anda yang tersimpan di server, tetapi juga memudahkan proses debugging dan pengujian.

Membangun lingkungan WordPress lokal

Rekomendasikan untuk menggunakan alat-alat seperti Local by Flywheel, XAMPP, atau MAMP untuk dengan cepat membangun lingkungan lokal. Pastikan bahwa lingkungan Anda memenuhi persyaratan yang diperlukan. WooCommerce Persyaratan minimum: PHP 7.2 atau versi lebih baru, MySQL 5.6 atau versi lebih baru, serta versi terbaru dari WordPress. Setelah WordPress terinstal, instal dan aktifkan plugin dari direktori plugin resmi. WooCommerce Menggunakan plugin dan menyelesaikan panduan pengaturan awalnya, serta mengimpor data contoh akan sangat membantu dalam proses pengembangan.

推荐阅读 Panduan Lengkap untuk Pengembangan Situs Web E-commerce dan Optimasi Kinerja dengan WooCommerce.。

Membuat struktur dasar plugin

Satu WooCommerce Plugin ini, pertama-tama, merupakan sebuah plugin standar untuk WordPress. wp-content/plugins/ Buatlah folder baru di dalam direktori tersebut, misalnya… my-custom-woocommerceDalam folder tersebut, buatlah file plugin utama, yang umumnya diberi nama sesuai dengan nama plugin tersebut, misalnya… my-custom-woocommerce.php。

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

File utama ini perlu memuat informasi header plugin WordPress yang standar. Berikut adalah contoh dasarnya:

<?php
/**
 * Plugin Name: My Custom WooCommerce
 * Plugin URI:  https://yourwebsite.com/
 * Description: 为 WooCommerce 商店添加自定义功能。
 * Version:     1.0.0
 * Author:      您的名字
 * Author URI:  https://yourwebsite.com/
 * License:     GPL v2 or later
 * Text Domain: my-custom-woocommerce
 * Domain Path: /languages
 * WC requires at least: 5.0.0
 * WC tested up to: 8.0.0
 */

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

// 检查 WooCommerce 是否已激活
if ( ! in_array( 'woocommerce/woocommerce.php', apply_filters( 'active_plugins', get_option( 'active_plugins' ) ) ) ) {
    add_action( 'admin_notices', function() {
        ?>
        <div class="notice notice-error">
            <p>“Plugin ”My Custom WooCommerce” memerlukan WooCommerce yang telah terinstal dan diaktifkan.</p>
        </div>
        &lt;?php
    } );
    return;
}

Poin kuncinya terletak pada penggunaan… WC requires at least 和 WC tested up to Header information is used to declare and specify certain details. WooCommerce Kemampuan kompatibilitas tersebut, serta pemeriksaan yang dilakukan dalam kode. WooCommerce Apakah sudah diaktifkan?

Core Extension Method: Action and Filter Hooks

WooCommerce Kelebihan utamanya terletak pada sistem hook yang sangat dapat diperluas. Memahami dan menguasai penggunaan Action Hook (Hook untuk Aksi) serta Filter Hook (Hook untuk Filter) merupakan kunci dalam pengembangan yang disesuaikan (custom development).

(Menggunakan action hooks untuk mengintervensi proses.)

Action hooks memungkinkan Anda untuk… WooCommerce Masukkan kode Anda pada momen tertentu saat eksekusi program berlangsung. Misalnya, Anda ingin melakukan operasi khusus (seperti memanggil API eksternal) setelah pengguna melakukan pemesanan.

推荐阅读 Panduan Praktis Pengembangan Plugin WordPress: Membangun Plugin Fungsional Pertama Anda dari Nol Hingga Satu.。

Anda dapat menggunakan woocommerce_thankyou “Hook” tersebut diaktifkan pada halaman ucapan terima kasih pesanan. Atau, gunakan pendekatan yang lebih umum (general). woocommerce_checkout_order_processedFungsi tersebut diaktifkan ketika proses penanganan pesanan selesai.

add_action( 'woocommerce_checkout_order_processed', 'my_custom_order_action', 10, 3 );

function my_custom_order_action( $order_id, $posted_data, $order ) {
    // 获取订单对象（如果未提供）
    if ( ! $order instanceof WC_Order ) {
        $order = wc_get_order( $order_id );
    }

// 执行您的自定义逻辑，例如记录日志或发送请求
    $logger = wc_get_logger();
    $logger->info( '订单 #' . $order_id . ' 已创建，开始执行自定义任务。', array( 'source' => 'my-custom-plugin' ) );

// 调用外部 API 示例（伪代码）
    // $response = wp_remote_post( 'https://api.example.com/notify', $args );
}

Menggunakan filter hook untuk memodifikasi data

Filter hooks memungkinkan Anda untuk melakukan modifikasi. WooCommerce Data yang dikirimkan. Misalnya, Anda ingin menambahkan biaya administrasi tetap ke harga semua barang.

Anda dapat menggunakan woocommerce_product_get_price Filter. Hook ini sangat kuat, tetapi harus digunakan dengan hati-hati karena dapat mempengaruhi penampilan semua harga.

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( 'woocommerce_product_get_price', 'my_custom_price_adjustment', 10, 2 );

function my_custom_price_adjustment( $price, $product ) {
    // 只在前端购物车和商品页面应用，避免影响后台
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return $price;
    }

// 假设增加 5 元手续费
    $fee = 5;
    $new_price = $price + $fee;

return $new_price;
}

Mengatur tipe produk khusus dan penyimpanan data

WooCommerce Secara default, sistem mendukung jenis barang sederhana dan barang yang nilainya dapat berubah (variabel). Namun, terkadang Anda memerlukan untuk membuat jenis barang yang baru, seperti “barang yang perlu dipesan” atau “barang berupa layanan”.

Mendaftarkan jenis barang baru

Membuat jenis produk baru melibatkan beberapa langkah. Pertama-tama, Anda perlu mendaftarkan jenis produk tersebut. Hal ini biasanya dilakukan di… init Proses pengambilan aksi (action) atau penginstalan plugin selesai saat hal tersebut dilakukan.

add_action( 'init', 'register_my_custom_product_type' );

function register_my_custom_product_type() {
    class WC_Product_Custom extends WC_Product {
        public function __construct( $product ) {
            parent::__construct( $product );
            $this->product_type = 'custom';
        }

// 您可以在这里重写父类方法，或添加新方法
        public function get_type() {
            return 'custom';
        }

// 示例：自定义“添加到购物车”按钮文本
        public function add_to_cart_text() {
            return __( '预约服务', 'my-custom-woocommerce' );
        }
    }
}

Selanjutnya, Anda perlu menambahkan jenis barang tersebut ke daftar pilihan jenis barang menggunakan filter.

推荐阅读 Membuat Halaman Produk Kustom WooCommerce dengan Mudah: Dari Pemula hingga Ahli.。

add_filter( 'product_type_selector', 'add_custom_product_type_to_dropdown' );

function add_custom_product_type_to_dropdown( $types ) {
    $types['custom'] = __( '自定义服务', 'my-custom-woocommerce' );
    return $types;
}

Menambahkan field kustom untuk produk

Untuk jenis produk baru, biasanya diperlukan bidang data tambahan. Hal ini dapat dicapai dengan… WooCommerce Data produk tersebut diimplementasikan menggunakan kotak data Metabox. woocommerce_product_options_general_product_data Tambahkan bidang untuk aksi tersebut, lalu gunakannya. woocommerce_process_product_meta Simpan tindakan-tindakan tersebut.

add_action( 'woocommerce_product_options_general_product_data', 'add_custom_product_fields' );

function add_custom_product_fields() {
    global $product_object;

echo '<div class="options_group show_if_custom">'; // `show_if_custom` 仅对“custom”类型显示

woocommerce_wp_text_input( array(
        'id'          =&gt; '_service_duration',
        'label'       =&gt; __( '服务时长 (小时)', 'my-custom-woocommerce' ),
        'desc_tip'    =&gt; true,
        'description' =&gt; __( '请输入完成此服务预计需要的小时数。', 'my-custom-woocommerce' ),
        'type'        =&gt; 'number',
        'custom_attributes' =&gt; array(
            'step' =&gt; '0.5',
            'min'  =&gt; '0.5'
        )
    ) );

echo '</div>',\n';
}

// Simpan bidang
add_action( 'woocommerce_process_product_meta', 'save_custom_product_fields' );

function save_custom_product_fields( $post_id ) {
    $product = wc_get_product( $post_id );
    if ( $product-&gt;get_type() === 'custom' ) {
        $duration = isset( $_POST['_service_duration'] ) ? sanitize_text_field( $_POST['_service_duration'] ) : '';
        $product-&gt;update_meta_data( '_service_duration', $duration );
        $product-&gt;save_meta_data();
    }
}

Berinteraksi dengan keranjang belanja dan proses pembayaran

Keranjang belanja dan proses pembayaran merupakan bagian inti dari aktivitas berbelanja online.WooCommerce Di sini tersedia banyak hook (fungsi tambahan) yang dapat digunakan untuk melakukan penyesuaian (customization).

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

(Modifying the behavior of items in the shopping cart)

Anda dapat melakukannya melalui… woocommerce_add_cart_item_data Filter menambahkan data khusus saat barang dimasukkan ke keranjang belanja. Misalnya, menambahkan tanggal janji temu untuk barang jenis “Jasa Khusus”.

add_filter( 'woocommerce_add_cart_item_data', 'add_custom_data_to_cart_item', 10, 3 );

function add_custom_data_to_cart_item( $cart_item_data, $product_id, $variation_id ) {
    $product = wc_get_product( $product_id );
    if ( $product->get_type() === 'custom' && isset( $_POST['appointment_date'] ) ) {
        $cart_item_data['appointment_date'] = sanitize_text_field( $_POST['appointment_date'] );
        // 确保每个有不同预约日期的商品都被视为独立项目
        $cart_item_data['unique_key'] = md5( microtime() . rand() );
    }
    return $cart_item_data;
}

Kemudian, Anda dapat menggunakan… woocommerce_get_item_data Filter tersebut menampilkan data kustom tersebut di halaman keranjang belanja dan halaman pembayaran.

Custom checkout fields

Menambahkan atau mengubah field pembayaran (pembayaran) merupakan hal yang sangat umum. Digunakan dalam berbagai aplikasi atau sistem. woocommerce_checkout_fields Filter tersebut dapat dengan mudah diimplementasikan.

add_filter( 'woocommerce_checkout_fields', 'add_custom_checkout_field' );

function add_custom_checkout_field( $fields ) {
    $fields['billing']['billing_custom_vat'] = array(
        'label'       => __( '增值税号', 'my-custom-woocommerce' ),
        'placeholder' => _x( '请输入您的公司税号', 'placeholder', 'my-custom-woocommerce' ),
        'required'    => false, // 根据业务需求调整
        'class'       => array( 'form-row-wide' ),
        'clear'       => true,
        'priority'    => 35, // 控制字段顺序
    );
    return $fields;
}

Untuk menyimpan nilai dari bidang ini ke dalam pesanan, Anda perlu menggunakan… woocommerce_checkout_update_order_meta Aksi.

add_action( 'woocommerce_checkout_update_order_meta', 'save_custom_checkout_field' );

function save_custom_checkout_field( $order_id ) {
    if ( ! empty( $_POST['billing_custom_vat'] ) ) {
        update_post_meta( $order_id, '_billing_custom_vat', sanitize_text_field( $_POST['billing_custom_vat'] ) );
    }
}

Menyimpulkan.

WooCommerce Pengembangan plugin secara kustom merupakan sebuah proses yang sistematis, yang dimulai dengan memahami arsitektur plugin tersebut. Mulai dari membangun lingkungan pengembangan yang tepat, membuat kerangka plugin yang sesuai dengan standar, hingga menelusuri sistem hook (aksi dan filter) untuk memodifikasi proses inti, setiap langkah tersebut merupakan dasar dalam menciptakan fitur-fitur unik. Dengan membuat jenis produk dan field metadata yang khusus, Anda dapat memperluas model data guna memenuhi kebutuhan bisnis yang kompleks. Akhirnya, dengan menambahkan interaksi dan data yang tepat pada proses keranjang belanja dan pembayaran, Anda dapat secara langsung meningkatkan pengalaman pengguna serta efisiensi operasional. Selalu patuhi praktik terbaik, seperti melakukan pengujian yang menyeluruh, memastikan keamanan kode, menjaga dokumentasi yang baik, dan memperhatikan aspek-aspek penting lainnya dalam pengembangan plugin. WooCommerce Seiring dengan pembaruan inti WordPress, hal ini akan memastikan bahwa plugin yang Anda kembangkan tetap stabil, efisien, dan memiliki daya tahan yang lama.

FAQ - Pertanyaan yang Sering Diajukan.

Apa saja pengetahuan dasar yang diperlukan untuk mengembangkan plugin WooCommerce?

Mengembangkan plugin untuk WooCommerce memerlukan pengetahuan pemrograman PHP yang kuat, serta pemahaman yang baik tentang konsep pemrograman berorientasi objek (Object-Oriented Programming/OOP). Selain itu, diperlukan pemahaman mendalam mengenai mekanisme inti WordPress, termasuk sistem hook (actions dan filters), jenis artikel kustom, metadata, serta struktur standar untuk plugin dan tema. Pengetahuan dasar tentang HTML, CSS, dan JavaScript juga sangat membantu dalam pengembangan interaksi antarmuka pengguna (user interface).

Bagaimana cara mendeteksi dan memperbaiki masalah dalam plugin WooCommerce yang dibuat sendiri?

Pertama-tama, pastikan bahwa… wp-config.php File tersebut membuka file WP_DEBUG 和 WP_DEBUG_LOGCatatkan kesalahan tersebut ke dalam berkas log. Selanjutnya, manfaatkan sepenuhnya… WooCommerce Sistem log yang terintegrasi, melalui… wc_get_logger() Fungsi tersebut mencatat informasi pada titik-titik kritis. Untuk masalah terkait front end, gunakan alat pengembang browser (konsol dan panel jaringan) untuk melakukan pemeriksaan. Selain itu, Anda dapat sementara waktu menonaktifkan plugin lainnya dan beralih ke tema default untuk menghilangkan kemungkinan adanya konflik.

Saya telah mengubah filter harga, tapi mengapa harga barang di daftar produk di backend juga berubah?

Ini adalah masalah yang sering terjadi. Banyak filter yang berkaitan dengan harga berdampak pada baik bagian frontend maupun backend. Untuk menghindari hal ini, Anda perlu menggunakan pengecekan kondisi (conditional checks) dalam fungsi filter untuk membatasi cakupan pengaruhnya. Hal ini biasanya dilakukan… is_admin() && ! defined( 'DOING_AJAX' ) Periksa apakah saat ini Anda berada di antarmuka administrasi backend, dan pastikan bahwa tidak ada permintaan AJAX yang sedang dieksekusi (karena operasi seperti pembaruan keranjang belanja dilakukan melalui AJAX, yang memerlukan perhitungan harga). Pada contoh sebelumnya, kami telah menunjukkan cara untuk menangani hal ini.

Bagaimana cara mengatasi masalah di mana jenis barang khusus (yang telah disesuaikan oleh pengguna) ditampilkan sebagai “Barang Sederhana” dalam pesanan?

Ini karena... WooCommerce Saat menyimpan snapshot produk dalam pesanan, tipe produk kustom Anda mungkin tidak dapat diidentifikasi dengan benar secara otomatis. Anda perlu memastikan bahwa informasi tipe produk tersebut ditransmisikan dengan benar saat menambahkannya ke keranjang belanja. Periksa hal tersebut. WC_Product_Custom Apakah kelas tersebut telah mewarisi dengan benar? WC_Product Dan juga telah diatur (set). $this->product_typeSelain itu, ketika barang diperoleh dari pesanan,WooCommerce Mungkin akan diinstansiasiakan sebuah objek dasar (basic object). WC_Product Objek. Untuk memastikan instansiasi yang benar, Anda mungkin perlu menggunakan… woocommerce_order_get_items Gunakan filter untuk memetakan tipe kustom Anda.

Bagaimana cara memastikan plugin kustom saya kompatibel dengan pembaruan WooCommerce di masa depan?

Kunci untuk menjaga kompatibilitas adalah dengan selalu menyelaraskan diri dengan praktik pengembangan resmi. Selalu gunakan (the official development practices). WooCommerce Gunakan API dan hook yang tersedia secara publik, dan hindari melakukan modifikasi langsung pada file inti atau penggunaan kelas serta metode yang tidak terbuka. Pastikan untuk menyatakan dengan jelas kompatibilitas tersebut dalam informasi header plugin. WooCommerce Versi (Version)WC tested up toDilakukan secara berkala… WooCommerce Uji coba dilakukan pada versi beta atau versi terbaru dari produk tersebut. Ikuti perkembangannya. WooCommerce Blog pengembangan resmi dan log pembaruan untuk mengetahui fitur-fitur yang akan dihentikan penggunaannya serta API baru.