プラグインWooCommerceのwoocommerce_order_details_after_customer_addressアクションの使用方法・解説

概要

woocommerce_order_details_after_customer_addressアクションは、WooCommerceの注文詳細ページにおいて顧客の住所情報の直後にカスタムコンテンツを追加するために使用されます。このフックは、特定の情報を表示したり、デザインをカスタマイズしたりする際に非常に便利です。以下のような機能を実装する際によく使われます。

注文のメモや特記事項の表示
お客様への特別オファーの提示
カスタムフィールドの情報表示
サポート用の連絡先情報の追加
配送方法や支払い方法の詳細の強調
フィードバックやレビューの依頼

構文

do_action( 'woocommerce_order_details_after_customer_address', $order, $is_visible );

パラメータ

$order (WC_Order): 完全な注文オブジェクト。
$is_visible (bool): 顧客のアドレス情報が表示されているかどうかを示すフラグ。

戻り値

このアクションは何も戻しません。カスタムの出力を生成するために使用されます。

使用可能なバージョン

WooCommerce バージョン: 3.0以上
WordPress バージョン: 4.0以上

この関数のアクションでの使用可能性

アクション	使用例
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

サンプルコード

サンプルコード1

add_action( 'woocommerce_order_details_after_customer_address', 'custom_order_details_message', 10, 2 );
function custom_order_details_message( $order, $is_visible ) {
    echo '<p>お買い上げありがとうございます！配送方法や支払い方法についての詳細は、「マイアカウント」でご確認ください。</p>';
}

このサンプルは、顧客の住所の後に感謝メッセージを表示します。

サンプルコード2

add_action( 'woocommerce_order_details_after_customer_address', 'display_order_note', 10, 2 );
function display_order_note( $order, $is_visible ) {
    $order_note = $order->get_customer_order_note();
    if ( ! empty( $order_note ) ) {
        echo '<p>注文メモ: ' . esc_html( $order_note ) . '</p>';
    }
}

このサンプルコードは、注文情報の中から顧客のメモを取得して表示します。

サンプルコード3

add_action( 'woocommerce_order_details_after_customer_address', 'show_customer_support_info', 10, 2 );
function show_customer_support_info( $order, $is_visible ) {
    echo '<p>サポートが必要ですか？お気軽にお問い合わせください： support@example.com</p>';
}

このサンプルは、顧客の住所の後にサポートへの連絡先情報を追加します。

サンプルコード4

add_action( 'woocommerce_order_details_after_customer_address', 'add_feedback_request', 10, 2 );
function add_feedback_request( $order, $is_visible ) {
    echo '<p>ご利用いただきありがとうございました！ぜひご意見をお聞かせください。</p>';
}

このサンプルは、顧客にフィードバックを依頼するメッセージを表示します。

サンプルコード5

add_action( 'woocommerce_order_details_after_customer_address', 'display_order_discount', 10, 2 );
function display_order_discount( $order, $is_visible ) {
    $discount_amount = $order->get_discount_total();
    if ( $discount_amount > 0 ) {
        echo '<p>今回のご注文では、合計で ' . wc_price( $discount_amount ) . ' の割引が適用されました。</p>';
    }
}

このサンプルは、注文の割引金額を顧客に表示します。

概要

構文