TokoDaring.Com – Memahami Hook woocommerce_review_order_before_order_total di WooCommerce untuk Mengustomisasi Ringkasan Total Pesanan.

Memahami Hook woocommerce_review_order_before_order_total di WooCommerce untuk Mengustomisasi Ringkasan Total Pesanan

WooCommerce menyediakan sistem hook yang memungkinkan developer melakukan kustomisasi hampir di setiap bagian halaman checkout tanpa harus memodifikasi file inti plugin. Salah satu hook yang sangat berguna pada tahap akhir proses checkout adalah woocommerce_review_order_before_order_total. Hook ini dijalankan tepat sebelum WooCommerce menampilkan baris total akhir pesanan pada tabel ringkasan checkout. Posisi tersebut sangat strategis karena pelanggan biasanya akan memperhatikan total pembayaran sebelum memutuskan untuk menyelesaikan transaksi.

Bagi developer pemula, mempelajari woocommerce_review_order_before_order_total menjadi langkah yang baik untuk memahami bagaimana WooCommerce menyusun ringkasan pesanan menggunakan action hook. Sementara itu, bagi developer tingkat menengah maupun mahir, hook ini menawarkan fleksibilitas yang tinggi untuk menampilkan biaya tambahan, pemberitahuan khusus, informasi promosi, maupun perhitungan yang berkaitan dengan total pembayaran. Artikel ini membahas fungsi hook, cara kerjanya, contoh implementasi, serta praktik terbaik agar proses kustomisasi tetap aman, efisien, dan kompatibel dengan pembaruan WooCommerce.

Mengenal Hook woocommerce_review_order_before_order_total

Hook woocommerce_review_order_before_order_total merupakan action hook yang dieksekusi tepat sebelum WooCommerce menampilkan total akhir pesanan pada halaman checkout. Karena berada di bagian akhir tabel ringkasan pesanan, hook ini sangat cocok digunakan untuk menampilkan informasi yang secara langsung berkaitan dengan nilai transaksi sebelum pelanggan melihat jumlah pembayaran akhir.

Sebagai action hook, woocommerce_review_order_before_order_total tidak mengembalikan nilai tertentu. Fungsi yang dikaitkan dengan hook ini hanya bertugas menghasilkan output berupa HTML menggunakan echo atau memanggil template tambahan sesuai kebutuhan. Pendekatan tersebut memungkinkan developer memperluas fungsi checkout tanpa harus mengubah template bawaan WooCommerce sehingga kompatibilitas dengan pembaruan plugin tetap terjaga.

Dalam implementasi nyata, hook ini sering dimanfaatkan untuk menampilkan informasi mengenai diskon tambahan, biaya administrasi, estimasi bonus pembelian, pengingat mengenai syarat promosi, maupun informasi lain yang memengaruhi keputusan pelanggan sebelum menyelesaikan pembayaran.

Contoh Dasar Penggunaan Hook

add_action(
    'woocommerce_review_order_before_order_total',
    'custom_order_total_notice'
);

function custom_order_total_notice() {

    echo '<tr>';
    echo '<td colspan="2">';
    echo 'Silakan periksa kembali total pembayaran sebelum melanjutkan proses checkout.';
    echo '</td>';
    echo '</tr>';

}

Kode di atas akan menambahkan satu baris informasi tepat sebelum WooCommerce menampilkan total akhir pesanan.

Cara Kerja Hook woocommerce_review_order_before_order_total

WooCommerce membangun halaman checkout menggunakan berbagai template yang berisi action hook pada setiap bagian penting. Ketika pelanggan membuka halaman checkout, seluruh hook akan dijalankan secara berurutan sehingga developer dapat menambahkan maupun memodifikasi tampilan tanpa perlu melakukan override terhadap file inti plugin. Mekanisme ini menjadi salah satu alasan mengapa WooCommerce sangat fleksibel untuk dikembangkan.

