Panduan Lengkap Plugin WooCommerce dan Penjelasan Rinci Mengenai Kodenya: Dari Pemasangan Hingga Pengembangan Kustom

Instalasi dan Konfigurasi Dasar WooCommerce

Proses instalasi WooCommerce itu sederhana, tetapi konfigurasi awal yang tepat adalah landasan untuk membangun situs e-commerce yang stabil. Pertama, Anda memerlukan server yang menjalankan PHP 7.4 atau lebih tinggi dengan WordPress terinstal. Untuk mengaktifkan WooCommerce, buka Plugins > Instal Plugin di backend WordPress, cari “WooCommerce” dan klik Instal. Setelah aktivasi, sistem akan secara otomatis memulai “Setup Wizard”, yang akan memandu Anda untuk menyelesaikan pengaturan dasar toko Anda.

Pada wizard penyiapan, Anda perlu menyelesaikannya secara berurutan: mengatur lokasi toko, mata uang, dan unit; mengonfigurasi metode pembayaran (misalnya PayPal, Stripe, atau transfer bank); mengatur aturan untuk menghitung tarif pengiriman (misalnya pengiriman gratis, tarif pengiriman tetap, atau tarif waktu nyata berdasarkan berat/alamat); dan Anda disarankan untuk menginstal beberapa ekstensi yang diperlukan, seperti Pembayaran WooCommerce atau plugin pelokalan! . Setelah menyelesaikan wizard, Anda akan dibawa ke panel pengaturan inti WooCommerce. Ada beberapa bagian utama yang perlu dikonfigurasi dengan hati-hati: opsi “Umum” memungkinkan Anda untuk mengatur tempat penjualan dan penghitungan pajak; opsi “Produk” memungkinkan Anda untuk menentukan unit ukuran, ulasan produk, dan manajemen inventaris; dan “Pembayaran Halaman ”Checkout“ adalah tempat semua gateway pembayaran dan proses checkout dikonfigurasikan; dan opsi ”Pengiriman" digunakan untuk mengelola zona, metode, dan kemasan pengiriman.

Langkah yang sering diabaikan tetapi penting adalah mengonfigurasi permalink. Di Pengaturan WordPress > Tautan Tetap, pastikan Anda tidak menggunakan struktur “biasa”, dan rekomendasikan untuk menggunakan “nama postingan” atau struktur khusus, yang bagus untuk SEO pada halaman produk. “Selain itu, di tab Pengaturan lanjutan WooCommerce, Anda perlu menetapkan halaman WordPress ke berbagai halaman (mis. Keranjang Belanja, Checkout, Akun Saya, dll.), yang secara otomatis dibuat selama instalasi plugin. Halaman-halaman ini secara otomatis dibuat selama instalasi plugin.

推荐阅读 Panduan Pengembangan Kustom WooCommerce: Tutorial Praktis Lengkap dari Tingkat Pemula hingga Tingkat Mahir.。

Pengaturan Informasi Dasar Toko

Pengaturan informasi dasar untuk toko berpusat pada WordPress Customiser dan Pengaturan Umum WooCommerce. Anda perlu memastikan bahwa alamat toko, alamat email layanan pelanggan, dan nomor telepon sudah benar, dan informasi ini akan muncul di notifikasi pesanan, faktur, dan catatan kaki. Selain itu, dalam pengaturan Umum di bawah Opsi Mata Uang, Anda dapat mengatur format mata uang, seperti RMB (¥123.00) atau USD ($123.00).

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

Integration of Payment and Delivery Gateways

Gerbang pembayaran adalah urat nadi e-commerce. wooCommerce memiliki berbagai macam metode pembayaran bawaan, seperti WC_Gateway_BACS(transfer bank),WC_Gateway_CHEQUE(pembayaran dengan cek) dan WC_Gateway_COD(Pembayaran Tunai). Untuk mengaktifkan gateway tingkat lanjut seperti Stripe atau PayPal, Anda biasanya perlu menginstal plugin mandiri dan mengonfigurasi kunci API. Misalnya, untuk mengonfigurasi Stripe, Anda perlu mengisi kunci yang dipublikasikan dan kunci rahasia pada halaman pengaturan yang sesuai.

Pengaturan pengiriman juga sangat penting. Anda dapat membuat aturan pengiriman terpisah untuk negara atau wilayah yang berbeda di Zona Pengiriman. Misalnya, buatlah wilayah untuk daratan Tiongkok dan tambahkan metode seperti “Pengiriman Gratis”, “Tarif Tetap”, dan “Penjemputan Lokal”. Dengan menggunakan woocommerce_shipping_init hook, pengembang bahkan dapat membuat kelas metode distribusi yang sepenuhnya kustom.

