プラグインWooCommerceのwoocommerce_thankyou_order_received_textフィルタの使用方法・解説

概要

woocommerce_thankyou_order_received_text フィルタは、WooCommerceの「注文確認」ページに表示されるメッセージをカスタマイズするために使用されます。このフィルタを使うことで、購入完了時のユーザー体験を向上させたり、特定の情報やメッセージを追加したりすることが可能です。主な用途としては、以下のような機能を実装する際に役立ちます。

注文が成功したことを通知するカスタムメッセージの追加。
割引やプロモーションコードの案内。
次回の購入を促すためのメッセージ。
特定の商品のレビューを依頼するメッセージ。
カスタマーサポートへの連絡情報の提供。
購入後の関連商品の提案。

フィルタの概要

構文: add_filter( 'woocommerce_thankyou_order_received_text', 'your_function_name', 10, 2 );
パラメータ:
- $text (string): デフォルトのメッセージ。
- $order (WC_Order): 注文オブジェクト。
戻り値: カスタマイズされたメッセージ (string)。
使用可能なプラグイン: WooCommerce（最新バージョンに依存）。
ワードプレスのバージョン: 通常、最新のWordPressバージョンで利用可能。

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

アクション	使用可能性
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_filter( 'woocommerce_thankyou_order_received_text', 'custom_order_received_message', 10, 2 );

function custom_order_received_message( $text, $order ) {
    $text .= '<p>ご購入ありがとうございます！次回のご利用では10%オフ！</p>';
    return $text;
}

このコードは、注文完了後に「次回のご利用では10%オフ」というメッセージを表示します。

サンプルコード 2: 注文の追跡リンクを追加

add_filter( 'woocommerce_thankyou_order_received_text', 'add_tracking_link_to_thankyou', 10, 2 );

function add_tracking_link_to_thankyou( $text, $order ) {
    $tracking_url = 'https://example.com/track/' . $order->get_id(); 
    $text .= '<p><a href="' . $tracking_url . '">ここをクリックして注文を追跡</a></p>';
    return $text;
}

このコードは、注文後に追跡リンクを追加します。

サンプルコード 3: アフターサポート情報の追加

add_filter( 'woocommerce_thankyou_order_received_text', 'add_support_info', 10, 2 );

function add_support_info( $text, $order ) {
    $text .= '<p>お困りのことがあれば、サポートまでご連絡ください。</p>';
    return $text;
}

このコードは、購入完了後にカスタマーサポートへの連絡情報を提示します。

サンプルコード 4: 商品レビューの依頼

add_filter( 'woocommerce_thankyou_order_received_text', 'request_product_review', 10, 2 );

function request_product_review( $text, $order ) {
    $text .= '<p>ご購入いただいた商品にレビューをお願いします！</p>';
    return $text;
}

このコードは、購入後にユーザーに商品レビューを依頼するメッセージを表示します。

サンプルコード 5: 関連商品の提案

add_filter( 'woocommerce_thankyou_order_received_text', 'suggest_related_products', 10, 2 );

function suggest_related_products( $text, $order ) {
    $text .= '<p>あなたにおすすめの商品はこちらです。</p>';
    return $text;
}

このコードは、購入完了後に関連商品を提案するメッセージを追加します。

概要