Hook woocommerce_review_order_before_order_total dipanggil setelah subtotal, pajak, biaya pengiriman, diskon, dan komponen biaya lainnya selesai dihitung. Tepat sebelum total akhir ditampilkan, WooCommerce menjalankan hook ini sehingga developer memiliki kesempatan untuk menambahkan informasi tambahan yang masih berkaitan dengan proses perhitungan total pembayaran.

Karena halaman checkout menggunakan pembaruan AJAX ketika pelanggan mengubah kuantitas produk, kupon, alamat pengiriman, atau metode pengiriman, kode yang dijalankan melalui hook ini sebaiknya ringan dan efisien. Hindari melakukan query database yang kompleks atau pemanggilan API eksternal secara langsung agar proses pembaruan checkout tetap cepat dan memberikan pengalaman pengguna yang optimal.

Contoh Menampilkan Informasi Bonus Pembelian

add_action(
    'woocommerce_review_order_before_order_total',
    'bonus_purchase_notice'
);

function bonus_purchase_notice() {

    if ( WC()->cart->subtotal >= 1000000 ) {

        echo '<tr>';
        echo '<td colspan="2">';
        echo 'Pesanan Anda memenuhi syarat untuk mendapatkan bonus pembelian.';
        echo '</td>';
        echo '</tr>';

    }

}

Contoh Menampilkan Informasi Berdasarkan Total Keranjang

add_action(
    'woocommerce_review_order_before_order_total',
    'priority_processing_notice'
);

function priority_processing_notice() {

    if ( WC()->cart->total >= 2000000 ) {

        echo '<tr>';
        echo '<td colspan="2">';
        echo 'Pesanan Anda akan diproses menggunakan layanan prioritas.';
        echo '</td>';
        echo '</tr>';

    }

}

Pada Bagian 2, pembahasan akan berlanjut mengenai implementasi woocommerce_review_order_before_order_total untuk berbagai kebutuhan bisnis, praktik terbaik dalam pengembangan WooCommerce, serta contoh kode lanjutan yang dapat langsung diterapkan pada proyek nyata.

Implementasi Hook woocommerce_review_order_before_order_total untuk Berbagai Kebutuhan Bisnis

Salah satu keunggulan hook woocommerce_review_order_before_order_total adalah kemampuannya untuk menampilkan informasi yang berkaitan langsung dengan total pembayaran sebelum pelanggan melihat jumlah akhir yang harus dibayarkan. Posisi ini sangat efektif untuk menyampaikan informasi penting seperti potongan harga, syarat promosi, biaya tambahan, maupun pemberitahuan mengenai keuntungan yang diperoleh pelanggan berdasarkan nilai transaksi mereka. Dengan demikian, pelanggan memiliki kesempatan untuk memahami seluruh komponen biaya sebelum menyelesaikan proses checkout.

Dalam implementasi yang lebih kompleks, hook ini dapat dikombinasikan dengan berbagai data yang tersedia di WooCommerce, seperti subtotal keranjang belanja, metode pengiriman, metode pembayaran, data pelanggan, maupun metadata produk. Fleksibilitas tersebut memungkinkan setiap pelanggan menerima informasi yang berbeda sesuai kondisi transaksi yang sedang berlangsung. Pendekatan seperti ini tidak hanya meningkatkan pengalaman pengguna, tetapi juga membantu menyampaikan informasi bisnis secara lebih relevan.

Penggunaan hook ini juga sering dimanfaatkan untuk meningkatkan transparansi transaksi. Misalnya, toko dapat menampilkan pemberitahuan mengenai batas minimum agar memperoleh gratis ongkos kirim, informasi mengenai hadiah pembelian, atau estimasi poin loyalitas yang akan diperoleh setelah pesanan selesai. Informasi yang ditampilkan sebelum total pembayaran sering kali membantu pelanggan mengambil keputusan pembelian dengan lebih percaya diri.

Contoh Menampilkan Informasi Gratis Ongkos Kirim