Fungsionalitas inti dan manajemen data

WooCommerce mengintegrasikan semua data e-commerce ke dalam jenis postingan dan taksonomi kustom WordPress. Produk disimpan sebagai product jenis artikel, dan urutannya sesuai dengan shop_order Jenis Artikel. Memahami model data ini merupakan prasyarat untuk pengembangan kustom tingkat lanjut.

Manajemen produk adalah inti dari inti.WooCommerce mendukung empat jenis produk:simple(Produk sederhana)grouped(Produk yang dikategorikan dalam kelompok tertentu)external(Produk Eksternal/Terkait) dan variable（Produk variabel memungkinkan Anda untuk mengatur atribut yang berbeda (misalnya warna, ukuran) dan harga serta SKU yang sesuai untuk produk yang sama. Produk variabel memungkinkan Anda untuk mengatur atribut yang berbeda (misalnya warna, ukuran) dan harga yang sesuai, stok dan SKU untuk produk yang sama Saat mengedit produk di backend, Anda akan menggunakan serangkaian kotak metadata untuk mengelola stok SKU, harga, status stok, informasi pengiriman, dan galeri produk terkait.

推荐阅读 Apa itu WooCommerce dan apa arsitektur intinya?。

Backend manajemen pesanan memberikan gambaran umum lengkap tentang penjualan. Setiap pesanan adalah metadata yang kaya shop_order Postingan yang mencatat informasi pelanggan, barang yang dibeli, harga, status pembayaran, dan riwayat catatan pesanan. Manajemen status sangat penting, dengan status default termasuk pending(menunggu pembayaran),processing(Dalam proses penanganan…)on-hold(ditangguhkan) dan completed(Selesai). Anda dapat menggunakan tombol wc_get_order_statuses mendapatkan semua state dan meneruskannya melalui fungsi woocommerce_register_shop_order_post_statuses Filter mendaftarkan status khusus.

Jenis Produk dan Manajemen Atribut

Atribut produk adalah alat bantu yang hebat untuk mengatur katalog yang kompleks. Anda dapat membuat atribut global, seperti “Warna” atau “Ukuran”, di Produk > Atribut. Atribut-atribut ini kemudian digunakan untuk membuat “kombinasi atribut” ketika mengedit produk variabel, dengan data varian yang terpisah untuk setiap kombinasi (misalnya “Merah - Besar”). Pada tingkat kode, hal ini dapat dilakukan dengan perintah WC_Product_Variable Kelas dan get_available_variations() untuk mendapatkan dan memanipulasi semua informasi varian.

Pemrosesan pesanan dan data pelanggan

Penggunaan WooCommerce WC_Order untuk merangkum data pesanan. Dengan kelas ini, Anda dapat membuat atau memperbarui pesanan secara terprogram. Sebagai contoh, kode berikut ini menunjukkan cara membuat pesanan baru dan menambahkan item:

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

// 创建一个新订单对象
$order = wc_create_order();

// 通过商品ID获取商品对象并添加到订单中
$product = wc_get_product(123);
$order->add_product($product, 2); // 数量为2

// 设置客户地址
$order->set_address(array(
    'first_name' => '张',
    'last_name'  => '三',
    'email'      => '[email protected]',
    'phone'      => '13800138000',
), 'billing');

// 计算总额并保存
$order->calculate_totals();
$order->save();