add_action(
    'woocommerce_review_order_before_order_total',
    'free_shipping_progress_notice'
);

function free_shipping_progress_notice() {

    $minimum = 500000;
    $subtotal = WC()->cart->subtotal;

    if ( $subtotal < $minimum ) {

        $remaining = $minimum - $subtotal;

        echo '<tr>';
        echo '<td colspan="2">';
        echo 'Belanja lagi sebesar Rp ' . wc_price( $remaining ) . ' untuk mendapatkan gratis ongkos kirim.';
        echo '</td>';
        echo '</tr>';

    }

}

Contoh Menampilkan Informasi Berdasarkan Status Login

add_action(
    'woocommerce_review_order_before_order_total',
    'member_reward_notice'
);

function member_reward_notice() {

    if ( is_user_logged_in() ) {

        $user = wp_get_current_user();

        echo '<tr>';
        echo '<td colspan="2">';
        echo 'Terima kasih telah menjadi pelanggan, ' . esc_html( $user->display_name ) . '.';
        echo '</td>';
        echo '</tr>';

    }

}

Praktik Terbaik Menggunakan woocommerce_review_order_before_order_total

Walaupun hook ini cukup sederhana untuk digunakan, penerapan yang baik tetap memerlukan perhatian terhadap standar pengembangan WordPress dan WooCommerce. Informasi yang ditampilkan sebaiknya memiliki hubungan langsung dengan total pembayaran atau keputusan pelanggan sebelum melakukan checkout. Hindari memasukkan konten yang tidak relevan karena dapat mengganggu fokus pelanggan ketika memeriksa rincian biaya pesanan.

Aspek keamanan juga harus menjadi prioritas. Apabila informasi yang ditampilkan berasal dari database, metadata, atau masukan pengguna, gunakan fungsi escaping seperti esc_html(), esc_attr(), maupun wp_kses_post() sebelum mencetak data ke halaman. Praktik ini membantu mencegah potensi kerentanan keamanan dan memastikan kode tetap sesuai dengan WordPress Coding Standards.

Selain itu, seluruh fungsi kustom sebaiknya ditempatkan di dalam plugin khusus atau child theme. Hindari melakukan modifikasi langsung pada file inti WooCommerce karena setiap pembaruan plugin akan menghapus perubahan tersebut. Dengan memanfaatkan action hook sebagaimana mestinya, proses pemeliharaan menjadi lebih mudah dan kompatibilitas dengan versi WooCommerce terbaru tetap terjaga.

Contoh Menampilkan Informasi Kontak Penjualan

add_action(
    'woocommerce_review_order_before_order_total',
    'sales_support_notice'
);

function sales_support_notice() {

    $email = get_option( 'admin_email' );

    echo '<tr>';
    echo '<td colspan="2">';
    echo 'Apabila terdapat pertanyaan mengenai total pembayaran, silakan hubungi ' . esc_html( $email );
    echo '</td>';
    echo '</tr>';

}

Contoh Menampilkan Informasi Berdasarkan Jumlah Produk

add_action(
    'woocommerce_review_order_before_order_total',
    'bulk_purchase_notice'
);

function bulk_purchase_notice() {

    if ( WC()->cart->get_cart_contents_count() >= 20 ) {

        echo '<tr>';
        echo '<td colspan="2">';
        echo 'Pesanan dalam jumlah besar akan melalui proses pemeriksaan tambahan sebelum diproses.';
        echo '</td>';
        echo '</tr>';

    }

}

Pada Bagian 3, pembahasan akan dilanjutkan dengan implementasi lanjutan woocommerce_review_order_before_order_total, optimasi performa, ringkasan artikel, serta lima pertanyaan yang paling sering diajukan mengenai hook ini.

Implementasi Lanjutan dan Optimasi Hook woocommerce_review_order_before_order_total

Dalam implementasi WooCommerce yang lebih kompleks, hook woocommerce_review_order_before_order_total sering dimanfaatkan sebagai titik integrasi dengan berbagai fitur tambahan. Developer dapat menggunakannya untuk menampilkan informasi mengenai program loyalitas, estimasi cashback, status promosi, maupun perhitungan manfaat yang akan diterima pelanggan berdasarkan nilai transaksi. Karena hook ini dijalankan tepat sebelum total akhir pesanan ditampilkan, seluruh informasi tersebut dapat membantu pelanggan memahami nilai transaksi secara lebih jelas sebelum menyelesaikan pembayaran.

Hook ini juga dapat dikombinasikan dengan metadata produk, metadata pelanggan, maupun plugin pihak ketiga untuk menghasilkan pengalaman checkout yang lebih personal. Sebagai contoh, apabila keranjang belanja berisi produk pre order, pelanggan dapat memperoleh pemberitahuan bahwa sebagian produk memiliki jadwal pengiriman yang berbeda. Apabila pelanggan termasuk anggota program loyalitas, sistem dapat menampilkan estimasi poin yang akan diperoleh setelah transaksi berhasil diselesaikan. Pendekatan seperti ini membuat halaman checkout menjadi lebih informatif sekaligus meningkatkan kepercayaan pelanggan terhadap proses transaksi.

Walaupun memiliki fleksibilitas yang tinggi, penggunaan hook ini tetap harus memperhatikan performa halaman checkout. Hindari menjalankan query database yang kompleks atau melakukan pemanggilan API eksternal setiap kali hook dieksekusi. Sebaiknya gunakan fungsi bawaan WooCommerce, manfaatkan data yang telah tersedia pada objek keranjang belanja, atau terapkan mekanisme cache apabila diperlukan. Dengan demikian, proses checkout tetap cepat, stabil, dan nyaman digunakan oleh pelanggan.

Contoh Menampilkan Informasi Produk Pre Order

add_action(
    'woocommerce_review_order_before_order_total',
    'preorder_order_notice'
);

function preorder_order_notice() {

    foreach ( WC()->cart->get_cart() as $cart_item ) {

        $product = $cart_item['data'];

        if ( get_post_meta( $product->get_id(), '_preorder', true ) ) {

            echo '<tr>';
            echo '<td colspan="2">';
            echo 'Pesanan Anda berisi produk pre order yang akan diproses sesuai jadwal produksi.';
            echo '</td>';
            echo '</tr>';

            break;

        }

    }

}

Contoh Menampilkan Informasi Produk Virtual

add_action(
    'woocommerce_review_order_before_order_total',
    'virtual_product_information'
);

function virtual_product_information() {

    foreach ( WC()->cart->get_cart() as $cart_item ) {

        $product = $cart_item['data'];

        if ( $product->is_virtual() ) {

            echo '<tr>';
            echo '<td colspan="2">';
            echo 'Produk digital akan tersedia untuk diunduh setelah pembayaran berhasil diverifikasi.';
            echo '</td>';
            echo '</tr>';

            break;

        }

    }

}

Ringkasan

Hook woocommerce_review_order_before_order_total merupakan action hook WooCommerce yang memungkinkan developer menambahkan berbagai informasi tepat sebelum total akhir pesanan ditampilkan pada halaman checkout. Posisi ini sangat ideal untuk menyampaikan pemberitahuan mengenai biaya, promosi, keuntungan transaksi, maupun informasi lain yang berkaitan langsung dengan total pembayaran. Dengan memanfaatkan hook ini secara tepat, developer dapat meningkatkan transparansi transaksi, memberikan pengalaman checkout yang lebih informatif, serta membantu pelanggan mengambil keputusan pembelian dengan lebih yakin. Agar implementasi tetap aman dan mudah dipelihara, seluruh kode sebaiknya ditempatkan pada plugin kustom atau child theme, menggunakan fungsi escaping yang sesuai, dan menghindari proses yang dapat mengurangi performa halaman checkout.

Pertanyaan Umum Tentang hook woocommerce_review_order_before_order