Data pelanggan ditautkan ke pengguna WordPress (WP_UserWooCommerce menyediakan pengikatan yang mendalam melalui wc_get_customer_order_count 和 wc_get_customer_total_spent dll. berfungsi memperluas kemampuan pengguna.

Integrasi Tema & Penggantian Templat

Integrasi WooCommerce dengan tema menentukan pengalaman front-end toko. Ini menggunakan sistem templat yang kuat di mana semua file tampilan front-end (seperti daftar produk, halaman produk individual, keranjang belanja) terletak di direktori plugin /templates/ folder. Untuk menyesuaikan templat ini tanpa memodifikasi file plugin inti, Anda perlu menimpanya di tema Anda.

Cara yang benar untuk melakukannya adalah: di direktori tema aktif Anda, buat file bernama woocommerce folder. Kemudian, salin file templat WooCommerce yang ingin Anda modifikasi dari direktori plugin ke folder baru ini dan buat perubahan pada salinan ini. Sebagai contoh, untuk memodifikasi struktur satu halaman produk, Anda dapat menyalin file plugins/woocommerce/templates/single-product.php 到 themes/your-theme/woocommerce/single-product.phpWooCommerce memberikan prioritas untuk memuat file templat dalam tema.

推荐阅读 WooCommerce Ultimate Guide to Building a Website: Creating Your E-commerce Empire from Scratch。

Selain menimpa seluruh file, Anda dapat menggunakan Kait Tindakan dan Kait Filter untuk menyisipkan atau memodifikasi konten di lokasi tertentu. Sebagai contoh.woocommerce_before_single_product_summary Kait dipicu sebelum informasi ringkasan pada item dan merupakan tempat yang ideal untuk menambahkan iklan spanduk khusus.

Struktur file templat yang disesuaikan

File templat WooCommerce memiliki struktur hierarki yang jelas. Sebagai contoh, lihatlah siklus produk.archive-product.php adalah templat halaman toko utama, yang memanggil content-product.php untuk merender setiap item. Dengan menimpa file-file ini, Anda dapat sepenuhnya mengubah cara item ditampilkan dalam daftar, seperti mengubah tata letak menjadi kisi atau daftar, atau menambahkan lencana khusus.

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

Menggunakan hook untuk memperluas fungsionalitas

Hooks adalah tulang punggung ekstensi WooCommerce. Action hooks memungkinkan Anda untuk “mengeksekusi” kode, seperti menambahkan kotak informasi khusus setelah formulir keranjang belanja:

add_action('woocommerce_after_cart_table', 'my_custom_cart_message');
function my_custom_cart_message() {
    echo '<div class="custom-notice">Gratis ongkos kirim untuk pembelian di atas $500!</div>';
}

Kait filter memungkinkan Anda untuk “memodifikasi” data. Sebagai contoh, dengan menggunakan woocommerce_add_to_cart_fragments Filter dapat secara dinamis memperbarui konten keranjang mini:

add_filter('woocommerce_add_to_cart_fragments', 'update_mini_cart_count');
function update_mini_cart_count($fragments) {
    $fragments['div.cart-count'] = '<div class="cart-count">' . WC()-&gt;cart-&gt;get_cart_contents_count() . '</div>';.
    mengembalikan $fragmen.
}

Praktik Kustomisasi dan Pengembangan Tingkat Lanjut

Ketika fitur dan pengait bawaan tidak mencukupi, pengembangan kustom yang lebih dalam diperlukan. Ini termasuk membuat jenis produk khusus, menulis gateway pembayaran atau pengiriman berpemilik, dan mengintegrasikan dengan sistem eksternal melalui REST API.

Membuat jenis produk khusus memerlukan ekstensi WC_Product Kelas. Pertama, Anda perlu mendefinisikan kelas baru yang mewarisi kelas tersebut dan mendaftarkan jenis produk. Misalnya, buat kelas produk bernama “Reservasi”:

class WC_Product_Booking extends WC_Product {
    public function __construct($product) {
        parent::__construct($product);
        $this->product_type = 'booking';
    }
    // 在这里添加自定义方法和属性，如 get_booking_dates()
}
// 将新类注册到工厂
add_filter('woocommerce_product_class', 'register_booking_product_class', 10, 2);
function register_booking_product_class($classname, $product_type) {
    if ($product_type == 'booking') {
        $classname = 'WC_Product_Booking';
    }
    return $classname;
}

API REST WooCommerce menyediakan antarmuka yang kuat untuk aplikasi seluler atau sistem manajemen eksternal. Anda dapat menggunakan API untuk mengelola produk, pesanan, pelanggan, dan hampir semua data lainnya. Untuk mengakses API, Anda perlu mengaktifkan dan membuat kunci API (Consoles API) di bagian back-end pada WooCommerce > Pengaturan > Lanjutan > API Lama. Anda perlu mengaktifkan dan membuat kunci API (Consumer Key & Consumer Secret) di backend “WooCommerce” > “Settings” > “Advanced” > “Old API”. Kemudian Anda dapat menggunakan titik akhir yang mirip dengan yang berikut ini untuk melakukan panggilan:GET /wp-json/wc/v3/products untuk mendapatkan daftar produk.

Pengembangan gerbang khusus

Gerbang pembayaran khusus adalah perpanjangan dari WC_Payment_Gateway di PHP. Anda perlu mendefinisikan ID gateway, judul, deskripsi, dan bidang pembayaran di kelas ini dan mengimplementasikan process_payment untuk menyelesaikan logika pembayaran. Setelah dikembangkan, logika pembayaran harus dilewatkan melalui woocommerce_payment_gateways Filter menambahkannya ke daftar gateway yang tersedia.

Integrasi API dengan layanan eksternal

WooCommerce menyediakan penghubung yang kaya untuk berinteraksi dengan ERP, CRM, atau sistem logistik. Sebagai contoh, ketika status pesanan diubah menjadi “Selesai”, hal ini akan memicu fitur woocommerce_order_status_completed Pengait Tindakan. Anda dapat mengaitkan fungsi ke hook ini untuk mendorong data pesanan ke sistem manajemen inventaris Anda:

add_action('woocommerce_order_status_completed', 'sync_order_to_erp');
function sync_order_to_erp($order_id) {
    $order = wc_get_order($order_id);
    $data = array(
        'order_id' => $order->get_id(),
        'total'    => $order->get_total(),
        // ... 准备其他数据
    );
    // 使用 wp_remote_post 将 $data 发送到外部 API
}

Menyimpulkan.

WooCommerce lebih dari sekadar pengaya, ini adalah kerangka kerja pengembangan e-niaga dengan fitur lengkap dan sangat mudah diperluas. Mulai dari instalasi dan konfigurasi yang sederhana hingga kustomisasi mendalam, WooCommerce menawarkan kemungkinan tak terbatas melalui sistem templat yang jelas, pengait yang kaya (Actions & Filters) dan model data berorientasi objek. Kunci untuk berhasil membangun toko WooCommerce adalah: konfigurasi dasar yang solid untuk memastikan toko stabil; pemahaman yang mendalam tentang produk dan model data pesanan; kemahiran dalam penyesuaian front-end menggunakan hamparan templat dan pengait; dan kemampuan untuk memenuhi kebutuhan bisnis yang unik melalui kelas khusus, gateway, dan integrasi API. Dengan mengikuti praktik terbaik ini, Anda akan dapat membangun toko online yang kuat, efisien, dan sepenuhnya selaras dengan logika bisnis Anda.

FAQ - Pertanyaan yang Sering Diajukan.

Bagaimana cara mengubah teks tombol “Tambahkan ke Keranjang”?

Anda dapat menggunakan woocommerce_product_add_to_cart_text Menyaring atau woocommerce_product_single_add_to_cart_text untuk mengubah teks tombol. Sebagai contoh, kode berikut ini mengubah teks tombol pada satu halaman produk menjadi “Beli Sekarang”:

add_filter('woocommerce_product_single_add_to_cart_text', 'change_single_add_to_cart_text');
function change_single_add_to_cart_text() {
    return '立即购买';
}

Untuk halaman arsip (daftar produk), gunakan tombol woocommerce_product_add_to_cart_text filter dan perlu menentukan jenis produk dalam fungsi tersebut.

Bagaimana cara menambahkan bidang khusus untuk kategori produk tertentu?

Anda harus menggunakan kombinasi pengait kategorisasi produk WooCommerce dan API metadata terminologi WordPress. product_cat_add_form_fields 和 product_cat_edit_form_fields Bidang keluaran tindakan pada halaman tambah/edit kategori. Kemudian, gunakan tombol created_term 和 edit_term untuk menyimpan nilai field ke dalam tabel term_meta. Terakhir, Anda dapat menggunakan file template get_term_meta Gunakan kode berikut untuk mendapatkan dan menampilkan nilai tersebut.

Mengapa perubahan templat khusus saya tidak berlaku?

Ikuti langkah-langkah berikut ini untuk memecahkan masalah: Pertama, pastikan Anda telah menyalin file templat ke jalur tema yang benar:your-theme/woocommerce/ ke bawah dan struktur direktori sama dengan templat plugin aslinya. Selanjutnya, hapus semua cache, termasuk cache peramban, cache objek WordPress, dan cache sisi server (seperti OPcache). Terakhir, periksa apakah tema Anda functions.php Apakah dukungan WooCommerce dinyatakan dengan benar:add_theme_support('woocommerce');. Jika masalah terus berlanjut, coba beralih sementara ke tema default (seperti Storefront) untuk memecahkan masalah kompatibilitas tema.

Bagaimana cara membuat Produk Variabel WooCommerce secara terprogram?

Anda harus menggunakan fitur WC_Product_Variable Kelas. Langkah-langkah dasarnya adalah: membuat objek produk dan mengatur atribut dasar; membuat dan menambahkan atribut global (misalnya, warna); membuat kombinasi atribut tertentu (misalnya, varian) untuk atribut-atribut tersebut; dan akhirnya, untuk setiap varian, buat WC_Product_Variation objek, menetapkan harga, inventaris, dan atribut unik lainnya, dan mengaitkannya dengan produk master. Ini adalah proses multi-langkah yang biasanya melibatkan wp_set_object_terms, set_attributes, dan save dan metode lainnya.